WhatsApp: „gesendet“ ist nicht „zugestellt“
Ein 202 Accepted von POST /v1/messages fühlt sich wie eine Bestätigung an. Das ist es nicht — es bedeutet nur, dass TextMeFlow deine Nachricht in die Warteschlange gestellt hat. Ob die Nachricht tatsächlich beim Empfänger angekommen ist, weißt du erst, wenn WhatsApp eine Zustellbestätigung zurückgibt. Teams, die diesen Unterschied ignorieren, merken erst, dass etwas nicht stimmt, wenn Kunden anrufen und sagen, sie hätten nichts erhalten — während ihr Dashboard nur grüne Haken für „gesendet" zeigt.
Genau dieses Problem löst die Delivery Ratio in TextMeFlow: ein Frühwarnsystem, Tage bevor eine sichtbare Fehlermeldung auftaucht.
Warum „gesendet" nichts über die Ankunft aussagt
Zwischen dem Moment, in dem TextMeFlow eine Nachricht an WhatsApp schickt, und dem Moment, in dem der Empfänger sie erhält, kann einiges schiefgehen: eine Nummer, die nicht mehr mit WhatsApp verknüpft ist, ein Netzwerk, das langsam reagiert, oder — das Szenario, um das es in diesem Artikel eigentlich geht — eine Nummer, die Meta stillschweigend drosselt. Eine gedrosselte Nummer meldet weiterhin „gesendet", weil der API-Aufruf selbst gelingt, aber die Nachrichten kommen nicht mehr an. Ohne Zustelldaten siehst du diesen Unterschied nicht.
Deshalb erfasst TextMeFlow nicht nur, dass eine Nachricht die Warteschlange verlassen hat, sondern auch die eigenen Zustell- und Lesebestätigungen von WhatsApp für jede einzelne Nachricht. Beide Datenpunkte zusammen ergeben die Delivery Ratio der bestätigten Zustellungen pro Nummer, sichtbar im Portal.
So liest du die Ratio
Eine gesunde Nummer hält eine stabile, hohe Ratio. Achte auf diese Signale:
- Ein allmählicher Rückgang über mehrere Tage — das tückischste Muster. Sendungen gelingen weiterhin, aber ein wachsender Anteil kommt nicht an. Das ist oft das erste Anzeichen dafür, dass Meta eine Nummer einschränkt, lange bevor du einen expliziten Fehlercode siehst.
- Ein plötzlicher Einbruch bei einer Nummer, während andere Nummern normal laufen — deutet auf ein Problem mit genau dieser Nummer hin, nicht mit deinem Konto oder deiner Integration. WhatsApp schränkt nämlich eine Nummer ein, kein Konto: Bei einem Konto mit drei gekoppelten Nummern kann eine gedrosselt werden, während die anderen beiden normal weiterarbeiten.
- Eine Ratio von 0 % direkt nach der Kopplung — kein Grund zur Panik. Der Zähler beginnt erst mit der ersten bestätigten Zustellung; Nachrichten, die du davor gesendet hast, zählen nicht mit und würden sonst ein irreführendes Bild ergeben.
Unterschied zum Risk Score
Delivery Ratio und Risk Score messen nicht dasselbe und ergänzen sich. Der Risk Score reagiert auf dein eigenes Sendeverhalten — identische Broadcasts, Senden an abgemeldete Empfänger, erzwungenes Senden außerhalb der Ruhezeiten — und zeigt damit, was du tust, das Risiko erzeugt (die vollständige Liste der Auslöser findest du im Anti-Spam-Leitfaden). Die Delivery Ratio misst die Folge: Kommt die Nachricht tatsächlich an, unabhängig von der Ursache. Eine Nummer kann einen ausgezeichneten Risk Score haben und trotzdem eine sinkende Delivery Ratio zeigen, etwa wegen eines veralteten WhatsApp-Kontos beim Empfänger oder eines Netzwerkproblems auf seiner Seite. Beide Kennzahlen zusammen ergeben das vollständige Bild.
Zustellstatus über die API abfragen
Neben dem Portal kannst du den Status einer einzelnen Nachricht auch programmatisch mit GET /v1/messages/{id} abfragen, mit der message_id, die du beim Senden erhalten hast:
curl -s https://api.textmeflow.eu/v1/messages/3fa85f64-5717-4562-b3fc-2c963f66afa6 \
-H "Authorization: Bearer $TEXTMEFLOW_TOKEN"
Für Produktionsintegrationen ist das vor allem nützlich, um automatisch auf fehlgeschlagene Zustellungen zu reagieren — zum Beispiel eine Buchungsbestätigung erneut per E-Mail zu senden, wenn die WhatsApp-Zustellung nach angemessener Zeit noch nicht bestätigt ist. Kombiniere das mit der korrekten Behandlung von 429-Antworten; das beschreibt unser Leitfaden zu Rate Limits und Nachrichtenstatus in der API ausführlich.
Was tun, wenn die Ratio sinkt
- Prüfe zuerst, ob sich das Problem auf eine Nummer beschränkt oder das ganze Konto betrifft.
- Schau nach, ob von derselben Nummer in kurzer Zeit viele neue Empfänger angeschrieben wurden — das löst zusätzliche Kontrollen bei Meta aus.
- Verlangsame Massenversand und verteile ihn über einen längeren Zeitraum, statt alles innerhalb weniger Minuten zu verschicken.
- Respektiere weiterhin STOP-Anfragen und sende keinen identischen Text an viele Empfänger gleichzeitig — beides erhöht das Risiko und drückt die Ratio weiter.
- Erholt sich die Ratio nicht, nimm Kontakt mit uns auf, bevor das Konto an die Risikoschwelle stößt.
Eine sinkende Delivery Ratio ist kein Alarm, den man ignoriert, bis daraus eine Fehlermeldung wird — sie ist die Fehlermeldung, nur früher und leiser. Wer das Portal wöchentlich prüft, sieht Probleme Wochen, bevor ein Kunde deswegen anruft.
Noch kein TextMeFlow-Konto? Starte kostenlos und beobachte die Delivery Ratio deiner eigenen Nummer ab den ersten gesendeten Nachrichten.
Selbst WhatsApp-Nachrichten per API senden?
Für immer gratis bis 50 Nachrichten/Monat. QR scannen und in 5 Minuten die erste Nachricht senden.
Für immer gratis