Créer un bot de réponse automatique WhatsApp en Python (Flask)
Un bot de réponse automatique est le « hello world » de l'automatisation WhatsApp : quelqu'un écrit à votre numéro, votre code décide de la réponse et celle-ci arrive dans sa conversation en quelques secondes. Ce tutoriel en construit un en Python avec Flask, en une soixantaine de lignes, sans compte Meta Business et sans validation de template.
Ce dont vous avez besoin
- Un compte TextMeFlow avec votre numéro WhatsApp lié par QR (guide de démarrage)
- Votre clé API et votre secret de webhook depuis le portail
- Python 3.10+ avec
flasketrequestsinstallés
Étape 1 — recevoir les messages entrants
TextMeFlow livre chaque message entrant à l'URL de votre webhook en JSON, signé en HMAC-SHA256 pour que vous puissiez vérifier qu'il vient bien de nous. Le squelette :
import hashlib
import hmac
import os
import requests
from flask import Flask, request, abort
app = Flask(__name__)
WEBHOOK_SECRET = os.environ["TMF_WEBHOOK_SECRET"]
API_KEY = os.environ["TMF_API_KEY"]
API_URL = "https://api.textmeflow.eu/v1/messages"
@app.post("/webhook")
def webhook():
received = request.headers.get("X-TextMeFlow-Signature", "")
expected = "sha256=" + hmac.new(
WEBHOOK_SECRET.encode(), request.get_data(), hashlib.sha256
).hexdigest()
if not hmac.compare_digest(received, expected):
abort(401)
event = request.get_json()
sender = event["from"]
text = event.get("message", "").strip().lower()
reply = make_reply(text)
if reply:
send_message(sender, reply)
return {"ok": True}
La signature se trouve dans l'en-tête X-TextMeFlow-Signature sous la forme sha256=<hex>, un condensé HMAC-SHA256 du corps brut de la requête. Calculez-la toujours sur request.get_data() (les octets bruts, pas du JSON réencodé) et comparez avec hmac.compare_digest (temps constant) avant de vous fier au payload. Le payload est compatible TextMeBot (type, from, from_name, to, message, file) ; tous les détails, y compris le comportement de nouvelle tentative et l'idempotence, figurent dans notre guide des signatures de webhook.
Étape 2 — décider de la réponse
Commencez par un simple routage par mots-clés. Ce n'est pas glamour, mais ça fonctionne :
def make_reply(text: str) -> str | None:
if text in ("salut", "bonjour", "hello"):
return "Bonjour ! Répondez HORAIRES pour nos horaires ou PRIX pour nos tarifs."
if "horaires" in text:
return "Nous sommes ouverts du lundi au vendredi de 9h00 à 18h00, le samedi de 10h00 à 16h00."
if "prix" in text:
return "Une prestation standard coûte 95 € TTC. Répondez RESERVER pour planifier."
return None # entrée inconnue : restez silencieux, un humain reprendra la main
Renvoyer None pour une entrée non reconnue est voulu. Un bot qui répond mal à tout est pire qu'un bot qui répond bien à trois choses et laisse le reste à une personne.
Étape 3 — envoyer la réponse
L'envoi tient en une requête POST :
def send_message(to: str, text: str) -> None:
resp = requests.post(
API_URL,
headers={"Authorization": f"Bearer {API_KEY}"},
json={"to": to, "text": text},
timeout=10,
)
resp.raise_for_status()
Notez que les réponses comptent dans le quota mensuel de votre forfait et dans les limites de débit par numéro (1 msg/sec) : pour un répondeur automatique qui répond à de vrais clients, vous resterez bien en dessous des deux.
Étape 4 — le lancer
export TMF_API_KEY=... TMF_WEBHOOK_SECRET=...
flask run --port 8000
Exposez le port avec un tunnel pendant le développement (ngrok ou équivalent), renseignez l'URL du tunnel comme endpoint de webhook dans le portail TextMeFlow, puis écrivez à votre propre numéro. Vous devriez voir arriver la réponse en une ou deux secondes.
Deux règles pour éviter les ennuis à votre bot
Respectez STOP. TextMeFlow gère automatiquement les mots-clés STOP au niveau de l'API (un destinataire désinscrit est bloqué avant même que votre code ne s'exécute), mais ne concevez pas de parcours qui harcèlent les gens pour qu'ils répondent.
Jamais de boucle. Si votre bot peut se déclencher sur ses propres messages sortants (les conversations de groupe sont un cas classique), prévoyez une garde pour qu'il ne se réponde pas à lui-même. Une simple vérification booléenne vous évite une conversation infinie très embarrassante.
Pour aller plus loin
Remplacez la table de mots-clés par un appel à un LLM, connectez un système de réservation ou transférez les messages non reconnus vers une boîte de réception humaine : la structure webhook en entrée, POST en sortie reste identique. Le forfait gratuit (50 messages/mois, pour toujours) suffit largement pour construire et tester. Créez votre compte gratuit et faites répondre le bot en un après-midi.
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