Meta Tech Provider

Foutcodes van de WhatsApp Cloud API

Dit zijn alle WhatsApp Cloud API-foutcodes die we documenteren, in één tabel, met hun betekenis en de vraag of opnieuw proberen helpt. Meestal niet: ze zijn deterministisch, dus hetzelfde verzoek mislukt op dezelfde manier en een herhalingslus verandert een fout verzoek in een snelheidslimiet.

Geen berichtopslagBusiness-app + Cloud APIMCP voor Claude en ChatGPTLive in 2 minuten

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

De kolom voor opnieuw proberen lezen

Deze heeft drie waarden, en de verkeerde keuze daartussen is de duurste fout in deze hele referentie.

Nee betekent dat de fout deterministisch is. Het verzoek, het template of de status van de ontvanger is mislukt. Hetzelfde verzoek opnieuw verzenden geeft dezelfde fout en verbruikt doorvoer die je later nodig hebt. Ja betekent dat de fout aan Meta's kant lag en back-off het probleem echt oplost. Wachten betekent dat de toestand echt maar tijdelijk is: een limiet of blokkering die vanzelf verdwijnt. Opnieuw proberen voordat dat gebeurt helpt niet en kan de blokkering verlengen.

Waarom de meeste hiervan niet opnieuw geprobeerd moeten worden

Omdat het platform specifieke codes terugstuurt in plaats van algemene. Een ongeldige parameter, een niet-bestaand template, een gesloten berichtenvenster en een ontvanger die zich heeft afgemeld zijn al bekend op het moment van het antwoord. Daarom benoemt Meta ze in plaats van vaag te falen.

Een probleem met een verzoek wordt niet correct bij een tweede poging.
Een templateprobleem zit in het template, dat het verzoek niet kan wijzigen.
Een probleem met een venster of afmelding gaat over de status van de ontvanger, niet over die van jou.
Een accountbeperking is een beslissing, en opnieuw proberen is geen beroep.

Wat je moet loggen wanneer er een binnenkomt

Genoeg om de fout te diagnosticeren zonder haar opnieuw te reproduceren. Dat is het verschil tussen een oplossing van vijf minuten en een dag gissen.

Het volledige foutantwoord, inclusief de trace id, waar Meta-support om vraagt.
De body van het verzoek zoals die is verzonden, niet zoals bedoeld. Het verschil daartussen is meestal de fout.
De telefoonnummer-id, zodat je een probleem met één nummer kunt onderscheiden van een probleem voor het hele account.
Het tijdstip, zodat je de fout kunt controleren tegen de status van de verbinding op dat moment.

De codes die alleen op Coexistence bestaan

Twee ervan, en ze brengen mensen in verwarring omdat ze eruitzien als gewone verzendfouten. 2593107 en 2593108 gaan beide over chatsynchronisatie. Dat is de stap waarbij recente gesprekken uit de WhatsApp Business-app worden gekopieerd wanneer een nummer voor het eerst wordt verbonden.

Het zijn geen berichtenfouten en ze betekenen niet dat de verbinding is mislukt. Als een synchronisatie de limiet overschrijdt of buiten het venster plaatsvindt, blijft het nummer verbonden en normaal verzenden, maar wordt er minder geschiedenis gekopieerd dan verwacht. Wie ze leest als een verbroken verbinding, verbreekt de verbinding en begint opnieuw. Daardoor gaat meer geschiedenis verloren in plaats van dat die wordt hersteld.

Veelgestelde vragen

Welke fouten moet ik opnieuw proberen?

131016 en 131000, met exponentiële back-off. 130429, 132015 en 133008 verdwijnen vanzelf als je wacht. Al het overige is deterministisch.

Betekent een foutcode dat mijn nummer niet meer verbonden is?

Meestal niet. De meeste gaan over het verzoek, het template of de ontvanger. Verbindingsproblemen verschijnen als account- en kwaliteitswebhooks, niet als verzendfouten.

Wat is een trace id?

Een identificatie in het foutantwoord waarmee Meta-support het specifieke verzoek kan vinden. Log deze bij elke fout. Zonder deze identificatie kan een ticket niet worden behandeld.

Zijn deze codes bij elke provider hetzelfde?

Ja. Ze komen uit Meta's Cloud API en zijn dus identiek, ongeacht welke provider het nummer heeft verbonden. Een provider kan alleen bepalen hoe duidelijk ze jou bereiken.

Klaar om te beginnen?

Stel WhatsApp Coexistence in enkele minuten in, niet maanden. De app blijft op je telefoon werken.

Start je gratis proefperiode7 dagen lang niets betalen. Annuleer op elk moment.

Lees verder

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.