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.