Documentation

Migrer depuis TextMeBot

TextMeFlow expose un endpoint compatible TextMeBot avec le même format d'URL et le même corps de réponse. Pour la plupart des intégrations, la migration se résume littéralement à changer un nom d'hôte.

1. Le changement d'une ligne

Si votre code appelle TextMeBot comme ceci :

GET https://api.textmebot.com/send.php?recipient=+32470000000&apikey=KEY&text=Hello

pointez-le plutôt vers TextMeFlow :

GET https://api.textmeflow.eu/send.php?recipient=+32470000000&apikey=KEY&text=Hello

Le corps de réponse conserve exactement le même contrat : vos vérifications de succès/échec existantes continuent de fonctionner sans modification :

Result: <b>Success</b><br>Message: queued (12345)
Result: <b>Failed</b><br>Reason: recipient_opted_out

2. Les boutons fonctionnent aussi

Les trois emplacements de boutons de TextMeBot (button1 + button1id jusqu'à button3 + button3id) sont pris en charge. Chaque paire est rendue comme un bouton CTA-URL : le libellé vient de buttonN, l'URL cible de buttonNid. Les contenus non-URL sont ignorés, et WhatsApp limite les boutons natifs à trois — la même limite que TextMeBot.

3. Ce qui se passe derrière l'endpoint de compatibilité

L'endpoint /send.php exécute exactement le même pipeline que notre API native POST /v1/messages : validation du destinataire (E.164), vérification d'opt-out, contrôle du quota mensuel et couche anti-spam (limites de débit + score de risque). Vous bénéficiez de la protection de délivrabilité même en conservant l'ancien format d'URL.

Les raisons d'échec sont renvoyées dans le corps de la réponse, p. ex. invalid_apikey, recipient_opted_out, quota_exceeded — plus précis qu'un simple « Failed ».

4. Quand passer à l'API native

L'endpoint de compatibilité sert à migrer sans effort. Le nouveau code devrait utiliser l'API JSON — elle renvoie des erreurs structurées et un id de message que vous pouvez interroger :

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"}

Consultez la référence API pour tous les endpoints et codes d'erreur, et les webhooks entrants pour recevoir les réponses en JSON signé HMAC.

5. Ce que vous gagnez en migrant

  • Hébergement UE (Paris, France) et un accord de traitement des données RGPD automatique sur les plans payants
  • Des quotas explicites par plan — pas de limitation surprise ; un plan gratuit de 50 messages/mois, pour toujours
  • Pipeline anti-spam intégré : limites de débit, score de risque, gestion automatique des STOP et heures de silence
  • Réponses entrantes via des webhooks signés avec reprises automatiques

En bref

Remplacez api.textmebot.com par api.textmeflow.eu, gardez tout le reste. Testez sur le plan gratuit (50 messages/mois) avant de basculer le trafic de production.