WhatsApp-API-Nachricht nicht zugestellt: die Ursachen in der Reihenfolge
Eine angenommene WhatsApp-API-Nachricht ist noch nicht zugestellt: Meta meldet das Ergebnis später in einem Status-Webhook, als sent, delivered, read oder failed, mit einem Fehlercode. Prüfen Sie der Reihe nach: den Status failed und seinen Code, das 24-Stunden-Fenster (131047), die Zahlungsmethode (131042), das Template (132001, 132015), den Empfänger (131026, 131049, 131050), danach die Limits und die Verbindung der Nummer.
easyCoexistence überwacht jede verbundene Nummer rund um die Uhr, schickt Ihnen eine E-Mail, wenn Meta nicht mehr zustellt, die Verbindung abbricht oder die Qualität sinkt, und leitet Metas Status-Webhooks unverändert an Ihr System weiter.
sent (ein Häkchen), delivered (zwei), read (zwei blaue) und failed (ein rotes Warndreieck), so wie Status-Webhooks sie melden.
Seit der letzten Antwort des Empfängers sind mehr als 24 Stunden vergangen; Meta empfiehlt, stattdessen ein Template zu senden.
Nicht zustellbar: Die Nummer ist nicht bei WhatsApp, der Empfänger hat die neuen Bedingungen nicht akzeptiert oder nutzt eine alte WhatsApp-Version.
Standardzeit, in der WhatsApp einen nicht zugestellten Utility- oder Marketing-Template erneut versucht, bevor es verworfen wird; Authentifizierungs-Templates haben standardmäßig 10 Minuten.
Feste Durchsatzrate einer Nummer, die sowohl in der WhatsApp Business-App als auch in der Cloud API genutzt wird.
Warum kommt eine angenommene Nachricht trotzdem nicht an?
Weil die API-Antwort und die Zustellung zwei getrennte Ereignisse sind. Beim Senden gibt Meta eine Nachrichten-ID zurück, sobald die Anfrage angenommen ist; ob die Nachricht das Gerät des Kunden erreicht, folgt später in einem Status-Webhook zum Feld messages. sent bedeutet, sie hat Metas Server verlassen (ein Häkchen), delivered, dass sie das Gerät erreicht hat (zwei), read, dass sie geöffnet wurde (zwei blaue), und failed, dass sie nicht gesendet oder zugestellt werden konnte. Dies wird Ihnen mit einem errors-Array angezeigt: code, title und error_data.details. Der erste Schritt ist also nie das Raten: Suchen Sie den failed-Status zu dieser Nachrichten-ID und lesen Sie seinen Code. Ohne Webhook-Ziel wird dies nirgends festgehalten.
Welche Ursachen gibt es, in der Reihenfolge der Prüfung?
Von der häufigsten bei einer neu verbundenen Nummer bis zur seltensten. Jede Zeile nennt Metas Code, damit der failed-Status zeigt, in welchem Fall Sie sich befinden:
- Fenster geschlossen: 131047, mehr als 24 Stunden seit der letzten Nachricht des Kunden. Freitext-Nachrichten brauchen ein offenes Fenster; senden Sie dann ein Template.
- Zahlung: 131042, oder Templates werden stillschweigend verworfen. Seit dem 1. Oktober 2026 enden auch Service-Nachrichten, sobald 1,000 pro Monat ohne hinterlegte Zahlungsmethode genutzt wurden.
- Template: 132001 nicht genehmigt oder falsche Sprache, 132000 falsche Anzahl an Variablen, 132012 falsches Format, 132015 pausiert, 132016 deaktiviert.
- Empfänger: 131026 nicht bei WhatsApp, alte Version oder Bedingungen nicht akzeptiert; 131050 Marketing-Nachrichten gestoppt; 131049 zurückgehalten, um die Interaktion gesund zu halten; Marketing-Templates an US-Nummern werden nicht zugestellt.
- Limits: 131048 eingeschränkt nach Spam-Signalen, 131056 zu viele Nachrichten an eine Person, 130429 Durchsatz, 20 Nachrichten pro Sekunde bei einer Coexistence-Nummer.
- Konto: 131031 oder 368, das WhatsApp Business-Konto wurde wegen eines Richtlinienverstoßes eingeschränkt oder deaktiviert.
- Verbindung: Die Nummer ist nicht mehr verknüpft, zum Beispiel nach 14 Tagen ohne Öffnen der WhatsApp Business-App.
Wie gehen Sie mit den Codes auf Empfängerseite um?
Anders, denn manche rechtfertigen einen erneuten Versuch, andere nie. 131050 bedeutet, dass die Person Marketing-Nachrichten von Ihnen gestoppt hat: Meta sagt, dass nicht erneut versucht werden sollte, und der user_preferences-Webhook meldet Ihnen, wann sie stoppen oder fortsetzen. 131049 bedeutet, dass Meta eine Marketing-Nachricht zurückhält, um die Interaktion gesund zu halten, oft ein Limit pro Nutzer für Marketing-Templates: Meta rät, mindestens 24 Stunden zu warten, bevor Sie erneut senden, denn früher zu senden liefert nur denselben Fehler. 131026 betrifft Nummern, die nicht bei WhatsApp sind, Nutzer, die die aktuellen Bedingungen von WhatsApp nicht akzeptiert haben, und sehr alte App-Versionen. Prüfen Sie zuerst Format und Ländervorwahl der Nummer, fragen Sie den Kunden dann über einen anderen Kanal.
Wie lange versucht WhatsApp zuzustellen?
So lange die Lebensdauer der Nachricht (Time to Live) reicht. Ist ein Telefon ausgeschaltet oder außer Reichweite, versucht WhatsApp die Zustellung erneut, statt sofort zu scheitern: standardmäßig 30 Tage bei Utility- und Marketing-Templates und 10 Minuten bei Authentifizierungs-Templates. Ein Unternehmen kann dies pro Template mit message_send_ttl_seconds verkürzen, von 30 Sekunden bis 12 Stunden für Utility und 30 Sekunden bis 15 Minuten für Authentifizierung. Eine Nachricht, die innerhalb ihrer TTL nicht zugestellt werden kann, wird verworfen. Eine Nachricht mit sent-Status ohne delivered-Status nach Stunden wartet daher meist auf das Telefon des Kunden und ist nicht verloren. Setzen Sie für Codes und zeitkritische Warnungen eine kurze TTL, damit eine späte Zustellung niemanden verwirrt.
Was bedeutet das für KI-Antworten und Automationen?
Lesen Sie zuerst den Lauf, dann den Status. Auf der Registerkarte Runs hat ein übersprungener Lauf nichts gesendet und sagt warum: „Mehr als 24 Stunden seit der letzten Nachricht des Kunden“, „Sie haben diesen Chat kürzlich von Ihrem Telefon aus beantwortet“ oder „KI-Antwortlimit für diesen Chat in dieser Stunde erreicht“. Ein erledigter Lauf bedeutet, dass Meta jede Antwort angenommen hat, was keinen Zustellungsnachweis darstellt. easyCoexistence speichert keine Nachrichtenstatus: Bei aktiven Automationen gelangen sie an Ihre Weiterleitungs-URL, falls Sie eine setzen, und im direkten Modus gehen sie unmittelbar an Ihren eigenen Endpoint. Aus ChatGPT oder Claude bitten Sie Ihre KI, get_number_health auszuführen: Das liefert den Live-Status, die Qualitätsbewertung und die letzten 15 Überwachungsereignisse, einschließlich eines sending-Blocks mit Metas Code.
So richten Sie es ein
- Find the statusLook up the message id in your webhook log and read the latest status: delivered, read, sent only, or failed with an error code.
- Match the codeLook up the failed status's code in the list of causes above and in Meta's error codes reference.
- Check the accountConfirm the WhatsApp Business Account has a default payment method, a currency and a time zone in Billing & payments.
- Check the templateIf it was a template, confirm it is APPROVED in that language and the variables match its definition.
- Check the numberAsk your AI to run get_number_health, or open the number in the dashboard, to see the connection and any sending block.
Häufige Fehler
- Erneut versuchen bei 131050. Die Person hat Marketing-Nachrichten von Ihnen gestoppt; weitere Versuche werden nie zugestellt und können nur negative Signale verstärken.
- Eine Nachrichten-ID als zugestellt lesen. Meta nimmt zuerst an und meldet Fehler später, also verpasst ein Workflow, der bei der ID stoppt, jede abgelehnte Nachricht.
- Eine Freitext-Antwort einen Tag später senden. Nach 24 Stunden ohne Nachricht des Kunden wird nur noch ein Template angenommen.
- Ohne Webhook-Ziel laufen. Fehlgeschlagene Status kommen nur als Webhooks an; ohne einen geht der Grund verloren, warum eine Nachricht nicht ankam.
Ihre KI kann eine Nummer aus ChatGPT oder Claude mit get_number_health prüfen. US$ 9 bis hinunter zu US$ 0.75 pro Nummer und Monat, mit jeder weiteren Nummer günstiger, mit den ersten 3 Tagen kostenlos.
Häufig gestellte Fragen
Warum zeigte die Nachricht stundenlang nur ein Häkchen?
Ein Häkchen ist der Status sent: Meta hat sie gesendet, aber das Telefon hat sie nicht empfangen, meist weil es aus oder offline ist. WhatsApp versucht es weiter, bis die Time to Live des Templates abläuft, standardmäßig 30 Tage bei Utility und Marketing.
Warum kommen Antworten an, Templates aber nicht?
Meist liegt ein Problem mit der Zahlungsmethode des WhatsApp Business-Kontos vor. Meta stellt Service-Nachrichten innerhalb des kostenlosen monatlichen Kontingents der Nummer auch ohne Zahlungsmethode zu, Templates aber nicht. Hinterlegen Sie eine Karte unter Abrechnung und Zahlungen.
Kann ich fehlgeschlagene Nachrichten in der WhatsApp Business-App sehen?
Nicht zuverlässig. Bei einer Coexistence-Nummer erscheinen über die API gesendete Nachrichten im Chatverlauf der App, der Grund für einen Fehler steht aber nur im Fehlercode des Status-Webhooks.
Berechnet Meta Nachrichten, die nicht zugestellt wurden?
Nein. Meta berechnet nur zugestellte Nachrichten, und Versuche mit einem pausierten Template werden ebenfalls nicht berechnet.
Weiterlesen
Bereit für den Start?
Richten Sie WhatsApp Coexistence in wenigen Minuten statt Monaten ein. Die App funktioniert weiterhin auf dem Telefon.
Kostenlose Testphase startenVerifiziert am