--- title: "WhatsApp-Cloud-API-Fehlercodes: Bedeutung und Lösung" description: "Die häufigsten Fehlercodes der WhatsApp Cloud API, von 131047 und 131026 bis 132001 und 130429: Bedeutung, Lösung und wann Sie nicht wiederholen sollten." canonical: "https://omnichannels.ai/de/blog/whatsapp-api-error-codes-troubleshooting/" language: "de" updated: "2026-10-10" publisher: "BroadNet Technologies" brand: "OmniChannels.ai" category: "whatsapp" primaryQuery: "whatsapp cloud api fehlercodes" keywords: ["whatsapp fehler 131047", "whatsapp fehler 131026", "whatsapp fehler 131049", "whatsapp fehler 132001", "whatsapp api nachricht fehlgeschlagen", "whatsapp rate limit 130429", "whatsapp fehler 131048"] published: "2026-10-10" author: "OmniChannels.ai Editorial Team" reviewer: "BroadNet Messaging Solutions Team" readingMinutes: 8 answer: "Fehler der WhatsApp Cloud API lassen sich in wenige Familien einteilen: Autorisierung (0, 190, 10), Integrität (368, 131031), Drosselung (4, 80007, 130429, 131048, 131049, 131056), Vorlagenprobleme (132000 bis 132016), Empfängerprobleme (131026, 131047, 131050) und Anfrageprobleme (131008, 131009). Lesen Sie den Code und die Details in error_data und entscheiden Sie dann: korrigieren und erneut senden, warten und erneut senden, auf eine Vorlage oder einen anderen Kanal wechseln oder nie wiederholen." takeaways: ["Fehler 131047 bedeutet, dass das 24-Stunden-Kundenservice-Fenster geschlossen ist; senden Sie eine genehmigte Vorlage statt einer Freitextnachricht.", "Fehler 131050 bedeutet, dass der Nutzer Marketingnachrichten beendet hat; laut Meta nicht erneut versuchen.", "Fehler 131049 ist ein Marketinglimit pro Nutzer; Meta rät, vor einem erneuten Versand mindestens 24 Stunden zu warten.", "Die Fehler 132000 und 132012 sind fast immer Abweichungen bei Anzahl oder Formatierung der Variablen gegenüber der genehmigten Vorlage.", "Manche Fehler kommen synchron in der API-Antwort, andere später in Status-Webhooks mit dem Status failed; Sie müssen daher beides protokollieren."] faq: - q: "Was bedeutet der WhatsApp-Fehler 131047?" a: "Fehler 131047 bedeutet, dass seit der letzten Nachricht des Empfängers an Ihre Nummer mehr als 24 Stunden vergangen sind und das Kundenservice-Fenster damit geschlossen ist. Freitext, Medien und interaktive Nachrichten sind dann nicht mehr erlaubt. Senden Sie stattdessen eine genehmigte Vorlage, am besten eine Utility-Vorlage, die den Kunden zur Antwort einlädt; antwortet er, öffnet sich das Fenster wieder." - q: "Warum erhalte ich Fehler 131026, obwohl die Nummer bei WhatsApp ist?" a: "Meta beschreibt 131026 als nicht zustellbar. Ursachen sind etwa eine Nummer ohne WhatsApp, ein Empfänger, der die neuesten Nutzungsbedingungen nicht akzeptiert hat, oder eine veraltete WhatsApp-Version. Auch eine falsche Ländervorwahl oder ein lokales Format ist ein häufiger Grund. Prüfen Sie die Nummer im internationalen Format, bitten Sie den Kunden, die App zu aktualisieren, oder nutzen Sie SMS oder E-Mail." - q: "Was ist der Unterschied zwischen 130429 und 131056?" a: "130429 bedeutet, dass Ihre Nummer das Durchsatzlimit der Cloud API erreicht hat, Sie also insgesamt zu schnell senden; drosseln Sie und nutzen Sie eine Warteschlange. 131056 bedeutet, dass Sie in kurzer Zeit zu viele Nachrichten an denselben Empfänger gesendet haben; andere Empfänger sind nicht betroffen. 130429 beheben Sie mit Ratensteuerung, 131056 durch größere Abstände zwischen Nachrichten an diesen einen Nutzer." - q: "Sollte ich fehlgeschlagene WhatsApp-Nachrichten automatisch wiederholen?" a: "Nur bei vorübergehenden Fehlern wie 131000 (unbekannt), 131016 (Dienst nicht verfügbar), 130429 (Durchsatz) sowie 4 oder 80007 (Ratenlimits), und zwar mit exponentiellem Backoff. Wiederholen Sie niemals automatisch 131050 (Marketing-Abmeldung), 131026 ohne eine Änderung, Vorlagenfehler oder 368 (Richtlinienbeschränkung). Blinde Wiederholungen verschwenden Budget, verärgern Nutzer und können die Qualität verschlechtern." - q: "Wo sehe ich die vollständigen Fehlerdetails?" a: "Synchrone Fehler kommen in der API-Antwort mit code, message und error_data zurück. Asynchrone Fehlschläge treffen im Nachrichten-Webhook als Status failed ein, mit einem errors-Array, das Code, Titel und Details enthält. Protokollieren Sie das gesamte Objekt, nicht nur den Code, denn das Feld details nennt oft den genauen Parameter oder das konkrete Medienproblem." sources: - title: "Fehlercodes — WhatsApp Cloud API, Meta for Developers" url: "https://developers.facebook.com/docs/whatsapp/cloud-api/support/error-codes" - title: "Referenz zum Status-Webhook für Nachrichten — Meta for Developers" url: "https://developers.facebook.com/docs/whatsapp/cloud-api/webhooks/reference/messages/status" - title: "Über die Plattform: Ratenlimits und Verschlüsselung — Meta for Developers" url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/about-the-platform" --- # WhatsApp-Cloud-API-Fehlercodes: Bedeutung und Lösung Canonical: https://omnichannels.ai/de/blog/whatsapp-api-error-codes-troubleshooting/ Language: de Publisher: OmniChannels.ai by BroadNet Technologies Dieser Leitfaden richtet sich an Entwickler und Messaging-Operations-Teams, die fehlgeschlagene WhatsApp-Nachrichten sehen und schnell wissen müssen, ob sie die Anfrage korrigieren, warten, den Nachrichtentyp wechseln oder aufhören sollen. Jeder Code unten wurde mit Metas Referenz zu den Cloud-API-Fehlercodes abgeglichen; Codes und Formulierungen ändern sich, prüfen Sie daher vor dem Hartcodieren von Logik die aktuelle Seite. ## Wo treten WhatsApp-Cloud-API-Fehler auf? Fehler treten an zwei Stellen auf, und Sie müssen beide erfassen. Anfragefehler kommen sofort in der API-Antwort zurück; Zustellfehler treffen später in einem Status-Webhook ein. - **Synchrone Fehler.** Die Sendeanfrage wird abgelehnt, und die Antwort enthält ein `error`-Objekt mit `code`, `message`, `type` und oft `error_data.details`. Typische Beispiele sind abgelaufene Tokens, fehlende Parameter und Vorlagenabweichungen. - **Asynchrone Fehler.** Die Sendeanfrage gelingt und liefert eine Nachrichten-ID, doch ein späterer Webhook meldet `status: failed` mit einem `errors`-Array. Typische Beispiele sind geschlossene Kundenservice-Fenster, nicht zustellbare Empfänger und Marketinglimits. Ein häufiger Fehler ist, nur die HTTP-Antwort zu protokollieren. Teams glauben dann, eine Kampagne sei erfolgreich gewesen, weil jede Anfrage eine Nachrichten-ID zurückgab, während Hunderte Nachrichten in Webhooks fehlschlugen. Wie die Status zusammenhängen, lesen Sie unter [gesendet, zugestellt, gelesen und fehlgeschlagen erklärt](/de/blog/message-delivery-status-explained/). ## Welche WhatsApp-Fehlercodes sind am häufigsten? Die Tabelle listet die Codes auf, denen die meisten Teams begegnen, gruppiert danach, was als Nächstes zu tun ist. Die Beschreibungen geben Metas Referenz sinngemäß wieder. | Code | Bedeutung | Lösung | Wiederholen? | |---|---|---|---| | 0 | App-Nutzer konnte nicht authentifiziert werden; Token abgelaufen oder widerrufen | Neues Zugriffstoken erzeugen | Nach Korrektur | | 190 | Zugriffstoken ist abgelaufen | Nicht ablaufendes System-User-Token verwenden, erneuern | Nach Korrektur | | 3, 10, 200–299 | Berechtigung oder Fähigkeit fehlt | Token-Berechtigungen im Access Token Debugger prüfen | Nach Korrektur | | 368 | WABA wegen Richtlinienverstoß eingeschränkt oder deaktiviert | Durchsetzung der Richtlinien im WhatsApp Manager prüfen; bei Irrtum Einspruch einlegen | Nein | | 131031 | Konto gesperrt, etwa wegen Richtlinien- oder Datenverifizierungsfehler | Kontostatus prüfen; mit Meta klären | Nein | | 4 | App hat das Ratenlimit für API-Aufrufe erreicht | Anfragevolumen senken; App Dashboard prüfen | Ja, später | | 80007 | WABA hat ihr Ratenlimit erreicht | Anfragevolumen senken; später erneut versuchen | Ja, später | | 130429 | Cloud-API-Durchsatz für die Nummer erreicht | Warteschlange nutzen und langsamer senden | Ja, mit Backoff | | 131048 | Spam-Ratenlimit: Einschränkungen für Nachrichten dieser Nummer | Qualität im WhatsApp Manager prüfen; Inhalt und Zielgruppenansprache verbessern | Nicht sofort | | 131049 | Nicht zugestellt, „um ein gesundes Engagement im Ökosystem zu erhalten“ | Vor erneutem Senden mindestens 24 Stunden warten | Nicht innerhalb von 24 h | | 131056 | Zu viele Nachrichten an denselben Empfänger in kurzer Zeit | Nachrichten an diesen Nutzer zeitlich strecken | Ja, später | | 131000 | Unbekannter Fehler | Erneut versuchen; bei Fortbestehen Support-Ticket öffnen | Ja, begrenzt | | 131016 | Dienst vorübergehend nicht verfügbar | Meta-Statusseite prüfen; erneut versuchen | Ja, mit Backoff | | 131008 | Pflichtparameter fehlt | Payload mit der Endpunkt-Referenz vergleichen | Nach Korrektur | | 131009 | Parameterwert ungültig | Werte prüfen, etwa Format der Telefonnummer oder IDs | Nach Korrektur | | 131021 | Absender und Empfänger sind dieselbe Nummer | An eine andere Nummer senden | Nein | | 131026 | Nachricht nicht zustellbar | Nummer prüfen, Nutzer zum Update von WhatsApp bitten oder anderen Kanal nutzen | Nicht unverändert | | 131042 | Problem mit der Zahlungsmethode | Abrechnung korrigieren: Zahlungskonto, Kreditlinie, Währung | Nach Korrektur | | 131045 / 133010 | Nummer nicht auf der Plattform registriert | Geschäftsrufnummer registrieren | Nach Korrektur | | 131047 | Mehr als 24 Stunden seit der letzten Antwort des Nutzers | Genehmigtes Vorlage senden | Als Vorlage | | 131050 | Nutzer hat Marketingnachrichten beendet | Nicht wiederholen; Präferenz respektieren | Nie | | 131051 | Nicht unterstützter Nachrichtentyp | Unterstützten Typ verwenden | Nach Korrektur | | 131052 | Vom Nutzer gesendetes Medium konnte nicht heruntergeladen werden | Nutzer bitten, es erneut zu senden | entfällt | | 131053 | Medium Ihrer Nachricht konnte nicht hochgeladen werden | MIME-Typ, Größe und URL prüfen | Nach Korrektur | | 131057 | Konto im Wartungsmodus | Abwarten; kann bei einem Durchsatz-Upgrade auftreten | Ja, später | | 132000 | Variablenanzahl passt nicht zur Vorlage | Genau die definierte Anzahl Parameter senden | Nach Korrektur | | 132001 | Vorlage in dieser Sprache nicht vorhanden oder nicht genehmigt | Name, Sprachcode und Status prüfen | Nach Korrektur | | 132005 | Übersetzter Text zu lang | Vorlagenübersetzung kürzen | Nach Korrektur | | 132007 | Vorlageninhalt verstößt gegen Richtlinien | Gemäß den Prüfregeln für Vorlagen überarbeiten | Nach Korrektur | | 132012 | Variablenwerte falsch formatiert | Erwartetes Format einhalten | Nach Korrektur | | 132015 | Vorlage wegen niedriger Qualität pausiert | Inhalt zur Qualitätsverbesserung überarbeiten | Nach Überarbeitung | | 132016 | Vorlage nach wiederholten Pausen dauerhaft deaktiviert | Neues Vorlage mit anderem Inhalt erstellen | Nein | | 135000 | Unbekannter Fehler bei den Anfrageparametern | Anfragesyntax prüfen; Support kontaktieren | Nach Korrektur | ## Wie beheben Sie die Fehler, die die meisten Kampagnenausfälle verursachen? In der Praxis verursachen wenige Codes die meisten Fehlschläge. Für jeden gibt es eine klare Entscheidungsregel. ### 131047: Das Kundenservice-Fenster ist geschlossen Der Kunde hat zuletzt vor mehr als 24 Stunden geschrieben. Freitext, Medien und interaktive Nachrichten sind nur innerhalb des 24-Stunden-Kundenservice-Fensters erlaubt; außerhalb müssen Sie eine genehmigte Vorlage verwenden, siehe [das 24-Stunden-Kundenservice-Fenster](/de/blog/whatsapp-24-hour-customer-service-window/). Agenten stoßen darauf häufig, wenn sie auf einen alten Chat antworten. Zeigen Sie Agenten den Fensterstatus an und bieten Sie nach Ablauf eine Vorlagenauswahl an. ### 131026: Nachricht nicht zustellbar Beginnen Sie mit der Nummernhygiene: internationales Format, korrekte Ländervorwahl, keine führende Null nach der Vorwahl. Akzeptieren Sie dann, dass manche Nummern schlicht nicht bei WhatsApp sind oder eine alte App-Version nutzen. Weichen Sie bei zeitkritischen Nachrichten wie OTPs auf SMS aus. Siehe [WhatsApp vs. SMS vs. RCS](/de/blog/whatsapp-vs-sms-vs-rcs/). ### 131049 und 131050: Marketinglimits und Abmeldungen Beide betreffen Marketingnachrichten. 131050 ist die ausdrückliche Entscheidung des Nutzers, kein Marketing mehr zu erhalten; schließen Sie diese Nutzer für Marketing aus und abonnieren Sie Metas Webhook für Nutzerpräferenzen. 131049 bedeutet, dass Meta die Zustellung zum Schutz des Nutzer-Engagements unterlassen hat; Meta rät, mindestens 24 Stunden zu warten, denn frühere Wiederholungen scheitern voraussichtlich erneut. Senken Sie die Frequenz und erhöhen Sie die Relevanz, statt erneut zu senden. ### 130429, 131048 und 131056: zu schnell oder zu viel gesendet 130429 betrifft den Durchsatz: Nachrichten in eine Warteschlange stellen und Backoff anwenden. 131056 gilt auf Paarebene: Sie schreiben einer Person zu oft. 131048 ist ein Qualitätssignal zur Absendernummer und erfordert eine Korrektur bei Inhalt und Zielgruppenansprache, keinen Wiederholungsversuch. Siehe [Nachrichtenlimits und Qualitätsbewertung](/de/blog/whatsapp-messaging-limits-quality-rating/). ### 132000, 132001 und 132012: Vorlagenabweichungen Dabei handelt es sich fast immer um Integrationsfehler. Vorlagenname, Sprachcode (zum Beispiel `ar` im Unterschied zu `en_US`) und Anzahl der Variablen müssen exakt dem genehmigten Stand entsprechen. Bauen Sie einen Test, der jede Vorlage nach einer Änderung mit Beispielwerten sendet. ## Eine Retry-Richtlinie, die Sie umsetzen können Mit dieser Checkliste klassifizieren Sie jeden Fehlschlag automatisch. 1. **Protokollieren** Sie Code, Titel, `error_data.details`, Nachrichten-ID, Empfänger und Vorlagennamen. 2. **Nie wiederholen** bei 131050, 131021, 132016, 368 und 131031. Melden Sie 368 und 131031 sofort an einen Administrator. 3. **Korrigieren, dann wiederholen** bei Fehlern zu Autorisierung (0, 190, 10), Parametern (131008, 131009, 135000), Vorlagen (132000 bis 132015) und Abrechnung (131042). Alarmieren Sie das zuständige Team. 4. **Mit Backoff wiederholen** bei 130429, 4, 80007, 131016 und 131057, mit exponentiellem Backoff und Obergrenze. 5. **Kanal oder Nachrichtentyp wechseln** bei 131047 (Vorlage) und 131026 (SMS oder E-Mail). 6. **24 Stunden oder länger warten** bei 131049 und die Kampagnenfrequenz überprüfen. 7. **Berichten** Sie Fehlschläge in Kampagnenberichten nach Code, nicht als einzelne Summe „fehlgeschlagen“. ## Praxisbeispiel: Die fehlgeschlagene Aktion eines Händlers in Riad Ein synthetisches Beispiel. „Najd Home“ sendet eine Marketing-Vorlage an 20.000 Kunden mit Einwilligung. Die API akzeptiert jede Anfrage, doch die Status-Webhooks zeigen rund 1.400 Fehlschläge. Nach Codes gruppiert ist das Bild klar. Die größte Gruppe ist 131049, daher nimmt das Team diese Nutzer aus den nächsten beiden Sendungen heraus und senkt die wöchentliche Frequenz. Eine kleinere Gruppe ist 131026; die Analyse zeigt, dass viele Nummern mit lokaler führender Null gespeichert waren, was eine Normalisierung behebt. Mehrere Nutzer mit 131050 werden dauerhaft für Marketing ausgeschlossen. Einige 130429-Fehler stammten vom anfänglichen Ansturm, daher wird der Versand jetzt über eine Warteschlange getaktet. ## Häufige Fehler und ehrliche Grenzen - **Jeden Fehlschlag als wiederholbar behandeln.** Das verschwendet Budget und kann die Qualität senken. - **Metas Text hartcodieren.** Meta aktualisiert Titel und Beschreibungen; richten Sie die Logik am numerischen Code aus und pflegen Sie eine Lookup-Tabelle, die Sie aktualisieren können. - **`error_data.details` ignorieren.** Es nennt oft den genau fehlerhaften Parameter. - **Nicht jeder Fehlschlag hat eine Lösung.** Manche Empfänger sind über WhatsApp nicht erreichbar, und Meta erklärt nicht jede 131049-Entscheidung. Planen Sie einen alternativen Kanal ein. ## So unterstützt Sie OmniChannels.ai OmniChannels.ai, die Plattform von BroadNet Technologies, stellt Teams Zustellberichte in Übersichts- und Detailansicht mit Filtern und CSV-Export bereit, sodass sich fehlgeschlagene Nachrichten pro Kampagne analysieren lassen. Schlägt WhatsApp fehl, kann der Kanal-Fallback die Nachricht erneut über RCS oder SMS senden. Vorlagen werden in einer Telefonvorschau geprüft und bis zur Genehmigung verfolgt, was Fehler durch nicht passende Vorlagen reduziert. [Webhooks](/developers/webhooks/) melden die Status FAILED und REJECTED in einem einheitlichen Format, und die öffentliche [Entwicklerdokumentation](/developers/) enthält eine Referenz zu [Fehlern und Limits](/developers/errors-and-limits/).