Error WhatsApp
Saat pesan WhatsApp gagal terkirim, Meta mengembalikan kode error. tumbuh.ai menampilkannya dalam bahasa Indonesia beserta langkah pemulihan. Halaman ini merangkum kode yang paling sering ditemui.
Sebelum mulai
- Catat kode error yang tampil (misalnya
131049). Kode inilah yang menentukan solusinya. - Untuk kode yang menyangkut kualitas atau kebijakan, Anda perlu akses ke WhatsApp Manager di akun Meta bisnis Anda.
- Pelajari juga Tips Anti-Banned agar masalah serupa tidak berulang.
Tabel kode error
| Kode | Penyebab | Solusi |
|---|---|---|
131048 | Pesan gagal dikirim karena pembatasan spam. | Periksa status kualitas di WhatsApp Manager. |
131049 | Pesan tidak tersampaikan untuk menjaga ekosistem yang sehat. | Tunggu 24 jam sebelum mengirim ulang. |
131050 | Penerima telah berhenti menerima pesan marketing dari bisnis Anda. | Hormati preferensi pengguna dan jangan kirim pesan marketing lagi. |
131056 | Terlalu banyak pesan ke nomor yang sama. | Tunggu sebelum mengirim lagi ke nomor ini. |
368 | Akun WhatsApp Business diblokir sementara karena melanggar kebijakan. | Tinjau kebijakan WhatsApp Business dan ajukan banding jika diperlukan. |
0 | Tidak dapat mengautentikasi. Token akses mungkin kedaluwarsa atau tidak valid. | Perbarui token akses Anda di pengaturan. |
131005 | Akses ditolak. Izin tidak diberikan atau sudah dihapus. | Periksa izin aplikasi di Meta Business Suite. |
132000 | Jumlah parameter template tidak sesuai. | Pastikan jumlah parameter sesuai dengan template. |
132001 | Template tidak ditemukan. | Periksa nama template dan sinkronkan ulang dari WhatsApp Manager. |
132015 | Template sedang dijeda karena masalah kualitas. | Perbaiki kualitas template atau tunggu hingga jeda berakhir. |
2388019 | Jumlah template maksimum (250) telah tercapai. | Hapus template yang tidak digunakan sebelum membuat yang baru. |
131042 | Pesan gagal karena masalah pembayaran akun WhatsApp Business. | Hubungi admin untuk memeriksa metode pembayaran akun. |
Kode lain yang tidak ada di tabel ini ditampilkan sebagai "Terjadi kesalahan yang tidak diketahui". Coba kirim ulang. Bila berlanjut, hubungi support.
Penjelasan tambahan
Pembatasan spam dan kualitas (131048, 131049, 131056)
Kode ini berkaitan dengan reputasi pengiriman Anda. Penyebab umumnya adalah pesan yang diblokir atau dilaporkan sebagai spam oleh penerima.
- Kurangi frekuensi pengiriman pesan.
- Pastikan penerima sudah opt-in.
- Tingkatkan kualitas dan relevansi isi pesan.
- Cek quality rating di WhatsApp Manager.
Untuk 131049, Meta memilih tidak mengirim pesan demi menjaga ekosistem yang sehat. Tunggu minimal 24 jam, dan kurangi pesan marketing ke pengguna yang sama.
Penerima berhenti berlangganan (131050)
Penerima sudah memilih tidak menerima pesan marketing dari Anda. Catat pilihan ini dan jangan kirim pesan marketing lagi. Lihat juga pengaturan consent dan blacklist di Broadcast.
Akun diblokir sementara (368)
Akun terdeteksi melanggar kebijakan WhatsApp. Langkah yang disarankan:
- Tinjau kebijakan WhatsApp Business di business.whatsapp.com/policy.
- Pastikan isi pesan sesuai pedoman.
- Tunggu hingga periode blokir berakhir.
- Hubungi admin bila perlu bantuan.
Token atau izin bermasalah (0, 131005)
Token akses kedaluwarsa, tidak valid, atau izin aplikasi dicabut. Perbarui token di pengaturan, atau periksa izin aplikasi di Meta Business Suite. Untuk koneksi yang dibuat manual, lihat WhatsApp (Manual).
Masalah template (132000, 132001, 132015, 2388019)
132000: jumlah variabel yang dikirim tidak sama dengan jumlah variabel di template.132001: nama template salah atau belum tersinkron. Sinkronkan ulang dari WhatsApp Manager.132015: template dijeda karena kualitas rendah. Perbaiki isinya atau tunggu jeda berakhir.2388019: batas 250 template tercapai. Hapus template yang tidak terpakai.
Panduan lengkap ada di Template.
Masalah pembayaran (131042)
Meta menolak pengiriman karena masalah billing atau kelayakan pembayaran. Admin akun bisnis perlu membuka Billing & payments di Meta, memilih WABA yang bersangkutan, lalu menyelesaikan penyebab yang dilaporkan. Penyelesaian billing dilakukan admin di Meta, bukan di tumbuh.ai.
tumbuh.ai menampilkan banner "Masalah billing WhatsApp" berisi jumlah nomor terdampak dan waktu kejadian terakhir dari Meta. Status "Pengiriman teramati pulih" muncul bila pengiriman baru berhasil pada semua nomor terdampak. Ini tidak memastikan pengaturan billing Meta sudah selesai.
Status akun WhatsApp
Bila Meta membatasi akun, tumbuh.ai menampilkan banner dengan salah satu status: Dibatasi, Sedang Ditinjau, Ditandai, atau Dinonaktifkan. Banner memuat waktu terdeteksi, alasan, serta tombol "Lihat Detail" dan "Hubungi Admin".
Hasil yang diharapkan
Setelah solusi diterapkan, pengiriman ulang berhasil dan status pesan berubah dari gagal menjadi terkirim.
Masalah umum
- Pesan ditolak karena di luar jendela 24 jam: kirim template yang sudah disetujui. Lihat Konsep Dasar.
- Koneksi WhatsApp terputus: lihat Masalah Koneksi Channel.
- Panduan menghubungkan nomor: WhatsApp.