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 neu 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:

entry.changes.value.errors
entry.changes.value.messages.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>" } }

Inhalte von Fehlerantworten

Eigenschaft	Werttyp	Beschreibung
`code`	Ganzzahl	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`	Ganzzahl	Veraltet. Wird nicht in v16.0+-Antworten zurückgegeben. Untercode der Graph API. 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": "Cloud API message throughput has been reached."
    },
    "error_subcode": 2494055,
    "fbtrace_id": "Az8or2yhqkZfEZ-_4Qn_Bam"
  }
}

Autorisierungsfehler

Code	Details	Mögliche Gründe und 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 Access Token Debugger, um zu verifizieren, dass deine App die vom Endpunkt geforderten Berechtigungen erhalten hat. Siehe Authentifizierungs- und Autorisierungsfehler.	`500` Interner Serverfehler
`10` Berechtigung verweigert	Die Berechtigung wurde entweder entzogen oder nicht erteilt.	Verwende den Access Token Debugger, um zu verifizieren, dass deine App die vom Endpunkt geforderten Berechtigungen erhalten hat. Siehe Authentifizierungs- und Autorisierungsfehler. Für WhatsApp Flows mit Endpunkt: Vergewissere dich, dass die Telefonnummer, die zum Festlegen des öffentlichen Unternehmensschlüssels verwendet wurde, auf der Positivliste steht. Prüfe die Qualifizierungskriterien für die API, auf die du zugreifen möchtest. Wenn du nicht berechtigt bist, auf die Endpunkte zuzugreifen, erhältst du diesen Fehlercode.	`403` Unzulässig
`190` Zugriffstoken ist abgelaufen	Dein Zugriffstoken ist abgelaufen.	Rufe einen neuen Zugriffstoken ab.	`401` Nicht autorisiert
`200-299` API-Berechtigung	Die Berechtigung wurde entweder entzogen oder nicht erteilt.	Verwende den Access Token Debugger, um zu verifizieren, dass deine App die vom Endpunkt geforderten Berechtigungen erhalten hat. Siehe Authentifizierungs- und Autorisierungsfehler.	`403` Unzulässig

Integrity-Fehler

Code Details Mögliche Gründe und Lösungen HTTP-Statuscode

Code	Details	Mögliche Gründe und 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.	WhatsApp-Unternehmenskonten können keine Nachrichten an Benutzer*innen in bestimmten Ländern 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.

WhatsApp-Unternehmenskonten können keine Nachrichten an Benutzer*innen in bestimmten Ländern 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

Fehler bei der Vorlagenerstellung

Fehler	Beschreibung	Mögliche Lösung
`2388040` – Zeichenlimit überschritten	Ein Feld in deiner Vorlage hat die maximal zulässige Zeichenzahl überschritten.	In der Fehlermeldung findest du genaue Angaben zum betroffenen Feld und zur entsprechenden Zeichenbeschränkung.
`2388047` – Nachrichten-Header-Format ist falsch	Dein Nachrichten-Header enthält ungültige Formatierungen.	In der Fehlermeldung findest du genaue Details zur gültigen Formatierung.
`2388072` – Nachrichtenformat ist falsch	Dein Nachrichtentext enthält ungültige Formatierungen.	In der Fehlermeldung findest du genaue Details zur gültigen Formatierung.
`2388073` – Nachrichten-Footer-Format ist nicht korrekt	Deine Nachrichtenfußzeile enthält eine ungültige Formatierung.	In der Fehlermeldung findest du genaue Details zur gültigen Formatierung.
`2388293` – Parameter-Wort-Verhältnis überschreitet Grenzwert	Diese Vorlage hat zu viele Variablen für ihre Länge. Verringere die Anzahl der Variablen oder erhöhe die Nachrichtenlänge.	In der Fehlermeldung findest du genaue Details zur gültigen Formatierung.
`2388299` – vor- oder nachgestellte Parameter sind nicht erlaubt	Variablen dürfen nicht am Anfang oder Ende der Vorlage stehen.	In der Fehlermeldung findest du genaue Details zur gültigen Formatierung.

Fehler beim Senden von Vorlagen

Fehler	Beschreibung	Mögliche Lösung
`2388019` – Nachrichtenvorlagenlimit überschritten	Du hast die für dieses WhatsApp-Unternehmenskonto zulässige Anzahl von Nachrichtenvorlagen überschritten.	Ein WhatsApp-Unternehmenskonto kann bis zu 250 Nachrichtenvorlagen enthalten. Mehr dazu: Vorlagenlimits.

Fehler bei der Telefonnummernmigration

Error	Description	Possible Solution
`2388001` - Please confirm ownership of this phone number.	Certificate can be downloaded only after confirming ownership of a phone number that is being migrated.	In order to download the certificate and proceed with registration, register and and verify the number.
`2388001` - Please ensure two-step authentication is disabled.	Two-step authentication must be disabled for this phone number.	In your WhatsApp Business Manager Settings, turn off two-step verification.
`2388012` - This phone number already exists in your list of phone numbers.	The phone number you are trying to migrate is already present in your WhatsApp account.	Try again with a phone number that is not already present in your WhatsApp account.
`2388091`, `2388093` - This phone number isn’t eligible to receive/verify a registration code since it is not being migrated.	Phone ownership verification APIs are not available for this use case.	Register and verify the number.
`2388103` - Cannot migrate phone number.	Webhooks have not been set up for the destination WhatsApp Business account.	Subscribe your app to webhooks on the destination WhatsApp Business account.
`2388103` - Please add this phone number in your WhatsApp account	This phone number is eligible to be added directly, and does not need to use phone migration APIs.	Register and verify the number.
`2388103` - Registered name should be present and approved.	The business phone number must have an approved display name (`name_status` is `APPROVED`) and cannot have any associated pending display name change requests.	Get your business phone number's display name approved.
`2388103` - The WhatsApp account that this phone number is registered with is not set up correctly.	The source WhatsApp Business Account must be approved, and its "messaging on behalf of" must be approved.	The WhatsApp Business Account may be using the now deprecated On-Behalf-Of ownership model. Contact support.
`2388103` - Your WhatsApp account does not have a payment account.	Your WhatsApp account must have an active credit line in order to send messages after migration.	Set up a credit line and share it with the business customer.
`2388103` - There was an error migrating this phone number.	Something went wrong when trying to migrate your phone number.	Try again after some time. If that doesn’t work, contact support.
`2388103` - This phone number belongs to a different Business Manager account.	The source and destination WABAs must represent the same business.	Migrate the phone number into a WhatsApp Business Account that is messaging for the same business as the source WhatsApp Business Account.
`2388103` - Your WhatsApp account must be approved	The destination WhatsApp Business Account must be approved before you can migrate phone numbers.	Ensure business verification is completed, and the WhatsApp Business Account review status is approved.
`2388103` - Your WhatsApp account’s "Messaging For" request must be approved	The destination WhatsApp Business Account "Messaging For" request must be approved by the client.	Ask your client to accept your "Messaging For" request in the Meta Business Suite.
`2494100` - Account is in maintenance mode.	The business phone number is in maintenance mode.	Try again in a few minutes.

Fehler bei Vorlagen-Insights

Fehler	Beschreibung	Mögliche Lösung
`200005` – Vorlagen-Insights nicht verfügbar	Vorlagen-Insights sind für dieses WhatsApp-Unternehmenskonto noch nicht verfügbar.	Du kannst derzeit keine Vorlagen-Insights für dieses WhatsApp-Unternehmenskonto aktivieren.
`200006` – Vorlagen-Insights können nicht deaktiviert werden	Ungültiger Vorgang. Nachrichtenvorlagen-Insights können nicht mehr deaktiviert werden, nachdem sie aktiviert wurden.	Nachdem Vorlagen-Insights für ein WhatsApp-Unternehmenskonto aktiviert wurden, können sie nicht mehr deaktiviert werden.
`200007` – Vorlagen-Insights nicht aktiviert	Vorlagen-Insights wurden für dieses WhatsApp-Unternehmenskonto nicht aktiviert.	Um Vorlagen-Insights zu aktivieren, sieh dir an, wie du Vorlagenanalysen bestätigen kannst.

Fehler bei WhatsApp-Unternehmenskonten

Fehler Beschreibung Mögliche Lösung

Fehler	Beschreibung	Mögliche Lösung
`2593079` Vorlagen-Insights nicht verfügbar	Dieses WhatsApp-Unternehmenskonto (WABA, WhatsApp Business Account) wurde bereits für die Migration zu einer anderen Lösungs-ID markiert.	Das OBO-Modell zur Kontoinhaberschaft ist jetzt veraltet. Wende dich an den Support.
`2593085` Ungültiges WhatsApp-Unternehmenskonto für OBO Mobility	Das WABA ist nicht zur Übertragung der OBO-Inhaberschaft berechtigt. Mögliche Gründe: Das WABA gehört bereits demder Geschäftskundin (d. h. das WABA wird schon geteilt). DerDie Geschäftskundin hat die OBO-Anfrage in der Meta Business Suite noch nicht angenommen.	Beachte, dass das OBO-Modell zur Kontoinhaberschaft jetzt veraltet ist. Wende dich an den Support.

2593079

Vorlagen-Insights nicht verfügbar

Dieses WhatsApp-Unternehmenskonto (WABA, WhatsApp Business Account) wurde bereits für die Migration zu einer anderen Lösungs-ID markiert.

Das OBO-Modell zur Kontoinhaberschaft ist jetzt veraltet. Wende dich an den Support.

2593085

Ungültiges WhatsApp-Unternehmenskonto für OBO Mobility

Das WABA ist nicht zur Übertragung der OBO-Inhaberschaft berechtigt. Mögliche Gründe:

Das WABA gehört bereits dem*der Geschäftskund*in (d. h. das WABA wird schon geteilt).
Der*Die Geschäftskund*in hat die OBO-Anfrage in der Meta Business Suite noch nicht angenommen.

Beachte, dass das OBO-Modell zur Kontoinhaberschaft jetzt veraltet ist. Wende dich an den Support.

Synchronisierungsfehler

Code Details Mögliche Gründe und Lösungen HTTP-Statuscode

Code	Details	Mögliche Gründe und Lösungen	HTTP-Statuscode
`2593107` Maximale Anzahl der Synchronisierungsanfragen überschritten	Du hast die maximale Anzahl der Abrufe der Synchronisierungs-API für diese Telefonnummer überschritten.	Du kannst diesen Endpunkt nur einmal abrufen, um die Kontakte für deine geschäftliche Telefonnummer zu synchronisieren, und ein weiteres Mal, um den Messaging-Verlauf zu synchronisieren. Weitere Informationen findest du im Artikel zum Einbinden von Benutzerinnen der Business-App. Schließe dendie Unternehmenskundin aus und binde ihnsie wieder ein.	`400` Fehlerhafte Anfrage
`2593108` Synchronisierungsanfrage außerhalb des zulässigen Zeitfensters	Synchronisierungsanfragen können nur innerhalb von 24 Stunden nach dem Einbinden gestellt werden.	Das Synchronisieren des Kontakte- und Messaging-Verlaufs eineseiner eingebundenen Benutzerin der WhatsApp Business-App ist nur innerhalb von 24 Stunden ab Einbindung desder Benutzerin möglich. Weitere Informationen findest du im Artikel zum Einbinden von Benutzerinnen der Business-App. Schließe dendie Benutzerin aus und binde ihnsie wieder ein.	`400` Fehlerhafte Anfrage

2593107

Maximale Anzahl der Synchronisierungsanfragen überschritten

Du hast die maximale Anzahl der Abrufe der Synchronisierungs-API für diese Telefonnummer überschritten.

Du kannst diesen Endpunkt nur einmal abrufen, um die Kontakte für deine geschäftliche Telefonnummer zu synchronisieren, und ein weiteres Mal, um den Messaging-Verlauf zu synchronisieren. Weitere Informationen findest du im Artikel zum Einbinden von Benutzer*innen der Business-App.

Schließe den*die Unternehmenskund*in aus und binde ihn*sie wieder ein.

400

Fehlerhafte Anfrage

2593108

Synchronisierungsanfrage außerhalb des zulässigen Zeitfensters

Synchronisierungsanfragen können nur innerhalb von 24 Stunden nach dem Einbinden gestellt werden.

Das Synchronisieren des Kontakte- und Messaging-Verlaufs eines*einer eingebundenen Benutzer*in der WhatsApp Business-App ist nur innerhalb von 24 Stunden ab Einbindung des*der Benutzer*in möglich. Weitere Informationen findest du im Artikel zum Einbinden von Benutzer*innen der Business-App.

Schließe den*die Benutzer*in aus und binde ihn*sie wieder ein.

400

Fehlerhafte Anfrage

Drosselungsfehler

Code	Details	Mögliche Gründe und Lösungen	HTTP-Statuscode
`4` Zu viele API-Aufrufe	Die App hat ihre Durchsatzratenbegrenzung für API-Aufrufe erreicht.	Lade die App im App-Dashboard und sieh dir den Bereich Durchsatzratenbegrenzung auf App-Ebene an, um zu verifizieren, dass die App ihre Durchsatzratenbegrenzung 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 die Durchsatzbegrenzung 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. Siehe Vorlagenlimits und Vorlagenqualität.	`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 geschäftliche Telefonnummer 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

Sonstige Fehler

Code Details Mögliche Gründe und Lösungen HTTP-Statuscode

Code	Details	Mögliche Gründe und Lösungen	HTTP-Statuscode
`1` API unbekannt	Ungültige Anfrage oder möglicher Serverfehler.	Auf der Seite WhatsApp Business Platform-Status findest du API-Statusinformationen. Wenn keine Serverausfälle vorliegen, prüfe die Endpunkt-Referenz und vergewissere dich, dass deine Anfrage korrekt formatiert ist und alle Anforderungen des Endpunkts erfüllt sind.	`400` Fehlerhafte Anfrage
`2` API-Dienst	Temporär aufgrund von Downtime oder Überlastung.	Auf der Seite WhatsApp Business Platform-Status kannst du die API-Statusinformationen einsehen, bevor du es erneut versuchst.	`503` Dienst nicht verfügbar
`33` Parameterwert ist ungültig	Die geschäftliche Telefonnummer wurde gelöscht.	Vergewissere dich, dass die geschäftliche Telefonnummer richtig ist.	`400` Fehlerhafte Anfrage
`100` Ungültiger Parameter	Die Anfrage beinhaltete einen oder mehrere nicht unterstützte oder falsch geschriebene Parameter.	Prüfe die Endpunkt-Referenz, um zu ermitteln, welche Parameter unterstützt und wie sie geschrieben werden. Für WhatsApp Flows mit Endpunkt: Achte beim Einrichten des öffentlichen Unternehmensschlüssels darauf, 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, mit einer zuvor gespeicherten Telefonnummer-ID übereinstimmt. 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` Etwas ist schiefgelaufen.	Die Nachricht konnte aufgrund eines unbekannten Fehlers nicht gesendet werden.	Versuche es noch einmal. Wenn der Fehler bestehen bleibt, öffne ein Direct Support-Ticket. Für WhatsApp Flows mit Endpunkt: 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.	`500` Interner Serverfehler
`131005` Zugriff verweigert	Die Berechtigung wurde entweder entzogen oder nicht erteilt.	Verwende den Access Token Debugger, um zu verifizieren, dass deine App die vom Endpunkt geforderten Berechtigungen erhalten hat. Siehe Authentifizierungs- und Autorisierungsfehler.	`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.	Auf der Seite WhatsApp Business Platform-Status kannst du API-Statusinformationen einsehen, 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. Derdie Empfängerin hat unsere neuen Nutzungsbedingungen und die neue Datenschutzrichtlinie nicht akzeptiert. Derdie Empfängerin 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
`131037` Bei einer von WhatsApp bereitgestellten Nummer kann erst eine Nachricht gesendet werden, wenn der Display-Name genehmigt wurde.	Die geschäftliche Telefonnummer mit der Vorwahl 555, mit der die Anfrage gesendet wird, hat keinen genehmigten Display-Namen.	Ändere den Display-Namen der geschäftlichen Telefonnummer mit der Vorwahl 555. Siehe auch unseren Artikel im Hilfebereich: Deinen WhatsApp Business-Display-Namen ändern.	`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 Business-Konto 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 Business-Konto wurde gelöscht WhatsApp Business-Konto wurde suspendiert Keine Zeitzone festgelegt Keine Währung festgelegt MessagingFor-Anfrage (On Behalf Of) ist offen oder wurde abgelehnt	`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 Vorlagennachricht an dendie Empfängerin.	`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 dies an der Beschränkung liegt, solltest du mindestens 24 Stunden warten, bevor du die Vorlagennachricht erneut sendest. Andernfalls würde es nur zu einer weiteren Fehlerantwort führen, da die Beschränkung für unterschiedliche Zeiträume gültig sein kann. Weitere Informationen findest du unter Nachrichtenlimit für Marketing-Vorlagen pro Benutzer*in.	`400` Fehlerhafte Anfrage
`131050` Benutzer*in hat den Erhalt von Marketing-Nachrichten gestoppt.	Nachricht kann nicht zugestellt werden. Dieser Benutzerin hat sich dagegen entschieden, Marketing-Nachrichten auf WhatsApp von deinem Unternehmen zu erhalten.	Versuche nicht erneut, Nachrichten an diesen Benutzerin zu senden, da sie nicht empfangen werden. Wenn du benachrichtigt werden möchtest, wenn eine WhatsApp-Benutzerin die Zustellung von Marketing-Vorlagennachrichten von deinem Unternehmen stoppt oder fortsetzt, abonniere den Webhook user_preferences.	`400` Fehlerhafte Anfrage
`131051` Nicht unterstützter Nachrichtentyp	Nicht unterstützter Nachrichtentyp.	Beachte die Informationen zu unterstützten Nachrichtentypen und versuche es dann erneut mit einem unterstützten Nachrichtentyp.	`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.	In unserem Dokument zu Vorlagen erfährst du mehr über Parameter und kannst sicherstellen, dass die Anfrage Werte für alle Parameter enthält, die von der Vorlage verlangt werden.	`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. Weitere Informationen zu Vorlagen findest du in unserem Dokument zu Vorlagen.	`404` Nicht gefunden
`132005` Dekomprimierter Vorlagentext zu lang	Übersetzter Text ist zu lang.	Prüfe im WhatsApp Manager, ob deine Vorlage übersetzt wurde. In unserem Dokument zur Vorlagenqualität erfährst du, wie du den Status deiner Vorlage überprüfen kannst.	`400` Fehlerhafte Anfrage
`132007` Vorlagenrichtlinie für Formatierungszeichen verletzt	Vorlageninhalt verstößt gegen eine WhatsApp-Richtlinie.	Sieh dir unser Dokument zur Vorlagenüberprüfung an, um mehr über mögliche Gründe für den Verstoß zu erfahren.	`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. In unserem Dokument zu Vorlagen erfährst du mehr über Vorlagenparameter und -formate.	`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.	Auf der Seite WhatsApp Business Platform-Status kannst du API-Statusinformationen einzusehen und den `details`-Wert der Antwort überprüfen, 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. Um die PIN zurückzusetzen, deaktiviere die Verifizierung in zwei Schritten und lege anschließend eine neue PIN fest. Siehe Verifizierung in zwei Schritten.	`400` Fehlerhafte Anfrage
`133006` Erneute Verifizierung der Telefonnummer erforderlich	Die Telefonnummer muss vor der Registrierung verifiziert werden.	Verifiziere und registriere die Telefonnummer.	`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
`134011` WhatsApp-Nutzungsbedingungen für Zahlungen wurden nicht akzeptiert	Nachricht konnte nicht gesendet werden, weil die WhatsApp-Nutzungsbedingungen für Zahlungen für das WhatsApp-Unternehmenskonto nicht akzeptiert wurden.	Akzeptiere die WhatsApp-Nutzungsbedingungen für Zahlungen mit dem Link in der Fehlermeldung, bevor du es erneut versuchst.	`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.

Auf der Seite WhatsApp Business Platform-Status findest du API-Statusinformationen. Wenn keine Serverausfälle vorliegen, prüfe die Endpunkt-Referenz und vergewissere dich, dass deine Anfrage korrekt formatiert ist und alle Anforderungen des Endpunkts erfüllt sind.

400

Fehlerhafte Anfrage

2

API-Dienst

Temporär aufgrund von Downtime oder Überlastung.

Auf der Seite WhatsApp Business Platform-Status kannst du die API-Statusinformationen einsehen, bevor du es erneut versuchst.

503

Dienst nicht verfügbar

33

Parameterwert ist ungültig

Die geschäftliche Telefonnummer wurde gelöscht.

Vergewissere dich, dass die geschäftliche Telefonnummer richtig ist.

400

Fehlerhafte Anfrage

100

Ungültiger Parameter

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

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

Für WhatsApp Flows mit Endpunkt: Achte beim Einrichten des öffentlichen Unternehmensschlüssels darauf, 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, mit einer zuvor gespeicherten Telefonnummer-ID übereinstimmt.

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

Etwas ist schiefgelaufen.

Die Nachricht konnte aufgrund eines unbekannten Fehlers nicht gesendet werden.

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

Für WhatsApp Flows mit Endpunkt: 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.

500

Interner Serverfehler

131005

Zugriff verweigert

Die Berechtigung wurde entweder entzogen oder nicht erteilt.

Verwende den Access Token Debugger, um zu verifizieren, dass deine App die vom Endpunkt geforderten Berechtigungen erhalten hat. Siehe Authentifizierungs- und Autorisierungsfehler.

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.

Auf der Seite WhatsApp Business Platform-Status kannst du API-Statusinformationen einsehen, 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.
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

131037

Bei einer von WhatsApp bereitgestellten Nummer kann erst eine Nachricht gesendet werden, wenn der Display-Name genehmigt wurde.

Die geschäftliche Telefonnummer mit der Vorwahl 555, mit der die Anfrage gesendet wird, hat keinen genehmigten Display-Namen.

Ändere den Display-Namen der geschäftlichen Telefonnummer mit der Vorwahl 555. Siehe auch unseren Artikel im Hilfebereich: Deinen WhatsApp Business-Display-Namen ändern.

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 Business-Konto 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 Business-Konto wurde gelöscht
WhatsApp Business-Konto wurde suspendiert
Keine Zeitzone festgelegt
Keine Währung festgelegt
MessagingFor-Anfrage (On Behalf Of) ist offen oder wurde abgelehnt

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 Vorlagennachricht an den*die Empfänger*in.

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 dies an der Beschränkung liegt, solltest du mindestens 24 Stunden warten, bevor du die Vorlagennachricht erneut sendest. Andernfalls würde es nur zu einer weiteren Fehlerantwort führen, da die Beschränkung für unterschiedliche Zeiträume gültig sein kann.

Weitere Informationen findest du unter Nachrichtenlimit für Marketing-Vorlagen pro Benutzer*in.

400

Fehlerhafte Anfrage

131050

Benutzer*in hat den Erhalt von Marketing-Nachrichten gestoppt.

Nachricht kann nicht zugestellt werden. Diese*r Benutzer*in hat sich dagegen entschieden, Marketing-Nachrichten auf WhatsApp von deinem Unternehmen zu erhalten.

Versuche nicht erneut, Nachrichten an diese*n Benutzer*in zu senden, da sie nicht empfangen werden. Wenn du benachrichtigt werden möchtest, wenn ein*e WhatsApp-Benutzer*in die Zustellung von Marketing-Vorlagennachrichten von deinem Unternehmen stoppt oder fortsetzt, abonniere den Webhook user_preferences.

400

Fehlerhafte Anfrage

131051

Nicht unterstützter Nachrichtentyp

Nicht unterstützter Nachrichtentyp.

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

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.

In unserem Dokument zu Vorlagen erfährst du mehr über Parameter und kannst sicherstellen, dass die Anfrage Werte für alle Parameter enthält, die von der Vorlage verlangt werden.

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. Weitere Informationen zu Vorlagen findest du in unserem Dokument zu Vorlagen.

404

Nicht gefunden

132005

Dekomprimierter Vorlagentext zu lang

Übersetzter Text ist zu lang.

Prüfe im WhatsApp Manager, ob deine Vorlage übersetzt wurde. In unserem Dokument zur Vorlagenqualität erfährst du, wie du den Status deiner Vorlage überprüfen kannst.

400

Fehlerhafte Anfrage

132007

Vorlagenrichtlinie für Formatierungszeichen verletzt

Vorlageninhalt verstößt gegen eine WhatsApp-Richtlinie.

Sieh dir unser Dokument zur Vorlagenüberprüfung an, um mehr über mögliche Gründe für den Verstoß zu erfahren.

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. In unserem Dokument zu Vorlagen erfährst du mehr über Vorlagenparameter und -formate.

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.

Auf der Seite WhatsApp Business Platform-Status kannst du API-Statusinformationen einzusehen und den details-Wert der Antwort überprüfen, 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.

Um die PIN zurückzusetzen, deaktiviere die Verifizierung in zwei Schritten und lege anschließend eine neue PIN fest. Siehe Verifizierung in zwei Schritten.

400

Fehlerhafte Anfrage

133006

Erneute Verifizierung der Telefonnummer erforderlich

Die Telefonnummer muss vor der Registrierung verifiziert werden.

Verifiziere und registriere die Telefonnummer.

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

134011

WhatsApp-Nutzungsbedingungen für Zahlungen wurden nicht akzeptiert

Nachricht konnte nicht gesendet werden, weil die WhatsApp-Nutzungsbedingungen für Zahlungen für das WhatsApp-Unternehmenskonto nicht akzeptiert wurden.

Akzeptiere die WhatsApp-Nutzungsbedingungen für Zahlungen mit dem Link in der Fehlermeldung, bevor du es erneut versuchst.

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

Fehlercodes für die Marketing Messages API für WhatsApp

Die MM API für WhatsApp verwendet dieselben Fehlercodes wie die Cloud API. Einige Ergänzungen sind unten aufgeführt.

Beispiel

{
  "error": {
    "message": "(#100) Invalid parameter",
    "type": "OAuthException",
    "code": 100,
    "error_data": {
      "messaging_product": "whatsapp",
      "details": "Message must be a template message."
    },
    "fbtrace_id": "Ak6nxJSySLEJz32Ps-QiZ1t"
  }
}

Codes

Code	Nachricht	Details	Mögliche Gründe und Lösungen	HTTP- Status- Code
`100`	`(#100) Invalid parameter`	`Message must be a template message.`	Du versuchst, eine nicht vorlagenbasierte Nachricht zu senden. Der Nachrichtentyp muss `template` sein. Versuche es noch einmal mit einer Marketing-Vorlage.	400 Bad Request (ungültige Anfrage)
`131009`	`(#131009) Parameter value is not valid`	`One or more parameter values are invalid.`	Möglicherweise verwendest du einen ungültigen Parameter. Überprüfe, ob du einen gültigen Parameter verwendest, und versuche es erneut. Die Anzeigensynchronisierung ist möglicherweise unvollständig. Warte 10 Minuten und versuche es dann noch einmal. Sollte das Problem weiterhin bestehen, wende dich an den Support.	400 Bad Request (ungültige Anfrage)
`131055`	`(#131055) Method not allowed`	`Only marketing template messages are supported`	Du hast möglicherweise versucht, eine nicht vorlagenbasierte Nachricht bzw. eine Authentifizierungs- oder Utility-Vorlage zu senden. Versuche, sie mit einer Marketing-Vorlage erneut zu senden.	400 Bad Request (ungültige Anfrage)
`134100`	`(#134100) Only marketing messages supported`	`You're only able to send marketing messages on this API.`	Wird mit Graph API Version 23.0 verfügbar sein. Du versuchst, eine Utility- oder Authentifizierungsvorlage zu senden. Es werden nur Vorlagen unterstützt, die als `MARKETING` kategorisiert sind.	400 Bad Request (ungültige Anfrage)
`134101`	`(#134101) Your template is still syncing`	`When you send a message from a template, the template syncing process can take up to 10 minutes to complete. Wait a few minutes, and then try sending your message again.`	Wird mit Graph API Version 23.0 verfügbar sein. Du versuchst, eine neu erstellte Vorlage zu senden, bevor die Anzeigensynchronisierung abgeschlossen wurde. Die Anzeigensynchronisierung kann bis zu 10 Minuten dauern. Warte 10 Minuten und versuche es dann noch einmal.	400 Bad Request (ungültige Anfrage)
`134102`	`(#134102) Template unavailable for use`	`Please check your eligibility status to ensure you are onboarded (https://developers.facebook.com/docs/whatsapp/marketing-messages-api-for-whatsapp/onboarding#ensure-you-are-eligible-to-onboard) or contact Meta's customer support.`	Wird mit Graph API Version 23.0 verfügbar sein. Wir konnten die Anzeigensynchronisierung für die Vorlage, die du zu senden versuchst, nicht abschließen oder du bist möglicherweise nicht zur Nutzung der MM API für WhatsApp berechtigt. Überprüfe deinen Qualifikationsstatus. Wenn für das WhatsApp-Unternehmenskonto für `marketing_messages_lite_api_status` der Wert `ONBOARDED` zurückgegeben wird und das Problem weiterhin besteht, wende dich an den Support.	500 Internal Server Error
`1752041`	`(#1752041) Duplicate Request`	`Duplicate Request is thrown when a client has already been invited to onboard by any partner.`	Es kann nur eine Anfrage zum Einbinden pro Unternehmenskundin gestellt werden, wobei nur derdie erste Partnerin, derdie die Intent-API aufruft, die Anfrage erfolgreich senden kann. Wenn eine Kundin freigeschaltet wird, wird dies automatisch für alle seine*ihre qualifizierten WhatsApp-Unternehmenskonten (WABAs) übernommen. Wenn du eine Fehlermeldung erhältst, die darauf hinweist, dass die Anfrage zum Einbinden bereits gestellt wurde, sind keine weiteren Aktionen erforderlich, da alle berechtigten WABAs für diesen Kunden ohne weitere Schritte eingebunden werden.	400 Bad Request (ungültige Anfrage)