Beranda Pesan Kesalahan

Pesan Kesalahan

Daftar pesan kesalahan dari WhatsApp Business API, yang umum terjadi saat mengirimkan pesan. Menjelaskan masalah umum, penyebab, dan solusi terkait pengiriman pesan.
Asep Rasjid
By Asep Rasjid
4 artikel

#131026: "Message undeliverable"

Error ini muncul ketika pesan gagal dikirim ke penerima, meskipun request API sudah berhasil diproses oleh server WhatsApp. Dengan kata lain: pesan Anda diterima oleh sistem WhatsApp, tetapi tidak sampai ke pengguna akhir. Kode ini termasuk error “delivery-level” — bukan error teknis dari sisi API, melainkan penolakan di tahap pengantaran pesan ke perangkat penerima. Penyebab Umum Error #131026 Error ini biasanya disebabkan oleh kondisi penerima atau akun WABA pengirim, bukan karena kesalahan format request. Berikut penyebab yang paling sering terjadi: 1. Nomor tidak aktif di WhatsApp Penerima bukan pengguna WhatsApp aktif (nomor belum atau sudah tidak terdaftar). Contoh: Anda kirim pesan ke nomor pelanggan yang sudah ganti nomor / belum pernah pakai WhatsApp. 2. Penerima belum menyetujui Syarat & Ketentuan WhatsApp terbaru WhatsApp memblokir pesan ke akun yang belum menekan tombol “Agree” pada update Terms of Service. Contoh: Penerima lama belum update aplikasi atau belum buka WhatsApp dalam waktu lama. 3. Versi aplikasi penerima terlalu lama / tidak kompatibel Pesan tidak bisa diterima karena versi aplikasi penerima terlalu usang untuk format pesan baru (mis. template interaktif). Contoh: Pesan dengan interactive button dikirim ke WhatsApp versi lama. 4. Penerima menonaktifkan akun sementara / uninstall aplikasi Nomor masih terdaftar tapi tidak ada perangkat aktif yang menerima pesan. Contoh: Pengguna sedang log out atau uninstall WhatsApp sementara. 5. Nomor penerima diblokir oleh WhatsApp (ban / suspend) WhatsApp menolak pesan karena penerima sedang diblokir / dinonaktifkan oleh sistem. Contoh: Nomor pengguna terlibat spam atau pelanggaran kebijakan. **6. Pengiriman template ke negara / jaringan yang sedang bermasalah ** Koneksi antar-region (routing) sedang terganggu di server WhatsApp. Contoh: Pesan ke nomor luar negeri tertentu gagal terkirim massal. 7. Kesalahan tipe pesan (mis. interactive vs text) Format pesan tidak cocok dengan kemampuan penerima. Contoh: Kamu kirim “interactive message” ke nomor yang tidak mendukung jenis itu. Cara Mengatasi Error #131026 Berikut langkah-langkah perbaikan praktis yang bisa dilakukan untuk menghindari atau mengatasi error ini. 1. Pastikan penerima telah menyetujui ToS dan update aplikasi Jika pelanggan jarang membuka WhatsApp, pesan akan gagal sampai. Dorong mereka untuk memperbarui aplikasi agar akun mereka kembali aktif. 2. Hindari pesan dengan format tidak kompatibel Jika pesan interaktif gagal, coba kirim versi teks biasa untuk memastikan perangkat penerima bisa menampilkan pesan. 3. Validasi database penerima secara berkala Bersihkan database dari nomor-nomor yang tidak lagi aktif di WhatsApp agar tidak memicu error massal. **4. Periksa status template di Meta Dashboard ** Pastikan template sudah disetujui dan berstatus “Active”. Template yang tidak aktif bisa memicu penolakan di level pengiriman. **6. Uji kirim pesan ke nomor yang sama melalui WhatsApp App biasa ** Jika pesan juga tidak terkirim lewat aplikasi biasa, berarti penerima memang tidak aktif / diblokir. Jika error #131026 muncul untuk ribuan penerima sekaligus, kemungkinan ada gangguan routing atau server-side di WhatsApp. Hubungi Kami.

Terakhir diperbarui saat Oct 18, 2025

#131049 “This message was not delivered to maintain healthy ecosystem engagement.”

Artinya secara sederhana: WhatsApp menolak mengirim pesan ini untuk menjaga kesehatan ekosistem komunikasi — biasanya karena algoritma Meta mendeteksi aktivitas yang bisa dianggap “spammy”, “tidak diinginkan”, atau “mengganggu pengalaman pengguna”. Pesan tersebut tidak sampai ke penerima, bukan karena kesalahan teknis seperti format salah, tetapi karena kebijakan proteksi ekosistem WhatsApp. Penyebab Umum Error #131049 Dari berbagai kasus nyata, penyebab utamanya terbagi jadi 4 kelompok besar: 1. Tingkat Interaksi Rendah / Pesan Tidak Relevan WhatsApp mendeteksi bahwa banyak penerima tidak membaca, mengabaikan, atau memblokir pesan dari akun WABA-mu. Contoh: Anda kirim pesan promo ke ribuan pelanggan, tapi hanya sedikit yang membuka atau merespons. 2. Kualitas Template Rendah (Low Quality Rating) Template pesan (HSM) memiliki rating rendah berdasarkan feedback pengguna (blokir, lapor spam, tidak dibaca, dll). Contoh: Template promo dikirim terlalu sering atau terlalu “jualan”. 3. Pelanggaran Kebijakan “User Experience” Pesan mengandung kata-kata yang dianggap terlalu mendesak, menakut-nakuti, atau terlalu promosi. Contoh: “Segera bayar sekarang sebelum akun Anda kami nonaktifkan!” 4. Frekuensi & Pola Pengiriman yang Tidak Wajar Sistem mendeteksi pengiriman masif ke nomor-nomor baru / tidak aktif, tanpa adanya percakapan dua arah. Contoh: Blast pesan 50.000+ dalam 1 jam, padahal baru daftar nomor hari itu. Bagaimana WhatsApp Mendeteksi Ini Meta menggunakan kombinasi dari: - Engagement Rate → seberapa sering pesan kamu dibaca / dibalas. - Block Rate → berapa persen penerima memblokir nomor pengirim. - Report Rate → berapa persen penerima melaporkan pesan sebagai spam. - Message Volume Pattern → lonjakan kirim masif dari WABA tertentu. - Template Quality Rating (dalam Dashboard Meta Business). Jika nilai engagement terlalu rendah atau block rate tinggi, sistem akan: 1. Menandai template sebagai “Low quality”. 2. Menolak pengiriman baru dengan error #131049. 3. Kadang bahkan menurunkan tier pengiriman (misal dari 10K/day → 1K/day). Solusi & Langkah Penanganan Berikut langkah-langkah konkret yang bisa Anda lakukan: 1. Evaluasi Template - Hindari kalimat yang terlalu promosi, mendesak, atau berulang. - Gunakan gaya yang ramah, personal, dan relevan. Misal: ❌ “Segera bayar tagihan Anda sekarang juga!” ✅ “Halo {name}, kami ingin mengingatkan bahwa tagihan Anda sudah tersedia. Klik di sini untuk cek.” - Kurangi pengiriman template yang sama berulang kali dalam 24 jam. - Pastikan setiap template sudah disetujui Meta (status Approved) dan tidak berubah secara dinamis. 2. Segmentasi & Validasi Nomor Penerima - Kirim hanya ke nomor yang pernah berinteraksi (existing customers). - Gunakan database nomor yang valid dan aktif di WhatsApp. - Hindari mengirim ke nomor yang baru didapat dari iklan / data mentah. 3. Gunakan Interaksi Dua Arah (Opt-in & Opt-out) - Minta pelanggan memberi izin (opt-in) untuk menerima pesan. - Tambahkan opsi berhenti berlangganan (“Ketik STOP jika tidak ingin menerima pesan”). - Hal ini meningkatkan “Trust Score” di algoritma Meta. 4. Pantau Frekuensi & Waktu Kirim - Hindari pengiriman dalam jumlah besar dalam waktu singkat. - Sebaiknya gunakan sistem throttling (contoh: 10.000 pesan dikirim bertahap 1.000–2.000 per jam). - Jangan kirim pesan di jam rawan (malam hari atau dini hari). 5. Hubungi Kami Jika sudah melakukan semua langkah di atas tapi error masih terjadi, hubungi kami ar bisa kami lakuka pengajuan review atau reset status kualitas akun.

Terakhir diperbarui saat Oct 18, 2025

#131008: “Required parameter is missing"

Pesan error ini muncul ketika sistem mendeteksi bahwa parameter wajib dengan tipe belum disertakan dalam payload ketika mengirim pesan template. Artinya, dalam definisi template kamu ada placeholder atau bagian yang mengharuskan parameter diberikan, tetapi request kamu tidak menyertakan parameter tersebut atau parameter tersebut hilang / null. Penyebab Umum Berikut beberapa penyebab paling sering error ini terjadi: 1. Payload parameter null / kosong Parameter memang disertakan, tapi nilainya kosong ("") atau null—sehingga sistem menganggap parameter “hilang”. 2. Penamaan parameter atau lokasi yang salah Parameter diberi field yang salah atau berada di struktur JSON yang tidak sesuai (misalnya di luar objek components). 3. Tipe parameter tidak sesuai Misalnya menggunakan {"type":"image","image": {...}} di tempat yang seharusnya type: "text", ketika placeholder mengharapkan teks. 4. Komponen template yang tidak cocok Misalnya kamu mendefinisikan header atau footer yang memerlukan teks, tetapi payload tidak menyertakan parameter teks untuk komponen tersebut. Langkah Perbaikan Berikut langkah-langkah agar error #131008 bisa dihindari atau diatasi: 1. Cek definisi template Pastikan template kamu menyertakan placeholder teks (body) yang benar dan definisi tersebut memang butuh parameter. 2. Pastikan nilai parameter tidak kosong / null denagn tipe yang sesuai Pastikan text berisi string valid, bukan "" atau null. **3. Pastikan parameter berada di lokasi benar ** Parameter harus berada di dalam urutan yang sesuai dalam struktur template. **5. Validasi payload minimal terlebih dahulu ** Coba kirim template paling sederhana (misalnya 1 placeholder) agar bisa diuji parameter mana yang hilang. Jika error berulang, silahkan hubungi kami.

Terakhir diperbarui saat Oct 18, 2025