Saluran: Telegram, WhatsApp, VK
Hubungkan Telegram, WhatsApp, dan VK ke satu proyek. Kenali perbedaan fiturnya dan ke mana bot mengirim balasan.
Di halaman ini
Satu proyek GetMyBot dapat membalas pesan melalui Telegram, WhatsApp, dan VK. Misalnya, aturan yang mengirim jadwal kelas dapat dipakai di ketiganya. Balasan dikirim ke saluran tempat pelanggan menulis.
Saat menghubungkan aplikasi pesan lain, periksa kembali tombol dan tindakan yang digunakan. Setiap platform memiliki kemampuan yang berbeda. Perbedaannya dan langkah penghubungannya dijelaskan di bawah ini.
Apa itu saluran
Saluran adalah tempat pengiriman yang terhubung, seperti bot Telegram tertentu, nomor WhatsApp Business, atau komunitas VK. Satu proyek GetMyBot dapat memiliki beberapa saluran. Semua saluran memakai reaksi yang sama. Jika pelanggan menulis melalui WhatsApp, reaksi yang sama seperti di Telegram akan memproses pesannya, lalu balasan dikirim kembali ke WhatsApp.
Tidak semua aplikasi pesan mendukung tombol, format teks, dan tindakan yang sama. Editor dapat menyembunyikan pengaturan yang tidak tersedia atau menggantinya dengan pilihan yang didukung. Uji pesan Anda di setiap saluran sebelum digunakan pelanggan.
Saluran utama (primary_channel)
Setiap bot memiliki saluran utama (primary_channel), yaitu platform yang paling erat terkait dengannya. Biasanya Telegram, tetapi Anda dapat membuat bot langsung untuk WhatsApp atau VK tanpa Telegram. Saluran utama ditentukan saat bot dibuat dan terlihat dalam daftar proyek. Anda dapat menambahkan saluran lain kemudian.
Fitur menurut saluran
Berikut kemampuan masing-masing aplikasi pesan. Data fitur terbaru juga tersedia melalui API GET /api/channels/capabilities.
Telegram mendukung tombol di bawah pesan dan papan tombol balasan, ketukan tombol yang memulai reaksi (callback), reaksi emoji, tautan /start, mengubah, menghapus, dan meneruskan pesan, balasan pesan sebagai pemicu, peristiwa anggota, izin, serta moderasi. Kartu dalam karusel foto dapat dijelajahi di satu pesan jika semua fotonya memiliki pengenal berkas yang sesuai. Format teks: Plain, HTML, dan Markdown. Telegram tidak menggunakan templat WhatsApp, daftar interaktif, atau batas waktu sesi.
WhatsApp melalui WhatsApp Cloud API mendukung tombol di bawah pesan, callback, reaksi emoji, tautan /start, templat pesan, daftar interaktif, dan sesi 24 jam. Format teks: Plain dan Markdown. WhatsApp tidak mendukung papan tombol balasan, mengubah, menghapus, atau meneruskan pesan, balasan pesan sebagai pemicu, peristiwa anggota, izin atau moderasi, maupun penelusuran karusel di satu pesan. Baca WhatsApp.
VK mendukung pesan dan lampiran, tombol di bawah pesan dan papan tombol balasan, callback, reaksi emoji, tautan /start, mengubah, menghapus, dan meneruskan pesan, peristiwa anggota, memblokir atau membuka blokir anggota, menyetujui permintaan bergabung yang sudah dikirim ke komunitas tertutup, serta peristiwa langganan berbayar VK Donut. Teks hanya dapat tampil sebagai teks biasa; HTML dan Markdown dihapus saat ditampilkan. VK tidak memakai templat WhatsApp, daftar interaktif, sesi 24 jam, atau penelusuran karusel di satu pesan.
Semua saluran mendukung tombol di bawah pesan, callback, reaksi emoji, dan tautan /start. Blok karusel foto tersedia pada saluran yang mendukung foto. Di Telegram, kartu dapat dijelajahi di satu pesan jika semua foto memiliki file_id yang sesuai. Di WhatsApp dan VK, serta di Telegram jika ada foto tanpa ID tersebut, kartu dikirim sebagai pesan foto terpisah. Baca Pesan dan tombol.
VK Donut
Jika komunitas mengaktifkan VK Donut, bot menerima peristiwa sistem untuk langganan berbayar. Nama di kolom pertama adalah nama pemicu yang terlihat di editor.
| Peristiwa di editor | Kunci | Data yang tersedia |
|---|---|---|
| VK Donut: subscription created | donut_subscription_created | {{event.donut_amount}}, {{event.donut_amount_without_fee}} |
| VK Donut: subscription prolonged | donut_subscription_prolonged | {{event.donut_amount}}, {{event.donut_amount_without_fee}} |
| VK Donut: subscription expired | donut_subscription_expired | Tidak ada |
| VK Donut: subscription cancelled | donut_subscription_cancelled | Tidak ada |
{{event.donut_amount}} berisi jumlah pembayaran, sedangkan {{event.donut_amount_without_fee}} berisi jumlah setelah potongan biaya VK. Peristiwa langganan berakhir dan dibatalkan tidak memiliki nilai pembayaran. Mengisi kolom itu dengan pembayaran sebelumnya akan menampilkan angka yang keliru.
Peristiwa ini berisi informasi tentang pelanggan, bukan pesan dari pelanggan. Karena itu, peristiwa tersebut tidak membuka percakapan pribadi, tidak menghapus blokir, tidak memperbarui aktivitas terakhir, dan tidak menambah jumlah pesan. Jika pelanggan belum ada dalam GetMyBot, platform membuat profilnya agar label dan hak akses dapat diterapkan.
Contoh alur untuk klub berlangganan:
- Buat reaksi untuk VK Donut: subscription created dan reaksi serupa untuk subscription prolonged. Tambahkan tindakan Ubah label untuk memberi label “Klub” selama
ttl_days= 31, lalu kirim tautan komunitas tertutup dan minta pelanggan mengajukan permintaan bergabung. - Setujui permintaan sebagai langkah terpisah setelah pelanggan mengirimkannya. Tindakan Ubah hak → Setujui permintaan bergabung hanya menyetujui permintaan yang sudah ada melalui
groups.approveRequest. Jalankan dalam reaksi berikutnya, misalnya saat pelanggan menekan tombol “Saya sudah mengirim permintaan” atau ketika langganannya diperpanjang. - Buat reaksi untuk pemicu Label expired (
label_expired), lalu gunakan Ubah hak → Keluarkan. Pelanggan keluar saat labelnya berakhir, meskipun VK belum mengirim peristiwa langganan berakhir. Lihat Pemicu. - Buat reaksi untuk subscription cancelled dan subscription expired. Gunakan Ubah label untuk menghapus label “Klub”, dan bila perlu Keluarkan pelanggan saat itu juga.
Kolom Obrolan (chat_id) dalam tindakan izin VK harus berisi ID numerik komunitas yang terhubung, sama dengan angka pada daftar saluran VK. VK hanya dapat mengelola anggota komunitas itu. Jika Anda mengisi ID lain, GetMyBot akan menolak tindakan sebelum mengirimnya ke VK. Untuk mengelola komunitas lain, hubungkan sebagai saluran tersendiri.
Cara mengaktifkan peristiwa:
- Long Poll: bot berlangganan secara otomatis saat saluran dihubungkan dan setiap kali platform dimulai. Komunitas yang sudah terhubung tidak perlu melakukan apa pun lagi.
- Callback API: di pengaturan komunitas VK, buka Работа с API → Callback API → Типы событий → VK Donut dan aktifkan keempat peristiwa pada tabel.
Menghubungkan saluran
Tambahkan saluran dari halaman Proyek.
- Buka Proyek dan temukan proyek yang akan digunakan.
- Klik Tambah saluran pada kartu proyek.
- Pilih Telegram, WhatsApp, atau VK.
- Masukkan data penghubung saluran: token untuk Telegram, data akun Meta untuk WhatsApp, atau data komunitas untuk VK.
- Klik Validasi agar GetMyBot memeriksa data tersebut pada platform terkait.
- Klik Hubungkan.
Untuk WhatsApp dan VK, saluran yang telah terhubung menampilkan alamat webhook melalui ikon 🔗. Masukkan alamat ini pada platform terkait, yaitu aplikasi Meta untuk WhatsApp atau pengaturan komunitas untuk VK, agar pesan masuk mencapai bot. Petunjuk WhatsApp tersedia di Pengaturan webhook WhatsApp.
Langkah berikutnya
- WhatsApp: penghubungan, webhook, sesi 24 jam, dan templat pesan.
- Proyek dan saluran: langkah dasar menghubungkan bot.
- Dasar-dasar reaksi: perilaku bot yang digunakan di semua saluran.
Data untuk menghubungkan saluran
Telegram menggunakan token lengkap dari BotFather. Untuk VK, siapkan token komunitas dan ID numerik komunitas. Callback API juga memerlukan string rahasia dan kode konfirmasi. Untuk WhatsApp, masukkan Phone Number ID, ID akun WhatsApp Business, token dengan akses ke akun, Verify Token webhook, dan App Secret aplikasi Meta.
Periksa data sebelum menghubungkan saluran. Jika Anda mengganti kunci, perbarui pengaturan terkait pada platform penyedia. Verify Token dipakai untuk memastikan alamat webhook, sedangkan App Secret dipakai untuk memeriksa tanda tangan peristiwa masuk. Keduanya tidak menggantikan token untuk mengakses API.
Pesan masuk dan alamat webhook
Untuk VK Callback API, daftarkan alamat yang ditampilkan GetMyBot pada pengaturan server komunitas, lalu masukkan string rahasia dan kode konfirmasi yang sama. Long Poll tidak memerlukan alamat publik atau kedua nilai tersebut. Untuk WhatsApp, daftarkan alamat dalam aplikasi Meta, gunakan Verify Token yang sama, dan berlangganan peristiwa pesan yang diperlukan. Data untuk mengirim pesan saja belum cukup untuk menerima pesan.
Menghubungkan Instagram dan Messenger melalui Meta
Panduan penghubungan akan membuka proses pemberian izin Meta. Masuk dengan akun yang mengelola halaman Facebook atau akun Instagram profesional yang dibutuhkan, berikan izin yang diminta, lalu pilih akun untuk proyek ini. Panduan akan memeriksa izin, langganan webhook, dan kesiapan pengiriman. Selesaikan pemeriksaan yang gagal sebelum menggunakan saluran. Pada saluran yang sudah terhubung, Anda dapat meninjau kembali akun yang dipilih.