Coduri de eroare WhatsApp Cloud API
Acestea sunt toate codurile de eroare WhatsApp Cloud API pe care le documentăm, într-un singur tabel, cu explicația fiecăruia și indicația dacă reîncercarea ajută. Majoritatea nu ajută: sunt deterministe, astfel încât aceeași cerere eșuează la fel, iar o buclă de reîncercare transformă o cerere greșită într-o limitare de rată.
EasyCoexistence monitorizează continuu conexiunea și înregistrează în cronologia conexiunii evenimentele Meta privind contul și calitatea, astfel încât erorile provenite din starea unui număr să fie vizibile înainte ca trimiterea să eșueze, nu după.
Cerere
| Cod | Ce înseamnă | Reîncercare |
|---|---|---|
| 100 | Un parametru nu este acceptat, este scris greșit sau este formatat incorect. | Nu |
| 131008 | Un parametru obligatoriu nu a fost inclus deloc. | Nu |
| 131009 | Un parametru este prezent cu o valoare pe care endpoint-ul o respinge. | Nu |
| 131021 | Expeditorul și destinatarul sunt același număr. | Nu |
| 131051 | Tipul de mesaj nu este acceptat, adesea din cauza unei limite Coexistence. | Nu |
| 131052 | Meta nu a putut descărca fișierele media trimise de un client. | Nu |
| 131053 | Meta nu a putut încărca fișierele media trimise de dumneavoastră. Dimensiune, format sau accesibilitate. | Nu |
Template
| Cod | Ce înseamnă | Reîncercare |
|---|---|---|
| 132000 | Numărul de parametri nu corespunde template-ului. | Nu |
| 132001 | Nu există niciun template cu această pereche de nume și limbă. | Nu |
| 132007 | Template-ul încalcă politica de mesagerie. Rescrieți-l și trimiteți-l din nou. | Nu |
| 132012 | Formatul parametrului nu corespunde celui definit de template. | Nu |
| 132015 | Template-ul este suspendat după o scădere a calității. Temporar. | Așteptați |
| 132016 | Template-ul este dezactivat permanent. Nu va reveni. | Nu |
Fereastră și destinatar
| Cod | Ce înseamnă | Reîncercare |
|---|---|---|
| 131047 | Fereastra de asistență de 24 de ore este închisă. Trimiteți un template. | Nu |
| 131026 | Destinatarul nu poate primi mesajul deloc. | Nu |
| 131050 | Persoana s-a dezabonat. Nu există nicio soluție de ocolire, în mod intenționat. | Nu |
| 130497 | Trimiterea de mesaje în acea țară este restricționată pentru contul dumneavoastră. | Nu |
Înregistrare și PIN
| Cod | Ce înseamnă | Reîncercare |
|---|---|---|
| 131045 | Numărul nu a fost niciodată înregistrat pentru mesagerie prin Cloud API. | Nu |
| 133010 | Numărul nu este înregistrat. Înregistrarea trebuie finalizată. | Nu |
| 133006 | Numărul trebuie verificat înainte de a putea fi înregistrat. | Nu |
| 133005 | PIN-ul de verificare în doi pași a fost greșit. Nu mai încercați la întâmplare. | Nu |
| 133008 | Prea multe încercări de PIN. Înregistrarea este blocată pentru o perioadă. | Așteptați |
Acces și cont
| Cod | Ce înseamnă | Reîncercare |
|---|---|---|
| 190 | Token-ul de acces a expirat sau a fost invalidat. | Nu |
| 368 | Contul este restricționat după o încălcare a politicilor. | Nu |
| 131031 | Contul este restricționat sau datele sale nu corespund cu cele ale Meta. | Nu |
| 131042 | O problemă de plată în contul business blochează trimiterea. | Nu |
| 131049 | Meta a blocat mesajul pentru a proteja sănătatea ecosistemului. | Nu |
Limite de rată
| Cod | Ce înseamnă | Reîncercare |
|---|---|---|
| 130429 | A fost atinsă limita de capacitate de trimitere a mesajelor pentru cont. | Așteptați |
| 131048 | A fost atinsă o limită de rată anti-spam. Cauza este calitatea, nu volumul. | Nu |
| 131056 | Prea multe mesaje între numărul dumneavoastră și un singur destinatar. | Nu |
| 80007 | Contul a atins limita de apeluri de administrare. De obicei din cauza polling-ului. | Așteptați |
Temporare
Sincronizare Coexistence
Cum se citește coloana de reîncercare
Are trei valori, iar alegerea greșită dintre ele este cea mai costisitoare greșeală din această referință.
Nu înseamnă că eșecul este determinist. Cererea, template-ul sau starea destinatarului este cauza, iar trimiterea aceleiași cereri produce aceeași eroare și consumă capacitatea de trimitere de care veți avea nevoie mai târziu. Da înseamnă că eșecul a fost de partea Meta, iar un backoff rezolvă problema în mod real. Așteptați înseamnă că situația este reală, dar temporară: o limită sau o blocare care dispare singură; reîncercarea înainte de ridicarea ei nu ajută și o poate prelungi.
De ce majoritatea nu permit reîncercarea
Pentru că platforma returnează coduri specifice, nu unele generice. Un parametru malformat, un template inexistent, o fereastră de mesagerie închisă și un destinatar care a refuzat comunicarea pot fi identificate în momentul răspunsului, așa că Meta le denumește în loc să eșueze vag.
- O problemă a cererii nu devine corectă la a doua încercare.
- O problemă a template-ului se află în template, iar cererea nu o poate schimba.
- O problemă a ferestrei sau a refuzului ține de starea destinatarului, nu de a dumneavoastră.
- O restricție a contului este o decizie, iar reîncercarea nu este o contestație.
Ce trebuie înregistrat când apare unul dintre aceste coduri
Suficiente informații pentru a diagnostica problema fără a o reproduce, ceea ce face diferența dintre o remediere de cinci minute și o zi de presupuneri.
- Răspunsul complet de eroare, inclusiv trace id, pe care îl solicită suportul Meta.
- Corpul cererii așa cum a fost trimis, nu cum a fost intenționat. Diferența dintre cele două este de obicei problema.
- phone number id, pentru a distinge o problemă a unui singur număr de una care afectează întregul cont.
- Marca temporală, pentru ca eșecul să poată fi verificat în raport cu starea conexiunii din acel moment.
Codurile care există doar în Coexistence
Două dintre ele creează confuzie deoarece seamănă cu erori obișnuite de trimitere. 2593107 și 2593108 privesc ambele sincronizarea istoricului conversațiilor, pasul care copiază conversațiile recente din aplicația WhatsApp Business când un număr este conectat pentru prima dată.
Nu sunt erori de mesagerie și nu înseamnă că a eșuat conexiunea. O sincronizare care depășește limita sau rulează în afara ferestrei lasă numărul conectat și funcțional pentru trimitere, dar copiază mai puțin istoric decât era de așteptat. Interpretarea lor ca fiind o conexiune defectă îi determină pe oameni să deconecteze și să reia procesul, ceea ce pierde și mai mult istoric în loc să îl recupereze.
Întrebări frecvente
Ce erori ar trebui să reîncerc?
131016 și 131000, cu backoff exponențial. 130429, 132015 și 133008 dispar singure dacă așteptați. Toate celelalte sunt deterministe.
Un cod de eroare înseamnă că numărul meu este deconectat?
De obicei, nu. Majoritatea privesc cererea, template-ul sau destinatarul. Problemele conexiunii apar ca webhook-uri de cont și calitate, nu ca erori de trimitere.
Ce este un trace id?
Un identificator din răspunsul de eroare care permite suportului Meta să găsească cererea specifică. Înregistrați-l la fiecare eșec; fără el, un tichet nu poate fi soluționat.
Aceste coduri sunt aceleași la fiecare furnizor?
Da. Provin din Cloud API al Meta, deci sunt identice indiferent de furnizorul care a conectat numărul. Furnizorul poate schimba doar cât de clar ajung la dumneavoastră.
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ăNimic de plătit timp de 3 zile. Anulați oricând.