Dokumentation
Migration von TextMeBot
TextMeFlow bietet einen TextMeBot-kompatiblen Endpoint mit derselben URL-Form und demselben Response-Body. Für die meisten Integrationen besteht die Migration buchstäblich aus einer Hostnamen-Änderung.
1. Die Ein-Zeilen-Änderung
Wenn dein Code TextMeBot so aufruft:
GET https://api.textmebot.com/send.php?recipient=+32470000000&apikey=KEY&text=Hello
richte ihn stattdessen auf TextMeFlow:
GET https://api.textmeflow.eu/send.php?recipient=+32470000000&apikey=KEY&text=Hello
Der Response-Body behält exakt denselben Vertrag, bestehende Erfolgs-/Fehler-Checks funktionieren also unverändert weiter:
Result: <b>Success</b><br>Message: queued (12345) Result: <b>Failed</b><br>Reason: recipient_opted_out
2. Buttons funktionieren auch
Die drei Button-Slots von TextMeBot (button1 + button1id bis button3 + button3id) werden unterstützt. Jedes Paar wird als CTA-URL-Button gerendert: das Label kommt aus buttonN, die Ziel-URL aus buttonNid. Nicht-URL-Payloads werden ignoriert, und WhatsApp begrenzt native Buttons auf drei — dasselbe Limit wie bei TextMeBot.
3. Was hinter dem Kompatibilitäts-Endpoint passiert
Der /send.php-Endpoint durchläuft exakt dieselbe Pipeline wie unsere native POST /v1/messages-API: Empfängervalidierung (E.164), Opt-out-Prüfung, monatliches Quota-Gate und die Anti-Spam-Schicht (Rate-Limits + Risk-Score). Du bekommst den Zustellbarkeitsschutz, auch wenn du noch die alte URL-Form nutzt.
Fehlergründe werden im Body zurückgegeben, z. B. invalid_apikey, recipient_opted_out, quota_exceeded — präziser als ein bloßes "Failed".
4. Wann du auf die native API umsteigst
Der Kompatibilitäts-Endpoint ist für die Migration ohne Aufwand gedacht. Neuer Code sollte die JSON-API nutzen — sie liefert strukturierte Fehler und eine Message-ID, die du abfragen kannst:
POST https://api.textmeflow.eu/v1/messages
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
{"to": "+32470000000", "text": "Hello", "media_url": "https://example.com/invoice.pdf"}
Siehe die API-Referenz für alle Endpoints und Fehlercodes sowie eingehende Webhooks, um Antworten als HMAC-signiertes JSON zu empfangen.
5. Was du durch die Migration gewinnst
- EU-Hosting (Paris, Frankreich) und ein automatischer DSGVO-Auftragsverarbeitungsvertrag bei bezahlten Plänen
- Explizite Quoten pro Plan — keine überraschende Drosselung; ein Gratis-Plan mit 50 Nachrichten/Monat, für immer
- Eingebaute Anti-Spam-Pipeline: Rate-Limits, Risk-Score, automatische STOP-Verarbeitung und Ruhezeiten
- Eingehende Antworten über signierte Webhooks mit Retries
Kurz gesagt
Tausche api.textmebot.com gegen api.textmeflow.eu, alles andere bleibt. Teste auf dem Gratis-Plan (50 Nachrichten/Monat), bevor du den Produktivverkehr umziehst.