Conectați-văÎncepeți perioada de probă gratuită
Meta Tech Provider

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ă.

Mesaje nestocate în mod implicitAplicația Business + Cloud APIMCP pentru Claude și ChatGPTGata în 2 minute

Cerere

CodCe înseamnăReîncercare
100Un parametru nu este acceptat, este scris greșit sau este formatat incorect.Nu
131008Un parametru obligatoriu nu a fost inclus deloc.Nu
131009Un parametru este prezent cu o valoare pe care endpoint-ul o respinge.Nu
131021Expeditorul și destinatarul sunt același număr.Nu
131051Tipul de mesaj nu este acceptat, adesea din cauza unei limite Coexistence.Nu
131052Meta nu a putut descărca fișierele media trimise de un client.Nu
131053Meta nu a putut încărca fișierele media trimise de dumneavoastră. Dimensiune, format sau accesibilitate.Nu

Template

CodCe înseamnăReîncercare
132000Numărul de parametri nu corespunde template-ului.Nu
132001Nu există niciun template cu această pereche de nume și limbă.Nu
132007Template-ul încalcă politica de mesagerie. Rescrieți-l și trimiteți-l din nou.Nu
132012Formatul parametrului nu corespunde celui definit de template.Nu
132015Template-ul este suspendat după o scădere a calității. Temporar.Așteptați
132016Template-ul este dezactivat permanent. Nu va reveni.Nu

Fereastră și destinatar

CodCe înseamnăReîncercare
131047Fereastra de asistență de 24 de ore este închisă. Trimiteți un template.Nu
131026Destinatarul nu poate primi mesajul deloc.Nu
131050Persoana s-a dezabonat. Nu există nicio soluție de ocolire, în mod intenționat.Nu
130497Trimiterea de mesaje în acea țară este restricționată pentru contul dumneavoastră.Nu

Înregistrare și PIN

CodCe înseamnăReîncercare
131045Numărul nu a fost niciodată înregistrat pentru mesagerie prin Cloud API.Nu
133010Numărul nu este înregistrat. Înregistrarea trebuie finalizată.Nu
133006Numărul trebuie verificat înainte de a putea fi înregistrat.Nu
133005PIN-ul de verificare în doi pași a fost greșit. Nu mai încercați la întâmplare.Nu
133008Prea multe încercări de PIN. Înregistrarea este blocată pentru o perioadă.Așteptați

Acces și cont

CodCe înseamnăReîncercare
190Token-ul de acces a expirat sau a fost invalidat.Nu
368Contul este restricționat după o încălcare a politicilor.Nu
131031Contul este restricționat sau datele sale nu corespund cu cele ale Meta.Nu
131042O problemă de plată în contul business blochează trimiterea.Nu
131049Meta a blocat mesajul pentru a proteja sănătatea ecosistemului.Nu

Limite de rată

CodCe înseamnăReîncercare
130429A fost atinsă limita de capacitate de trimitere a mesajelor pentru cont.Așteptați
131048A fost atinsă o limită de rată anti-spam. Cauza este calitatea, nu volumul.Nu
131056Prea multe mesaje între numărul dumneavoastră și un singur destinatar.Nu
80007Contul a atins limita de apeluri de administrare. De obicei din cauza polling-ului.Așteptați

Temporare

CodCe înseamnăReîncercare
131016Un serviciu Meta este temporar indisponibil.Da
131000Eroare neclasificată. Reîncercați o dată, apoi escaladați cu trace id-ul.Da

Sincronizare Coexistence

CodCe înseamnăReîncercare
2593107A fost depășită limita de sincronizare a istoricului conversațiilor.Nu
2593108S-a încercat o sincronizare în afara ferestrei de sincronizare de 24 de ore.Nu

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.

Continuați să citiți