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.
EasyCoexistence bewaakt de verbinding continu en legt Meta's account- en kwaliteitsgebeurtenissen vast op de verbindingstijdlijn.
Verzoek
| Code | Wat het betekent | Opnieuw proberen |
|---|---|---|
| 100 | Een parameter wordt niet ondersteund, is verkeerd gespeld of onjuist opgebouwd. | Nee |
| 131008 | Een verplichte parameter ontbreekt helemaal. | Nee |
| 131009 | Een parameter is aanwezig met een waarde die het endpoint weigert. | Nee |
| 131021 | Afzender en ontvanger zijn hetzelfde nummer. | Nee |
| 131051 | Het berichttype wordt niet ondersteund, vaak een beperking van Coexistence. | Nee |
| 131052 | Meta kon media die een klant stuurde niet downloaden. | Nee |
| 131053 | Meta kon media die jij verstuurde niet uploaden. Grootte, formaat of bereikbaarheid. | Nee |
Template
| Code | Wat het betekent | Opnieuw proberen |
|---|---|---|
| 132000 | Het aantal parameters komt niet overeen met het template. | Nee |
| 132001 | Er bestaat geen template met die combinatie van naam en taal. | Nee |
| 132007 | Het template schendt het berichtenbeleid. Herschrijf het en dien het opnieuw in. | Nee |
| 132012 | Het parameterformaat komt niet overeen met wat het template definieert. | Nee |
| 132015 | Het template is gepauzeerd na een kwaliteitsdaling. Tijdelijk. | Wachten |
| 132016 | Het template is permanent uitgeschakeld. Het komt niet terug. | Nee |
Venster en ontvanger
| Code | Wat het betekent | Opnieuw proberen |
|---|---|---|
| 131047 | Het klantenservicevenster van 24 uur is gesloten. Stuur een template. | Nee |
| 131026 | De ontvanger kan het bericht helemaal niet ontvangen. | Nee |
| 131050 | De persoon heeft zich afgemeld. Er is bewust geen omweg. | Nee |
| 130497 | Berichten naar dat land zijn beperkt voor je account. | Nee |
Registratie en pincode
| Code | Wat het betekent | Opnieuw proberen |
|---|---|---|
| 131045 | Het nummer is nooit geregistreerd voor berichten via de Cloud API. | Nee |
| 133010 | Het nummer is niet geregistreerd. De registratie moet worden afgerond. | Nee |
| 133006 | Het nummer moet worden geverifieerd voordat het kan worden geregistreerd. | Nee |
| 133005 | De pincode voor tweestapsverificatie was onjuist. Stop met raden. | Nee |
| 133008 | Te veel pogingen met de pincode. De registratie is een tijd geblokkeerd. | Wachten |
Toegang en account
| Code | Wat het betekent | Opnieuw proberen |
|---|---|---|
| 190 | Het toegangstoken is verlopen of ongeldig gemaakt. | Nee |
| 368 | Het account is beperkt na een beleidsschending. | Nee |
| 131031 | Het account is beperkt, of de gegevens ervan komen niet overeen met die van Meta. | Nee |
| 131042 | Een betalingsprobleem op het zakelijke account blokkeert het verzenden. | Nee |
| 131049 | Meta heeft het bericht geblokkeerd om de gezondheid van het ecosysteem te beschermen. | Nee |
Snelheidslimieten
| Code | Wat het betekent | Opnieuw proberen |
|---|---|---|
| 130429 | De doorvoerlimiet voor berichten van het account is bereikt. | Wachten |
| 131048 | Een spamlimiet is bereikt. De oorzaak is kwaliteit, niet volume. | Nee |
| 131056 | Te veel berichten tussen je nummer en één ontvanger. | Nee |
| 80007 | Het account heeft zijn limiet voor beheeraanroepen bereikt. Meestal door polling. | Wachten |
Tijdelijk
Coexistence-synchronisatie
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 proefperiode3 dagen lang niets betalen. Annuleer op elk moment.