Pesan Gagal Terkirim
Panduan menelusuri kegagalan pengiriman, diurutkan dari penyebab yang paling sering.
Langkah 1 — Cek jendela 24 jam
Ini penyebab nomor satu. Bila pesan terakhir dari pelanggan lebih dari 24 jam lalu, atau pelanggan belum pernah menghubungi Anda sama sekali, pesan bebas akan ditolak.
Solusi: gunakan template yang sudah disetujui. Lihat Jendela 24 Jam.
Langkah 2 — Cek status template
Buka menu Template Pesan dan pastikan template yang Anda pakai berstatus APPROVED.
Template berstatus PENDING belum bisa dipakai. Template REJECTED tidak akan pernah terkirim. Template PAUSED dihentikan Meta karena kualitas buruk.
Perlu diperhatikan: template yang tadinya APPROVED bisa berubah menjadi PAUSED bila banyak penerima memblokir. Broadcast yang tadinya jalan bisa mendadak gagal karena ini.
Langkah 3 — Cek nomor tujuan
- Format harus
628..., bukan08...atau+62 812-3456-7890 - Nomor harus benar-benar terdaftar di WhatsApp
- Nomor yang salah ketik satu digit akan gagal tanpa penjelasan jelas
Periksa daftar penerima yang gagal di laporan broadcast — bila polanya sama, kemungkinan besar masalah format saat impor.
Langkah 4 — Cek kesehatan nomor pengirim
Buka Nomor WABA → tab Messaging Limit.
| Status | Artinya |
|---|---|
| CONNECTED | Normal |
| FLAGGED | Ditandai, pengiriman bisa dibatasi |
| RESTRICTED | Dibatasi |
| RATE_LIMITED | Terlalu banyak permintaan sekaligus |
| BANNED | Nomor dinonaktifkan permanen |
Bila statusnya bukan CONNECTED, kegagalan berasal dari sini. Lihat Menjaga Nomor Tetap Sehat.
Langkah 5 — Cek variabel template
Variabel yang kosong bisa membuat pengiriman ditolak. Bila kontak tidak punya nilai untuk {{1}}, pengiriman ke kontak itu gagal sementara kontak lain berhasil.
Gejala khasnya: sebagian kecil penerima gagal sementara sebagian besar berhasil.
Langkah 6 — Cek pendaftaran nomor
Nomor yang belum menyelesaikan pendaftaran Cloud API tidak bisa mengirim sama sekali. Wavio menampilkan pemberitahuan pada daftar nomor bila ini masalahnya.
Solusi: selesaikan pendaftaran dengan mengatur PIN. Lihat Pendaftaran Nomor & PIN.
Langkah 7 — Cek token
Token nomor bisa kedaluwarsa. Bila Anda berlangganan event number.token_expired lewat Webhook Out, Anda akan mendapat pemberitahuan otomatis.
Solusi: hubungkan ulang nomor tersebut.
Kasus khusus: pesan terkirim tapi balasan tidak muncul
Ini masalah webhook, bukan masalah pengiriman. Pesan Anda sampai ke pelanggan, tetapi balasan mereka tidak masuk ke Inbox.
Solusi: buka tab Pengaturan Lanjutan pada nomor tersebut, periksa URL Callback dan Verify Token, lalu pastikan langganan bidang messages aktif di Meta. Lihat Menghubungkan Nomor WABA.
Kasus khusus: semua pesan gagal mendadak
Bila semuanya gagal padahal sebelumnya normal, periksa berurutan:
- Status nomor — apakah berubah menjadi FLAGGED atau RESTRICTED
- Status paket — apakah langganan kedaluwarsa
- Status template — apakah berubah menjadi PAUSED
Bila masih gagal
Buat tiket lewat Support Ticket dengan menyertakan:
- WABA ID dan Phone Number ID (salin dari tab Profil Bisnis)
- Nama template yang dipakai
- Contoh nomor tujuan yang gagal
- Tanggal dan jam kejadian
- Tangkapan layar pesan kesalahannya