Whatsapp Error Code

Panduan Lengkap Kode Error WhatsApp Business API: Penyebab dan Solusi Praktis

17 Januari 2026 Komentar Dinonaktifkan pada Panduan Lengkap Kode Error WhatsApp Business API: Penyebab dan Solusi Praktis

Dalam mengelola WhatsApp Business API, kegagalan pengiriman pesan bukanlah sebuah “misteri”. Setiap pesan yang gagal terkirim selalu disertai dengan kode error khusus. Memahami kode-kode ini adalah kunci agar strategi WhatsApp Marketing dan Automation Anda berjalan mulus tanpa hambatan.

Berikut adalah rangkuman kode error WhatsApp API yang paling sering muncul, dikelompokkan berdasarkan penyebabnya.

1. Kategori: Kualitas Data & Penerima

Error dalam kategori ini biasanya disebabkan oleh kondisi nomor tujuan atau database yang Anda miliki.

Error 131030: Recipient Phone Number Not On WhatsApp

  • Penyebab: Nomor tujuan tidak terdaftar di platform WhatsApp.

  • Dampak: Membuang kuota biaya dan menurunkan reputasi nomor pengirim.

  • Solusi: Lakukan filtrasi nomor (WhatsApp Checker) secara rutin pada database Anda sebelum melakukan pengiriman massal.

Error 131026: Message Undeliverable

  • Penyebab: Pesan tidak bisa diantarkan. Biasanya karena HP penerima mati, tidak ada sinyal dalam waktu lama, atau nomor Anda telah diblokir oleh pengguna tersebut.

  • Solusi: Jangan mengirim ulang secara berulang-ulang ke nomor yang sama. Jika gagal 3 kali, tandai nomor tersebut sebagai “Tidak Aktif”.

Error 130472: User’s Phone Number is Part of an Experiment

  • Penyebab: Nomor tujuan sedang masuk dalam program uji coba internal Meta.

  • Solusi: Masalah ini bersifat sementara dan sangat jarang. Coba kirim ulang pesan setelah beberapa jam.

2. Kategori: Kebijakan & Aturan Main (Policy)

WhatsApp sangat menjaga kenyamanan pengguna. Jika Anda melanggar “aturan main”, kode-kode ini akan muncul.

Error 131049: Healthy Ecosystem Engagement

  • Penyebab: Sistem mendeteksi aktivitas Anda mengganggu ekosistem (indikasi spam). Biasanya terjadi jika banyak orang melaporkan (Report) nomor Anda.

  • Solusi: Hentikan aktivitas pengiriman selama 24-48 jam. Perbaiki konten pesan agar lebih ramah pengguna dan pastikan Anda hanya mengirim pesan kepada orang yang sudah memberikan izin (opt-in).

Error 131051: Message Expired

  • Penyebab: Anda mencoba membalas chat pelanggan yang sudah lewat dari 24 jam menggunakan pesan teks biasa.

  • Solusi: Kirimkan Template Message resmi untuk mengaktifkan kembali jendela percakapan. Pastikan tim support merespons chat di bawah 24 jam.

3. Kategori: Administrasi & Sistem

Masalah yang muncul dari sisi pengaturan akun atau integrasi teknis.

Error 131042: Business Eligibility Payment Issue

  • Penyebab: Ada masalah pada metode pembayaran di Meta Business Suite (Kartu kredit ditolak, saldo habis, atau kadaluwarsa).

  • Solusi: Segera perbarui informasi kartu di menu Billing & Payments pada dashboard Meta Anda agar layanan tidak terhenti.

Error 132001: Template Parameter Count Mismatch

  • Penyebab: Kesalahan pada integrasi coding. Jumlah variabel (seperti nama, nomor order) yang dikirim tidak sesuai dengan yang terdaftar di template.

  • Solusi: Periksa kembali logika automation atau script API Anda. Pastikan setiap variabel terisi dengan benar.


Tabel Panduan Error WhatsApp Business API

Kode Error Pesan Utama Penjelasan Singkat Solusi Praktis
131030 Recipient Not on WhatsApp Nomor tujuan tidak memiliki akun WhatsApp. Bersihkan database dengan layanan WhatsApp Filter sebelum kirim.
131026 Message Undeliverable Nomor terdaftar, tapi gagal kirim (HP mati, sinyal buruk, atau Anda di-block). Jangan paksa kirim ulang; jika gagal berkali-kali, pindahkan ke channel SMS.
131049 Healthy Ecosystem Engagement Meta mendeteksi indikasi spam karena banyak user yang me-report/block nomor Anda. Hentikan blast 24-48 jam. Perbaiki konten agar lebih relevan dan tidak mengganggu.
131051 Message Expired Anda mencoba membalas chat setelah lewat dari 24 jam dengan teks biasa. Kirimkan Template Message berbayar untuk memancing balasan pelanggan.
131042 Payment Issue Pembayaran di Meta Business Suite gagal (Limit habis, kartu expired, atau ditolak bank). Segera update metode pembayaran di dashboard Meta agar layanan aktif kembali.
132001 Template Parameter Mismatch Jumlah variabel di coding (JSON) tidak sama dengan jumlah variabel di template. Sinkronkan kembali jumlah variabel {{1}}, {{2}} antara sistem Anda dan Meta.
130472 Part of Experiment Nomor tujuan sedang masuk dalam grup uji coba fitur baru internal Meta. Masalah langka dan sementara. Tunggu beberapa jam lalu coba kirim ulang secara manual.
131031 Insufficient Balance Khusus pengguna sistem prabayar, saldo kredit API Anda sudah habis. Top-up atau isi ulang kredit WhatsApp API Anda.
133010 Phone Number Not Verified Nomor bisnis Anda belum menyelesaikan proses verifikasi kepemilikan. Lakukan verifikasi nomor via OTP (SMS/Call) di dashboard Meta.