Detail Integrasi
Membaca identitas teknis sebuah nomor atau bot, status kesiapannya, dan arti setiap kode kendala yang muncul.
Kalau sebuah nomor berhenti menerima pesan, panel Detail Integrasi menjawab dua hal sekaligus: identitas teknis nomor itu, dan apa yang sedang menghambatnya. Panel ini sama untuk ketiga kanal — WhatsApp Meta Verified, WhatsApp Web Sync, dan Telegram.
Buka lewat tombol Lihat detail pada kartu integrasi di menu Integrasi → WhatsApp atau Integrasi → Telegram.
Semua akun yang boleh melihat halaman integrasi juga boleh membuka panel ini, termasuk anggota tim yang tidak bisa mengelola integrasi. Yang membedakan hanya tombol pemulihannya: tombol seperti Sambungkan ulang atau Pindai QR hanya muncul untuk Pemilik dan Manajer. Kendala dan kodenya tetap terlihat oleh semua orang, begitu juga tombol Periksa ulang.
Setiap kali panel dibuka atau tombol Periksa ulang ditekan, sistem menanyakan keadaan terkini langsung ke Meta atau Telegram. Tidak ada jawaban lama yang dipakai ulang, jadi hasilnya selalu keadaan saat itu juga.
Tab Identitas Integrasi
Tab pertama berisi identitas nomor atau bot, dan baris yang tampil menyesuaikan kanalnya.
| Baris | Arti |
|---|---|
| Nama | Nama yang tersimpan untuk nomor atau bot ini. |
| Platform | Kanal integrasi: WhatsApp Official, WhatsApp Unofficial, atau Telegram. |
| Nomor WhatsApp | Nomor yang terhubung (kedua kanal WhatsApp). |
| ID Nomor Telepon dan ID WABA | Identitas nomor di Meta (khusus WhatsApp Meta Verified). |
| Username Bot dan ID Bot | Identitas bot di Telegram. |
| Koneksi | Status koneksi tersimpan: Terhubung, Terputus, Dibatasi, atau Diblokir. |
| Kesiapan | Siap atau Belum siap. |
| Penanganan | Siapa yang membalas: anggota tim, AI, AI dijeda, atau AI sesuai jadwal. |
| Ditangani oleh | Anggota tim yang sedang memegang percakapan belum selesai di nomor ini. |
Nilai yang belum tersimpan ditampilkan sebagai Tidak tersedia, bukan dibiarkan kosong.
ID Nomor Telepon, ID WABA, dan ID Bot punya tombol salin. Tiga nilai inilah yang biasanya diminta tim support, jadi salin dari sini alih-alih mengetik ulang.
Kesiapan
Kesiapan bukan status koneksi. Sebuah nomor baru dinyatakan Siap kalau koneksinya terhubung dan pemeriksaan tidak menemukan kendala yang menghambat sama sekali. Nomor yang tampak "Terhubung" tetapi webhook-nya tidak terpasang akan tampil sebagai Belum siap — dan itu memang keadaan sebenarnya, karena pesan masuk tidak sampai.
Peringatan dan catatan informasi tidak membuat sebuah nomor menjadi belum siap.
Ditangani oleh
Baris ini menampilkan akun yang sedang memegang setidaknya satu percakapan belum selesai di nomor tersebut, bukan penugasan tetap per nomor. Isinya berubah mengikuti percakapan yang berjalan. Kalau tidak ada yang memegang, barisnya menyatakannya secara jelas.
Status Sinkron
Blok terakhir pada tab ini berisi:
- Terakhir sinkron — kapan status koneksi terakhir berubah.
- Aktivitas terakhir — waktu pesan terakhir di nomor ini, masuk maupun keluar.
Keduanya ditulis sebagai tanggal dan jam, bukan "3 hari lalu", supaya mudah dicocokkan dengan kejadian lain.
Blok ini juga memberi dua catatan bila berlaku:
- Kalau provider tidak bisa dihubungi, blok ini menyatakan bahwa yang tampil adalah keadaan terakhir yang diketahui.
- Untuk WhatsApp Web Sync, blok ini menyatakan bahwa hasilnya dibaca dari keadaan tersimpan, bukan jawaban langsung dari provider. Sesi perangkatnya berjalan di proses terpisah dan tidak bisa ditanyai langsung.
Nomor WhatsApp Meta Verified yang riwayat chat-nya masih diimpor menampilkan catatan netral di atas kedua tab. Catatan itu hanya pemberitahuan — tidak ada yang perlu dilakukan, dan kesiapannya tidak terpengaruh.
Tab Kendala
Tab kedua berisi daftar kendala, diurutkan dari yang paling menghambat: penghalang dulu, lalu peringatan, lalu catatan informasi. Angka di samping judul tab menghitung penghalang dan peringatan saja — catatan informasi tidak pernah membuat sebuah integrasi terlihat bermasalah.
Setiap kendala membawa kode yang tidak berubah antarbahasa. Sebutkan kode itu saat menghubungi support.
Kode kendala WhatsApp Meta Verified
| Kode | Arti dan yang perlu dilakukan |
|---|---|
WA_TOKEN_EXPIRED | Meta menolak token yang tersimpan; nomor tidak bisa mengirim maupun menerima. Hubungkan lagi nomornya. |
WA_NUMBER_UNAVAILABLE | Nomor tidak lagi bisa dibaca dengan token yang ada — mungkin dihapus atau pindah akun bisnis. Hubungkan lagi nomornya. |
WA_CONNECTION_REQUIRES_ATTENTION | Aplikasi kami tidak terdaftar pada WABA nomor ini, jadi Meta tidak mengirimkan pesan masuk ke kami. Bisa juga terjadi kalau nomornya memang sengaja dikelola aplikasi Meta lain. |
WA_DISCONNECTED_BY_PROVIDER | Meta memutus nomor ini dari sisi mereka. Hubungkan lagi nomornya. |
WA_DISCONNECTED_MANUALLY | Nomor diputus dari dashboard ini. Nomornya tetap utuh dan bisa disambungkan ulang kapan saja. |
WA_STATUS_SYNC_FAILED | Meta tidak bisa dihubungi atau menjawab dengan error. Coba Periksa ulang sebentar lagi. |
Kode kendala Telegram
| Kode | Arti dan yang perlu dilakukan |
|---|---|
TELEGRAM_TOKEN_INVALID | Telegram menolak token bot. Sambungkan ulang bot dengan token valid dari BotFather. |
TELEGRAM_WEBHOOK_MISSING | Bot belum punya webhook, jadi tidak ada pesan yang masuk. Sambungkan ulang botnya. |
TELEGRAM_WEBHOOK_MISMATCH | Webhook menunjuk ke selain aplikasi ini, artinya pesannya diterima instalasi lain. Sambungkan ulang bot di sini. |
TELEGRAM_WEBHOOK_ERROR | Pengiriman webhook terakhir gagal. Kalau berulang, sambungkan ulang botnya. |
TELEGRAM_UPDATES_BACKLOG | Telegram menahan update yang belum sampai ke inbox, biasanya menyusul masalah pengiriman. |
TELEGRAM_STATUS_SYNC_FAILED | Telegram tidak bisa dihubungi. Coba Periksa ulang sebentar lagi. |
Kode kendala WhatsApp Web Sync
| Kode | Arti dan yang perlu dilakukan |
|---|---|
BAILEYS_SESSION_MISSING | Nomor belum pernah dipasangkan, atau sesinya sudah terhapus. Pindai QR untuk memasangkannya. |
BAILEYS_DISCONNECTED | Nomor pernah dipasangkan tetapi sekarang terputus, dan bukan karena diputus dari sini. Pindai QR lagi. |
WA_DISCONNECTED_MANUALLY | Nomor diputus dari dashboard ini. Sambungkan ulang kapan saja. |
Kode kendala semua kanal
| Kode | Arti dan yang perlu dilakukan |
|---|---|
INTEGRATION_AGENT_MISSING | Balasan AI menyala tetapi agennya belum dipilih, jadi tidak ada yang membalas otomatis. Pilih agen di Pengaturan Balasan AI. |
INTEGRATION_AI_PAUSED | Jeda manual masih berlaku. Ini catatan, bukan kerusakan. |
INTEGRATION_OFF_SCHEDULE | Saat ini di luar jam aktif jadwal AI. Ini catatan, bukan kerusakan. |
Kalau muncul kode yang belum dikenali dashboard, entrinya tetap tampil dengan kodenya. Sebutkan kode itu ke support.
Tombol di panel
- Periksa ulang menjalankan pemeriksaan lagi dan memperbarui kedua tab. Selama pemeriksaan berjalan, isi lama tetap terlihat dan tombolnya tidak bisa ditekan dua kali.
- Sambungkan ulang, Hubungkan lagi, dan Pindai QR membawa ke alur pemulihan yang memang sudah ada untuk kanal tersebut. Panel menutup sendiri kalau alurnya membutuhkan halaman di belakangnya.
- Pilih agen AI membuka pemilihan agen untuk integrasi itu.
Panel ini hanya mendiagnosis. Tidak ada yang diubah di Meta atau Telegram hanya
karena panelnya dibuka — termasuk saat kendala WA_CONNECTION_REQUIRES_ATTENTION
muncul, sistem tidak pernah mengambil alih WABA dari aplikasi lain.