Basis pengetahuan GetMyBot

Orang (CRM)

Temukan pelanggan, lihat percakapannya, tambahkan label, dan simpan nomor telepon atau informasi lain.

Di halaman ini

Bagian Orang berisi pelanggan yang pernah menulis kepada bot. Buka profil seseorang untuk melihat percakapan, berkas, dan informasi yang tersimpan, seperti nomor telepon, kelas yang diminati, atau status pembayaran. Profil dibuat dan diperbarui otomatis ketika ada peristiwa dari pelanggan.

Kumpulan data pelanggan seperti ini disebut CRM. Label membantu Anda mengelompokkan orang, misalnya “Sudah membayar”. Parameter menyimpan nilai tertentu, seperti phone atau order_id.

Daftar pelanggan

Daftar menampilkan nama, ID Telegram, label, dan aktivitas, termasuk kapan pelanggan terakhir muncul atau apakah ia memblokir bot. Cari menurut nama atau ID, atau pilih filter cepat Semua, VIP, Sudah membayar, Baru, dan Berhenti berlangganan. Jumlah orang ditampilkan pada setiap filter. Klik satu baris untuk membuka percakapan.

Filter Memblokir bot hanya menampilkan orang yang telah memblokir bot; tanggal pemblokiran terlihat dalam profilnya. Ekspor CSV mengunduh hasil sesuai pencarian dan filter, paling banyak 10.000 baris. Anda dapat membukanya dalam aplikasi tabel. Kolom teknisnya: tg_user_id, name, username, platform, is_blocked, blocked_at, first_seen, last_seen, labels. Beberapa label dipisahkan dengan ;, tanggal memakai format RFC3339, dan isi teks dilindungi agar tidak dijalankan sebagai rumus oleh aplikasi tabel. Jika batas baris tercapai, API mengembalikan header X-Export-Truncated: true. Melalui API, gunakan GET /api/bots/{botID}/users?is_blocked=true&format=csv. Parameter is_blocked=true|false juga dapat dipakai untuk daftar JSON biasa; pelanggan yang memblokir bot memiliki blocked_at.

Informasi dalam profil pelanggan

Profil berisi foto, nama, @username, tautan Buka di Telegram, jumlah pesan, tanggal percakapan pertama dan terakhir, label, serta parameter global. Anda juga dapat melihat apakah pelanggan memblokir bot atau sedang menunggu jawaban operator.

Asal pelanggan menunjukkan tautan yang pertama kali membawa seseorang ke bot. Misalnya, tautan khusus iklan musim semi membedakan pengunjung iklan itu dari pengunjung lain. Penanda asal iklan disebut UTM. Di Telegram, bagian tautan setelah start= disebut payload atau penanda awal.

Contoh tautan:

  • Telegram: t.me/<bot>?start=utm_source-vk__utm_medium-cpc__utm_campaign-spring. Telegram hanya mengizinkan huruf, angka, _, dan - di payload. Pasangan dipisahkan __; nama dan nilai dipisahkan tanda - pertama.
  • VK: vk.me/<group>?ref=utm_source=vk&utm_medium=post.
  • Tautan undangan: t.me/<bot>?start=ref_<ID pelanggan>. Profil dan {{referrals.count}} menunjukkan jumlah orang yang diundang. Bentuk ref=<ID> dan ref_<ID> diproses terpisah dari UTM.

GetMyBot menyimpan lima nilai: utm_source, utm_medium, utm_campaign, utm_content, dan utm_term. Nilai pertama yang tidak kosong untuk setiap nama dipakai. Nilai tersebut tersedia dalam penggantian nilai dan segmen sebagai attribution.utm_source sampai attribution.utm_term.

Asal pelanggan ditetapkan dari tautan pertama yang memiliki penanda awal. /start berikutnya tidak mengubah asal dan tidak menambahkan UTM dari tautan baru. Jika penanda pertama adalah teks biasa atau tautan undangan, kolom UTM tetap kosong. Tautan tanpa penanda tidak menetapkan asal.

Dalam segmen, UTM dari tautan awal lebih diutamakan daripada UTM kunjungan situs dengan nama sama. Kolom yang tidak ada pada tautan dapat diambil dari data situs; tautan tanpa UTM tidak menghapusnya. Asal terkait dengan saluran saat pelanggan pertama kali membuka bot, dan masuk ke segmen setelah segmen dihitung ulang hanya untuk pelanggan dengan ID yang sama di saluran tersebut.

Label

Label memudahkan Anda memilih kelompok pelanggan, seperti “VIP”, “Sudah membayar”, “Baru”, atau “Berhenti berlangganan”. Anda dapat membuat label sendiri dan memilih warnanya. Tambahkan secara manual atau melalui tindakan Ubah label, lalu gunakan dalam kondisi dan memilih penerima siaran.

Label dapat berlaku terus atau hanya beberapa hari. Ketika masa berlaku habis, label dihapus otomatis dan bot menerima peristiwa Label expired. Melalui API, gunakan POST /api/bots/{botID}/users/{tgUserID}/labels dengan UUID resmi label_id dan ttl_days opsional dari 0 sampai 106751. ttl_days: 0 berarti label tidak memiliki batas waktu. Waktu berakhirnya label sementara tersedia sebagai label_expires_at dalam daftar pelanggan.

Parameter

Parameter menyimpan nilai untuk seorang pelanggan, seperti nama, email, total pesanan, status, atau poin. Nilai diisi melalui Ubah parameter, Simpan pesan, atau langkah percakapan. Gunakan kembali melalui penggantian nilai, seperti {{param.key}}, dan dalam kondisi. Dengan begitu, bot memiliki profil pelanggan tanpa memerlukan basis data luar.

Percakapan

Dalam percakapan, Anda dapat melihat pesan, foto, video, pesan suara, dokumen, tombol, dan tanda pengiriman. Reaksi yang dikirim ditampilkan sebagai kartu tersendiri. Di bagian bawah, Anda dapat menulis balasan, melampirkan berkas, atau mengirim reaksi dari daftar.

Lampiran

Tombol Lampiran membuka galeri berkas percakapan. Filter yang tersedia adalah Foto, File, Suara, dan Tautan, serta tombol Unduh semua.

Riwayat percakapan dan impor

GetMyBot menyimpan seluruh percakapan. Pesan lama dimuat sedikit demi sedikit saat Anda menggulir ke atas, sehingga percakapan panjang dapat dibuka tanpa menunggu seluruh riwayat. Pesan baru segera muncul dalam percakapan yang sedang terbuka dan di antrean operator.

Jika Anda memindahkan bot dari sambot, riwayat percakapan diimpor bersama pelanggan. Setelah impor, pesan dan lampiran lama langsung terlihat di profil. Baca Impor dari sambot.

Profil pelanggan dan tindakan massal

Profil menggabungkan data pelanggan, riwayat peristiwa (timeline), segmen, percakapan, dan catatan operator. Riwayat dimuat per bagian dan dapat difilter menurut jenis, asal, dan waktu. Setelah mengubah properti atau label, simpan perubahan. Perubahan tercatat dalam log tindakan dan memicu pembaruan segmen.

Dalam daftar, Anda dapat memilih beberapa pelanggan dan mengubah satu properti sekaligus. Tindakan ini memakai salinan daftar penerima yang disimpan, terbatas pada 5.000 orang, dan aman jika permintaan dikirim ulang. Ekspor CSV dibuat sebagai proses tersendiri yang dapat dibatalkan sebelum berkas diunduh. Tindakan massal yang sudah diterapkan tidak dapat dibatalkan sebagian.

Gabungkan profil

Pemilik proyek dapat memilih dua orang pada halaman daftar yang sama dan memilih Gabungkan profil. Periksa kontak dan kanal, pilih profil utama, lalu konfirmasi. Riwayat dan data digabungkan; jika ada konflik, nilai profil utama digunakan. Penggabungan tidak dapat dibatalkan.

Selesaikan atau periksa sinkronisasi CRM dan operasi Ozma yang belum selesai. Selesaikan dahulu konflik kontak dan tautan ke catatan CRM yang berbeda.

Alamat email yang sama tidak menggabungkan profil secara otomatis. Gunakan identify bertanda tangan untuk menghubungkan pengguna situs yang masuk; Tautan Telegram yang terkonfirmasi hanya tersedia jika fitur diaktifkan di wilayah Anda; menghubungkan kanal saja tidak cukup.

Langkah berikutnya

Segmen yang diperbarui otomatis

Di bagian Segmen, tentukan penerima dengan kondisi yang digabung menggunakan DAN atau ATAU. Periksa hasil pratinjau sebelum menyimpan. Setelah data berubah, hitung ulang anggota segmen dan pastikan segmen siap sebelum dipakai untuk siaran. Menyimpan aturan segmen saja tidak memastikan jumlah anggota sudah terbaru.