Meta Tech Provider

Kodovi pogrešaka WhatsApp Cloud API-ja

Ovo su svi kodovi pogrešaka WhatsApp Cloud API-ja koje dokumentiramo, u jednoj tablici, uz objašnjenje svakog kôda i informaciju pomaže li ponovni pokušaj. Većinom ne pomaže: pogreške su determinističke, pa isti zahtjev ne uspijeva na isti način, a petlja ponovnih pokušaja loš zahtjev pretvara u ograničenje broja zahtjeva.

Bez pohrane porukaBusiness App + Cloud APIMCP za Claude i ChatGPTAktivno za 2 minute

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

Code	What it means	Retry
131047	The 24-hour service window is closed. Send a template.	No
131026	The recipient cannot receive the message at all.	No
131050	The person opted out. There is no workaround, by design.	No
130497	Messaging that country is restricted for your account.	No

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

Code	What it means	Retry
130429	The account's messaging throughput limit was reached.	Wait
131048	A spam rate limit was hit. Quality, not volume, is the cause.	No
131056	Too many messages between your number and one recipient.	No
80007	The account hit its management call limit. Usually polling.	Wait

Transient

Code	What it means	Retry
131016	A Meta service is temporarily unavailable.	Yes
131000	Unclassified failure. Retry once, then escalate with the trace id.	Yes

Coexistence sync

Code	What it means	Retry
2593107	The chat history synchronisation limit was exceeded.	No
2593108	A sync was attempted outside the 24-hour sync window.	No

Kako čitati stupac o ponovnom pokušaju

Sadrži tri vrijednosti, a pogrešan odabir među njima najskuplja je pogreška u cijeloj ovoj referenci.

Ne znači da je neuspjeh deterministički. Pogreška je u zahtjevu, predlošku ili stanju primatelja, a ponovno slanje identičnog zahtjeva daje istu pogrešku i troši propusnost koja će vam poslije trebati. Da znači da je pogreška na Metinoj strani i da je postupno ponovno slanje doista uklanja. Pričekajte znači da je uvjet stvaran, ali privremen: ograničenje ili zaključavanje koje se samo uklanja, pa ponovni pokušaj prije toga ne pomaže i može ga produljiti.

Zašto se većina ovih kôdova ne može riješiti ponovnim pokušajem

Zato što platforma vraća konkretne kodove, a ne generičke. Neispravan parametar, predložak koji ne postoji, zatvoren prozor za slanje poruka i primatelj koji je odustao od primanja poruka poznati su već u trenutku odgovora, pa ih Meta imenuje umjesto da neodređeno prijavi neuspjeh.

Problem sa zahtjevom ne postaje ispravan u drugom pokušaju.
Problem s predloškom nalazi se u samom predlošku, a zahtjev ga ne može promijeniti.
Problem s prozorom ili odjavom primanja poruka odnosi se na stanje primatelja, a ne na vaše stanje.
Ograničenje računa odluka je sustava, a ponovni pokušaj nije žalba.

Što zapisati kada stigne jedan od ovih kôdova

Dovoljno podataka za dijagnostiku bez ponavljanja problema, što je razlika između popravka za pet minuta i cijelog dana nagađanja.

Cijeli odgovor pogreške, uključujući trace id, koji Meta podrška traži.
Tijelo zahtjeva kako je poslano, a ne kako je zamišljeno. Razlika između toga najčešće je pogreška.
ID telefonskog broja, kako bi se problem na jednom broju razlikovao od problema na cijelom računu.
Vremensku oznaku, kako bi se neuspjeh mogao provjeriti u odnosu na stanje veze u tom trenutku.

Kôdovi koji postoje samo na Coexistence

Dva su takva kôda i zbunjuju ljude jer izgledaju kao obični neuspjesi slanja. 2593107 i 2593108 odnose se na sinkronizaciju povijesti razgovora, odnosno korak koji kopira nedavne razgovore iz aplikacije WhatsApp Business kada se broj prvi put poveže.

To nisu pogreške slanja poruka i ne znače da povezivanje nije uspjelo. Sinkronizacija koja premaši ograničenje ili se pokrene izvan svojeg prozora ostavlja broj povezanim i spremnim za uobičajeno slanje, ali kopira manje povijesti nego što se očekivalo. Ako ih protumačite kao neispravnu vezu, mogli biste prekinuti povezivanje i početi ispočetka, čime se gubi još više povijesti umjesto da se ona obnovi.

Često postavljana pitanja

Koje pogreške trebam pokušati ponoviti?

131016 i 131000, uz eksponencijalno povećavanje razmaka između pokušaja. 130429, 132015 i 133008 sami se ponište ako pričekate. Sve ostalo je determinističko.

Znači li kôd pogreške da je moj broj odspojen?

Obično ne. Većina se odnosi na zahtjev, predložak ili primatelja. Problemi s povezivanjem pojavljuju se kao webhookovi računa i kvalitete, a ne kao pogreške slanja.

Što je trace id?

Identifikator u odgovoru pogreške koji Metinoj podršci omogućuje pronalaženje konkretnog zahtjeva. Zapisujte ga pri svakom neuspjehu; bez njega se upit ne može obraditi.

Jesu li ovi kôdovi isti kod svakog pružatelja?

Da. Dolaze iz Metina Cloud API-ja, pa su jednaki bez obzira na to koji je pružatelj povezao broj. Pružatelj može promijeniti samo koliko jasno dopiru do vas.

Spremni za početak?

Postavite WhatsApp Coexistence u nekoliko minuta, a ne mjeseci. Aplikacija i dalje radi na telefonu.

Započnite besplatno probno razdoblje7 dana bez naplate. Otkažite bilo kada.

Nastavite čitati

ReferenceWhatsApp error 131047: re-engagement messageError 131047 means more than 24 hours have passed since that customer last messaged you, so the customer service window is closed and free text will not deliver.ReferenceWhatsApp error 100: invalid parameterError 100 means the request carried a parameter Meta does not accept: unsupported, misspelled, or the wrong shape for that endpoint.ReferenceWhatsApp error 131016: service unavailableError 131016 means a service on Meta's side is temporarily unavailable.ReferenceA number stopped working: how to find out whyWhen a connected number stops working, the cause is almost never the code.ReferenceWhatsApp webhook fields, and which ones go whereA WhatsApp Business Account delivers events as named fields.GuideWhatsApp Coexistence: the app and the API on one numberCoexistence is Meta's official mode for running the WhatsApp Business app and the Cloud API on one number at the same time.