Integrasi Notifikasi Telegram
Fitur notifikasi Telegram mengirim alert otomatis ke Telegram saat status koneksi perangkat berubah, seperti saat perangkat terputus atau kembali terhubung. Berguna untuk memantau kondisi sistem tanpa harus membuka dashboard secara manual.
Prasyarat
- Sudah login ke dashboard Whapi
- Perangkat sudah terhubung dan aktif
- Aplikasi Telegram sudah terinstal di ponsel atau desktop
Ada beberapa cara atau metode yang dapat digunakan untuk integrasi notifikasi via telegram, antara lain :
Metode 1: Menggunakan Bot Resmi Whapi
Langkah 1: Buka Pengaturan Notifikasi
- Masuk ke menu Kelola Perangkat di dashboard
- Pilih perangkat yang ingin dipantau
- Buka tab Fitur, lalu cari bagian Downtime Notification
Langkah 2: Dapatkan ID Telegram
- Buka Telegram dan cari bot resmi Whapi: @whapinotif_bot.
- Klik Start atau ketik /start
- Bot akan menampilkan ID Telegram secara otomatis
- Salin ID tersebut
Langkah 3: Aktifkan Notifikasi
- Kembali ke dashboard Whapi
- Tempel ID Telegram ke kolom ID Telegram
- Klik Simpan
Notifikasi akan mulai terkirim ke Telegram saat status koneksi perangkat berubah.
Metode 2: Menggunakan Bot Telegram Sendiri (Custom Bot)
Gunakan metode ini jika notifikasi perlu dikirim melalui bot pribadi, misalnya untuk kebutuhan branding atau integrasi ke channel Telegram tertentu.
Langkah 1: Buat Bot Baru via BotFather
- Buka Telegram dan cari @BotFather.
- Ketik /newbot dan ikuti instruksi yang diberikan
- Setelah selesai, BotFather akan memberikan Token Bot
- Salin Token Bot tersebut
Langkah 2: Dapatkan Chat ID
- Mulai percakapan dengan bot yang baru dibuat
- Buka URL berikut di browser untuk mendapatkan Chat ID:
https://api.telegram.org/bot<TOKEN_BOT>/getUpdates
Ganti <TOKEN_BOT> dengan token yang didapat dari BotFather. Cari nilai "chat":{"id":...} di response JSON.
Langkah 3: Daftarkan ke Dashboard Whapi
- Masuk ke pengaturan perangkat di dashboard
- Tempel Token Bot ke kolom Token Bot
- Tempel Chat ID ke kolom ID Telegram
- Klik Simpan
Untuk kembali menggunakan bot resmi Whapi, kosongkan kolom Token Bot dan pastikan kolom ID Telegram tetap terisi.
Jenis Notifikasi yang Tersedia
| Kondisi | Notifikasi yang Dikirim |
|---|---|
| Perangkat terputus | Alert saat status berubah ke DISCONNECTED atau SERVICE_OFF |
| Perangkat kembali terhubung | Alert saat status berubah ke CONNECTED |
| Menunggu scan QR | Alert saat status berubah ke SERVICE_SCAN |
| Proses pairing | Alert saat status berubah ke PAIRING |
Jenis notifikasi yang aktif bisa dikonfigurasi di bagian tab Notifikasi.
Error Umum dan Solusinya
| Kondisi | Penyebab | Solusi |
|---|---|---|
| Notifikasi tidak masuk ke Telegram | ID Telegram salah atau belum klik Start di bot | Pastikan sudah klik Start di bot dan salin ID yang benar |
| Bot tidak merespons saat klik Start | Bot belum aktif atau URL bot salah | Cari ulang @whapinotif_bot di Telegram dan klik Start |
| Custom bot tidak mengirim notifikasi | Token Bot salah atau Chat ID tidak sesuai | Verifikasi token via getMe dan Chat ID via getUpdates |
| Notifikasi terhenti setelah beberapa waktu | Bot diblokir atau percakapan dihapus | Buka kembali percakapan dengan bot dan klik Start ulang |