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.
Anfrage
| Code | Bedeutung | Wiederholen |
|---|---|---|
| 100 | Ein Parameter wird nicht unterstützt, ist falsch geschrieben oder fehlerhaft formatiert. | Nein |
| 131008 | Ein Pflichtparameter fehlt vollständig. | Nein |
| 131009 | Ein Parameter ist vorhanden, aber mit einem Wert, den der Endpoint ablehnt. | Nein |
| 131021 | Absender und Empfänger sind dieselbe Nummer. | Nein |
| 131051 | Der Nachrichtentyp wird nicht unterstützt, oft eine Einschränkung von Coexistence. | Nein |
| 131052 | Meta konnte Medien, die ein Kunde gesendet hat, nicht herunterladen. | Nein |
| 131053 | Meta konnte Medien, die Sie gesendet haben, nicht hochladen. Größe, Format oder Erreichbarkeit. | Nein |
Template
| Code | Bedeutung | Wiederholen |
|---|---|---|
| 132000 | Die Anzahl der Parameter stimmt nicht mit dem Template überein. | Nein |
| 132001 | Für dieses Paar aus Name und Sprache existiert kein Template. | Nein |
| 132007 | Das Template verstößt gegen die Messaging-Richtlinien. Überarbeiten und erneut einreichen. | Nein |
| 132012 | Das Parameterformat entspricht nicht der Definition im Template. | Nein |
| 132015 | Das Template ist nach einem Qualitätsrückgang pausiert. Vorübergehend. | Warten |
| 132016 | Das Template ist dauerhaft deaktiviert. Es kommt nicht zurück. | Nein |
Zeitfenster und Empfänger
| Code | Bedeutung | Wiederholen |
|---|---|---|
| 131047 | Das 24-Stunden-Kundenservicefenster ist geschlossen. Senden Sie ein Template. | Nein |
| 131026 | Der Empfänger kann die Nachricht überhaupt nicht empfangen. | Nein |
| 131050 | Die Person hat sich abgemeldet. Es gibt bewusst keinen Umweg. | Nein |
| 130497 | Nachrichten in dieses Land sind für Ihr Konto eingeschränkt. | Nein |
Registrierung und PIN
| Code | Bedeutung | Wiederholen |
|---|---|---|
| 131045 | Die Nummer wurde nie für Nachrichten über die Cloud API registriert. | Nein |
| 133010 | Die Nummer ist nicht registriert. Die Registrierung muss abgeschlossen werden. | Nein |
| 133006 | Die Nummer muss verifiziert werden, bevor sie registriert werden kann. | Nein |
| 133005 | Die PIN der Zwei-Schritt-Verifizierung war falsch. Hören Sie auf zu raten. | Nein |
| 133008 | Zu viele PIN-Versuche. Die Registrierung ist für eine gewisse Zeit gesperrt. | Warten |
Zugriff und Konto
| Code | Bedeutung | Wiederholen |
|---|---|---|
| 190 | Das Zugriffstoken ist abgelaufen oder wurde ungültig gemacht. | Nein |
| 368 | Das Konto ist nach einem Richtlinienverstoß eingeschränkt. | Nein |
| 131031 | Das Konto ist eingeschränkt, oder seine Daten stimmen nicht mit denen von Meta überein. | Nein |
| 131042 | Ein Zahlungsproblem im Unternehmenskonto blockiert den Versand. | Nein |
| 131049 | Meta hat die Nachricht blockiert, um die Gesundheit des Ökosystems zu schützen. | Nein |
Ratenlimits
| Code | Bedeutung | Wiederholen |
|---|---|---|
| 130429 | Das Durchsatzlimit des Kontos für Nachrichten wurde erreicht. | Warten |
| 131048 | Ein Spam-Ratenlimit wurde erreicht. Ursache ist die Qualität, nicht das Volumen. | Nein |
| 131056 | Zu viele Nachrichten zwischen Ihrer Nummer und einem einzelnen Empfänger. | Nein |
| 80007 | Das Konto hat sein Limit für Verwaltungsaufrufe erreicht. Meist durch Polling. | Warten |
Vorübergehend
Coexistence-Synchronisierung
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.