Basis pengetahuan GetMyBot

Proyek dan Saluran

Cara membuat proyek, menghubungkan bot, dan memeriksa statusnya. Termasuk beberapa saluran, penggantian token, penjedaan, dan pemulihan bot.

Di halaman ini

Proyek menyatukan pengaturan, reaksi, dan data untuk bot atau layanan Anda. Saluran menghubungkan proyek ke tempat Anda berbicara dengan pelanggan, seperti bot Telegram, obrolan di situs web, atau aplikasi pesan lain. Misalnya, sebuah sekolah dapat memakai satu proyek untuk Telegram dan situs webnya.

Buat proyek di halaman Proyek, lalu tambahkan saluran. Untuk Telegram, Anda memerlukan token dari @BotFather, yaitu kunci untuk mengelola bot. Anda dapat beralih proyek melalui pemilih di bagian atas.

Bot tidak terbatas pada Telegram. Anda dapat menghubungkan WhatsApp dan VK ke proyek yang sama, lalu menggunakan reaksi yang sama di semua saluran. Baca Saluran untuk gambaran umum dan WhatsApp untuk petunjuk penghubungan.

Menghubungkan bot

  1. Jika belum ada proyek, buka Proyek dan klik Tambah proyek. Pada kartu proyek, klik Tambah saluran lalu pilih Telegram. Untuk bot pertama, Anda juga dapat mengikuti panduan saat pertama kali masuk.
  2. Tempelkan token dari @BotFather dan klik Validasi. GetMyBot akan menampilkan @username yang ditemukan, sehingga Anda dapat memastikan tokennya benar.
  3. Klik Hubungkan. Token disimpan dalam bentuk terenkripsi, dan bot segera mulai menerima pesan.

Setelah terhubung, Telegram akan muncul pada kartu proyek bersama saluran lain. Kartu tersebut menampilkan nama proyek, @username bot, jumlah pengguna, reaksi aktif, dan permintaan hari ini. Lihat sisa permintaan di Penagihan atau Statistik.

Mengelola beberapa bot

Satu akun dapat mengelola beberapa proyek dan bot sekaligus. Jumlahnya dibatasi oleh paket Anda melalui ketentuan “jumlah bot maksimum”. Beralihlah melalui pemilih di bagian atas atau halaman Proyek. Halaman Reaksi, Obrolan, dan Statistik akan menampilkan data proyek yang sedang dipilih.

Cara bot menerima pesan

Setelah bot dihubungkan, GetMyBot menerima peristiwa dari Telegram secara otomatis: pesan, ketukan tombol, orang yang bergabung ke obrolan, dan pembayaran. Anda tidak perlu mengatur penerimaan pesan sendiri; token yang masih berlaku sudah cukup. Bergantung pada pengaturan server, Telegram mengirim peristiwa ke alamat platform melalui webhook, atau platform mengambilnya secara berkala dari Telegram melalui long polling.

Mengaktifkan atau menonaktifkan bot

Setiap bot memiliki status aktif atau nonaktif pada kartu Status bot di Pengaturan. Bot yang dinonaktifkan tidak membalas pesan. Perubahan berlaku segera tanpa perlu menghubungkan ulang bot.

Status proyek dan saluran

Halaman Proyek menampilkan status proyek secara terpisah: Aktif, Dijeda, atau Dibekukan. Status ini tidak memastikan pesan Telegram terkirim. Setiap saluran memiliki label sendiri: Online, Tidak ada sinyal, Terkonfigurasi, Dinonaktifkan, atau Proyek tidak aktif. Karena itu, proyek aktif yang hanya menggunakan obrolan situs web tidak akan terlihat seperti bot Telegram yang terhenti.

Jika proyek aktif memiliki tepat satu saluran Telegram yang diaktifkan, label Online berarti proses yang menangani bot baru saja melaporkan bahwa bot berjalan. Jika laporan terbaru tidak ada, label berubah menjadi Tidak ada sinyal. Jika beberapa saluran Telegram aktif, labelnya Terkonfigurasi karena laporan tingkat proyek tidak dapat menunjukkan saluran mana yang berjalan. Untuk platform selain Telegram, Terkonfigurasi berarti saluran sudah terhubung, bukan jaminan bahwa setiap pesan pasti terkirim.

Beberapa proses platform menangani bot secara bersamaan. Proses yang menangani bot melaporkan kondisinya setiap 30 detik. Laporan dianggap baru selama satu setengah menit, sehingga satu laporan yang terlewat tidak langsung mengubah status.

Apa artinya bagi Anda:

  • Label status dapat terlambat berubah. Setelah bot dihubungkan atau platform dimulai ulang, label Online mungkin baru muncul dalam rentang waktu tersebut.
  • Jika Tidak ada sinyal bertahan lebih dari beberapa menit untuk saluran Telegram yang aktif, periksa token dan kartu Bot health di Pengaturan. Proyek tetap aktif sampai Anda menjedanya atau platform membekukannya karena batas paket.
  • Laporan tersebut berlaku untuk proses yang menangani proyek. Server mana pun yang menjawab permintaan Anda tidak memengaruhi label ini. Jika ada beberapa saluran Telegram, laporan itu tidak membuktikan keadaan masing-masing saluran.

Jika bot tidak terhubung

Setiap menit, platform memeriksa laporan kondisi bot. Jika bot aktif tidak memiliki laporan terbaru, platform mencatat sebuah insiden, mencari penyebabnya satu kali, lalu mencoba memulihkan bot secara otomatis.

Ada empat kemungkinan penyebab, yang ditampilkan pada kartu Bot health di Pengaturan:

  • Webhook: Telegram tidak mengirim pembaruan ke alamat platform; platform mendaftarkan ulang alamatnya.
  • Token dicabut: pemeriksaan getMe menghasilkan kode 401. Platform tidak mengulang pemulihan untuk kondisi ini. Buat token baru di @BotFather dan masukkan melalui Ganti token.
  • Tidak ada server yang menangani bot: platform memulai ulang bot agar pembaruan kembali diproses.
  • Penyebab belum diketahui: Telegram tidak menjawab pemeriksaan.

Pemulihan otomatis melakukan hal yang sama dengan tombol Sinkronkan: memeriksa token melalui getMe dan mendaftarkan ulang webhook. Jeda antarpercobaan akan bertambah. Setiap percobaan dicatat dalam Restart log insiden, termasuk waktu, hasil, dan pesan kesalahan bila gagal. Anda juga dapat melihat jadwal percobaan berikutnya pada kartu tersebut.

Jika bot tidak aktif lebih lama daripada batas pada kartu Bot health (awalannya 5 menit), pemilik bot mendapat pemberitahuan “Bot offline” melalui ikon notifikasi dan email. Obrolan dalam daftar penerima notifikasi mendapat pesan dari bot. Setiap insiden hanya mengirim satu pemberitahuan. Saat laporan kondisi kembali muncul, pemilik mendapat kabar “Bot kembali online” beserta lamanya gangguan. Riwayat insiden, durasi, dan penyebabnya tetap tersedia di kartu yang sama.

Bot dibekukan karena batas paket

Selain status aktif atau nonaktif, bot dapat berstatus dibekukan. Platform membekukan bot secara otomatis jika paket yang berlaku tidak lagi mencakup jumlah bot yang terhubung. Ada dua alasan:

  • Batas bot terlampaui: Anda pindah ke paket yang mengizinkan lebih sedikit bot daripada jumlah yang sudah terhubung.
  • Langganan tidak diperpanjang: paket berbayar berakhir, sehingga batas paket gratis berlaku kembali.

Bot yang dibekukan tidak menerima pesan karena penerimaan pembaruannya benar-benar dimatikan. Data, reaksi, dan pelanggan tetap tersimpan. Bot dapat dipulihkan.

Cara memulihkan bot. Bayar paket yang mencakup jumlah bot yang dibutuhkan. Ketika paket aktif, platform otomatis mengaktifkan kembali bot mulai dari yang paling lama terhubung, sampai batas paket terisi. Anda tidak dapat memilih bot mana yang kembali lebih dulu. Jika ingin mempertahankan bot yang lebih baru, hapus koneksi yang tidak diperlukan sebelum membayar paket.

Pembekuan seluruh akun adalah keadaan yang berbeda: semua bot dan siaran berhenti sekaligus, dan dasbor menampilkan “Akun dibekukan”. Hubungi bantuan untuk membuka kembali akun. Baca juga Pembayaran dan saldo.

Profil dan sinkronisasi

Tombol Sinkronkan di Pengaturan memperbarui nama bot dari Telegram jika Anda mengubahnya melalui @BotFather. Foto profil pengguna bot diperbarui secara otomatis.

Mengganti token

Jika Anda menerbitkan ulang token di @BotFather (Bot Settings → Revoke / New token), perbarui di Pengaturan → Kanal → Telegram 🔑. Token baru harus milik bot yang sama (ID internal Telegram harus sama) — ini memastikan semua reaksi, pelanggan, dan data tetap terjaga. Jika kanal Telegram tidak ditampilkan, pilih «Ganti token» di jendela yang sama.

Memindahkan bot ke akun lain

Melalui Pengaturan → Ganti pemilik, Anda dapat mengirim undangan pemindahan proyek ke akun GetMyBot lain melalui email. Undangan berlaku selama 72 jam. Sebelum penerima menyetujuinya, proyek tetap milik Anda dan undangan dapat dibatalkan. Setelah disetujui, pemilik berubah dan Anda kehilangan akses ke proyek. Gunakan saat menyerahkan proyek kepada klien atau rekan kerja.

Templat bot

Templat menyimpan pengaturan bot dan semua reaksinya sebagai salinan yang dapat diterapkan ke bot lain:

  • Buat template di Pengaturan menyimpan bot saat ini sebagai templat bernama.
  • Terapkan template mengganti pengaturan bot yang dipilih dengan pengaturan dari templat dan menambahkan reaksi dari templat ke reaksi yang sudah ada.

Cara ini memudahkan Anda menyiapkan beberapa proyek dengan pola bot yang sama.

Memasang solusi dari katalog

Katalog solusi siap pakai memiliki panduan pemasangan. Isi parameter yang diminta, periksa kecocokan dan koneksi yang diperlukan, lalu lihat daftar hal yang akan dibuat. Setelah pemasangan, selesaikan langkah yang tersisa dan uji alurnya dengan permintaan percobaan.

Panduan ini berbeda dari penerapan templat bot di atas. Pemeriksaan sebelum pemasangan dapat menunjukkan parameter atau kemampuan yang belum tersedia. Tanda bahwa suatu langkah sudah diisi tidak membuktikan bahwa layanan luar telah bekerja.

Hasil solusi siap pakai

Pilih rentang waktu untuk menilai solusi yang telah dipasang. Jika ingin membandingkan hasil, pilih cara perbandingan yang tersedia, lalu periksa jumlah data dan keterangannya. Data yang belum cukup atau perbandingan yang tidak tersedia berbeda dari hasil yang benar-benar bernilai nol.

Langkah berikutnya