API WhatsApp en PHP, Python et Node.js : exemples
Si vous développez une fonctionnalité backend — confirmations de commande, rappels de rendez-vous, codes OTP — vous n'avez pas besoin d'un outil no-code au milieu. L'API de TextMeFlow se résume à une requête POST authentifiée, donc l'appeler directement depuis votre propre code PHP, Python ou Node.js est souvent plus simple que de monter une plateforme d'automatisation. Ce guide propose des extraits fonctionnels pour les trois.
Avant de commencer
- Créez un compte TextMeFlow gratuit — 50 messages/mois, sans carte bancaire, sans vérification Meta Business.
- Scannez le QR code du portail avec le téléphone qui contient votre numéro WhatsApp.
- Copiez votre clé API depuis le tableau de bord.
Référence complète des endpoints : /fr/docs/api.
PHP
<?php
$response = file_get_contents('https://api.textmeflow.eu/v1/messages', false, stream_context_create([
'http' => [
'method' => 'POST',
'header' => "Content-Type: application/json\r\n" .
"Authorization: Bearer YOUR_API_KEY\r\n",
'content' => json_encode([
'to' => '+32472932208',
'text' => 'Votre commande n°1042 a été expédiée.',
]),
],
]));
$data = json_decode($response, true);
echo $data['status']; // "queued"
Si vous migrez depuis TextMeBot, l'endpoint de compatibilité /send.php (documenté dans le guide de migration) ne nécessite aucune modification de code — il suffit de changer l'URL de base et la clé. Les nouvelles intégrations devraient utiliser directement /v1/messages, car il renvoie un vrai corps JSON et un message_id que vous pouvez suivre.
Python
import requests
response = requests.post(
"https://api.textmeflow.eu/v1/messages",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={
"to": "+32472932208",
"text": "Votre commande n°1042 a été expédiée.",
},
)
response.raise_for_status()
message_id = response.json()["message_id"]
Pour des rappels de rendez-vous envoyés depuis une tâche cron ou Celery, conservez le numéro to au format E.164 (+ suivi de l'indicatif pays) — l'API rejette tout le reste avec une erreur 422.
Node.js
const response = await fetch("https://api.textmeflow.eu/v1/messages", {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: "Bearer YOUR_API_KEY",
},
body: JSON.stringify({
to: "+32472932208",
text: "Votre commande n°1042 a été expédiée.",
}),
});
const data = await response.json();
console.log(data.status); // "queued"
Fonctionne de la même manière dans une route d'API Next.js, un handler Express ou une Lambda — aucune dépendance à un SDK, juste fetch et votre clé API.
Envoyer des médias
Les trois exemples ci-dessus acceptent un champ media_url facultatif en plus de text — pointez-le vers n'importe quel fichier accessible publiquement (image, PDF, message vocal) jusqu'à 100 Mo et il sera joint au message WhatsApp.
Gérer les erreurs et le quota
Une réponse 202 signifie que le message est en file d'attente, pas qu'il est délivré — interrogez GET /v1/messages/{id} si vous avez besoin du statut de livraison dans votre propre tableau de bord. Une réponse 429 signifie que vous avez atteint la limite de débit ou le quota mensuel de votre offre ; l'offre gratuite plafonne à 50 messages/mois pendant toute la durée de vie du compte, donc au-delà il faut une offre payante (Starter à partir de 5 €/mois).
Recevoir les réponses
L'envoi n'est que la moitié de la plupart des intégrations. Configurez un webhook dans le portail et TextMeFlow envoie chaque message WhatsApp entrant en POST vers votre endpoint sous forme de JSON signé par HMAC — vérifiez la signature côté serveur avant de faire confiance à la payload. Voir /fr/docs/webhooks pour le format exact de l'en-tête et un exemple de vérification.
Pour conclure
Pour la plupart des cas d'usage backend, c'est toute l'intégration : un POST pour envoyer, un endpoint de webhook pour recevoir. Pas de Meta Business Manager, pas de file d'approbation de modèles, pas de SDK à installer. Commencez gratuitement et envoyez votre premier message 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