Cara Menghubungkan FoneClaw ke Bot Telegram
Panduan membuat bot Telegram khusus, menyimpan token BotFather di FoneClaw, memasangkan akun pribadi, menguji satu ToDo Android, dan memperbaiki error koneksi.
- Untuk menghubungkan FoneClaw ke bot Telegram, buat bot khusus lewat BotFather, simpan token dengan aman, lalu gunakan bot itu hanya untuk percakapan pribadi FoneClaw.
- Setelah token disimpan di FoneClaw, buka bot Anda sendiri di Telegram dan kirim “hello” dalam 10 menit; akun Telegram pertama yang mengirim pesan itulah yang dipasangkan.
- Koneksi chat yang berhasil belum sama dengan tugas Android yang selesai. Uji satu hasil sederhana, seperti ToDo tanpa tanggal, lalu periksa item tersimpan di FoneClaw.
- Jika koneksi gagal, bedakan token salah, bot sudah pernah dipakai, pesan dikirim ke bot yang keliru, jendela 10 menit lewat, jaringan Telegram tidak terjangkau, atau konflik layanan lain.
Buat bot Telegram khusus
Menghubungkan FoneClaw ke bot Telegram berarti memakai bot sebagai pintu percakapan pribadi ke FoneClaw. Ini berbeda dari mengontrol aplikasi Telegram dengan suara di Android. Jika tujuan Anda adalah mengoperasikan Telegram sebagai aplikasi, panduan Kontrol Telegram dengan Suara di Android membahas alur yang berbeda. Di sini, yang Anda siapkan adalah bot pribadi agar Anda bisa mengirim permintaan ke FoneClaw melalui chat bot.
Mulai dari panduan resmi Telegram tentang BotFather. Buka akun resmi @BotFather di Telegram, lalu gunakan perintah /newbot. BotFather akan meminta nama bot dan nama pengguna bot. Setelah selesai, BotFather memberi token unik untuk bot tersebut. Token ini mengautentikasi bot, bukan kata sandi akun pribadi Telegram Anda dan bukan kode login Telegram.
Simpan token itu dengan hati-hati. Jangan kirim ke grup, jangan masukkan ke situs yang tidak Anda percaya, dan jangan gunakan bot yang sama untuk banyak layanan jika Anda ingin menghindari konflik. Untuk FoneClaw, paling rapi memakai bot khusus yang memang hanya Anda gunakan untuk koneksi pribadi ke FoneClaw. Dengan begitu, jika ada masalah, Anda tahu token, bot, dan chat mana yang perlu diperiksa.
Pasangkan akun pribadi Anda
Setelah bot dibuat, buka FoneClaw dan masuk ke bagian koneksi Telegram. Masukkan token dari BotFather ke kolom BotFather token, lalu tekan Save bot token untuk menyimpan token bot. Setelah itu, ikuti prompt pemasangan yang tampil di FoneClaw.
Buka Telegram dan cari bot yang baru Anda buat, bukan BotFather. Kirim pesan persis hello ke bot tersebut dalam 10 menit. Tunggu konfirmasi pengikatan sebelum mulai mengirim permintaan lain. Koneksi ini dibuat untuk chat pribadi, bukan grup atau channel.
Akun pertama yang mengirim pesan ke bot setelah token disimpan akan dipasangkan. Karena itu, jangan membagikan bot ke orang lain sebelum Anda mengirim pesan pertama. Jika orang lain mengirim duluan, bot dapat terikat ke akun yang salah. Jika Anda punya beberapa akun Telegram di ponsel, pastikan pesan hello dikirim dari akun yang memang ingin Anda pakai bersama FoneClaw. Jika jendela pemasangan sudah lewat, ketuk Connect this chat di ponsel untuk membuka jendela baru, lalu kirim hello ke bot Anda sendiri dalam 10 menit dan tunggu konfirmasi.
Cek satu hasil Android yang didukung
Begitu bot terhubung, uji dengan tugas yang kecil dan mudah dicek. Jangan mulai dari tindakan sensitif atau permintaan panjang. Contoh yang tepat adalah ToDo tanpa tanggal: “Buat ToDo: cek daftar perangkat yang perlu dibersihkan.” Permintaan ini tidak berisi tanggal, hari, atau kata seperti besok; hasilnya seharusnya menjadi ToDo tanpa tanggal, bukan acara kalender.
Koneksi Telegram hanya membawa pesan ke FoneClaw. Izin Android, persetujuan yang berlaku, dan hasil akhir tetap dikelola di FoneClaw pada perangkat Anda. Jadi, pemasangan bot tidak otomatis memberi izin Android baru dan tidak membuat semua tindakan bisa disetujui dari Telegram. Jika tugas membutuhkan izin atau persetujuan tertentu, ikuti alur yang ditampilkan FoneClaw.
Setelah mengirim permintaan, periksa hasilnya di tempat yang benar. Untuk contoh ToDo tadi, lihat apakah item ToDo tersimpan dan tetap tanpa tanggal. Jika Anda baru belajar menjalankan tugas pertama, gunakan Cara Memakai Agen AI Gratis di Android dengan FoneClaw. Untuk memahami ToDo yang tidak punya jadwal, baca ToDo AI Android Tanpa Tanggal: Simpan dan Ubah Aman. Cakupan kemampuan publik FoneClaw dapat dilihat di halaman Fitur FoneClaw.
Diagnosis error koneksi yang spesifik
Jika koneksi tidak berhasil, jangan langsung membuat banyak bot baru. Cocokkan pesan atau gejalanya dengan penyebab yang paling mungkin.
| Gejala | Kemungkinan penyebab | Yang bisa Anda cek |
|---|---|---|
| Token ditolak | Token salah, terpotong, atau bukan token dari BotFather | Salin ulang token lengkap dari BotFather, tanpa spasi tambahan |
Tidak ada konfirmasi setelah hello | Pesan dikirim ke BotFather, bot yang salah, atau jendela 10 menit sudah lewat | Buka bot yang nama penggunanya Anda buat sendiri. Jika jendela sudah lewat, ketuk Connect this chat di ponsel, lalu kirim hello selama jendela 10 menit yang baru |
| Bot sudah terhubung | Bot sudah pernah dipakai pada koneksi FoneClaw lain | Gunakan bot khusus baru atau hapus koneksi lama jika itu milik Anda |
| Telegram tidak terjangkau | Masalah jaringan atau akses Telegram | Periksa koneksi internet dan akses Telegram pada perangkat |
| Konflik poller atau webhook | Bot sedang dipakai layanan lain | Gunakan bot khusus baru, atau hapus webhook hanya jika Anda memang ingin menghentikan layanan lama |
Untuk konflik webhook, langkah paling aman biasanya membuat bot khusus baru untuk FoneClaw. Menghapus webhook akan menghentikan pengiriman ke alamat layanan lama yang sedang memakai bot tersebut. Lakukan hanya jika Anda tahu layanan lama itu tidak lagi diperlukan. Hindari mencoba banyak perubahan sekaligus; ubah satu hal, lalu cek lagi apakah koneksi berhasil.
Jeda, lanjutkan, atau hapus koneksi
Setelah bot tersambung, Anda dapat mengelola koneksi sesuai kebutuhan. Kontrol Pause connection menjeda koneksi sehingga bot tidak dipakai untuk menerima permintaan baru. Jika ingin menggunakannya lagi, pakai Resume connection. Koneksi yang dijeda perlu dilanjutkan sebelum Anda mengharapkan pesan baru berjalan kembali.
Jika token bot diperbarui, pemasangan akun dan riwayat chat lokal dapat tetap dipertahankan. Ini berguna ketika Anda mengganti token karena alasan keamanan tetapi masih ingin memakai pasangan akun yang sama. Menyimpan token tidak perlu diperlakukan sebagai cara pasti untuk membuka ulang jendela pemasangan yang sudah lewat atau memindahkan bot ke akun Telegram lain; jika jendela pemasangan sudah lewat, gunakan Connect this chat di ponsel dan ikuti jendela 10 menit yang baru.
Menghapus koneksi adalah keputusan yang lebih besar. Saat koneksi dihapus, token yang tersimpan di FoneClaw, antrean permintaan, dan catatan pengiriman koneksi ikut dihapus. Riwayat chat lokal tetap dipertahankan, sehingga Anda masih dapat melihat percakapan lama di perangkat. Penghapusan koneksi lokal tidak dengan sendirinya mencabut kredensial bot di Telegram.
Gunakan koneksi Telegram sebagai cara praktis untuk mengirim permintaan pribadi ke FoneClaw, bukan sebagai janji otomatisasi tanpa batas. FoneClaw menjalankan tindakan Android yang didukung dengan model yang dikonfigurasi, izin yang relevan, dan hasil yang dapat diperiksa. Untuk memasang atau memperbarui aplikasi dari jalur resmi, mulai dari halaman Download FoneClaw.