Basis pengetahuan GetMyBot

Siaran pesan

Kirim berita atau pengingat kepada sekelompok pelanggan: pilih pesan, saluran, dan penerima, periksa sebelum mengirim, lalu lihat hasilnya.

Di halaman ini

Siaran mengirim satu pesan yang sudah disiapkan kepada banyak orang. Misalnya, undangan kelas kepada semua pelanggan berlabel “Tertarik pada kursus”. Pilih isi pesan, penerima, dan saluran, lalu periksa daftar penerima sebelum memulai pengiriman.

Ada dua cara mengirim siaran di GetMyBot:

  • Bagian Siaran (/app/broadcasts): editor lengkap untuk satu dokumen konten, pilihan saluran dan segmen, jadwal, pemeriksaan sebelum mengirim, serta laporan per saluran. Ini cara utama.
  • Tombol Siaran pada reaksi: mengirim reaksi yang sudah dibuat kepada pelanggan aktif. Cara ini tidak memiliki draf atau pemeriksaan penerima sebelum mengirim. Periksa isi reaksi dan audiensnya lebih dulu.

Keduanya memerlukan paket yang menyertakan siaran serta hak bot untuk Reaksi. Tanpa fitur pada paket, pembuatan siaran menghasilkan kesalahan pembayaran. Tanpa hak tersebut, halaman menampilkan petunjuk bahwa Anda tidak punya akses.

Editor siaran

Buka Siaran di menu kiri. Tombol Buat siaran membuka editor dengan empat bagian.

Nama dan saluran. Nama maksimal 160 karakter. Pilih satu atau beberapa saluran: Telegram, VK, WhatsApp, chat situs, Email, push browser, push seluler, atau pesan di dalam aplikasi. Messenger dapat digabung dengan chat situs; push browser dapat digabung dengan push seluler. Email dan pesan dalam aplikasi harus dipilih sendiri-sendiri. Setiap kelompok memakai jenis dokumen tersendiri: Pesan, Push, Email, atau Dalam aplikasi. Karena satu siaran terhubung ke satu dokumen, memilih saluran dari kelompok lain akan membatalkan pilihan saluran sebelumnya.

Konten. Pilih versi dokumen yang sudah diterbitkan dan sesuai dengan saluran. Siaran menyimpan identitas dokumen dan nomor versinya; menerbitkan versi baru nanti tidak mengubah siaran yang sudah dibuat. Anda dapat membuat konten baru atau salinan yang dapat diedit langsung dari editor ini. Setelah disimpan, salinan akan diterbitkan dan digunakan oleh siaran. Untuk messenger dan chat situs, tersedia blok pesan, termasuk pesan suara, GIF, video bulat, dan karusel. Di VK, karusel dikirim sebagai beberapa pesan.

Untuk messenger, chat situs, dan Email, Anda dapat melihat pratinjau menurut saluran. Jika memilih satu penerima uji, pratinjau memakai datanya dan tombol Kirim tes mengirim konten hanya ke kontak yang sudah terverifikasi itu. Tes menggunakan kuota dan batas yang sama seperti pengiriman tes di Studio konten. Tes tidak mengubah daftar penerima siaran; Anda tidak dapat memasukkan alamat sembarang, dan tes yang terlalu sering akan ditolak. Push browser, push seluler, dan pesan dalam aplikasi dapat dilihat pada tiruan layar perangkat, tetapi tidak dapat dikirim sebagai tes dari editor ini.

Audiens dan eksperimen. Pilih semua pelanggan bot, satu segmen yang sudah dibuat, atau audiens bot_chats, yaitu grup, supergrup, dan saluran Telegram tempat bot ditambahkan. Daftar chat terisi otomatis saat bot masuk ke chat atau dijadikan admin. Anda dapat mencentang chat tertentu. Jika tidak ada yang dicentang, siaran dikirim ke semua chat tempat bot boleh menulis. Pilihan ini hanya berlaku untuk Telegram; saluran lain dibatalkan. Chat yang sudah menghapus bot, tidak mengizinkan bot menulis, atau memiliki ID tidak dikenal dikecualikan dengan alasan bot_left, cannot_post, atau chat_unknown. Data pribadi pelanggan ({{profile.*}}, {{event.*}}) tidak diisikan dalam pesan ke chat. Anda juga dapat menghubungkan eksperimen A/B yang sedang berjalan.

Jadwal. Atur zona waktu siaran, cara menafsirkan waktu, jam pengiriman, dan kecepatannya.

  • Waktu pengiriman boleh kosong. Jika kosong, siaran dimulai segera setelah dikonfirmasi.
  • Menurut waktu bot: semua penerima mendapat jadwal pada satu saat yang sama, dihitung dengan zona waktu siaran.
  • Menurut waktu setempat penerima: setiap orang menerima pesan pada jam lokal yang sama. Jika zona waktunya tidak ada, tidak dikenali, atau jam itu tidak terjadi pada tanggal tersebut, pesan dijadwalkan menurut zona waktu siaran. Pada siaran email, penerima seperti ini justru dikecualikan.
  • Editor menolak jam yang tidak terjadi karena perubahan waktu musiman dan menjelaskannya di bawah kolom.
  • Pesan per menit: dari 1 sampai 10.000. Pengiriman dibagi sesuai angka ini. Jika nilainya 60, enam puluh penerima pertama dijadwalkan pada waktu mulai, enam puluh berikutnya satu menit kemudian, dan seterusnya.

Jika siaran berbayar diaktifkan untuk bot dan Telegram dipilih, tersedia sakelar untuk membayar dengan Telegram Stars serta kotak konfirmasi terpisah. Tanpa konfirmasi, draf tidak dapat disimpan. Jika fitur siaran berbayar dimatikan setelah draf dibuat, pengiriman tetap berjalan sebagai siaran gratis.

Periksa sebelum mengirim

Tombol Periksa penerima tidak mengirim pesan. Sistem menghitung audiens berdasarkan draf, saluran, dan izin komunikasi saat ini. Anda akan melihat jumlah penerima per saluran, jumlah yang dikecualikan beserta alasannya, serta kesalahan atau peringatan pada konten.

Alasan penerima dikecualikan:

  • no_identity: pelanggan tidak punya alamat atau identitas pada saluran ini;
  • unverified: kontak belum terverifikasi;
  • blocked: pelanggan telah memblokir bot;
  • channel_disabled: saluran belum terhubung atau dimatikan;
  • email_unsubscribed, email_bounced, email_complained, email_no_consent: status izin email bukan “berlangganan”;
  • wa_window_closed: tidak ada pesan masuk dari orang tersebut dalam 24 jam terakhir, sehingga pesan bebas WhatsApp tidak boleh dikirim.

Kesalahan yang mencegah pengiriman:

  • content_not_published: versi konten yang dipilih tidak ada atau belum diterbitkan;
  • audience_not_ready: segmen tidak ada atau belum selesai dihitung ulang;
  • experiment_not_ready: eksperimen yang terhubung belum berjalan atau tidak membagi berdasarkan pelanggan;
  • empty_audience: tidak ada penerima;
  • kesalahan validasi konten untuk tiap saluran, ditandai content:<saluran>, misalnya content:wa.

Peringatan konten ditampilkan di dekatnya, tetapi tidak mencegah pengiriman. Tombol untuk memulai aktif hanya jika tidak ada kesalahan dan ada setidaknya satu penerima.

Memulai dan mengelola siaran

Hanya draf yang dapat dimulai, dan hanya dari bagian pemeriksaan. Tombolnya bernama Kirim sekarang atau Jadwalkan, sesuai waktu yang diisi. Anda harus mengonfirmasi tindakan, dan versi draf harus masih sama dengan yang ditampilkan di layar.

Saat dimulai, sistem menetapkan versi konten, saluran, audiens, eksperimen, dan jadwal. Untuk setiap penerima yang memenuhi syarat, sistem membuat pesan dalam antrean dengan waktu pengiriman yang dihitung. Untuk orang yang dikecualikan, sistem menyimpan alasannya tanpa membuat pesan. Dalam laporan, penerima yang dikecualikan berbeda dari penerima yang sudah dicoba dikirimi pesan tetapi pengirimannya gagal.

Setelah siaran dimulai, isinya tidak dapat diubah. Editor hanya dapat dibaca; buat siaran baru jika ada yang perlu diubah.

Statusnya: Draf, Terjadwal, Mengirim, Dijeda, Selesai, Dibatalkan, Gagal, dan Diarsipkan. Tindakan yang tersedia:

  • Jeda saat Terjadwal atau Mengirim. Pesan yang belum mulai diproses berhenti, tetapi pesan yang sedang dikirim tetap selesai.
  • Lanjutkan saat Dijeda, kembali ke Mengirim.
  • Batalkan saat Draf, Terjadwal, Mengirim, atau Dijeda. Pesan yang belum terkirim ditandai dibatalkan.
  • Arsipkan saat Selesai, Dibatalkan, atau Gagal. Siaran arsip terlihat melalui sakelar Tampilkan siaran arsip.

Setiap tindakan memeriksa revisi yang diharapkan. Jika dua operator mengubah siaran bersamaan, operator kedua mendapat pesan bahwa siaran telah diubah di tempat lain.

Laporan dan penerima

Pilih siaran dalam daftar untuk membuka hasilnya. Setiap saluran menampilkan jumlah Dalam antrean, Terkirim, Tersampaikan, Gagal, dan Dikecualikan. Saat siaran masih terjadwal, sedang dikirim, atau dijeda, laporan diperbarui otomatis setiap 15 detik.

Untuk siaran ke chat dan saluran bot, laporan juga menampilkan tabel Per chat: nama chat, status pengiriman (dalam antrean, terkirim, gagal, dibatalkan), atau alasan pengecualian. Angka untuk Telegram menghitung chat, bukan pelanggan. Jeda, lanjutkan, pembatalan, dan batas pesan per menit bekerja seperti siaran ke pelanggan.

Angka Tersampaikan pada tingkat ini tetap nol. Platform tahu pesan telah dikirim ke saluran, tetapi tidak mengumpulkan konfirmasi bahwa pesan diterima untuk laporan ini. Rincian email, seperti pembukaan, klik, pantulan, dan keluhan, tersedia di Siaran email.

Memblokir setelah siaran menghitung kejadian ketika penerima memblokir bot dalam 24 jam setelah pesan dari siaran ini tersampaikan. Pemblokiran dikaitkan dengan siaran terakhir yang tersampaikan dalam rentang itu. Ini jumlah kejadian pemblokiran, bukan jumlah pelanggan unik. Daftar orangnya ada di Orang → Memblokir → Ekspor CSV, pada kolom blocked_at.

Tombol Penerima membuka daftar berhalaman yang hanya berisi saluran, status (menunggu, dikecualikan, dalam antrean, mengirim, terkirim, gagal, dibatalkan), dan alasan pengecualian. Tidak ada kolom tersendiri untuk nama penerima.

Satu batas penting: jika konten untuk seorang penerima menghasilkan beberapa pesan, siaran hanya mengirim pesan pertama. Satu baris penerima disimpan untuk setiap pasangan “penerima dan saluran”.

Mengirim reaksi dari daftar reaksi

Cara lama tetap tersedia. Dalam daftar Reaksi, tiap reaksi memiliki tombol bergambar kirim dengan petunjuk “Kirim reaksi kepada pelanggan”. Menekannya langsung memasukkan siaran ke antrean. Tidak ada draf, pemeriksaan penerima, atau laporan per saluran. Pada dialog, Anda dapat memilih siaran berbayar dengan Telegram Stars jika fitur tersebut diizinkan untuk bot. Tombol Siaran pada halaman Ringkasan membuka daftar reaksi yang sama.

Siaran ini dikirim ke semua pelanggan bot yang aktif. Pembatasan berdasarkan label hanya tersedia melalui API dengan parameter labels; tidak ada pilihan label di antarmuka. Lihat REST API dan token.

Statusnya lebih singkat: menunggu, berjalan, selesai, dibatalkan, serta penanda jeda. Jeda, lanjutkan, dan pembatalan tersedia melalui API. Siaran berjalan per halaman dan melanjutkan dari posisi yang tersimpan setelah layanan dimulai ulang.

Siaran terjadwal

Reaksi dengan pemicu Menurut jadwal (tanggal) berjalan pada waktu yang ditentukan dan otomatis dikirim kepada pelanggan aktif. Ini berguna untuk rangkuman atau pengingat rutin tanpa memulai siaran secara manual. Jika proses diulang setelah gangguan, sebagian pelanggan mungkin menerima pesan ganda. Untuk pengumuman terjadwal, duplikasi yang jarang terjadi dianggap lebih baik daripada pesan yang hilang tanpa pemberitahuan.

Langkah berikutnya