Mesajul WhatsApp API nu a fost livrat: cauzele, în ordine
Un mesaj WhatsApp API acceptat nu este un mesaj livrat: Meta raportează rezultatul mai târziu, într-un webhook de stare, ca trimis, livrat, citit sau eșuat, cu un cod de eroare. Verificați în ordine: starea eșuată și codul ei, fereastra de 24 de ore (131047), metoda de plată (131042), șablonul (132001, 132015), destinatarul (131026, 131049, 131050), apoi limitele și conexiunea numărului.
easyCoexistence urmărește fiecare număr conectat non-stop, vă trimite e-mail când Meta încetează livrarea, elimină legătura sau scade calitatea și transmite webhook-urile de stare Meta nemodificate către sistemul dumneavoastră.
trimis (o bifă), livrat (două), citit (două albastre) și eșuat (un triunghi roșu cu eroare), așa cum le raportează webhook-urile de stare.
Au trecut mai mult de 24 de ore de la ultimul răspuns al destinatarului; Meta recomandă trimiterea unui șablon în loc.
Livrarea nu reușește: numărul nu este pe WhatsApp, destinatarul nu a acceptat noii termeni sau folosește o versiune veche de WhatsApp.
Timpul implicit în care WhatsApp reîncearcă livrarea unui șablon utilitar sau de marketing, înainte să-l abandoneze; șabloanele de autentificare au implicit 10 minute.
Debit fix al unui număr folosit atât în aplicația WhatsApp Business, cât și în Cloud API.
De ce un mesaj acceptat tot nu ajunge?
Pentru că răspunsul API și livrarea sunt două evenimente separate. Când trimiteți, Meta returnează un id de mesaj imediat ce acceptă cererea; dacă mesajul ajunge pe telefonul clientului se află mai târziu, într-un webhook de stare pe câmpul messages. sent înseamnă că a părăsit serverele Meta (o bifă), delivered că a ajuns la dispozitiv (două), read că a fost deschis (două albastre), iar failed că nu a putut fi trimis sau livrat, arătat în tabloul errors: code, title și error_data.details. Deci prima mișcare nu este să ghiciți: găsiți starea failed pentru acel id de mesaj și citiți codul. Dacă nu aveți o destinație de webhook, nimic nu o înregistrează.
Care sunt cauzele, în ordinea verificării?
De la cea mai frecventă la un număr nou conectat până la cea mai rară. Fiecare rând indică codul Meta, astfel încât starea eșuată vă arată în care vă aflați:
- Fereastra s-a închis: 131047, mai mult de 24 de ore de la ultimul mesaj al clientului. Mesajele libere au nevoie de o fereastră deschisă; trimiteți un șablon.
- Plata: 131042, sau șabloanele eliminate fără anunț. Din 1 octombrie 2026, mesajele de serviciu se opresc și ele după 1.000 de utilizări pe lună fără metodă de plată.
- Șablon: 132001 neaprobat sau în limbă greșită, 132000 număr greșit de variabile, 132012 format greșit, 132015 pus pe pauză, 132016 dezactivat.
- Destinatar: 131026 nu este pe WhatsApp, versiune veche sau termeni neacceptați; 131050 a oprit mesajele de marketing; 131049 reținut pentru o implicare sănătoasă; șabloanele de marketing către numerele din SUA nu sunt livrate.
- Limite: 131048 restricționat după semnale de spam, 131056 prea multe mesaje către aceeași persoană, 130429 debit, 20 de mesaje pe secundă pe un număr Coexistence.
- Cont: 131031 sau 368, contul WhatsApp Business restricționat sau dezactivat pentru o încălcare a politicii.
- Conexiune: numărul nu mai este legat, de exemplu după 14 zile fără deschiderea aplicației WhatsApp Business.
Cum tratați codurile de la destinatar?
Diferit, pentru că unele merită o nouă încercare, iar altele niciodată. 131050 înseamnă că persoana a ales să oprească mesajele de marketing de la dumneavoastră: Meta spune să nu reîncercați, iar webhook-ul user_preferences vă anunță când se opresc sau reiau. 131049 este Meta reținând un mesaj de marketing pentru a menține o implicare sănătoasă, adesea o limită pe fiecare utilizator pentru șabloanele de marketing: Meta recomandă să așteptați cel puțin 24 de ore înainte de retrimitere, pentru că o retrimitere mai devreme returnează doar aceeași eroare. 131026 acoperă numerele care nu sunt pe WhatsApp, utilizatorii care nu au acceptat termenii actuali WhatsApp și versiunile foarte vechi ale aplicației; verificați mai întâi formatul numărului și prefixul țării, apoi contactați clientul pe alt canal.
Cât timp încearcă WhatsApp să livreze?
Pe durata de viață a mesajului (time to live). Când telefonul este oprit sau în afara acoperirii, WhatsApp reîncearcă livrarea în loc să eșueze imediat: implicit timp de 30 de zile pentru șabloanele utilitare și de marketing și 10 minute pentru cele de autentificare. O afacere poate scurta acest timp pentru fiecare șablon cu message_send_ttl_seconds, de la 30 de secunde la 12 ore pentru utilitare și de la 30 de secunde la 15 minute pentru autentificare. Un mesaj care nu poate fi livrat în durata sa de viață este eliminat. Deci un mesaj cu starea sent și fără starea delivered după ore de așteptare este de obicei în așteptare pe telefonul clientului, nu pierdut; setați o durată scurtă pentru coduri și alertele sensibile la timp, ca o livrare întârziată să nu încurce pe nimeni.
Ce înseamnă asta pentru răspunsurile AI și automatizări?
Citiți mai întâi rularea, apoi starea. În fila Runs, o rulare Skipped nu a trimis nimic și spune de ce: „Au trecut mai mult de 24 de ore de la ultimul mesaj al clientului”, „Ați răspuns recent acestei conversații de pe telefon” sau „Limita de răspunsuri AI pentru această conversație a fost atinsă în această oră”. O rulare Done înseamnă că Meta a acceptat fiecare răspuns, ceea ce nu este dovada livrării. easyCoexistence nu stochează stările mesajelor: cu automatizările pornite, ajung la URL-ul de redirecționare dacă l-ați setat, iar în modul direct merg direct la endpoint-ul propriu. Din ChatGPT sau Claude, cereți AI-ului să ruleze get_number_health: returnează starea live, scorul de calitate și ultimele 15 evenimente de monitorizare, inclusiv un bloc sending cu codul Meta.
Cum să îl configurați
- 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.
Greșeli frecvente
- Reîncercarea la 131050. Persoana a oprit mesajele de marketing de la dumneavoastră; încercările suplimentare nu sunt livrate niciodată și pot doar adăuga semnale negative.
- Considerarea unui id de mesaj ca livrat. Meta acceptă primul și raportează eșecurile mai târziu, deci un flux care se oprește la id pierde fiecare mesaj refuzat.
- Trimiterea unui răspuns liber a doua zi. După 24 de ore fără mesaj de la client, este acceptat doar un șablon.
- Rularea fără destinație de webhook. Stările eșuate sosesc doar ca webhook-uri, deci fără una se pierde motivul pentru care un mesaj nu a ajuns.
AI-ul dumneavoastră poate verifica un număr din ChatGPT sau Claude cu get_number_health. US$ 9 până la US$ 0,75 per număr pe lună, prețul scăzând pe măsură ce adăugați numere, cu primele 3 zile gratuite.
Întrebări frecvente
De ce mesajul a arătat o singură bifă ore întregi?
O bifă înseamnă starea sent: Meta l-a trimis, dar telefonul nu l-a primit, de obicei pentru că este oprit sau offline. WhatsApp continuă reîncercările până expiră durata de viață a șablonului, implicit 30 de zile pentru cele utilitare și de marketing.
De ce ajung răspunsurile, dar șabloanele nu?
De obicei este o problemă cu metoda de plată din contul WhatsApp Business. Meta livrează mesajele de serviciu în limita gratuită lunară a numărului fără una, dar nu livrează șabloane. Adăugați un card în Billing & payments.
Pot vedea mesajele eșuate în aplicația WhatsApp Business?
Nu în mod sigur. Pe un număr Coexistence, mesajele trimise prin API apar în firul de conversație din aplicație, dar motivul eșecului apare doar în codul de eroare din webhook-ul de stare.
Meta taxează mesajele care nu au fost livrate?
Nu. Meta taxează doar mesajele livrate, iar încercările cu un șablon pus pe pauză nu sunt taxate nici ele.
Continuați să citiți
Gata să începeți?
Configurați WhatsApp Coexistence în câteva minute, nu luni. Aplicația continuă să funcționeze pe telefon.
Începeți perioada de probă gratuităVerificat la