Mesej API WhatsApp tidak sampai: punca mengikut susunan
Mesej API WhatsApp yang telah diterima belum tentu sampai. Meta melaporkan hasilnya kemudian dalam webhook status, sama ada sent, delivered, read atau failed, dengan kod ralat. Semak mengikut susunan: status gagal dan kodnya, tetingkap 24 jam (131047), kaedah pembayaran (131042), template (132001, 132015), penerima (131026, 131049, 131050), kemudian had dan sambungan nombor.
easyCoexistence memantau setiap nombor yang disambungkan sepanjang masa, menghantar e-mel kepada anda apabila Meta berhenti menghantar, memutuskan sambungan atau menurunkan kualiti, dan memajukan webhook status Meta tanpa sebarang perubahan ke sistem anda.
sent (satu tanda semak), delivered (dua tanda semak), read (dua tanda semak biru) dan failed (segi tiga ralat merah), seperti yang dilaporkan oleh webhook status.
Lebih 24 jam telah berlalu sejak penerima kali terakhir membalas; Meta menyarankan supaya template dihantar sebagai gantinya.
Tidak dapat dihantar: nombor tidak berada di WhatsApp, penerima belum menerima terma baharu, atau menggunakan versi WhatsApp yang lama.
Tempoh lalai WhatsApp mencuba semula template utiliti atau pemasaran yang tidak dihantar sebelum ia digugurkan; template pengesahan lalai kepada 10 minit.
Had throughput tetap bagi nombor yang digunakan dalam aplikasi WhatsApp Business dan Cloud API.
Mengapa mesej yang diterima masih tidak sampai?
Ini kerana jawapan API dan penghantaran ialah dua peristiwa yang berasingan. Apabila anda menghantar, Meta mengembalikan ID mesej sebaik sahaja ia menerima permintaan; sama ada mesej sampai ke telefon pelanggan berlaku kemudian, dalam webhook status pada medan messages. sent bermakna mesej meninggalkan pelayan Meta (satu tanda semak), delivered bermakna ia sampai ke peranti (dua tanda semak), read bermakna ia telah dibuka (dua tanda semak biru), dan failed bermakna ia gagal dihantar, dan kegagalan itu dipaparkan kepada anda melalui tatasusunan errors: code, title dan error_data.details. Jadi langkah pertama ialah jangan meneka: cari status gagal bagi ID mesej tersebut dan baca kodnya. Jika anda tiada destinasi webhook, tiada apa yang merekodkannya.
Apakah punca-puncanya, mengikut susunan untuk disemak?
Daripada yang paling biasa pada nombor yang baru disambungkan kepada yang paling jarang. Setiap baris menyatakan kod Meta, supaya status gagal memberitahu anda yang mana satu berlaku:
- Tetingkap ditutup: 131047, lebih 24 jam sejak pelanggan kali terakhir menulis. Mesej bentuk bebas memerlukan tetingkap yang terbuka; hantar template.
- Pembayaran: 131042, atau template digugurkan secara senyap. Sejak 1 Oktober 2026, mesej perkhidmatan juga berhenti selepas 1,000 mesej sebulan digunakan tanpa kaedah pembayaran.
- Template: 132001 belum diluluskan atau bahasa salah, 132000 bilangan pembolehubah salah, 132012 format salah, 132015 dijeda, 132016 dilumpuhkan.
- Penerima: 131026 tidak berada di WhatsApp, versi lama atau terma tidak diterima; 131050 berhenti menerima mesej pemasaran; 131049 ditahan untuk mengekalkan interaksi yang sihat; template pemasaran ke nombor AS tidak dihantar.
- Had: 131048 disekat selepas isyarat spam, 131056 terlalu banyak mesej kepada seorang, 130429 throughput, 20 mesej sesaat pada nombor Coexistence.
- Akaun: 131031 atau 368, WhatsApp Business Account disekat atau dilumpuhkan kerana pelanggaran dasar.
- Sambungan: nombor tidak lagi dipautkan, contohnya selepas 14 hari tanpa membuka aplikasi WhatsApp Business.
Bagaimana anda mengendalikan kod di sebelah penerima?
Secara berbeza, kerana sesetengahnya wajar dicuba semula dan sesetengahnya tidak sekali-kali. 131050 bermakna orang itu memilih untuk berhenti menerima mesej pemasaran daripada anda: Meta menyatakan supaya tidak dicuba semula, dan webhook user_preferences memberitahu anda apabila mereka berhenti atau menyambung semula. 131049 ialah Meta yang menahan mesej pemasaran untuk mengekalkan interaksi yang sihat, selalunya had setiap pengguna bagi template pemasaran: Meta menasihatkan supaya menunggu sekurang-kurangnya 24 jam sebelum menghantar semula, kerana menghantar lebih awal hanya akan mengembalikan ralat yang sama. 131026 merangkumi nombor yang tidak berada di WhatsApp, pengguna yang belum menerima terma semasa WhatsApp dan versi aplikasi yang sangat lama; semak format dan kod negara nombor terlebih dahulu, kemudian hubungi pelanggan melalui saluran lain.
Berapa lama WhatsApp terus cuba menghantar?
Sepanjang masa hidup mesej tersebut. Apabila telefon dimatikan atau berada di luar liputan, WhatsApp mencuba semula penghantaran dan tidak gagal serta-merta: secara lalai selama 30 hari bagi template utiliti dan pemasaran, serta 10 minit bagi template pengesahan. Perniagaan boleh memendekkannya bagi setiap template dengan message_send_ttl_seconds, dari 30 saat hingga 12 jam bagi utiliti dan 30 saat hingga 15 minit bagi pengesahan. Mesej yang tidak dapat dihantar dalam masa hidupnya akan digugurkan. Jadi mesej dengan status sent tetapi tiada status delivered selepas berjam-jam biasanya sedang menunggu pada telefon pelanggan, bukan hilang; tetapkan TTL yang pendek untuk kod dan amaran yang sensitif kepada masa supaya penghantaran lewat tidak mengelirukan sesiapa.
Apakah maksud ini untuk balasan AI dan automasi?
Baca larian dahulu, kemudian status. Dalam tab Runs, larian dilangkau tidak menghantar apa-apa dan menyatakan sebabnya: Lebih 24 jam sejak mesej terakhir pelanggan, anda membalas sembang ini dari telefon anda baru-baru ini, atau Had balasan AI bagi sembang ini telah dicapai pada jam ini. Larian selesai bermakna Meta menerima setiap balasan, yang bukan bukti penghantaran. easyCoexistence tidak menyimpan status mesej: dengan automasi dihidupkan, status sampai ke URL pemajuan anda jika anda menetapkannya, dan dalam mod terus, status dihantar terus ke endpoint anda sendiri. Dari ChatGPT atau Claude, minta AI anda menjalankan get_number_health: ia memulangkan status semasa, penarafan kualiti dan 15 peristiwa pemantauan terakhir, termasuk blok sending dengan kod Meta.
Cara menetapkannya
- 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.
- Match the codeLook up the failed status's code in the list of causes above and in Meta's error codes reference.
- Check the accountConfirm the WhatsApp Business Account has a default payment method, a currency and a time zone in Billing & payments.
- Check the templateIf it was a template, confirm it is APPROVED in that language and the variables match its definition.
- 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.
Kesilapan biasa
- Mencuba semula pada 131050. Orang itu berhenti menerima mesej pemasaran daripada anda; percubaan selanjutnya tidak pernah sampai dan hanya boleh menambah isyarat negatif.
- Menganggap ID mesej sebagai telah sampai. Meta menerima dahulu dan melaporkan kegagalan kemudian, jadi aliran kerja yang berhenti pada ID terlepas setiap mesej yang ditolak.
- Menghantar balasan bentuk bebas sehari kemudian. Selepas 24 jam tanpa mesej pelanggan, hanya template yang diterima.
- Beroperasi tanpa destinasi webhook. Status gagal hanya sampai melalui webhook, jadi tanpa satu pun, sebab mesej tidak sampai akan hilang.
AI anda boleh menyemak nombor dari ChatGPT atau Claude dengan get_number_health. Daripada US$ 9 hingga US$ 0.75 setiap nombor yang disambungkan sebulan, menurun apabila nombor ditambah, dengan 3 hari pertama percuma.
Soalan lazim
Mengapa mesej menunjukkan satu tanda semak selama berjam-jam?
Satu tanda semak ialah status sent: Meta telah menghantarnya, tetapi telefon belum menerimanya, biasanya kerana telefon dimatikan atau di luar talian. WhatsApp terus mencuba sehingga masa hidup template tamat, secara lalai 30 hari bagi utiliti dan pemasaran.
Mengapa balasan sampai tetapi template tidak?
Biasanya masalah kaedah pembayaran pada WhatsApp Business Account. Meta menghantar mesej perkhidmatan dalam had percuma bulanan nombor tanpa kaedah pembayaran, tetapi tidak menghantar template. Tambahkan kad dalam Bil & pembayaran.
Bolehkah saya melihat mesej yang gagal dalam aplikasi WhatsApp Business?
Tidak sepenuhnya. Pada nombor Coexistence, mesej yang dihantar melalui API muncul dalam utas sembang aplikasi, tetapi sebab mesej gagal hanya datang dalam kod ralat webhook status.
Adakah Meta mengenakan bayaran untuk mesej yang tidak sampai?
Tidak. Meta hanya mengenakan bayaran untuk mesej yang sampai, dan percubaan dengan template yang dijeda juga tidak dikenakan bayaran.
Teruskan membaca
Sedia untuk bermula?
Sediakan WhatsApp Coexistence dalam beberapa minit, bukan berbulan-bulan. Aplikasi terus berfungsi pada telefon.
Mulakan Percubaan PercumaDisahkan pada