Cloud API-Fehlercodes

Die Cloud API basiert auf der Graph API. Sieh dir also die Graph API-Dokumentation zum Umgang mit Fehlern an, falls der Umgang mit Graph API-Fehlerantworten Neuland für dich ist.

Generell empfehlen wir, dass du die Fehlerbehandlungslogik deiner App um code-Werte und details-Payload-Eigenschaften herum aufbaust. Diese Eigenschaften und ihre Werte geben eher Aufschluss über den zugrunde liegenden Fehler.

Code-Titel, die in Payloads von API-Fehlerantworten keine eigene Eigenschaft haben, sind im Wert message enthalten. Wir empfehlen jedoch, dich bei der Fehlerbehandlungslogik nicht allein auf Titel zu verlassen, da diese früher oder später veraltet sind.

Fehlerempfang: Synchron und asynchron

Cloud API-Fehler werden entweder synchron als Graph API-Antwort oder asynchron per Webhook oder auch manchmal über beide Methoden zurückgegeben.

Du solltest bei der Arbeit mit der Cloud API sowohl die Graph API-Antwort als auch den messages-Webhook für die Fehlerbehandlung überwachen. Wenn du das messages-Webhook-Feld abonniert hast, erhältst du Benachrichtigungen über Fehler, wenn unterstützte asynchrone Fehlertypen auftreten.

Webhooks und Syntax für Fehlerantworten

Cloud API-Fehler können in den folgenden Webhook-Objekten angezeigt werden:

Cloud API

entry.changes.value.errors
entry.changes.value.messages.errors

On-Premises API

errors

Syntax für Fehlerantworten

{
  "error": {
    "message": "<MESSAGE>",
    "type": "<TYPE>",
    "code": <CODE>,
    "error_data": {
        "messaging_product": "whatsapp",
        "details": "<DETAILS>"
    },
    "error_subcode": <ERROR_SUBCODE>
    "fbtrace_id": "<FBTRACE_ID>"
  }
}

Fehlerantwortinhalte

Eigenschaft	Werttyp	Beschreibung
`code`	Integer	Fehlercode. Wir empfehlen dir, die Fehlerbehandlung deiner App um Fehlercodes statt um Subcodes oder HTTP-Antwort-Statuscodes herum aufzubauen.
`details`	String	Beschreibung des Fehlers und des wahrscheinlichsten Grunds für den Fehler. Kann auch Informationen zur Behebung des Fehlers beinhalten, etwa Angaben dazu, welcher Parameter ungültig ist oder welche Werte akzeptabel sind.
`error_subcode`	Integer	Veraltet. Wird nicht in v16.0+-Antworten zurückgegeben. Graph API-Subcode Nicht alle Antworten beinhalten einen Subcode. Daher empfehlen wir dir, deine Fehlerbehandlungslogik stattdessen um die Eigenschaften `code` und `details` herum aufzubauen.
`fbtrace_id`	String	Eine Trace-ID, die du einbinden kannst, wenn du den Direct Support kontaktierst. Die ID kann uns helfen, den Fehler zu beheben.
`message`	String	Kombination aus Fehlercode und zugehörigem Titel. Beispiel: `(#130429) Rate limit hit`.
`messaging_product`	String	Messaging-Produkt. Für Cloud API-Antworten ist dies immer der String `whatsapp`.
`type`	String	Fehlertyp.

Beispielantwort

{
  "error": {
    "message": "(#130429) Rate limit hit",
    "type": "OAuthException",
    "code": 130429,
    "error_data": {
        "messaging_product": "whatsapp", 
        "details": "Message failed to send because there were too many messages sent from this phone number in a short period of time"
    },
    "error_subcode": 2494055,
    "fbtrace_id": "Az8or2yhqkZfEZ-_4Qn_Bam"
  }
}

Fehlercodes

Autorisierungsfehler

Code	Beschreibung	Mögliche Lösungen	HTTP-Statuscode
`0` AuthException	Die Authentifizierung desder App-Benutzerin ist fehlgeschlagen.	Das bedeutet in der Regel, dass das eingebundene Zugriffstoken abgelaufen ist oder ungültig gemacht wurde oder dass derdie App-Benutzerin eine Einstellung verändert hat, um alle Apps am Zugriff auf seine*ihre Daten zu hindern. Wir empfehlen dir, ein neues Zugriffstoken anzufordern.	`401` Nicht autorisiert
`3` API-Methode	Problem mit Funktionen oder Berechtigungen.	Verwende den Zugriffstoken-Debugger, um zu bestätigen, dass deine App die vom Endpunkt verlangten Berechtigungen erhalten hat. Siehe Fehlerbehebung.	`500` Interner Serverfehler
`10` Berechtigung verweigert	Die Berechtigung wurde entweder entzogen oder nicht erteilt.	Verwende den Zugriffstoken-Debugger, um zu bestätigen, dass deine App die vom Endpunkt verlangten Berechtigungen erhalten hat. Siehe Fehlerbehebung. Vergewissere dich, dass die Telefonnummer, die zum Festlegen des öffentlichen Schlüssels des Unternehmens verwendet wurde, auf die Positivliste gesetzt wurde.	`403` Unzulässig
`190` Zugriffstoken ist abgelaufen	Dein Zugriffstoken ist abgelaufen.	Rufe ein neues Zugriffstoken ab.	`401` Nicht autorisiert
`200-299` API-Berechtigung	Die Berechtigung wurde entweder entzogen oder nicht erteilt.	Verwende den Zugriffstoken-Debugger, um zu bestätigen, dass deine App die vom Endpunkt verlangten Berechtigungen erhalten hat. Siehe Fehlerbehebung.	`403` Unzulässig

Drosselungsfehler

Code	Beschreibung	Mögliche Lösungen	HTTP-Statuscode
`4` Zu viele API-Aufrufe	Die App hat ihre Ratenbegrenzung für API-Aufrufe erreicht.	Lade die App im App-Dashboard und sieh dir den Bereich Ratenbegrenzung für Anwendung an, um zu verifizieren, dass die App ihre Ratenbegrenzung erreicht hat. Falls dies der Fall ist, versuche es später noch einmal oder reduziere die Frequenz oder Menge der API-Aufrufe, die die App tätigt.	`400` Fehlerhafte Anfrage
`80007` Probleme mit der Ratenbegrenzung	Das WhatsApp-Unternehmenskonto hat seine Ratenbegrenzung erreicht.	Siehe Ratenbegrenzungen für WhatsApp Business-Konten. Versuche es später noch einmal oder reduziere die Frequenz oder Menge der API-Aufrufe, die die App tätigt.	`400` Fehlerhafte Anfrage
`130429` Ratenbegrenzung erreicht	Das Nachrichtendurchsatz-Limit der Cloud API wurde erreicht.	Die App hat das Durchsatz-Limit der API erreicht. Siehe Durchsatz. Versuche es später noch einmal oder reduziere die Frequenz, in der die App Nachrichten sendet.	`400` Fehlerhafte Anfrage
`131048` Spam-Ratenbegrenzung erreicht	Die Nachricht konnte nicht gesendet werden, weil von dieser Telefonnummer nur eine begrenzte Anzahl von Nachrichten gesendet werden kann. Der Grund hierfür kann sein, dass zu viele vorherige Nachrichten blockiert oder als Spam markiert wurden.	Prüfe deinen Qualitätsstatus im WhatsApp Manager und sieh dir die Dokumentation zu qualitätsbasierten Ratenbegrenzungen an, um mehr zu erfahren.	`400` Fehlerhafte Anfrage
`131056` (Unternehmenskonto, Verbraucher*innen-Konto) Kopplungsratenbegrenzung erreicht	Es wurden innerhalb kurzer Zeit zu viele Nachrichten von der sendenden Telefonnummer an dieselbe empfangende Telefonnummer geschickt.	Warte und versuche es erneut, wenn du Nachrichten an dieselbe Telefonnummer senden möchtest. Du kannst weiterhin Nachrichten an eine andere Telefonnummer senden, ohne zu warten.	`400` Fehlerhafte Anfrage
`133016` Ratenbegrenzung für Registrierung/Deregistrierung von Konten überschritten	Die Registrierung oder Deregistrierung ist aufgrund zu vieler Versuche mit dieser Telefonnummer in einem kurzen Zeitraum fehlgeschlagen.	Die Unternehmenstelefonnummer wird blockiert, weil sie die Begrenzung für Registrierungs-/Deregistrierungsversuche erreicht hat. Versuche es noch einmal, sobald die Telefonnummer nicht mehr blockiert ist. Siehe „Einschränkungen“ im Dokument Registrierung.	`400` Fehlerhafte Anfrage

Integrity-Fehler

Code Beschreibung Mögliche Lösungen HTTP-Statuscode

Code	Beschreibung	Mögliche Lösungen	HTTP-Statuscode
`368` Aufgrund von Richtlinienverstößen vorübergehend gesperrt	Das mit der App verknüpfte WhatsApp-Unternehmenskonto wurde aufgrund eines Verstoßes gegen eine Plattformrichtlinie eingeschränkt oder deaktiviert.	Im Dokument Richtliniendurchsetzung erfährst du mehr über Richtlinienverstöße und wie du sie beheben kannst.	`403` Unzulässig
`130497` Über das Unternehmenskonto ist es nicht möglich, Nachrichten an Benutzer*innen in diesem Land zu senden.	Über das WhatsApp-Unternehmenskonto ist es nicht möglich, Nachrichten an Benutzer*innen in bestimmten Ländern zu senden.	Weitere Informationen zu den zulässigen Ländern für Nachrichten in deiner Unternehmenskategorie findest du in der WhatsApp Business Messaging-Richtlinie.	`403` Unzulässig
`131031` Konto wurde gesperrt	Das mit der App verknüpfte WhatsApp-Unternehmenskonto wurde aufgrund eines Verstoßes gegen eine Plattformrichtlinie eingeschränkt oder deaktiviert oder wir konnten die in der Anfrage enthaltenen Daten nicht anhand der zum WhatsApp-Unternehmenskonto gehörigen Daten verifizieren (z. B., weil die in der Anfrage enthaltene PIN zur Verifizierung in zwei Schritten nicht korrekt ist).	Im Dokument Richtliniendurchsetzung erfährst du mehr über Richtlinienverstöße und wie du sie beheben kannst. Du kannst auch die Health Status API verwenden, die ggf. zusätzliche Einblicke in den Grund oder die Gründe für die Kontosperre bietet.	`403` Unzulässig

368

Aufgrund von Richtlinienverstößen vorübergehend gesperrt

Das mit der App verknüpfte WhatsApp-Unternehmenskonto wurde aufgrund eines Verstoßes gegen eine Plattformrichtlinie eingeschränkt oder deaktiviert.

Im Dokument Richtliniendurchsetzung erfährst du mehr über Richtlinienverstöße und wie du sie beheben kannst.

403

Unzulässig

130497

Über das Unternehmenskonto ist es nicht möglich, Nachrichten an Benutzer*innen in diesem Land zu senden.

Über das WhatsApp-Unternehmenskonto ist es nicht möglich, Nachrichten an Benutzer*innen in bestimmten Ländern zu senden.

Weitere Informationen zu den zulässigen Ländern für Nachrichten in deiner Unternehmenskategorie findest du in der WhatsApp Business Messaging-Richtlinie.

403

Unzulässig

131031

Konto wurde gesperrt

Das mit der App verknüpfte WhatsApp-Unternehmenskonto wurde aufgrund eines Verstoßes gegen eine Plattformrichtlinie eingeschränkt oder deaktiviert oder wir konnten die in der Anfrage enthaltenen Daten nicht anhand der zum WhatsApp-Unternehmenskonto gehörigen Daten verifizieren (z. B., weil die in der Anfrage enthaltene PIN zur Verifizierung in zwei Schritten nicht korrekt ist).

Im Dokument Richtliniendurchsetzung erfährst du mehr über Richtlinienverstöße und wie du sie beheben kannst.

Du kannst auch die Health Status API verwenden, die ggf. zusätzliche Einblicke in den Grund oder die Gründe für die Kontosperre bietet.

403

Unzulässig

Sonstige Fehler

Code Beschreibung Mögliche Lösungen HTTP-Statuscode

Code	Beschreibung	Mögliche Lösungen	HTTP-Statuscode
`1` API unbekannt	Ungültige Anfrage oder möglicher Serverfehler.	Prüfe die Seite Status der WhatsApp Business Platform, um API-Statusinformationen einzusehen. Wenn keine Serverausfälle vorliegen, prüfe die Endpunkt-Referenz und verifiziere, dass deine Anfrage korrekt formatiert ist und alle Anforderungen des Endpunkts erfüllt.	`400` Fehlerhafte Anfrage
`2` API-Dienst	Temporär aufgrund von Downtime oder Überlastung.	Prüfe die Seite WhatsApp Business Platform-Status, um die API-Statusinformationen einzusehen, bevor du es erneut versuchst.	`503` Dienst nicht verfügbar
`33` Parameterwert ist ungültig	Die Telefonnummer des Unternehmens wurde gelöscht.	Vergewissere dich, dass die Telefonnummer des Unternehmens richtig ist.	`400` Fehlerhafte Anfrage
`100` Ungültiger Parameter	Die Anfrage beinhaltete einen oder mehrere nicht unterstützte oder falsch geschriebene Parameter.	Beachte die Endpunkt-Referenz, um zu ermitteln, welche Parameter unterstützt werden und wie sie geschrieben werden. Vergewissere dich beim Festlegen des öffentlichen Schlüssels des Unternehmens, dass es sich um einen gültigen öffentlichen 2048-Bit-RSA-Schlüssel im PEM-Format handelt. Vergewissere dich, dass die Telefonnummer-ID, die du registrierst, und die zuvor gespeicherte Telefonnummer übereinstimmen. Stelle sicher, dass dein Parameter unter der Längenbeschränkung des entsprechenden Typs liegt.	`400` Fehlerhafte Anfrage
`130472` Die Nummer desder Benutzerin ist Teil eines Experiments	Nachricht wurde nicht im Rahmen eines Experiments gesendet.	Siehe Marketing-Nachrichten-Experiment.	`400` Fehlerhafte Anfrage
`131000` Leider ist etwas schiefgelaufen.	Die Nachricht konnte aufgrund eines unbekannten Fehlers nicht gesendet werden. Beim Festlegen eines öffentlichen Schlüssels für das Unternehmen konnte entweder die Unterschrift nicht berechnet oder der GraphQL-Endpunkt nicht aufgerufen werden, oder der GraphQL-Endpunkt hat einen Fehler zurückgegeben.	Versuche es noch einmal. Wenn der Fehler bestehen bleibt, öffne ein Direct Support-Ticket.	`500` Interner Serverfehler
`131005` Zugriff verweigert	Die Berechtigung wurde entweder entzogen oder nicht erteilt.	Verwende den Zugriffstoken-Debugger, um zu bestätigen, dass deine App die vom Endpunkt verlangten Berechtigungen erhalten hat. Siehe Fehlerbehebung.	`403` Unzulässig
`131008` Erforderlicher Parameter fehlt	In der Anfrage fehlt ein erforderlicher Parameter.	Beachte die Endpunkt-Referenz, um zu ermitteln, welche Parameter erforderlich sind.	`400` Fehlerhafte Anfrage
`131009` Parameterwert ist ungültig	Mindestens ein Parameterwert ist ungültig.	Beachte die Endpunkt-Referenz, um zu ermitteln, welche Werte für jeden Parameter unterstützt werden. Unter Telefonnummern erfährst du außerdem, wie du eine Telefonnummer zu einem WhatsApp-Unternehmenskonto hinzufügst.	`400` Fehlerhafte Anfrage
`131016` Dienst nicht verfügbar	Ein Dienst ist vorübergehend nicht verfügbar.	Prüfe die Seite Status der WhatsApp Business Platform, um API-Statusinformationen einzusehen, bevor du es erneut versuchst.	`500` Interner Serverfehler
`131021` Empfängerin kann nicht gleich Absenderin sein	Die sendende Telefonnummer ist mit der empfangenden Telefonnummer identisch.	Schicke eine Nachricht an eine Telefonnummer, die sich von der sendenden Telefonnummer unterscheidet.	`400` Fehlerhafte Anfrage
`131026` Nachricht ist nicht zustellbar	Die Nachricht kann nicht zugestellt werden. Dies kann u. a. folgende Gründe haben: Die Telefonnummer desder Empfängerin ist keine WhatsApp-Telefonnummer. Es wurde eine Authentifizierungsvorlage an einen WhatsApp-Benutzerin mit der Landesvorwahl +91 (Indien) gesendet. Authentifizierungsvorlagen können derzeit nicht an WhatsApp-Benutzerinnen in Indien gesendet werden. Derdie Empfängerin hat unsere neuen Nutzungsbedingungen und die neue Datenschutzrichtlinie nicht akzeptiert. Derdie Empfänger*in verwendet eine alte WhatsApp-Version und muss mindestens die folgende WhatsApp-Version verwenden: Android: 2.21.15.15 SMBA: 2.21.15.15 iOS: 2.21.170.4 SMBI: 2.21.170.4 KaiOS: 2.2130.10 Web: 2.2132.6	Bitte dendie WhatsApp-Benutzerin außerhalb von WhatsApp, Folgendes zu tun: Bestätigen, dass ersie tatsächlich eine Nachricht an deine WhatsApp-Unternehmenstelefonnummer senden kann. Bestätigen, dass ersie unsere aktuellen Nutzungsbedingungen akzeptiert hat (unter Einstellungen > Hilfe oder Einstellungen > Anwendungsinformationen kann ersie die aktuellen Nutzungsbedingungen/Richtlinien akzeptieren, wenn ersie dies noch nicht getan hat) Auf die neueste Version des WhatsApp-Clients aktualisieren	`400` Fehlerhafte Anfrage
`131042` Berechtigung des Unternehmens – Zahlungsproblem	Im Zusammenhang mit deiner Zahlungsmethode ist ein Fehler aufgetreten.	Sieh dir die Seite Abrechnungsinformationen zu deinem WhatsApp-Unternehmenskonto an und verifiziere, dass du die richtigen Abrechnungseinstellungen vorgenommen hast. Häufige Probleme: Zahlungskonto ist nicht mit einem WhatsApp-Unternehmenskonto verknüpft Kreditlinie wurde überschritten Kreditlinie (Zahlungskonto) ist nicht festgelegt oder ist nicht aktiv WhatsApp-Unternehmenskonto wurde gelöscht WhatsApp-Unternehmenskonto wurde suspendiert Keine Zeitzone festgelegt Keine Währung festgelegt MessagingFor-Anfrage (im Namen von) ist offen oder wurde abgelehnt Die Höchstanzahl der kostenlosen Unterhaltungen wurde ohne eine gültige Zahlungsmethode überschritten	`400` Fehlerhafte Anfrage
`131045` Fehlerhaftes Zertifikat	Senden der Nachricht ist aufgrund eines Telefonnummer-Registrierungsfehlers fehlgeschlagen.	Registriere die Telefonnummer, bevor du es wieder versuchst.	`500` Interner Serverfehler
`131047` Nachricht für erneute Interaktion	Mehr als 24 Stunden sind vergangen, seitdem derdie Empfängerin eine Antwort an die sendende Telefonnummer geschickt hat.	Sende stattdessen eine vom Unternehmen initiierte Nachricht an dendie Empfängerin und verwende dafür eine Nachrichtenvorlage.	`400` Fehlerhafte Anfrage
`131049` Meta hat sich gegen die Zustellung dieser Nachricht entschieden.	Diese Nachricht wurde nicht zugestellt, um fehlerfreie Interaktionen im Ökosystem aufrechtzuerhalten.	Wenn du diesen Fehlercode erhältst und vermutest, dass er auf das Limit zurückzuführen ist, versuche es nicht sofort erneut. Versuche es stattdessen in immer größeren Zeitschritten erneut, bis die Nachricht zugestellt wird, da die Beschränkung für unterschiedliche Zeiträume gelten kann. Weitere Informationen findest du unter Nachrichtenbeschränkungen für Marketingvorlagen pro Benutzer*in.	`400` Fehlerhafte Anfrage
`131051` Nicht unterstützter Nachrichtentyp	Nicht unterstützter Nachrichtentyp.	Beachte Nachrichten für Informationen zu unterstützten Nachrichtentypen und versuche es dann mit einem unterstützten Nachrichtentyp erneut.	`400` Fehlerhafte Anfrage
`131052` Fehler beim Medien-Download	Die von demder Benutzerin gesendeten Medien können nicht heruntergeladen werden.	Die in der Nachricht desder WhatsApp-Benutzerin enthaltenen Medien konnten nicht heruntergeladen werden. Weitere Informationen findest du im Wert `error.error_data.details` in beliebigen messages-Webhooks, die bei Erhalt dieser Nachricht ausgelöst werden. Bitte dendie WhatsApp-Benutzerin, die Mediendatei außerhalb von WhatsApp zu senden.	`400` Fehlerhafte Anfrage
`131053` Fehler beim Medien-Upload	Die in der Nachricht verwendeten Medien konnten nicht hochgeladen werden.	Die Medien konnten aus einem Grund oder mehreren Gründen nicht hochgeladen werden, z. B. aufgrund eines nicht unterstützten Medientyps. Weitere Informationen findest du im Wert `error.error_data.details` in beliebigen messages-Webhooks, die ausgelöst werden, wenn diese Nachricht nicht gesendet werden kann. Wir empfehlen dir, alle Mediendateien zu überprüfen, die Fehler verursachen, und sicherzustellen, dass sie tatsächlich unterstützt werden. Unter UNIX kannst du beispielsweise die Dateiinspektion über die Befehlszeile verwenden, um den MIME-Typ zu ermitteln: `file -I rejected-file.mov` Anschließend kannst du überprüfen, ob der MIME-Typ unterstützt wird. Siehe Unterstützte Medientypen.	`400` Fehlerhafte Anfrage
`131057` Konto in Wartungsmodus	Unternehmenskonto ist im Wartungsmodus	Das WhatsApp-Unternehmenskonto ist im Wartungsmodus. Eine Ursache dafür könnte sein, dass für das Konto ein Durchsatz-Upgrade durchgeführt wird.	`500` Fehlerhafte Anfrage
`132000` Unstimmigkeit bei Vorlagenparameterzahl	Die Anzahl der in der Anfrage enthaltenen variablen Parameter stimmt nicht mit der in der Vorlage definierten Anzahl variabler Parameter überein.	Beachte die Richtlinien zu Nachrichtenvorlagen und stelle sicher, dass die Anfrage alle variablen Parameterwerte beinhaltet, die in der Vorlage definiert wurden.	`400` Fehlerhafte Anfrage
`132001` Vorlage existiert nicht	Die Vorlage ist in der festgelegten Sprache nicht vorhanden oder sie wurde nicht genehmigt.	Stelle sicher, dass deine Vorlage genehmigt wurde und der Name und die Sprache korrekt sind. Vergewissere dich bitte, dass du die Richtlinien zu Nachrichtenvorlagen befolgst.	`404` Nicht gefunden
`132005` Dekomprimierter Vorlagentext zu lang	Übersetzter Text ist zu lang.	Prüfe im WhatsApp Manager, ob deine Vorlage übersetzt wurde. Siehe Qualitätsbewertung und Status der Vorlage.	`400` Fehlerhafte Anfrage
`132007` Vorlagenrichtlinie für Formatierungszeichen verletzt	Vorlageninhalt verstößt gegen eine WhatsApp-Richtlinie.	Siehe Ablehnungsgründe, um mögliche Ursachen für den Verstoß zu ermitteln.	`400` Fehlerhafte Anfrage
`132012` Unstimmigkeit bei Vorlagenparameterformat	Variable Parameterwerte sind nicht korrekt formatiert.	Die in der Anfrage enthaltenen variablen Parameter verwenden nicht das in der Vorlage festgelegte Format. Siehe Richtlinien zu Nachrichtenvorlagen.	`400` Fehlerhafte Anfrage
`132015` Vorlage wurde pausiert	Die Vorlage wurde aufgrund der geringen Qualität pausiert. Das heißt, sie kann nicht in einer Vorlagennachricht gesendet werden.	Bearbeite die Vorlage, um ihre Qualität zu verbessern, und versuche es erneut, sobald sie genehmigt wurde.	`400` Fehlerhafte Anfrage
`132016` Vorlage ist deaktiviert	Die Vorlage wurde zu oft wegen geringer Qualität pausiert und wurde nun dauerhaft deaktiviert.	Erstelle eine neue Vorlage mit anderen Inhalten.	`400` Fehlerhafte Anfrage
`132068` Vorgang wurde blockiert	Vorgang befindet sich im Status „Blockiert“.	Vorgang korrigieren	`400` Fehlerhafte Anfrage
`132069` Vorgang wurde gedrosselt	Der Vorgang befindet sich im Status „Gedrosselt“ und 10 Nachrichten, die diesen Vorgang verwenden, wurden in der letzten Stunde bereits gesendet.	Flow korrigieren	`400` Fehlerhafte Anfrage
`133000` Unvollständige Deregistrierung	Ein früherer Deregistrierungsversuch ist fehlgeschlagen.	Deregistriere die Nummer erneut, bevor du sie registrierst.	`500` Interner Serverfehler
`133004` Server vorübergehend nicht verfügbar	Server ist vorübergehend nicht verfügbar.	Prüfe die Seite Status der WhatsApp Business Platform, um die API-Statusinformationen einzusehen, und prüfe den `details`-Wert der Antwort, bevor du es erneut versuchst.	`503` Dienst nicht verfügbar
`133005` Unstimmigkeit bei der PIN für die Verifizierung in zwei Schritten	Die PIN für die Verifizierung in zwei Schritten ist nicht korrekt.	Verifiziere, dass die in der Anfrage enthaltene PIN für die Verifizierung in zwei Schritten korrekt ist. Zum Zurücksetzen der PIN für die Verifizierung in zwei Schritten: Deaktiviere die Autorisierung in zwei Schritten. Sende eine POST-Anfrage mit der neuen PIN an den Telefonnummer-Endpunkt.	`400` Fehlerhafte Anfrage
`133006` Erneute Verifizierung der Telefonnummer erforderlich	Telefonnummer muss vor der Registrierung verifiziert werden.	Verifiziere die Telefonnummer, bevor du sie registrierst.	`400` Fehlerhafte Anfrage
`133008` Zu viele PIN-Eingabeversuche bei der Verifizierung in zwei Schritten	Bei der Verifizierung in zwei Schritten wurden für diese Telefonnummer zu viele PIN-Eingabeversuche getätigt.	Versuche es noch einmal, wenn die im `details`-Antwortwert festgelegte Zeit vergangen ist.	`400` Fehlerhafte Anfrage
`133009` PIN für die Verifizierung in zwei Schritten wurde zu schnell erraten	PIN für die Verifizierung in zwei Schritten wurde zu schnell eingegeben.	Prüfe den `details`-Antwortwert, bevor du es erneut versuchst.	`400` Fehlerhafte Anfrage
`133010` Telefonnummer nicht registriert	Telefonnummer ist nicht auf der WhatsApp Business Platform registriert.	Registriere die Telefonnummer, bevor du es erneut versuchst.	`400` Fehlerhafte Anfrage
`133015` Warte einige Minuten, bevor du versuchst, diese Telefonnummer zu registrieren.	Die Telefonnummer, die du registrieren möchtest, wurde kürzlich gelöscht, und der Löschvorgang ist noch nicht abgeschlossen.	Warte fünf Minuten, bevor du die Anfrage wiederholst.	`400` Fehlerhafte Anfrage
`135000` Generischer Benutzungsfehler	Nachricht konnte aufgrund eines unbekannten Fehlers in Verbindung mit deinen Anfrageparametern nicht gesendet werden.	Beachte die Endpunkt-Referenz, um zu ermitteln, ob du den Endpunkt mit der korrekten Syntax aufrufst. Kontaktiere das Support-Team, wenn du weiterhin diesen Fehlercode als Antwort erhältst.	`400` Fehlerhafte Anfrage

1

API unbekannt

Ungültige Anfrage oder möglicher Serverfehler.

Prüfe die Seite Status der WhatsApp Business Platform, um API-Statusinformationen einzusehen. Wenn keine Serverausfälle vorliegen, prüfe die Endpunkt-Referenz und verifiziere, dass deine Anfrage korrekt formatiert ist und alle Anforderungen des Endpunkts erfüllt.

400

Fehlerhafte Anfrage

2

API-Dienst

Temporär aufgrund von Downtime oder Überlastung.

Prüfe die Seite WhatsApp Business Platform-Status, um die API-Statusinformationen einzusehen, bevor du es erneut versuchst.

503

Dienst nicht verfügbar

33

Parameterwert ist ungültig

Die Telefonnummer des Unternehmens wurde gelöscht.

Vergewissere dich, dass die Telefonnummer des Unternehmens richtig ist.

400

Fehlerhafte Anfrage

100

Ungültiger Parameter

Die Anfrage beinhaltete einen oder mehrere nicht unterstützte oder falsch geschriebene Parameter.

Beachte die Endpunkt-Referenz, um zu ermitteln, welche Parameter unterstützt werden und wie sie geschrieben werden.

Vergewissere dich beim Festlegen des öffentlichen Schlüssels des Unternehmens, dass es sich um einen gültigen öffentlichen 2048-Bit-RSA-Schlüssel im PEM-Format handelt.

Vergewissere dich, dass die Telefonnummer-ID, die du registrierst, und die zuvor gespeicherte Telefonnummer übereinstimmen.

Stelle sicher, dass dein Parameter unter der Längenbeschränkung des entsprechenden Typs liegt.

400

Fehlerhafte Anfrage

130472

Die Nummer des*der Benutzer*in ist Teil eines Experiments

Nachricht wurde nicht im Rahmen eines Experiments gesendet.

Siehe Marketing-Nachrichten-Experiment.

400

Fehlerhafte Anfrage

131000

Leider ist etwas schiefgelaufen.

Die Nachricht konnte aufgrund eines unbekannten Fehlers nicht gesendet werden.

Beim Festlegen eines öffentlichen Schlüssels für das Unternehmen konnte entweder die Unterschrift nicht berechnet oder der GraphQL-Endpunkt nicht aufgerufen werden, oder der GraphQL-Endpunkt hat einen Fehler zurückgegeben.

Versuche es noch einmal. Wenn der Fehler bestehen bleibt, öffne ein Direct Support-Ticket.

500

Interner Serverfehler

131005

Zugriff verweigert

Die Berechtigung wurde entweder entzogen oder nicht erteilt.

Verwende den Zugriffstoken-Debugger, um zu bestätigen, dass deine App die vom Endpunkt verlangten Berechtigungen erhalten hat. Siehe Fehlerbehebung.

403

Unzulässig

131008

Erforderlicher Parameter fehlt

In der Anfrage fehlt ein erforderlicher Parameter.

Beachte die Endpunkt-Referenz, um zu ermitteln, welche Parameter erforderlich sind.

400

Fehlerhafte Anfrage

131009

Parameterwert ist ungültig

Mindestens ein Parameterwert ist ungültig.

Beachte die Endpunkt-Referenz, um zu ermitteln, welche Werte für jeden Parameter unterstützt werden. Unter Telefonnummern erfährst du außerdem, wie du eine Telefonnummer zu einem WhatsApp-Unternehmenskonto hinzufügst.

400

Fehlerhafte Anfrage

131016

Dienst nicht verfügbar

Ein Dienst ist vorübergehend nicht verfügbar.

Prüfe die Seite Status der WhatsApp Business Platform, um API-Statusinformationen einzusehen, bevor du es erneut versuchst.

500

Interner Serverfehler

131021

Empfänger*in kann nicht gleich Absender*in sein

Die sendende Telefonnummer ist mit der empfangenden Telefonnummer identisch.

Schicke eine Nachricht an eine Telefonnummer, die sich von der sendenden Telefonnummer unterscheidet.

400

Fehlerhafte Anfrage

131026

Nachricht ist nicht zustellbar

Die Nachricht kann nicht zugestellt werden. Dies kann u. a. folgende Gründe haben:

Die Telefonnummer des*der Empfänger*in ist keine WhatsApp-Telefonnummer.
Es wurde eine Authentifizierungsvorlage an eine*n WhatsApp-Benutzer*in mit der Landesvorwahl +91 (Indien) gesendet. Authentifizierungsvorlagen können derzeit nicht an WhatsApp-Benutzer*innen in Indien gesendet werden.
Der*die Empfänger*in hat unsere neuen Nutzungsbedingungen und die neue Datenschutzrichtlinie nicht akzeptiert.
Der*die Empfänger*in verwendet eine alte WhatsApp-Version und muss mindestens die folgende WhatsApp-Version verwenden:
- Android: 2.21.15.15
- SMBA: 2.21.15.15
- iOS: 2.21.170.4
- SMBI: 2.21.170.4
- KaiOS: 2.2130.10
- Web: 2.2132.6

Bitte den*die WhatsApp-Benutzer*in außerhalb von WhatsApp, Folgendes zu tun:

Bestätigen, dass er*sie tatsächlich eine Nachricht an deine WhatsApp-Unternehmenstelefonnummer senden kann.
Bestätigen, dass er*sie unsere aktuellen Nutzungsbedingungen akzeptiert hat (unter Einstellungen > Hilfe oder Einstellungen > Anwendungsinformationen kann er*sie die aktuellen Nutzungsbedingungen/Richtlinien akzeptieren, wenn er*sie dies noch nicht getan hat)
Auf die neueste Version des WhatsApp-Clients aktualisieren

400

Fehlerhafte Anfrage

131042

Berechtigung des Unternehmens – Zahlungsproblem

Im Zusammenhang mit deiner Zahlungsmethode ist ein Fehler aufgetreten.

Sieh dir die Seite Abrechnungsinformationen zu deinem WhatsApp-Unternehmenskonto an und verifiziere, dass du die richtigen Abrechnungseinstellungen vorgenommen hast.

Häufige Probleme:

Zahlungskonto ist nicht mit einem WhatsApp-Unternehmenskonto verknüpft
Kreditlinie wurde überschritten
Kreditlinie (Zahlungskonto) ist nicht festgelegt oder ist nicht aktiv
WhatsApp-Unternehmenskonto wurde gelöscht
WhatsApp-Unternehmenskonto wurde suspendiert
Keine Zeitzone festgelegt
Keine Währung festgelegt
MessagingFor-Anfrage (im Namen von) ist offen oder wurde abgelehnt
Die Höchstanzahl der kostenlosen Unterhaltungen wurde ohne eine gültige Zahlungsmethode überschritten

400

Fehlerhafte Anfrage

131045

Fehlerhaftes Zertifikat

Senden der Nachricht ist aufgrund eines Telefonnummer-Registrierungsfehlers fehlgeschlagen.

Registriere die Telefonnummer, bevor du es wieder versuchst.

500

Interner Serverfehler

131047

Nachricht für erneute Interaktion

Mehr als 24 Stunden sind vergangen, seitdem der*die Empfänger*in eine Antwort an die sendende Telefonnummer geschickt hat.

Sende stattdessen eine vom Unternehmen initiierte Nachricht an den*die Empfänger*in und verwende dafür eine Nachrichtenvorlage.

400

Fehlerhafte Anfrage

131049

Meta hat sich gegen die Zustellung dieser Nachricht entschieden.

Diese Nachricht wurde nicht zugestellt, um fehlerfreie Interaktionen im Ökosystem aufrechtzuerhalten.

Wenn du diesen Fehlercode erhältst und vermutest, dass er auf das Limit zurückzuführen ist, versuche es nicht sofort erneut. Versuche es stattdessen in immer größeren Zeitschritten erneut, bis die Nachricht zugestellt wird, da die Beschränkung für unterschiedliche Zeiträume gelten kann.

Weitere Informationen findest du unter Nachrichtenbeschränkungen für Marketingvorlagen pro Benutzer*in.

400

Fehlerhafte Anfrage

131051

Nicht unterstützter Nachrichtentyp

Nicht unterstützter Nachrichtentyp.

Beachte Nachrichten für Informationen zu unterstützten Nachrichtentypen und versuche es dann mit einem unterstützten Nachrichtentyp erneut.

400

Fehlerhafte Anfrage

131052

Fehler beim Medien-Download

Die von dem*der Benutzer*in gesendeten Medien können nicht heruntergeladen werden.

Die in der Nachricht des*der WhatsApp-Benutzer*in enthaltenen Medien konnten nicht heruntergeladen werden. Weitere Informationen findest du im Wert error.error_data.details in beliebigen messages-Webhooks, die bei Erhalt dieser Nachricht ausgelöst werden.

Bitte den*die WhatsApp-Benutzer*in, die Mediendatei außerhalb von WhatsApp zu senden.

400

Fehlerhafte Anfrage

131053

Fehler beim Medien-Upload

Die in der Nachricht verwendeten Medien konnten nicht hochgeladen werden.

Die Medien konnten aus einem Grund oder mehreren Gründen nicht hochgeladen werden, z. B. aufgrund eines nicht unterstützten Medientyps.

Weitere Informationen findest du im Wert error.error_data.details in beliebigen messages-Webhooks, die ausgelöst werden, wenn diese Nachricht nicht gesendet werden kann.

Wir empfehlen dir, alle Mediendateien zu überprüfen, die Fehler verursachen, und sicherzustellen, dass sie tatsächlich unterstützt werden. Unter UNIX kannst du beispielsweise die Dateiinspektion über die Befehlszeile verwenden, um den MIME-Typ zu ermitteln:

file -I rejected-file.mov

Anschließend kannst du überprüfen, ob der MIME-Typ unterstützt wird. Siehe Unterstützte Medientypen.

400

Fehlerhafte Anfrage

131057

Konto in Wartungsmodus

Unternehmenskonto ist im Wartungsmodus

Das WhatsApp-Unternehmenskonto ist im Wartungsmodus. Eine Ursache dafür könnte sein, dass für das Konto ein Durchsatz-Upgrade durchgeführt wird.

500

Fehlerhafte Anfrage

132000

Unstimmigkeit bei Vorlagenparameterzahl

Die Anzahl der in der Anfrage enthaltenen variablen Parameter stimmt nicht mit der in der Vorlage definierten Anzahl variabler Parameter überein.

Beachte die Richtlinien zu Nachrichtenvorlagen und stelle sicher, dass die Anfrage alle variablen Parameterwerte beinhaltet, die in der Vorlage definiert wurden.

400

Fehlerhafte Anfrage

132001

Vorlage existiert nicht

Die Vorlage ist in der festgelegten Sprache nicht vorhanden oder sie wurde nicht genehmigt.

Stelle sicher, dass deine Vorlage genehmigt wurde und der Name und die Sprache korrekt sind. Vergewissere dich bitte, dass du die Richtlinien zu Nachrichtenvorlagen befolgst.

404

Nicht gefunden

132005

Dekomprimierter Vorlagentext zu lang

Übersetzter Text ist zu lang.

Prüfe im WhatsApp Manager, ob deine Vorlage übersetzt wurde. Siehe Qualitätsbewertung und Status der Vorlage.

400

Fehlerhafte Anfrage

132007

Vorlagenrichtlinie für Formatierungszeichen verletzt

Vorlageninhalt verstößt gegen eine WhatsApp-Richtlinie.

Siehe Ablehnungsgründe, um mögliche Ursachen für den Verstoß zu ermitteln.

400

Fehlerhafte Anfrage

132012

Unstimmigkeit bei Vorlagenparameterformat

Variable Parameterwerte sind nicht korrekt formatiert.

Die in der Anfrage enthaltenen variablen Parameter verwenden nicht das in der Vorlage festgelegte Format. Siehe Richtlinien zu Nachrichtenvorlagen.

400

Fehlerhafte Anfrage

132015

Vorlage wurde pausiert

Die Vorlage wurde aufgrund der geringen Qualität pausiert. Das heißt, sie kann nicht in einer Vorlagennachricht gesendet werden.

Bearbeite die Vorlage, um ihre Qualität zu verbessern, und versuche es erneut, sobald sie genehmigt wurde.

400

Fehlerhafte Anfrage

132016

Vorlage ist deaktiviert

Die Vorlage wurde zu oft wegen geringer Qualität pausiert und wurde nun dauerhaft deaktiviert.

Erstelle eine neue Vorlage mit anderen Inhalten.

400

Fehlerhafte Anfrage

132068

Vorgang wurde blockiert

Vorgang befindet sich im Status „Blockiert“.

Vorgang korrigieren

400

Fehlerhafte Anfrage

132069

Vorgang wurde gedrosselt

Der Vorgang befindet sich im Status „Gedrosselt“ und 10 Nachrichten, die diesen Vorgang verwenden, wurden in der letzten Stunde bereits gesendet.

Flow korrigieren

400

Fehlerhafte Anfrage

133000

Unvollständige Deregistrierung

Ein früherer Deregistrierungsversuch ist fehlgeschlagen.

Deregistriere die Nummer erneut, bevor du sie registrierst.

500

Interner Serverfehler

133004

Server vorübergehend nicht verfügbar

Server ist vorübergehend nicht verfügbar.

Prüfe die Seite Status der WhatsApp Business Platform, um die API-Statusinformationen einzusehen, und prüfe den details-Wert der Antwort, bevor du es erneut versuchst.

503

Dienst nicht verfügbar

133005

Unstimmigkeit bei der PIN für die Verifizierung in zwei Schritten

Die PIN für die Verifizierung in zwei Schritten ist nicht korrekt.

Verifiziere, dass die in der Anfrage enthaltene PIN für die Verifizierung in zwei Schritten korrekt ist.

Zum Zurücksetzen der PIN für die Verifizierung in zwei Schritten:

Deaktiviere die Autorisierung in zwei Schritten.
Sende eine POST-Anfrage mit der neuen PIN an den Telefonnummer-Endpunkt.

400

Fehlerhafte Anfrage

133006

Erneute Verifizierung der Telefonnummer erforderlich

Telefonnummer muss vor der Registrierung verifiziert werden.

Verifiziere die Telefonnummer, bevor du sie registrierst.

400

Fehlerhafte Anfrage

133008

Zu viele PIN-Eingabeversuche bei der Verifizierung in zwei Schritten

Bei der Verifizierung in zwei Schritten wurden für diese Telefonnummer zu viele PIN-Eingabeversuche getätigt.

Versuche es noch einmal, wenn die im details-Antwortwert festgelegte Zeit vergangen ist.

400

Fehlerhafte Anfrage

133009

PIN für die Verifizierung in zwei Schritten wurde zu schnell erraten

PIN für die Verifizierung in zwei Schritten wurde zu schnell eingegeben.

Prüfe den details-Antwortwert, bevor du es erneut versuchst.

400

Fehlerhafte Anfrage

133010

Telefonnummer nicht registriert

Telefonnummer ist nicht auf der WhatsApp Business Platform registriert.

Registriere die Telefonnummer, bevor du es erneut versuchst.

400

Fehlerhafte Anfrage

133015

Warte einige Minuten, bevor du versuchst, diese Telefonnummer zu registrieren.

Die Telefonnummer, die du registrieren möchtest, wurde kürzlich gelöscht, und der Löschvorgang ist noch nicht abgeschlossen.

Warte fünf Minuten, bevor du die Anfrage wiederholst.

400

Fehlerhafte Anfrage

135000

Generischer Benutzungsfehler

Nachricht konnte aufgrund eines unbekannten Fehlers in Verbindung mit deinen Anfrageparametern nicht gesendet werden.

Beachte die Endpunkt-Referenz, um zu ermitteln, ob du den Endpunkt mit der korrekten Syntax aufrufst. Kontaktiere das Support-Team, wenn du weiterhin diesen Fehlercode als Antwort erhältst.

400

Fehlerhafte Anfrage