Meta Tech Provider

Fehlercodes der WhatsApp Cloud API

Hier finden Sie jeden WhatsApp Cloud API-Fehlercode, den wir dokumentieren, in einer Tabelle. Dazu gehören die Bedeutung und die Frage, ob ein erneuter Versuch hilft. Die meisten nicht: Sie sind deterministisch, daher schlägt dieselbe Anfrage immer gleich fehl und eine Wiederholungsschleife macht aus einer fehlerhaften Anfrage ein Rate Limit.

Keine Speicherung von NachrichtenBusiness App + Cloud APIMCP für Claude und ChatGPTIn 2 Minuten live

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

So lesen Sie die Spalte für erneute Versuche

Sie enthält drei Werte. Die falsche Wahl zwischen ihnen ist der teuerste Fehler in dieser gesamten Referenz.

Nein bedeutet, dass der Fehler deterministisch ist. Die Anfrage, das Template oder der Status des Empfängers ist fehlgeschlagen. Dieselbe Anfrage erneut zu senden erzeugt denselben Fehler und verbraucht Durchsatz, den Sie später benötigen. Ja bedeutet, dass der Fehler auf Metas Seite lag und eine Backoff-Strategie ihn tatsächlich behebt. Warten bedeutet, dass die Bedingung real, aber vorübergehend ist: ein Limit oder eine Sperre, die sich von selbst aufhebt. Ein erneuter Versuch davor bewirkt nichts und kann die Sperre verlängern.

Warum die meisten dieser Fehler nicht durch erneute Versuche behoben werden

Weil die Plattform spezifische statt allgemeiner Fehlercodes zurückgibt. Ein fehlerhafter Parameter, ein nicht vorhandenes Template, ein geschlossenes Nachrichtenfenster und ein abgemeldeter Empfänger sind bereits bei der Antwort erkennbar. Deshalb benennt Meta sie, statt vage fehlzuschlagen.

Ein Problem mit der Anfrage wird beim zweiten Versuch nicht korrekt.
Ein Template-Problem liegt im Template, das die Anfrage nicht ändern kann.
Ein Problem mit einem Fenster oder einer Abmeldung betrifft den Status des Empfängers, nicht Ihren.
Eine Kontoeinschränkung ist eine Entscheidung. Ein erneuter Versuch ist kein Einspruch.

Was Sie beim Auftreten eines dieser Fehler protokollieren sollten

Genug, um den Fehler ohne Reproduktion zu diagnostizieren. Das ist der Unterschied zwischen einer Lösung in fünf Minuten und einem Tag voller Vermutungen.

Die vollständige Fehlerantwort einschließlich trace id, das der Meta-Support anfordert.
Den gesendeten Anfrage-Body, nicht den beabsichtigten. Die Abweichung zwischen beiden ist meist der Fehler.
Die phone number id, damit sich ein Problem bei einer Nummer von einem kontoweiten Problem unterscheiden lässt.
Den Zeitstempel, damit sich der Fehler mit dem Status der Verbindung zu diesem Zeitpunkt abgleichen lässt.

Die Codes, die nur bei Coexistence vorkommen

Zwei davon sorgen für Verwirrung, weil sie wie gewöhnliche Sendefehler aussehen. 2593107 und 2593108 betreffen beide die Synchronisierung des Chatverlaufs. Dabei werden aktuelle Unterhaltungen kopiert, wenn eine Nummer erstmals verbunden wird.

Es handelt sich nicht um Nachrichtenfehler, und sie bedeuten nicht, dass die Verbindung fehlgeschlagen ist. Überschreitet eine Synchronisierung ihr Limit oder läuft sie außerhalb ihres Zeitfensters, bleibt die Nummer verbunden und kann normal senden. Es wird nur weniger Verlauf kopiert als erwartet. Wer sie als unterbrochene Verbindung liest, trennt die Verbindung und beginnt erneut. Dadurch geht mehr Verlauf verloren, statt wiederhergestellt zu werden.

Häufig gestellte Fragen

Welche Fehler sollte ich erneut versuchen?

131016 und 131000 mit exponentieller Backoff-Strategie. 130429, 132015 und 133008 klären sich von selbst, wenn Sie warten. Alles andere ist deterministisch.

Bedeutet ein Fehlercode, dass meine Nummer getrennt ist?

Normalerweise nicht. Die meisten betreffen die Anfrage, das Template oder den Empfänger. Verbindungsprobleme erscheinen als Konto- und Qualitäts-Webhooks, nicht als Versandfehler.

Was ist eine trace id?

Eine Kennung in der Fehlerantwort, mit der der Meta-Support die konkrete Anfrage findet. Protokollieren Sie sie bei jedem Fehler. Ohne sie kann ein Ticket nicht bearbeitet werden.

Sind diese Codes bei jedem Anbieter gleich?

Ja. Sie stammen aus Metas Cloud API und sind daher identisch, unabhängig davon, welcher Anbieter die Nummer verbunden hat. Ein Anbieter kann nur beeinflussen, wie klar sie Sie erreichen.

Bereit für den Start?

Richten Sie WhatsApp Coexistence in wenigen Minuten statt Monaten ein. Die App funktioniert weiterhin auf dem Telefon.

Kostenlose Testphase starten7 Tage lang keine Kosten. Jederzeit kündbar.

Weiterlesen

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.