MasukMulai uji coba gratis
Meta Tech Provider

Pesan WhatsApp API tidak terkirim: penyebabnya, sesuai urutan

Pesan WhatsApp API yang diterima belum tentu terkirim: Meta melaporkan hasilnya kemudian lewat webhook status, yaitu sent, delivered, read atau failed, disertai kode kesalahan. Periksa berurutan: status failed beserta kodenya, jendela 24 jam (131047), metode pembayaran (131042), template (132001, 132015), penerima (131026, 131049, 131050), lalu batas dan koneksi nomor.

easyCoexistence memantau setiap nomor yang terhubung sepanjang waktu, mengirim email saat Meta berhenti mengirim, memutus tautan atau menurunkan kualitas, dan meneruskan webhook status Meta tanpa perubahan ke sistem Anda.

4 statuses

sent (satu centang), delivered (dua), read (dua biru) dan failed (segitiga kesalahan merah), sebagaimana dilaporkan webhook status.

131047

Lebih dari 24 jam telah berlalu sejak penerima terakhir membalas; Meta menyarankan mengirim template sebagai gantinya.

131026

Tidak dapat dikirim: nomor tidak ada di WhatsApp, penerima belum menerima syarat baru, atau memakai versi WhatsApp lama.

30 days

Waktu default WhatsApp mencoba kembali template utility atau marketing yang belum terkirim sebelum dibuang; template autentikasi default 10 menit.

20 mps

Throughput tetap untuk nomor yang dipakai di aplikasi WhatsApp Business maupun Cloud API.

Mengapa pesan yang sudah diterima API tetap tidak sampai?

Karena respons API dan pengiriman adalah dua peristiwa terpisah. Saat Anda mengirim, Meta mengembalikan message id begitu permintaan diterima; apakah pesan sampai ke ponsel pelanggan terjadi kemudian, dan dilaporkan dalam webhook status pada field messages. sent berarti pesan sudah keluar dari server Meta (satu centang), delivered berarti sudah sampai ke perangkat (dua), read berarti sudah dibuka (dua biru), dan failed berarti pesan tidak dapat dikirim atau disampaikan, yang ditampilkan kepada Anda dalam array errors: code, title dan error_data.details. Jadi langkah pertama tidak pernah menebak: cari status failed untuk message id tersebut dan baca kodenya. Jika Anda tidak punya tujuan webhook, tidak ada yang mencatatnya.

Apa saja penyebabnya, sesuai urutan pemeriksaan?

Dari yang paling umum pada nomor yang baru terhubung hingga yang paling jarang. Setiap baris menyebut kode Meta, sehingga status failed memberi tahu Anda penyebabnya:

  • Jendela tertutup: 131047, lebih dari 24 jam sejak pelanggan terakhir menulis. Pesan teks bebas memerlukan jendela yang terbuka; kirim template.
  • Pembayaran: 131042, atau template dibuang diam-diam. Sejak 1 Oktober 2026 pesan layanan juga berhenti setelah 1,000 pesan per bulan terpakai tanpa metode pembayaran.
  • Template: 132001 belum disetujui atau bahasa salah, 132000 jumlah variabel salah, 132012 format salah, 132015 dijeda, 132016 dinonaktifkan.
  • Penerima: 131026 tidak ada di WhatsApp, versi lama atau syarat belum diterima; 131050 berhenti menerima pesan marketing; 131049 ditahan demi menjaga interaksi yang sehat; template marketing ke nomor US tidak terkirim.
  • Batas: 131048 dibatasi setelah sinyal spam, 131056 terlalu banyak pesan ke satu orang, 130429 throughput, 20 pesan per detik pada nomor Coexistence.
  • Akun: 131031 atau 368, WhatsApp Business Account dibatasi atau dinonaktifkan karena pelanggaran kebijakan.
  • Koneksi: nomor sudah tidak tertaut, misalnya setelah 14 hari tanpa membuka aplikasi WhatsApp Business.

Bagaimana menangani kode dari sisi penerima?

Berbeda, karena sebagian layak dicoba kembali dan sebagian tidak pernah. 131050 berarti orang tersebut memilih berhenti menerima pesan marketing dari Anda: Meta menyarankan jangan mencoba kembali, dan webhook user_preferences memberi tahu Anda saat mereka berhenti atau melanjutkan. 131049 berarti Meta menahan pesan marketing demi menjaga interaksi yang sehat, sering kali berupa batas per pengguna untuk template marketing: Meta menyarankan menunggu minimal 24 jam sebelum mengirim ulang, karena mengirim lebih cepat hanya mengembalikan kesalahan yang sama. 131026 mencakup nomor yang tidak ada di WhatsApp, pengguna yang belum menerima syarat WhatsApp terbaru, dan versi aplikasi yang sangat lama; periksa dulu format nomor dan kode negara, lalu hubungi pelanggan lewat saluran lain.

Berapa lama WhatsApp terus mencoba mengirim?

Selama time to live (TTL) pesan tersebut. Saat ponsel mati atau di luar jangkauan sinyal, WhatsApp mencoba kembali mengirim alih-alih langsung gagal: secara default 30 hari untuk template utility dan marketing, serta 10 menit untuk template autentikasi. Bisnis dapat memperpendeknya per template dengan message_send_ttl_seconds, dari 30 detik hingga 12 jam untuk utility dan 30 detik hingga 15 menit untuk autentikasi. Pesan yang tidak dapat disampaikan dalam TTL-nya akan dibuang. Jadi pesan dengan status sent tanpa status delivered setelah berjam-jam biasanya sedang menunggu di ponsel pelanggan, bukan hilang; atur TTL pendek untuk kode dan notifikasi yang mendesak agar pengiriman yang terlambat tidak membingungkan siapa pun.

Apa artinya untuk balasan AI dan otomasi?

Baca dulu run-nya, lalu statusnya. Di tab Runs, run Skipped tidak mengirim apa pun dan menyebut alasannya: "More than 24 hours since the customer's last message", "You answered this chat from your phone recently" atau "AI reply limit for this chat reached this hour". Run Done berarti Meta menerima setiap balasan, yang bukan bukti pesan sampai. easyCoexistence tidak menyimpan status pesan: jika otomasi aktif, status diteruskan ke forward URL bila Anda mengaturnya, dan dalam mode langsung dikirim langsung ke endpoint Anda sendiri. Dari ChatGPT atau Claude, minta AI Anda menjalankan get_number_health: hasilnya berupa status terkini, peringkat kualitas dan 15 event pemantauan terakhir, termasuk blok sending dengan kode Meta.

Cara mengonfigurasi

  1. Find the statusLook up the message id in your webhook log and read the latest status: delivered, read, sent only, or failed with an error code.
  2. Match the codeLook up the failed status's code in the list of causes above and in Meta's error codes reference.
  3. Check the accountConfirm the WhatsApp Business Account has a default payment method, a currency and a time zone in Billing & payments.
  4. Check the templateIf it was a template, confirm it is APPROVED in that language and the variables match its definition.
  5. Check the numberAsk your AI to run get_number_health, or open the number in the dashboard, to see the connection and any sending block.

Kesalahan umum

  • Mencoba kembali saat 131050. Orang tersebut berhenti menerima pesan marketing dari Anda; percobaan berikutnya tidak pernah terkirim dan hanya menambah sinyal negatif.
  • Menganggap message id sebagai tanda terkirim. Meta menerima lebih dulu dan melaporkan kegagalan kemudian, jadi alur kerja yang berhenti di message id melewatkan setiap pesan yang ditolak.
  • Mengirim balasan teks bebas sehari kemudian. Setelah 24 jam tanpa pesan pelanggan, hanya template yang diterima.
  • Berjalan tanpa tujuan webhook. Status failed hanya datang sebagai webhook, jadi tanpa itu alasan pesan tidak sampai akan hilang.
Melakukan ini dengan EasyCoexistence

AI Anda dapat memeriksa nomor dari ChatGPT atau Claude dengan get_number_health. US$ 9 turun ke US$ 0.75 per nomor per bulan, makin turun seiring bertambahnya nomor, dengan 3 hari pertama gratis.

Pertanyaan yang sering diajukan

Mengapa pesan menampilkan satu centang selama berjam-jam?

Satu centang adalah status sent: Meta sudah mengirimnya, tetapi ponsel belum menerimanya, biasanya karena ponsel mati atau offline. WhatsApp terus mencoba sampai time to live template habis, secara default 30 hari untuk utility dan marketing.

Mengapa balasan sampai tetapi template tidak?

Biasanya masalah metode pembayaran pada WhatsApp Business Account. Meta mengirim pesan layanan dalam kuota gratis bulanan nomor tanpa metode pembayaran, tetapi tidak mengirim template. Tambahkan kartu di Billing & payments.

Bisakah saya melihat pesan yang gagal di aplikasi WhatsApp Business?

Tidak selalu. Pada nomor Coexistence, pesan yang dikirim lewat API muncul di utas chat aplikasi, tetapi alasan pesan gagal hanya ada pada kode kesalahan di webhook status.

Apakah Meta menagih pesan yang tidak terkirim?

Tidak. Meta hanya menagih pesan yang terkirim, dan percobaan dengan template yang dijeda juga tidak ditagih.

Lanjut membaca

Siap memulai?

Konfigurasikan WhatsApp Coexistence dalam hitungan menit, bukan bulan. Aplikasi tetap berfungsi di ponsel.

Mulai uji coba gratis

Diverifikasi pada