Envoyer un message WhatsApp depuis Retool
Les équipes qui construisent des tableaux de bord internes dans Retool ont souvent besoin d'un moyen rapide de contacter un client sans quitter l'application — confirmer un remboursement, relancer un paiement en retard ou prévenir qu'une commande est prête. Plutôt que de passer par un outil de messagerie séparé ou de faire transiter l'envoi par Zapier, vous pouvez brancher un bouton d'envoi WhatsApp directement dans n'importe quelle app Retool avec une seule ressource REST API.
Ce guide couvre la configuration d'une console de support ou d'un tableau de bord opérationnel, mais la même ressource fonctionne dans toute app Retool : panneaux d'administration, outils de gestion des commandes ou CRM internes.
Pourquoi le faire directement depuis Retool
Les apps Retool sont généralement l'endroit où votre équipe consulte déjà la fiche client — la commande, le ticket, le compte. Si envoyer un message WhatsApp oblige à ouvrir un autre outil et à retaper le numéro de téléphone, les gens s'en dispensent ou font des erreurs. Un bouton relié directement à l'API garde la recherche et l'envoi sur le même écran, avec le numéro de téléphone et le message tirés de la fiche déjà affichée.
Si votre déclencheur est un événement backend plutôt qu'une personne qui clique sur un bouton — un webhook, une tâche cron, un changement de statut dans votre base de données —, c'est un autre schéma ; voyez Envoyer des messages WhatsApp depuis n8n, Make.com ou Zapier pour les envois déclenchés par automatisation. La ressource native de Retool convient précisément quand c'est une personne qui lance le message depuis un outil interne.
Ce qu'il vous faut
- Une app Retool avec un tableau ou une vue détaillée qui affiche déjà une fiche client (numéro de téléphone et nom, au minimum).
- Un compte TextMeFlow gratuit avec un numéro WhatsApp associé par QR code — aucune vérification Meta Business requise.
- Votre clé API depuis le tableau de bord TextMeFlow.
Étape 1 : ajouter la ressource REST API
Dans Retool, allez dans Resources → Create New → REST API, et configurez :
- Base URL :
https://api.textmeflow.eu/v1 - Headers :
Authorization: Bearer YOUR_API_KEY,Content-Type: application/json
Donnez-lui un nom comme textmeflow pour la retrouver facilement lors de la création des requêtes.
Étape 2 : créer une requête pour envoyer un message
Ajoutez une nouvelle requête sur la ressource, définissez la méthode sur POST, le chemin sur /messages et le corps sur :
{
"to": "{{ table1.selectedRow.data.phone }}",
"text": "{{ textArea1.value }}"
}
Référencez les composants qui contiennent le destinataire et le texte du message — une ligne de tableau sélectionnée, un champ de saisie ou un modèle de texte fixe construit avec la syntaxe de liaison {{ }} de Retool.
Étape 3 : relier la requête à un bouton
Placez un bouton à côté de la fiche et réglez son gestionnaire d'événement onClick sur Trigger query, en pointant vers la requête de l'étape 2. Ajoutez un gestionnaire de succès Show notification pour que l'agent reçoive une confirmation visuelle (« Message envoyé ») au lieu de se demander si le clic a été pris en compte.
// Optional: disable the button while the query runs
sendWhatsapp.trigger({
onSuccess: () => {
utils.showNotification({ title: "WhatsApp sent", notificationType: "success" });
},
onFailure: (error) => {
utils.showNotification({ title: "Send failed", description: error.message, notificationType: "error" });
},
});
Se protéger des numéros de téléphone incorrects
L'échec le plus courant dans un outil interne n'est pas l'appel API — c'est un numéro de téléphone enregistré sans indicatif de pays. TextMeFlow attend le format E.164 (+ et indicatif du pays, p. ex. +32470123456) ; un numéro au format local comme 0470123456 est rejeté avant tout envoi. Ajoutez un transformer Retool ou une simple requête JS qui valide et normalise le numéro avant le déclenchement de la requête d'envoi, et désactivez le bouton quand le champ est vide ou manifestement incorrect. Les règles de format complètes se trouvent dans /fr/docs/api.
Journaliser les envois dans votre propre base de données
Si votre app Retool repose sur une ressource Postgres ou MySQL, enchaînez une seconde requête après un envoi réussi qui écrit une ligne dans une table message_log (destinataire, texte, horodatage, utilisateur à l'origine de l'envoi), à l'aide du gestionnaire onSuccess de la première requête. Votre équipe dispose ainsi d'une piste d'audit de qui a envoyé quoi depuis l'outil interne, indépendante des journaux de livraison de TextMeFlow.
Ce que TextMeFlow gère de son côté
Chaque message envoyé via l'API — depuis Retool, une tâche backend ou toute autre intégration — passe automatiquement par le même pipeline anti-spam : limites de débit, score de risque, gestion des mots STOP et heures calmes. Vous n'avez rien à configurer par outil ; cela s'applique quel que soit l'origine de la requête. Les détails sont dans /fr/docs/anti-spam.
Aller au-delà du forfait gratuit
Le forfait gratuit comprend 50 messages par mois, à vie — de quoi construire et tester cette ressource avec des données réelles. Pour un volume quotidien de support ou d'exploitation, le forfait Starter à 5 €/mois augmente votre quota, avec des données hébergées dans l'UE (Paris) et un DPA automatique sur les forfaits payants si votre outillage interne en a besoin pour un contrat client.
Prêt à ajouter le bouton ? Créez un compte gratuit et envoyez votre premier message WhatsApp depuis une app Retool en quelques minutes.
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