WhatsApp Business Platform On-Premises API

WhatsApp Business Platform > On-Premises API

Wir stellen die On-Premises API ein. Weitere Informationen und wie du auf unsere Cloud API der nächsten Generation migrieren kannst, findest du in unserem Dokument zur Einstellung der On-Premises API.

Fehlercodes und Statusmeldungen

Dieses Dokument enthält weitere Informationen zu folgenden Fehlertypen und Statusmeldungen:

WhatsApp Business API: Client-Fehlercodes
HTTP-Statuscodes

Schritte zur Fehlerbehebung bei Embedded Signup findest du unter Fehler beim Embedded Signup-Ablauf.

Fehlercodes des WhatsApp Business API-Clients

Fehlercode	Beschreibung
`400` – Fehler beim Herunterladen von Medien	Das Medium des Absenders konnte nicht heruntergeladen werden.
`402` – Business-Berechtigung – Fehler bei Zahlungen	Die Nachricht konnte nicht gesendet werden, weil im Zusammenhang mit deiner Zahlungsmethode ein oder mehrere Fehler auftraten. Zahlungskonto ist nicht mit einem WhatsApp Account verknüpft Kreditlinie wurde überschritten Kreditlinie (Zahlungskonto) ist nicht auf aktiv gesetzt WhatsApp Business Account wurde gelöscht Konto wurde von uns gesperrt 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. (Dieser Fehlertyp wird ab dem 1. Februar 2022 angezeigt.) Prüfe deine Zahlungseinrichtung in WhatsApp Manager und versuche es noch einmal.
`408` – Nachricht ist ungültig	Die Nachricht konnte nicht gesendet werden, weil sie zu lange ausstehend war (d. h. länger als einen Tag). Dies wird erwartet, wenn der WhatsApp Business API-Client länger als einen Tag ausfällt und dann neu gestartet wird. Sende die Nachricht noch einmal.
`410` – Nachricht abgelaufen	Die Nachricht konnte nicht während des TTL-Zeitraums (Time To Live) versendet werden.
`429` – Ratenbegrenzung erreicht	Für ausgehende Nachrichten: Die Nachricht konnte nicht gesendet werden, weil von dieser Telefonnummer in einem kurzen Zeitraum zu viele Nachrichten gesendet wurden. Sende die fehlgeschlagenen Nachrichten noch einmal. Für eingehende Nachrichten: Aufgrund der Ratenbegrenzung konnte das Medium nicht heruntergeladen werden. Bitte den Sender, die Nachricht erneut zu senden.
`430` – Nicht signiertes Zertifikat	Nachricht konnte nicht gesendet werden, da in Bezug auf dein Zertifikat ein Fehler aufgetreten ist. Lade ein neues Zertifikat vom WhatsApp Manager herunter und registriere es neu.
`432` – Unstimmigkeit bei Zertifikats-ID	Nachricht konnte nicht gesendet werden, da in Bezug auf dein Zertifikat ein Fehler aufgetreten ist. Lade ein neues Zertifikat vom WhatsApp Manager herunter und registriere es neu.
`433` – Ungültige Zertifikatssignatur	Tritt auf, wenn eine Nachricht gesendet wird, aber das Zertifikat des Business-Clients nicht ordnungsgemäß mit den ID-Keys des Clients signiert wurde. Wahrscheinlich hat der Client sich mit neuen ID-Keys nochmals registriert, jedoch den Vorgang der Zertifikaterstellung nicht vollständig durchlaufen.
`470` – Nachricht zur erneuten Interaktion	Die Nachricht konnte nicht gesendet werden, weil seit der letzten Antwort desder Kundin an diese Nummer mehr als 24 Stunden vergangen sind. Verwende zum Antworten eine Nachrichtenvorlage.
`471` – 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 einen Qualitätsstatus im WhatsApp Manager. Weitere Informationen findest du in der Dokumentation zu Ratenbegrenzungen auf Qualitätsbasis.
`472` – Nummer desder Nutzerin ist Teil eines Experiments	Die Nachricht konnte nicht gesendet werden, weil die Telefonnummer diesesdieser Nutzerin Teil eines Experiments ist. Überspringe das Senden von Nachrichten an diesen Nutzerin.
`480` – Nutzer*in möglicherweise geändert	Nachricht konnte nicht gesendet werden, da sich der Nutzer mit dieser Rufnummer möglicherweise geändert hat.
`500` – Allgemeiner Fehler	Die Nachricht konnte aufgrund eines unbekannten Fehlers nicht gesendet werden. Versuche es später erneut.
`501` – Der Nachrichtentyp wird derzeit nicht unterstützt.	Dokumentnachrichten mit Untertiteln werden derzeit nicht unterstützt.
`1000` – Allgemeiner Fehler
`1001` – Nachricht zu lang	Die Nachricht enthält mehr als 4.096 Zeichen.
`1002` – Ungültiger Empfängertyp	Gültige Empfängertypen: `individual`
`1004` – Ressource existiert bereits	Möglicher UUID-Konflikt bei Anfrage zum Hochladen von Medien. Oder Medium mit dieser UUID bereits vorhanden.
`1005` – Zugriff verweigert	Schreiben in Medienverzeichnis nicht möglich (Anfrage hochladen) oder Ungültige Anmeldedaten oder Zertifikat-Fehler oder App abgelaufen: Versions-Upgrade erforderlich oder `button`-Nachrichten für dieses Konto deaktiviert oder Nummer ist bereits auf WhatsApp registriert (unter Migrieren einer Telefonnummer findest du Informationen zum Verschieben einer Telefonnummer von WhatsApp zur WhatsApp Business API) oder Falls dein Unternehmen Commerce-Nachrichten in Indien versendet, stelle sicher, dass du alle Unternehmensprofil- und Produktelementfelder ausgefüllt hast. Weitere Informationen findest du unter https://www.facebook.com/business/help/1104628230079278.
`1006` – Ressource nicht gefunden	Datei oder Ressource nicht gefunden.
`1007` – Empfänger ist für den Empfang von Nachrichten gesperrt (Veraltet)	Empfänger nicht auf Positivliste aufgeführt
`1008` – Erforderlicher Parameter fehlt	Es fehlt ein obligatorischer Parameter. Wenn du eine Listennachricht senden möchtest, hast du vielleicht den `title` des `section`-Objekts oder die `ID`s deiner `rows` vergessen. Wenn du eine Nachricht für einzelne oder mehrere Produkte senden möchtest, hast du vielleicht die `catalog_id` oder die `product_retailer_id` vergessen. Beide Felder sind für diesen Nachrichtentyp erforderlich.
`1009` – Wert des Parameters ist nicht gültig	Falscher Typ eines eingegebenen Parameterwerts oder sonstiges Problem. Wenn du eine Listennachricht sendest, stelle sicher, dass die ID jeder Reihe eindeutig ist. Wenn du eine Nachricht für einzelne Produkte sendest, hast du vielleicht die falsche `catalog_id` übermittelt. Gehe zurück zum Commerce Manager und prüfen die ID erneut. Wenn du eine Nachricht für mehrere Produkte sendest, stelle sicher, dass deine `product_retailer_id` pro Abschnitt eindeutig ist. Achte außerdem darauf, dass die Objekte `header` und `body` vorhanden sind und einen Wert aufweisen.
`1010` – Parameter ist nicht erforderlich	Enthält einen nicht benötigten Parameter.
`1011` – Dienst ist nicht bereit
`1013` – Ungültiger Nutzer
`1014` – Interner Fehler	Hochladen wegen ungültigem Bild fehlgeschlagen (Bild nicht ordnungsgemäß hochgeladen), oder Endpunkt nicht gefunden Der von dir angegebene Hash stimmt nicht mit dem aktuellen Hash des Benutzers überein
`1015` – Zu viele Anfragen	Clientseitige Ratenbegrenzung wurde erreicht
`1016` – Systemüberlastung	Bei hoher Auslastung des Systems wird dieser Fehler übergeben, damit das System Last abbauen kann.
`1017` – Kein primärer Master	Dieser Fehler tritt auf, wenn ausschließlich an einen Master gerichtete Anfragen, beispielsweise Einstellungen festlegen, Einstellungen abrufen, Import, Export, Codeanfrage, Registrierung etc., an einen Node gesendet werden, der kein primärer Master ist. Dies kann geschehen, wenn der WhatsApp Business API-Client nicht ordnungsgemäß eingerichtet ist oder interne Fehler aufgetreten sind. Dieser Fehler kann in der Regel durch Wiederholung der Anfrage behoben werden. Wenn sich der Fehler dadurch nicht beheben lässt, kontaktiere den Support.
`1018` – Keine primäre Coreapp	Dieser Fehler tritt auf, wenn Anfragen an einen Coreapp-Node gesendet werden, der nicht der Shard-Eigentümer ist bzw. dessen Einrichtung als Shard-Eigentümer noch nicht abgeschlossen ist. Auf diesen Fehler triffst du möglicherweise, wenn wir in einer Multiconnect-Konfiguration ein Shard-Failover veranlassen. Dieser Fehler kann in den meisten Fällen durch Wiederholung der Anfrage behoben werden. Wenn nicht, wende dich an den Support.
`1021` – Falscher Nutzer	Dieser Fehler tritt auf, wenn du eine Nachricht an dich selbst sendest. Sende in diesem Fall die Nachricht an eine Nummer, die nicht deine eigene ist.
`1022` – URL der Webhooks ist nicht konfiguriert	Dieser Fehler tritt auf, wenn du das Format für REST API-Webhooks nicht konfiguriert hast.
`1023` – Datenbankfehler ist aufgetreten
`1024` – Änderung des Passworts erforderlich	Du musst dein Passwort ändern.
`1025` – Ungültige Anfrage	Die Anfrage ist nicht gültig.
`1026` – Empfänger*in unfähig	Nachricht ist nicht zustellbar. Siehe „Warum beträgt meine Auslieferungsrate nicht 100 %?“ FAQ.
`1028` – Eine `user_identity_changed`-Systembenachrichtigung muss bestätigt werden	Du hast eine Nachricht an einen WhatsApp-Benutzer gesendet, der sich möglicherweise geändert hat. Dabei wurde eine `user_identity_changed`-Systembenachrichtigung an dich gesendet, die noch von dir bestätigt werden muss.
`1031` – Absender-Account wurde gesperrt	Dein Account wurde gesperrt und kann aufgrund eines Verstoßes gegen die Integritätsrichtlinien keine Nachrichten senden. Mehr dazu erfährst du unter Durchsetzung der Richtlinie für die WhatsApp Business Platform.
`2000` – Keine Übereinstimmung zwischen Vorlage und Parameteranzahl	Die Anzahl der angegebenen Parameter entspricht nicht der erwarteten Anzahl von Parametern.
`2001` – Vorlage fehlt	Der Status der Vorlage ist nicht „aktiv“ oder die Vorlage ist für eine Sprache und Regio nicht vorhanden.
`2002` – Abrufen der Vorlage fehlgeschlagen	Der Empfänger konnte die Vorlage nicht herunterladen.
`2003` – Vorlagenpaket fehlt	Für eine bestimmte Sprache und ein bestimmtes Gebietsschema gibt es keine Vorlagen.
`2004` – Parameterlänge der Vorlage ist zu lang	Parameter zu lang
`2005` – Hydrierter Text der Vorlage ist zu lang	Übersetzter Text zu lang.
`2006` – Verstoß gegen die Richtlinie zur Vorlage für leere Bereiche	Richtlinie für leere Bereiche verletzte
`2007` – Verstoß gegen die Richtlinie zur Vorlage für Formatierungszeichen	Richtlinie für Formatierungszeichen verletzt.
`2008` – Vorlage für Medienformat wird nicht unterstützt	Verwendetes Medienformat wird nicht unterstützt
`2009` – Fehlende erforderliche Vorlagenkomponente	Erforderliche Komponente in der Vorlage fehlt
`2010` – Ungültige hydrierte URL der Vorlage	URL in Button-Komponente ist ungültig
`2011` – Ungültige Telefonnummer der Vorlage	Telefonnummer in Button-Komponente ist ungültig
`2012` – Keine Übereinstimmung zwischen Vorlage und Parameterformat	Parameterformat stimmt nicht mit Format in der erstellten Vorlage überein
`2013` – Schaltflächen der Vorlage nicht unterstützt	Buttons werden vom Empfänger nicht unterstützt
`2014` – Erwarteter Namespace ist leer	Dieser Fehler tritt auf, wenn das Sprachpaket für eine Vorlagennachricht noch nicht heruntergeladen wurde.
`2015` – Ungültige Anzahl an Abschnitten	Die Anzahl der Abschnitte der Nachrichtenanfrage liegt unter dem Minimalwert oder über dem Maximalwert. Weitere Informationen findest du unter `section`-Objekt. Du musst mindestens ein `section` Objekt haben und kannst bis zu zehn haben.
`2016` – Ungültige Anzahl an Reihen	Die Anzahl der Reihen ist ungültig. Für Listennachrichten muss mindestens ein `rows` Objekt pro `section` vorhanden sein.
`2017` – Verstoß gegen Zeichenrichtlinie	Es liegt ein Verstoß gegen die Richtlinie für Formatierungszeichen vor.
`2023` – Ungültige Anzahl an Produkten	Das section-Objekt enthält keine Produkte, oder die Gesamtanzahl an Produkten hat die maximal zulässige Anzahl überschritten.
`2024` – Katalog-ID nicht gefunden	Die angegebene Katalog-ID ist nicht vorhanden oder gehört nicht zu deinem WhatsApp Business Account (WABA).
`2025` – Katalog-ID ist nicht mit der API-Nummer verknüpft	Die angegebene Katalog-ID ist nicht mit der Telefonnummer, mit der du eine Nachricht sendest, verbunden.
`2026` Produkte fehlen	Einige in deiner Anfrage angegebenen Produkte wurden nicht im Katalog gefunden.
`2027` – Keine Produkte gefunden	Im angegebenen Katalog wurden keine Produkte gefunden.
`2028` – Kein Produkt entspricht den Compliance-Vorgaben	Nur für Unternehmen in Indien verfügbar. Dieser Fehler wird zurückgegeben, wenn ein Unternehmen eine Nachricht für einzelne Produkte mit fehlenden oder unvollständigen E-Commerce-Compliance-Informationen sendet.
`2029` – Einige Produkte entsprechen nicht den Compliance-Vorgaben	Nur für Unternehmen in Indien verfügbar. Dieser Fehler wird zurückgegeben, wenn ein Unternehmen eine Nachricht für mehrere Produkte mit fehlenden oder unvollständigen E-Commerce-Compliance-Informationen sendet.
`2030` – Einige Produkte sind ungültig und einige entsprechen nicht den Compliance-Vorgaben	Nur für Unternehmen in Indien verfügbar. Dieser Fehler wird zurückgegeben, wenn ein Unternehmen eine Nachricht für mehrere Produkte sendet, bei denen einige ungültig sind und für andere Compliance-Informationen fehlen.
`2036` – Ungültige Kopfzeilenstruktur	Wird zurückgegeben, wenn die Struktur des `header`-Objekts ungültig ist.
`2050` – Fehlende Compliance-Infos	Nur für Unternehmen in Indien verfügbar. Dieser Fehler wird zurückgegeben, wenn ein Unternehmen keine Compliance-Informationen angegeben hat. Siehe Business Compliance-Endpunkt.
`2060` – Vorlage abgelehnt	Der Vorlagenstatus lautet `REJECTED`. Das Senden ist nicht möglich.
`2061` – Vorlage pausiert	Der Vorlagenstatus lautet `PAUSED`. Das Senden ist nicht möglich.
`2062` – Vorlage deaktiviert	Der Vorlagenstatus lautet `DISABLED`. Das Senden ist nicht möglich.
`2064` - Ungültige Vorgangs-ID	Es existiert kein Vorgang mit der angegebenen ID oder er gehört nicht zu deinem WhatsApp Business-Konto (WABA) beziehungsweise der Status ist „Ungültig“.
`2068` – Vorgang ist blockiert	Vorgang befindet sich im Status „Blockiert“. Dieser Fehler kann auch zurückgegeben werden, wenn der Vorgang einen Endpunkt verwendet und die erforderliche Einrichtung unvollständig ist (z. B. wurde der öffentliche Schlüssel nicht hochgeladen oder ist nicht mehr gültig). Siehe Implementierung eines Endpunkts für Vorgänge.
`2069` – Vorgang ist gedrosselt	Der Vorgang befindet sich im Status „Gedrosselt“ und 10 Nachrichten, die diesen Vorgang verwenden, wurden in der letzten Stunde bereits gesendet.

Informationen zu Commerce Manager-Fehlercodes, die speziell für Unternehmen in Indien gelten, findest du im Hilfebereich für Unternehmen.

HTTP-Statuscodes

Diese HTTP-Statuscodes werden möglicherweise vom WhatsApp Business API-Client verwendet.

HTTP-Code	Beschreibung
`2xx`	Erfolg
`200`	Erfolg (OK)
`201`	Erfolgreich erstellt (für POST-Anfragen)
`302`	Gefunden
`4xx`	Client-Fehler
`400`	Anfrage war ungültig
`401`	Nicht autorisiert
`403`	Unzulässig
`404`	Nicht gefunden
`405`	Methode nicht zulässig.
`412`	Vorbedingung nicht erfüllt
`420`	Für Nachricht gilt eine Ratenbegrenzung
`429`	Zu viele Anfragen
`5xx`	Serverfehler
`500`	Interner Serverfehler
`504`	Zeitüberschreitung

WhatsApp Business Platform | Cloud API | On-Premises API | Business Management API