Fehlercodes
Diese Seite listet die Fehlercodes auf, die beim Senden und Zustellen einer WhatsApp-Nachricht auftreten können, einschließlich der Bedeutung jedes Codes und der empfohlenen Vorgehensweise.
Die Fehlercodes stammen aus zwei Quellen. Bitte prüfen Sie zunächst, welche davon zutrifft, und ziehen Sie dann den entsprechenden Abschnitt weiter unten heran:
| Quelle | Nummerierung |
|---|---|
| Offizielle Meta-Fehlercodes | Identisch mit den offiziellen Meta-Codes |
| EngageLab-Plattformfehlercodes | Von EngageLab definiert |
Geltungsbereich: Diese Seite behandelt ausschließlich das Senden und Zustellen von Nachrichten. Fehlercodes auf Ebene des API-Aufrufs finden Sie im Abschnitt „Fehlercodes“ der Dokumentation zur Nachrichtenversand-API und zur Vorlagenverwaltungs-API.
Offizielle Meta-Fehlercodes
Die folgenden Fehlercodes werden von Meta definiert, und die Codenummern sind mit den offiziellen Meta-Codes identisch. Weitere Informationen finden Sie in der offiziellen Meta-Dokumentation.
Ratenbegrenzung und Durchsatz
Diese Fehler zeigen an, dass eine Versandraten- oder Volumengrenze erreicht wurde. Die Nachricht selbst ist dabei nicht das Problem – der Versand wird nach einer Wartezeit und einem erneuten Versuch fortgesetzt.
| Code | Fehler | Beschreibung | Empfohlene Maßnahme |
|---|---|---|---|
| 4 | API-Aufruflimit erreicht | Die App hat ihr Limit für die API-Aufrufrate erreicht. | Reduzieren Sie die Aufruffrequenz oder versuchen Sie es später erneut. |
| 80007 | Konto-Ratenlimit erreicht | Das WhatsApp Business-Konto (WABA) hat sein Versandratenlimit erreicht. | Verlangsamen Sie das Versandtempo und versuchen Sie es später erneut. Versenden Sie Massenkampagnen in gleichmäßig getakteten Chargen. |
| 130429 | Nachrichtendurchsatz-Limit erreicht | Die maximale Anzahl an Nachrichten, die pro Zeiteinheit gesendet werden können, ist erreicht. | Reduzieren Sie die Anzahl gleichzeitiger Sendevorgänge und versuchen Sie es erneut. Wenn Ihr Geschäft einen höheren Durchsatz erfordert, wenden Sie sich an den technischen Support von EngageLab, um ein Upgrade zu prüfen. |
| 131048 | Spam-Rate-Limit erreicht | Zahlreiche kürzlich von dieser Absendernummer gesendete Nachrichten wurden blockiert oder als Spam gemeldet, wodurch eine Versandbeschränkung ausgelöst wurde. | Prüfen Sie die Qualitätsbewertung der Nummer im WhatsApp Manager und verbessern Sie Inhalt und Zielgruppengenauigkeit, bevor Sie erneut senden. |
| 131056 | Zu viele Nachrichten an denselben Empfänger | In kurzer Zeit wurden zu viele Nachrichten an denselben Empfänger gesendet. | Vergrößern Sie den Abstand zwischen Nachrichten an denselben Nutzer. Der Versand an andere Empfänger ist nicht betroffen. |
| 131064 | Nachrichtenlimit erreicht (Vorlagenkategorie) | Das Konto hat sein Nachrichtenlimit erreicht, weil Vorlagenkategorien (Marketing / Utility / Authentifizierung) falsch verwendet wurden. Betroffen sind sowohl Vorlagennachrichten als auch reguläre Nachrichten. | Prüfen Sie, ob die Vorlagenkategorien dem tatsächlichen Verwendungszweck entsprechen. Die Beschränkung wird nach Ablauf des Durchsetzungszeitraums automatisch aufgehoben. |
Konto und Berechtigungen
Diese Fehler betreffen den Kontostatus, die Anbindungskonfiguration oder Richtlinienmaßnahmen. Ein erneuter Versuch behebt sie nicht.
| Code | Fehler | Beschreibung | Empfohlene Maßnahme |
|---|---|---|---|
| 0 | Authentifizierung fehlgeschlagen | Das für die Anbindung an Meta verwendete Zugriffstoken ist nicht mehr gültig. | Dies ist ein Problem auf Seiten der Plattformanbindung. Bitte wenden Sie sich an den technischen Support von EngageLab. |
| 3 | Fehlende Funktion oder Berechtigung | Die für diesen Endpunkt erforderliche Funktion oder Berechtigung fehlt. | Wenden Sie sich an den technischen Support von EngageLab, um die erforderliche Berechtigung freischalten zu lassen. |
| 10 | Berechtigung verweigert | Die Berechtigung wurde nie erteilt oder wurde entfernt. | Wenden Sie sich an den technischen Support von EngageLab, um die Berechtigungen prüfen zu lassen. |
| 190 | Zugriffstoken abgelaufen | Das für die Anbindung an Meta verwendete Zugriffstoken ist abgelaufen. | Dies ist ein Problem auf Seiten der Plattformanbindung. Wenden Sie sich an den technischen Support von EngageLab, um es zu erneuern. |
| 200 | Kein Zugriffstoken bereitgestellt | Die Anfrage enthielt kein gültiges Zugriffstoken. | Dies ist ein Problem der Anbindungskonfiguration. Bitte wenden Sie sich an den technischen Support von EngageLab. |
| 368 | Wegen Richtlinienverstoß vorübergehend gesperrt | Das WhatsApp Business-Konto wurde wegen eines Verstoßes gegen eine Plattformrichtlinie eingeschränkt oder deaktiviert. | Prüfen Sie kürzlich gesendete Inhalte und Vorlagen auf Richtlinienkonformität. Details zur Maßnahme und die Möglichkeit zum Einspruch finden Sie im Meta Business Manager. Die Einschränkung wird nach Ablauf des Durchsetzungszeitraums automatisch aufgehoben. |
| 130497 | Versand an Nutzer in bestimmten Ländern eingeschränkt | Das WhatsApp Business-Konto darf keine Nachrichten an Nutzer in bestimmten Ländern oder Regionen senden. | Prüfen Sie, ob das Land bzw. die Region des Empfängers zulässig ist. Einzelheiten finden Sie in der WhatsApp Business Messaging Policy. |
| 131005 | Zugriff verweigert | Die für diesen Endpunkt erforderliche Berechtigung wurde nie erteilt oder wurde entfernt. | Wenden Sie sich an den technischen Support von EngageLab, um die Berechtigungen prüfen zu lassen. |
| 131031 | Konto gesperrt | Das WhatsApp Business-Konto wurde wegen eines Verstoßes gegen eine Plattformrichtlinie eingeschränkt oder deaktiviert. | Wenden Sie sich an den technischen Support von EngageLab, um den Kontostatus prüfen zu lassen. Den Zustand Ihres Kontos können Sie auch im Meta Business Manager einsehen. |
| 131042 | Zahlungsproblem | Es liegt ein Problem mit der Zahlungsmethode oder dem Kreditrahmen vor – zum Beispiel kein hinterlegtes Zahlungskonto, ein überschrittener oder inaktiver Kreditrahmen oder fehlende Einstellungen für Zeitzone und Währung. | Prüfen Sie im Meta Business Manager, ob Zahlungskonto, Kreditrahmen, Zeitzone und Währung vollständig und korrekt eingerichtet sind. |
| 131057 | Business-Konto im Wartungsmodus | Das WhatsApp Business-Konto wird gerade gewartet oder aktualisiert. | Versuchen Sie es später erneut. |
| 131063 | Marketing-Vorlagen in der Cloud API deaktiviert | Die Vorlage ist als Marketing kategorisiert, Marketing-Vorlagen sind jedoch in der Cloud-API-Konfiguration des Kontos deaktiviert. | Aktivieren Sie Marketing-Nachrichten für das Konto wieder oder verwenden Sie stattdessen eine Utility- oder Authentifizierungsvorlage. |
| 134011 | WhatsApp Payments-Nutzungsbedingungen nicht akzeptiert | Das WhatsApp Business-Konto hat die Nutzungsbedingungen von WhatsApp Payments noch nicht akzeptiert. | Akzeptieren Sie die Bedingungen über den Link in der Fehlermeldung und versuchen Sie es erneut. |
Versand und Empfänger
Diese Fehler betreffen den Inhalt der Anfrage, den Status des Empfängers oder das Nachrichtenfenster.
| Code | Fehler | Beschreibung | Empfohlene Maßnahme |
|---|---|---|---|
| 1 | Ungültige Anfrage oder Serverfehler | Die Anfrage ist fehlerhaft aufgebaut oder es ist ein Serverfehler auf Seiten von Meta aufgetreten. | Prüfen Sie das Anfrageformat anhand der API-Dokumentation. Ist das Format korrekt, versuchen Sie es später erneut. |
| 2 | Vorübergehender Ausfall oder Überlastung | Der Dienst von Meta ist aufgrund eines Ausfalls oder einer Überlastung vorübergehend nicht verfügbar. | Versuchen Sie es später erneut. |
| 100 | Ungültiger oder falsch geschriebener Parameter | Die Anfrage enthielt einen oder mehrere nicht unterstützte, falsch geschriebene oder zu lange Parameter. | Prüfen Sie Parameternamen, Werte und Längenbeschränkungen anhand der API-Dokumentation. |
| 130403 | Unternehmen hat den Nutzer auf WhatsApp blockiert | Ihre Unternehmensnummer hat diesen Empfänger auf WhatsApp blockiert. | Nicht erneut versuchen. Heben Sie die Blockierung des Nutzers zuerst im WhatsApp Manager auf und senden Sie die Nachricht dann erneut. |
| 130472 | Nachricht im Rahmen eines Experiments nicht gesendet | Der Empfänger wurde in ein Meta-Marketingnachrichten-Experiment (Kontrollgruppe) einbezogen, sodass die Nachricht gemäß den Experimentregeln nicht gesendet wurde. | Keine Maßnahme erforderlich. Dies weist nicht auf ein Problem mit Ihrer Nachricht oder Ihrem Konto hin. |
| 131000 | Unbekannter Fehler | Die Nachricht konnte aufgrund eines unbekannten Fehlers nicht gesendet werden. | Versuchen Sie es später erneut. Bei anhaltendem Fehler wenden Sie sich an den technischen Support von EngageLab. |
| 131008 | Erforderlicher Parameter fehlt | In der Anfrage fehlt ein erforderlicher Parameter. | Ergänzen Sie die erforderlichen Parameter gemäß der API-Dokumentation und senden Sie erneut. |
| 131009 | Parameterwert ungültig | Einer oder mehrere Parameterwerte sind ungültig. | Prüfen Sie die unterstützten Werte und Formate der einzelnen Parameter in der API-Dokumentation. |
| 131016 | Dienst vorübergehend nicht verfügbar | Ein Dienst auf Seiten von Meta ist vorübergehend nicht verfügbar. | Versuchen Sie es später erneut. |
| 131021 | Absender und Empfänger sind identisch | Die Empfängernummer ist identisch mit der Absendernummer. | Senden Sie an eine andere Empfängernummer. |
| 131026 | Zustellung an Empfänger nicht möglich | Der Empfänger ist kein WhatsApp-Nutzer, hat die aktuellen Nutzungsbedingungen nicht akzeptiert oder verwendet eine veraltete Client-Version. | Prüfen Sie, ob die Nummer bei WhatsApp registriert ist. Bitten Sie den Empfänger über einen anderen Kanal, die aktuellen Bedingungen zu akzeptieren und WhatsApp zu aktualisieren. |
| 131037 | Kein genehmigter Anzeigename | Für die Absendernummer ist kein genehmigter Anzeigename hinterlegt. | Lassen Sie zuerst den Anzeigenamen genehmigen und senden Sie anschließend. |
| 131045 | Registrierungsfehler der Rufnummer | Die Nachricht ist aufgrund eines Registrierungsproblems der Absendernummer fehlgeschlagen. | Prüfen Sie, ob die Absendernummer vollständig registriert ist. Liegt ein Problem vor, registrieren Sie die Nummer erneut. |
| 131047 | Außerhalb des 24-Stunden-Nachrichtenfensters | Seit der letzten Antwort des Empfängers sind mehr als 24 Stunden vergangen, sodass keine Freitextnachrichten mehr gesendet werden können. | Verwenden Sie stattdessen eine genehmigte Vorlagennachricht. Das 24-Stunden-Fenster öffnet sich erneut, sobald der Nutzer antwortet. |
| 131049 | Nachricht nicht zugestellt, um ein gesundes Ökosystem-Engagement zu erhalten | Der Empfänger hat das Limit für Marketing-Vorlagennachrichten erreicht, die er innerhalb eines bestimmten Zeitraums erhalten kann. | Warten Sie mindestens 24 Stunden vor einem erneuten Versand und steuern Sie Häufigkeit und Relevanz Ihrer Marketingnachrichten. |
| 131050 | Nutzer hat Marketing abbestellt | Der Empfänger möchte keine Marketingnachrichten Ihres Unternehmens mehr erhalten. | Nicht erneut versuchen. Entfernen Sie den Nutzer aus Ihrer Marketingliste und senden Sie nur noch notwendige Utility-Nachrichten. |
| 131051 | Nicht unterstützter Nachrichtentyp | Es wurde ein nicht unterstützter Nachrichtentyp verwendet. | Verwenden Sie einen unterstützten Nachrichtentyp gemäß der Dokumentation zur Nachrichtenversand-API. |
| 131052 | Download der Mediendatei fehlgeschlagen | Die vom Nutzer gesendeten Medieninhalte konnten nicht heruntergeladen werden. | Bitten Sie den Nutzer, die Datei über einen anderen Kanal bereitzustellen. |
| 131053 | Upload der Mediendatei fehlgeschlagen | Die Mediendatei in der Nachricht konnte nicht hochgeladen werden. | Prüfen Sie, ob Format und Größe der Datei den Anforderungen entsprechen, und versuchen Sie es erneut. |
Vorlagen und Flows
Diese Fehler betreffen den Status, den Inhalt oder die Parameterwerte der Vorlage.
| Code | Fehler | Beschreibung | Empfohlene Maßnahme |
|---|---|---|---|
| 132000 | Anzahl der Vorlagenparameter stimmt nicht überein | Die Anzahl der übergebenen Variablen entspricht nicht der in der Vorlage definierten Anzahl. | Ergänzen oder entfernen Sie Parameter, sodass sie der tatsächlichen Variablenanzahl der Vorlage entsprechen, und senden Sie erneut. |
| 132001 | Vorlage fehlt oder ist nicht genehmigt | Die Vorlage existiert in der angegebenen Sprache nicht oder wurde nicht genehmigt. | Prüfen Sie, ob Vorlagenname und Sprachcode exakt übereinstimmen (einschließlich Groß-/Kleinschreibung und Unterstrichen) und der Status der Vorlage „Genehmigt“ lautet. |
| 132005 | Übersetzter Text zu lang | Die Übersetzung der Vorlage für diese Sprache überschreitet die Längenbeschränkung. | Kürzen Sie den Vorlagentext für die betreffende Sprache. |
| 132007 | Vorlageninhalt verstößt gegen Richtlinien | Der Inhalt der Vorlage verstößt gegen eine WhatsApp-Richtlinie. | Überarbeiten Sie den Inhalt gemäß den Prüfrichtlinien für Vorlagen und reichen Sie ihn erneut zur Prüfung ein. |
| 132012 | Vorlagenparameter-Format ungültig | Das Format der Variablenwerte entspricht nicht dem in der Vorlage definierten Format. | Übergeben Sie die Variablen in dem von der Vorlage definierten Format. |
| 132015 | Vorlage wegen geringer Qualität pausiert | Die Vorlage wurde wegen einer niedrigen Qualitätsbewertung pausiert und kann nicht gesendet werden. | Bearbeiten Sie die Vorlage, um ihre Qualität zu verbessern, und verwenden Sie sie nach erneuter Genehmigung. Nutzen Sie in der Zwischenzeit eine andere genehmigte Vorlage. |
| 132016 | Vorlage dauerhaft deaktiviert (geringe Qualität) | Die Vorlage wurde zu oft wegen geringer Qualität pausiert und ist nun dauerhaft deaktiviert. | Die Vorlage kann nicht wiederhergestellt werden. Erstellen Sie eine neue Vorlage mit anderem Inhalt. |
| 132018 | Validierungsfehler der Vorlagenparameter | Die Parameter in der Vorlage haben die Validierung nicht bestanden. | Korrigieren Sie die Parameterkonfiguration anhand der Fehlermeldung und senden Sie erneut. |
| 132068 | Flow blockiert | Der verwendete Flow befindet sich im Status „blockiert“. | Prüfen und korrigieren Sie die Flow-Konfiguration oder erreichen Sie den Nutzer auf anderem Weg. |
| 132069 | Flow gedrosselt | Über diesen Flow wurden in der letzten Stunde bereits 10 Nachrichten gesendet, wodurch eine Drosselung ausgelöst wurde. | Warten Sie das Ende des Drosselungsfensters ab, bevor Sie erneut senden. |
Registrierung und Verifizierung von Rufnummern
| Code | Fehler | Beschreibung | Empfohlene Maßnahme |
|---|---|---|---|
| 133000 | Abmeldung nicht abgeschlossen | Ein früherer Abmeldeversuch ist fehlgeschlagen, sodass die Nummer nicht erneut registriert werden kann. | Melden Sie die Nummer erneut ab und registrieren Sie sie anschließend. |
| 133004 | Server vorübergehend nicht verfügbar | Der Server von Meta ist vorübergehend nicht verfügbar. | Versuchen Sie es später erneut. |
| 133005 | PIN der zweistufigen Verifizierung falsch | Die in der Anfrage enthaltene PIN der zweistufigen Verifizierung ist falsch. | Prüfen Sie die PIN. Falls Sie sie vergessen haben, deaktivieren Sie die zweistufige Verifizierung und legen Sie eine neue PIN fest. |
| 133006 | Erneute Verifizierung der Rufnummer erforderlich | Die Nummer muss verifiziert werden, bevor sie registriert werden kann. | Verifizieren Sie die Nummer zuerst und registrieren Sie sie anschließend. |
| 133008 | Zu viele PIN-Versuche | Die PIN wurde zu oft falsch eingegeben und ist vorübergehend gesperrt. | Warten Sie, bis die Sperre aufgehoben ist, und versuchen Sie es erneut. |
| 133009 | PIN zu schnell eingegeben | Die PIN wurde zu häufig übermittelt. | Versuchen Sie es später erneut. |
| 133010 | Rufnummer nicht registriert | Die Nummer ist nicht auf der WhatsApp Business Platform registriert. | Registrieren Sie die Nummer, bevor Sie senden. |
| 135000 | Unbekannter Fehler bei den Anfrageparametern | In den Anfrageparametern liegt ein unbekannter Fehler vor. | Prüfen Sie Syntax und Parameter der Anfrage anhand der API-Dokumentation. Besteht der Fehler weiterhin, wenden Sie sich an den technischen Support von EngageLab. |
Status der Absendernummer
| Code | Fehler | Beschreibung | Empfohlene Maßnahme |
|---|---|---|---|
| 33 | Geschäftliche Telefonnummer wurde gelöscht | Die für den Versand verwendete geschäftliche Telefonnummer wurde gelöscht. | Prüfen Sie die Absendernummer. Wurde sie gelöscht, verwenden Sie eine andere gültige Absendernummer oder registrieren Sie sie erneut. |
| 133015 | Rufnummer kürzlich gelöscht; Löschung noch nicht abgeschlossen | Die Nummer wurde kürzlich gelöscht, der Löschvorgang ist noch nicht abgeschlossen. | Warten Sie etwa 5 Minuten und versuchen Sie es erneut. |
| 133016 | Zu viele Registrierungs-/Abmeldeversuche; Nummer vorübergehend gesperrt | Für diese Nummer gab es in kurzer Zeit zu viele Registrierungs- oder Abmeldeversuche, sodass sie vorübergehend gesperrt ist. | Warten Sie, bis die Sperre aufgehoben ist, und vermeiden Sie in der Zwischenzeit wiederholte Versuche. |
EngageLab-Plattformfehlercodes
| Code | Fehler | Beschreibung | Empfohlene Maßnahme |
|---|---|---|---|
| 1 | Ungültige Empfängernummer | Das Format der Empfängernummer ist ungültig und hat die Prüfung nicht bestanden. | Prüfen Sie, ob die Nummer ausschließlich Ziffern enthält, die Ländervorwahl umfasst und kein +, keine Leerzeichen und keine Bindestriche enthält, und senden Sie sie korrigiert erneut. |
| 5000 | Zeitüberschreitung beim Senden | Bei der Übermittlung der Nachricht an Meta ist eine Zeitüberschreitung aufgetreten, die Nachricht wurde nicht gesendet. | Versuchen Sie es später erneut. |
| 5001 | Nicht ausreichendes Guthaben; Nachricht nicht gesendet | Das Kontoguthaben reicht nicht aus, die Nachricht wurde nicht gesendet. | Laden Sie Ihr Konto in der Konsole auf und senden Sie erneut. Wir empfehlen, Guthabenwarnungen zu aktivieren. |
