WhatsApp-Ruhezeiten erklärt: Warum Nachrichten warten
Wenn du schon einmal eine WhatsApp-Nachricht über TextMeFlow in die Warteschlange gestellt hast und sie länger als erwartet im Status queued hängen sah, sind sehr wahrscheinlich die Ruhezeiten der Grund. Das ist kein Bug und nicht der Rate Limiter — es ist eine bewusste Steuerungsregel, die deine Nummer schützt, und sie verhält sich anders als fast jede andere Einschränkung der API, weil sie einen Versand nie ablehnt. Sie wartet einfach.
Was Ruhezeiten tatsächlich tun
Jede Nachricht, die zwischen 22:00 und 08:00 Uhr Ortszeit des Empfängers gesendet wird — abgeleitet aus der Landesvorwahl seiner Telefonnummer, nicht aus der Zeitzone deines Accounts oder der Serverzeit —, wird bis 08:00 Uhr Ortszeit zurückgehalten. Die Nachricht wird nicht verworfen, nicht hinter einem Retry eingereiht und muss nicht erneut gesendet werden: TextMeFlow hält sie zurück und gibt sie frei, sobald das Zeitfenster sich öffnet.
Entscheidend ist die Zeitzone des Empfängers, was leicht übersehen wird, wenn dein eigenes Unternehmen in MEZ arbeitet. Eine Buchungsbestätigung an einen Kunden in Bangkok um 15:00 Uhr deiner Zeit kann trotzdem in dessen Ruhezeit fallen, weil es dort schon nach 22:00 Uhr ist.
curl -X POST https://api.textmeflow.eu/v1/messages \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"to": "+66812345678", "text": "Deine Buchung für morgen ist bestätigt."}'
Trifft diese Anfrage in der Ruhezeit von Bangkok ein, liefert die API trotzdem ein 202 zurück — die Nachricht existiert und ist eingeplant —, aber ihr Status bleibt deferred, bis sich das Fenster öffnet, und springt dann auf sent. Frage den Status-Endpunkt ab oder höre auf den Webhook message.sent, wenn deine Integration genau wissen muss, wann die Nachricht rausging.
Warum es das gibt
Das ist eine Regel in TextMeFlows umfassender Anti-Spam-Pipeline: Rate Limits, zufällige Pausen zwischen Sendungen, Risikobewertung und STOP-Verarbeitung greifen ineinander, um WhatsApp-Nummern aus dem Radar von Meta herauszuhalten. Ruhezeiten zielen speziell auf ein Muster, das selbst bei völlig legitimem Inhalt botartig wirkt — eine Welle von Nachrichten, die um 3 Uhr nachts Ortszeit auf Handys landet. Echte Unternehmen, die Kunden einzeln und von Hand anschreiben, tun das nicht; automatisierte Systeme schon, wenn sie nichts daran hindert.
Einen Versand in der Ruhezeit trotzdem zu erzwingen (siehe unten), erhöht deinen Risikowert leicht — +5 pro Vorfall laut der dokumentierten Trigger-Liste. Es ist der günstigste Trigger auf der Liste, gerade weil er vermeidbar sein soll: Erzwinge ihn nicht, dann zahlst du ihn nie.
Wenn Ruhezeiten dir im Weg stehen
Nicht jede Nachricht ist ein Marketing-Versand, der bis zum Morgen warten kann. Ein Hotelgast, der um 22:30 Uhr eincheckt, braucht seinen Türcode jetzt — ein Türcode, der am nächsten Morgen um 08:00 Uhr ankommt, ist wertlos, und ihn zurückzuhalten wäre schlimmer, als ihn im Anti-Spam-Sinn „zu spät“ zu senden.
Deshalb sind Ruhezeiten im Portal eine Einstellung pro Account und keine fest verdrahtete Regel: Accounts mit rein transaktionalem Verkehr (Türcodes, OTPs, Ankunftsmeldungen bei Lieferungen, Zahlungsbestätigungen) können sie komplett abschalten. Das Abschalten deaktiviert nicht den Rest der Anti-Spam-Pipeline — Rate Limits, Pacing und Risikobewertung für andere Trigger gelten weiter. Es entfällt nur die tageszeitabhängige Zurückhaltung.
So entscheidest du, ob du sie abschaltest
Frage dich, was passiert, wenn die Nachricht um 2 Uhr nachts ankommt statt in dem Moment, in dem du sie gesendet hast:
- Türcodes, „Dein Tisch ist bereit“-Hinweise, Ankunftsmeldungen bei Lieferungen — zeitkritisch, transaktional, ein einzelner Empfänger. Schalte die Ruhezeiten für diese Abläufe ab.
- Bestellbestätigungen, Rechnungskopien, Marketing-Erinnerungen, Terminerinnerungen, die einen Tag vorher gesendet werden — nichts geht kaputt, wenn sie um 08:00 Uhr statt um 23:00 Uhr ankommen. Lass die Ruhezeiten an.
Wenn dein Account beide Arten von Verkehr mischt, ist der sauberste Weg nicht ein globaler Schalter, sondern die Trennung von transaktionalen und Massensendungen auf getrennte TextMeFlow-Accounts (oder getrennte gekoppelte Nummern über Multi-Device), sodass die Einstellung zum Verkehr passt und nicht umgekehrt.
Was du prüfst, wenn eine Nachricht festzuhängen scheint
- Prüfe, ob die Landesvorwahl des Empfängers zu einer Zeitzone gehört, in der es gerade zwischen 22:00 und 08:00 Uhr ist — eine Nachricht, die um 21:55 Uhr MEZ an eine US-Nummer (+1) geht, kann dort mitten in den Geschäftszeiten liegen.
- Prüfe den Nachrichtenstatus über
GET /v1/messages/{id}—deferredbedeutet Ruhezeit, nicht Fehler. - Ist der Ablauf wirklich transaktional und zeitkritisch, schalte die Ruhezeiten für diesen Account im Portal ab, statt sie mit Retries zu umgehen.
Einen vollständigen Überblick über alle Anti-Spam-Prüfungen, die TextMeFlow durchführt — Rate Limits, Pacing, Risikobewertung, STOP-Verarbeitung —, findest du in der Anti-Spam-Richtlinie. Wenn du überlegst, ob ein bestimmter Nachrichtentyp die Ruhezeiten umgehen soll, zeigt dir die Aufschlüsselung des Risikowerts genau, was ein erzwungener Versand kostet.
TextMeFlow kostenlos testen — die Steuerung über Ruhezeiten läuft in jedem Plan, auch im kostenlosen: 50 Nachrichten pro Monat, ohne Zeitlimit, gehostet in der EU (Paris).
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