AnmeldenKostenlose Testphase starten
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.

EasyCoexistence überwacht die Verbindung kontinuierlich und zeichnet Metas Konto- und Qualitätsereignisse in der Verbindungschronik auf.

Standardmäßig keine NachrichtenspeicherungBusiness App + Cloud APIMCP für Claude und ChatGPTIn 2 Minuten live

Anfrage

CodeBedeutungWiederholen
100Ein Parameter wird nicht unterstützt, ist falsch geschrieben oder fehlerhaft formatiert.Nein
131008Ein Pflichtparameter fehlt vollständig.Nein
131009Ein Parameter ist vorhanden, aber mit einem Wert, den der Endpoint ablehnt.Nein
131021Absender und Empfänger sind dieselbe Nummer.Nein
131051Der Nachrichtentyp wird nicht unterstützt, oft eine Einschränkung von Coexistence.Nein
131052Meta konnte Medien, die ein Kunde gesendet hat, nicht herunterladen.Nein
131053Meta konnte Medien, die Sie gesendet haben, nicht hochladen. Größe, Format oder Erreichbarkeit.Nein

Template

CodeBedeutungWiederholen
132000Die Anzahl der Parameter stimmt nicht mit dem Template überein.Nein
132001Für dieses Paar aus Name und Sprache existiert kein Template.Nein
132007Das Template verstößt gegen die Messaging-Richtlinien. Überarbeiten und erneut einreichen.Nein
132012Das Parameterformat entspricht nicht der Definition im Template.Nein
132015Das Template ist nach einem Qualitätsrückgang pausiert. Vorübergehend.Warten
132016Das Template ist dauerhaft deaktiviert. Es kommt nicht zurück.Nein

Zeitfenster und Empfänger

CodeBedeutungWiederholen
131047Das 24-Stunden-Kundenservicefenster ist geschlossen. Senden Sie ein Template.Nein
131026Der Empfänger kann die Nachricht überhaupt nicht empfangen.Nein
131050Die Person hat sich abgemeldet. Es gibt bewusst keinen Umweg.Nein
130497Nachrichten in dieses Land sind für Ihr Konto eingeschränkt.Nein

Registrierung und PIN

CodeBedeutungWiederholen
131045Die Nummer wurde nie für Nachrichten über die Cloud API registriert.Nein
133010Die Nummer ist nicht registriert. Die Registrierung muss abgeschlossen werden.Nein
133006Die Nummer muss verifiziert werden, bevor sie registriert werden kann.Nein
133005Die PIN der Zwei-Schritt-Verifizierung war falsch. Hören Sie auf zu raten.Nein
133008Zu viele PIN-Versuche. Die Registrierung ist für eine gewisse Zeit gesperrt.Warten

Zugriff und Konto

CodeBedeutungWiederholen
190Das Zugriffstoken ist abgelaufen oder wurde ungültig gemacht.Nein
368Das Konto ist nach einem Richtlinienverstoß eingeschränkt.Nein
131031Das Konto ist eingeschränkt, oder seine Daten stimmen nicht mit denen von Meta überein.Nein
131042Ein Zahlungsproblem im Unternehmenskonto blockiert den Versand.Nein
131049Meta hat die Nachricht blockiert, um die Gesundheit des Ökosystems zu schützen.Nein

Ratenlimits

CodeBedeutungWiederholen
130429Das Durchsatzlimit des Kontos für Nachrichten wurde erreicht.Warten
131048Ein Spam-Ratenlimit wurde erreicht. Ursache ist die Qualität, nicht das Volumen.Nein
131056Zu viele Nachrichten zwischen Ihrer Nummer und einem einzelnen Empfänger.Nein
80007Das Konto hat sein Limit für Verwaltungsaufrufe erreicht. Meist durch Polling.Warten

Vorübergehend

CodeBedeutungWiederholen
131016Ein Meta-Dienst ist vorübergehend nicht verfügbar.Ja
131000Nicht klassifizierter Fehler. Einmal wiederholen, dann mit der Trace-ID eskalieren.Ja

Coexistence-Synchronisierung

CodeBedeutungWiederholen
2593107Das Limit für die Synchronisierung des Chatverlaufs wurde überschritten.Nein
2593108Eine Synchronisierung wurde außerhalb des 24-Stunden-Synchronisierungsfensters versucht.Nein

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 starten3 Tage lang keine Kosten. Jederzeit kündbar.

Weiterlesen