· 5 min · TextMeFlow Team

De TextMeBot à TextMeFlow : checklist de migration en production

Remplacer api.textmebot.com par api.textmeflow.eu est, techniquement, une modification d'une seule ligne — le endpoint compatible TextMeBot accepte les mêmes paramètres de requête et renvoie le même corps Result: Success / Result: Failed. Mais « le format de requête correspond » et « je suis confiant pour basculer le trafic de production » sont deux choses différentes. Si vous faites tourner aujourd'hui des automatisations en production — confirmations de réservation, suivis de commande, rappels — via TextMeBot, voici la checklist que nous suivrions nous-mêmes.

1. Recensez chaque endroit qui appelle TextMeBot

Avant de toucher à quoi que ce soit, cherchez textmebot.com dans votre code, dans vos scénarios n8n/Make/Zapier et dans tout Google Apps Script ou tâche cron. Il est courant de trouver trois ou quatre points d'appel : un service backend, une macro de tableur écrite il y a deux ans et un webhook Zapier dont plus personne ne se souvient. Migrer « l'application » en oubliant la macro du tableur, c'est ainsi qu'un client cesse de recevoir ses confirmations de commande sans que personne ne s'en aperçoive pendant une semaine.

2. Testez sur le plan gratuit avant de toucher à la production

Créez un compte TextMeFlow gratuit (50 messages/mois, sans carte bancaire), scannez le code QR avec un numéro de secours ou secondaire et faites pointer une copie d'une intégration vers api.textmeflow.eu avec une clé API de test. Envoyez une poignée de messages réalistes — y compris les variables que vos modèles interpolent — avant de toucher à la clé ou au numéro de production.

3. Associez le « Failed » brut de TextMeBot aux motifs précis de TextMeFlow

C'est l'étape que les équipes sautent puis regrettent. La réponse compat de TextMeBot se limite à Result: Failed. Le endpoint /send.php de TextMeFlow fait passer la requête dans le même pipeline de validation que l'API native et renvoie un motif précis dans le corps — invalid_apikey, recipient_opted_out, quota_exceeded, etc. Si votre code actuel ne vérifie que la chaîne littérale Success, il continuera de fonctionner sans changement. Mais cela vaut la peine de consacrer vingt minutes à adapter votre gestion d'erreurs pour qu'elle se branche sur la chaîne du motif : on passe de « le message n'est pas arrivé, sans explication » à « ce client s'est désinscrit, arrêtez de réessayer ».

4. Vérifiez vos emplacements de boutons, si vous en utilisez

Si certains de vos messages TextMeBot utilisent button1/button1id à button3/button3id, sachez que TextMeFlow prend en charge la même structure à trois emplacements, affichée sous forme de boutons CTA-URL natifs. Le libellé provient de buttonN, l'URL de destination de buttonNid. Les charges utiles de boutons qui ne sont pas des URL sont ignorées — la même contrainte que chez TextMeBot, puisque WhatsApp lui-même limite les boutons natifs à trois.

5. Choisissez une vraie fenêtre de bascule, ne passez pas simplement en direct

Même un changement « d'une ligne » mérite un plan de retour arrière. Gardez l'ancienne clé TextMeBot active et inchangée pendant que vous basculez une intégration à la fois — en commençant par la moins critique (une alerte interne, pas une confirmation de commande destinée aux clients). Surveillez-la pendant une journée. Ce n'est qu'ensuite que vous déplacez les flux plus sensibles. Si quelque chose casse, revenir en arrière consiste simplement à remettre l'ancienne URL.

6. Décidez quand abandonner le endpoint compat

/send.php existe pour que la migration ne vous coûte rien le premier jour — mais c'est un pont, pas une destination. Une fois la bascule éprouvée, le nouveau code (et, à votre rythme, l'ancien) devrait passer à l'API JSON native POST /v1/messages. Elle renvoie des erreurs structurées au lieu d'une chaîne à analyser, ainsi qu'un identifiant de message pour interroger le statut de livraison. Associez-la aux webhooks entrants — signés par HMAC et avec nouvelles tentatives — si vous souhaitez aussi que les réponses remontent dans votre système au lieu de rester dans WhatsApp.

7. Sachez ce qui change en dessous, même si votre code ne change pas

Le format de requête est compatible ; le backend derrière ne l'est pas. Les messages transitent par une infrastructure européenne (Paris, France), les plans payants incluent automatiquement un accord de traitement des données conforme au RGPD, et chaque envoi — via le endpoint compat ou l'API native — passe par la même couche anti-spam : limites de débit par numéro, gestion du STOP et heures calmes. Rien de tout cela ne demande de modification de code de votre côté, mais il est bon de savoir que c'est là, surtout si une question de conformité se pose plus tard. Pour comprendre pourquoi nous l'avons conçu ainsi, lisez notre note sur la question de l'alternative à TextMeBot.

Toute la migration, dans l'ordre

Recenser les points d'appel → tester sur le plan gratuit → adapter la gestion des erreurs aux motifs précis → vérifier les boutons si utilisés → basculer intégration par intégration → conserver le endpoint compat aussi longtemps que nécessaire → passer à l'API native quand vous êtes prêt. Aucune de ces étapes n'est difficile en soi ; les sauter est ce qui transforme un « changement d'une ligne » en incident du lundi matin.

Commencez avec le plan gratuit — 50 messages/mois, sans carte bancaire, et le même pipeline anti-spam que le trafic de production.

Envie d'envoyer des messages WhatsApp via API ?

Gratuit pour toujours jusqu'à 50 messages/mois. Scannez un QR et envoyez votre premier message en 5 minutes.

Gratuit pour toujours