Dokumentation
Rate-Limits & Kontingente
TextMeFlow setzt zwei unabhängige Ebenen durch: Rate-Limits pro Nummer (die deine WhatsApp-Nummer vor Meta-Sperren schützen) und monatliche Kontingente pro Plan (wofür du bezahlst). Diese Seite erklärt beide — und was dein Code tun sollte, wenn er sie erreicht.
1. Rate-Limits pro Nummer
Sie existieren, um deine Nummer zu schützen — WhatsApp sperrt Nummern, die sich wie Spam-Kanonen verhalten. Sie gelten für jeden Sendeweg (native API, TextMeBot-kompatibler Endpoint, No-Code-Integrationen):
- 1 Nachricht pro Sekunde dauerhaft
- 60 Nachrichten pro Minute
- 1.000 Nachrichten pro Stunde
Burst-Limits werden weicher, sobald deine Nummer schon einige Wochen sendet — eine „warme" Nummer mit gesunder Zustellhistorie bekommt mehr Spielraum als eine frisch verbundene. Lies die Anti-Spam Best Practices für das Gesamtbild (Risk-Score, Opt-in, STOP-Handling, Ruhezeiten).
2. Wie ein 429 aussieht
Oberhalb des Rate-Limits liefert die API 429 Too Many Requests. Versuche es nicht sofort in einer engen Schleife erneut — warte ab und retry mit exponentieller Verzögerung. Senden über eine Queue ist das bessere Muster: schiebe Nachrichten in deine eigene Queue und arbeite sie mit ≤1 Nachricht/Sek. ab.
3. Monatliche Kontingente pro Plan
Unabhängig von Rate-Limits hat jeder Plan ein monatliches Nachrichtenkontingent — Free sind 50 Nachrichten/Monat (lebenslang), bezahlte Pläne beginnen bei 5 €/Monat. Siehe Preise für die aktuellen Stufen. Zwei Dinge passieren, wenn du dich dem Kontingent näherst:
- Bei 80 % Verbrauch mailen wir dir eine Warnung
- Bei 100 % werden neue Sendungen mit
429und dem Fehlerquota_exceededabgelehnt — Nachrichten werden nie stillschweigend in die nächste Periode verschoben
HTTP/1.1 429 Too Many Requests
{"error": "quota_exceeded", "monthly_quota": 500, "used": 500}
Ein Upgrade wirkt sofort (anteilig); andernfalls setzt sich der Zähler zu Beginn der nächsten Abrechnungsperiode zurück.
4. Muster, die dich aus Schwierigkeiten heraushalten
- Verteile Batches: 200 Erinnerungen pünktlich um 08:00 lösen das Minutenlimit aus — plane sie über ein Zeitfenster
- Behandle
429getrennt von4xx-Validierungsfehlern: das eine heißt „später", das andere „nie" - Überwache die
quota_exceeded-Payload-Felder (monthly_quota,used), um eigene Verbrauchs-Alerts zu bauen - Variiere den Nachrichteninhalt — identischer Text an viele Empfänger erhöht den internen Risk-Score, selbst unterhalb des Rate-Limits
Kurz gesagt
Bleib unter 1 Nachricht/Sek., achte auf 429er und upgrade, bevor du 100 % des Kontingents erreichst. Die Limits sind da, damit deine Nummer jahrelang weiterfunktioniert.