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ă.
Request
| Code | What it means | Retry |
|---|---|---|
| 100 | A parameter is unsupported, misspelled or malformed. | No |
| 131008 | A required parameter was not included at all. | No |
| 131009 | A parameter is present with a value the endpoint rejects. | No |
| 131021 | Sender and recipient are the same number. | No |
| 131051 | The message type is not supported, often a Coexistence limit. | No |
| 131052 | Meta could not download media a customer sent. | No |
| 131053 | Meta could not upload media you sent. Size, format or reach. | No |
Template
| Code | What it means | Retry |
|---|---|---|
| 132000 | The number of parameters does not match the template. | No |
| 132001 | No template exists with that name and language pair. | No |
| 132007 | The template breaks messaging policy. Rewrite and resubmit. | No |
| 132012 | Parameter format does not match what the template defines. | No |
| 132015 | The template is paused after a quality decline. Temporary. | Wait |
| 132016 | The template is permanently disabled. It will not come back. | No |
Window and recipient
Registration and PIN
| Code | What it means | Retry |
|---|---|---|
| 131045 | The number was never registered for Cloud API messaging. | No |
| 133010 | The number is not registered. Registration must be completed. | No |
| 133006 | The number must be verified before it can be registered. | No |
| 133005 | The two-step verification PIN was wrong. Stop guessing. | No |
| 133008 | Too many PIN attempts. Registration is locked for a period. | Wait |
Access and account
| Code | What it means | Retry |
|---|---|---|
| 190 | The access token expired or was invalidated. | No |
| 368 | The account is restricted after a policy violation. | No |
| 131031 | The account is restricted, or its data does not match Meta's. | No |
| 131042 | A payment problem on the business account blocks sending. | No |
| 131049 | Meta blocked the message to protect ecosystem health. | No |
Rate limits
Transient
Coexistence sync
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 7 zile. Anulați oricând.