Envoyer un message WhatsApp depuis AWS Lambda (Node.js)
Si votre backend tourne déjà sur AWS — un endpoint API Gateway, un déclencheur d'upload S3, un flux DynamoDB, une règle EventBridge planifiée — ajouter une notification WhatsApp ne devrait pas vous obliger à monter un nouveau serveur rien que pour appeler une API HTTP. Une fonction Lambda peut envoyer le message elle-même, sans processus à maintenir en vie et sans infrastructure supplémentaire à payer entre deux invocations.
Ce guide couvre une Lambda déclenchée par API Gateway (un récepteur de webhook) et une autre déclenchée par EventBridge (un rappel planifié) — les deux schémas les plus courants pour envoyer des messages WhatsApp transactionnels.
Ce dont vous avez besoin
- Un compte TextMeFlow gratuit avec un numéro WhatsApp associé par QR code.
- Votre clé API depuis le tableau de bord TextMeFlow.
- Une fonction Lambda avec le runtime Node.js 20.x (ou plus récent), qui intègre
fetchen global — aucune bibliothèque HTTP supplémentaire à embarquer.
Étape 1 : stocker la clé API dans une variable d'environnement
Ne codez jamais la clé en dur dans le corps de la fonction. Dans la console Lambda, allez dans Configuration → Environment variables et ajoutez TEXTMEFLOW_API_KEY. Si vous déployez avec Serverless Framework, SAM ou CDK, récupérez plutôt la clé depuis AWS Secrets Manager ou SSM Parameter Store au moment du déploiement, au lieu de la committer dans votre template.
Étape 2 : la fonction d'envoi
export const handler = async (event) => {
const body = JSON.parse(event.body ?? "{}");
const res = await fetch("https://api.textmeflow.eu/v1/messages", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.TEXTMEFLOW_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
to: body.phone,
text: body.message,
}),
});
if (!res.ok) {
const error = await res.json();
console.error("WhatsApp send failed", error);
return { statusCode: res.status, body: JSON.stringify(error) };
}
return { statusCode: 200, body: JSON.stringify({ sent: true }) };
};
Ce code fonctionne tel quel, que le déclencheur soit API Gateway (où event.body est le corps brut de la requête) ou une invocation directe de la Lambda par un autre service — seul le code qui construit event.body change.
Schéma A : récepteur de webhook (déclencheur API Gateway)
Placez la fonction derrière une API HTTP API Gateway, puis pointez un webhook en amont — Stripe, Shopify, un gestionnaire de formulaire, tout ce qui peut envoyer du JSON en POST — vers ce endpoint. La Lambda analyse la payload, en extrait le numéro de téléphone et un message, puis appelle TextMeFlow. Comme API Gateway met déjà en file d'attente et relance les livraisons échouées vers la Lambda, vous n'avez pas besoin de créer votre propre logique de nouvelle tentative pour le saut du webhook lui-même — uniquement pour l'appel à TextMeFlow, traité dans la section suivante.
Schéma B : rappel planifié (déclencheur EventBridge)
Pour les rappels qui partent selon un calendrier plutôt que sur un événement — par exemple un lot quotidien de rappels de rendez-vous — associez une règle EventBridge (rate(1 hour) ou une expression cron) à la même fonction, qui lit alors dans DynamoDB ou RDS au lieu de event.body :
export const handler = async () => {
const dueReminders = await getDueReminders(); // your own query
const results = await Promise.allSettled(
dueReminders.map((r) =>
fetch("https://api.textmeflow.eu/v1/messages", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.TEXTMEFLOW_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({ to: r.phone, text: r.text }),
})
)
);
return { statusCode: 200, body: JSON.stringify({ count: results.length }) };
};
Évitez Promise.all ici — une seule requête rejetée ne doit pas faire avorter tout le lot. Promise.allSettled laisse chaque rappel tenter sa chance de façon indépendante, et vous pouvez journaliser les rejetés pour un passage de reprise.
Gérer la limitation de débit au lieu de la combattre
Un lot de rappels déclenché par EventBridge est exactement le type de trafic que la logique de cadencement de TextMeFlow est conçue pour lisser : les envois consécutifs vers des destinataires différents sont espacés par un délai aléatoire plutôt que de partir tous en même temps, et une réponse 429 signifie que vous avez atteint le plafond horaire de votre offre, pas que quelque chose est cassé. Consultez la valeur Retry-After dans le corps de la réponse, puis mettez les envois échoués en file d'attente pour une invocation Lambda ultérieure (une dead-letter queue SQS convient bien ici) ou laissez-les attendre la prochaine exécution planifiée. Ne relancez pas immédiatement en boucle dans la même invocation — vous ne feriez que remplacer un pic par un autre. L'ensemble des règles de cadencement et de limitation de débit se trouve dans /fr/docs/anti-spam.
Timeouts et cold starts
L'API de TextMeFlow répond généralement bien en moins d'une seconde, mais réglez le timeout de la Lambda à 10 secondes minimum pour laisser de la marge aux cold starts et aux variations réseau — le timeout par défaut de 3 secondes coupe parfois une invocation lente et signale un faux échec. Si vos rappels tournent selon un calendrier, un cold start ne vous coûte rien ; si un webhook se trouve sur le chemin critique d'une requête visible par l'utilisateur, envisagez la provisioned concurrency.
Aller au-delà de l'offre gratuite
L'offre gratuite comprend 50 messages par mois à vie, de quoi mettre en place et tester les deux schémas ci-dessus. Dès que vous envoyez des rappels ou des notifications à un vrai volume, l'offre Starter à 5 €/mois augmente votre quota, avec des données hébergées dans l'UE (Paris) et un DPA automatique sur les offres payantes. Si vous récupérez aussi les réponses entrantes ou les statuts de livraison dans la même architecture basée sur Lambda, consultez Envoyer des messages WhatsApp depuis n8n, Make.com ou Zapier pour l'équivalent no-code du même schéma de webhook.
Prêt à vous lancer ? Créez un compte gratuit et envoyez votre premier message WhatsApp depuis une fonction Lambda 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