Envoyer un message WhatsApp depuis Next.js sur Vercel
Next.js sur Vercel est un endroit courant pour mettre en place des notifications WhatsApp : l'envoi d'un formulaire, une confirmation de commande, la mise à jour d'un ticket de support. La difficulté n'est pas l'appel HTTP lui-même, mais de l'effectuer de façon fiable depuis une fonction serverless, et de recevoir des webhooks en retour sur une plateforme sans serveur persistant. Ce guide couvre les deux.
Envoyer un message depuis une route API
Un Route Handler (la convention app/api/*/route.ts) est l'endroit le plus simple pour appeler l'API TextMeFlow. Il s'exécute comme une fonction serverless de courte durée : gardez donc la requête synchrone et renvoyez une réponse une fois l'appel d'API terminé — ne lancez pas l'appel sans l'attendre (fire-and-forget), sinon Vercel peut geler la fonction avant la fin de la requête.
// app/api/notify/route.ts
export async function POST(req: Request) {
const { phone, message } = await req.json();
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: phone, text: message }),
});
if (!res.ok) {
const error = await res.json();
return Response.json({ error }, { status: res.status });
}
return Response.json({ sent: true });
}
Stockez TEXTMEFLOW_API_KEY comme variable d'environnement Vercel, pas dans le code — elle ne doit jamais être exposée dans le bundle client ; ne la référencez donc que dans un Route Handler ou une Server Action, jamais dans un composant 'use client'.
L'appeler depuis une Server Action
Si vous utilisez déjà l'App Router, une Server Action vous évite le saut réseau supplémentaire qu'implique l'appel de votre propre route API depuis le client :
// app/actions.ts
'use server';
export async function sendConfirmation(phone: string, orderId: string) {
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: phone,
text: `Votre commande ${orderId} est confirmée.`,
}),
});
return res.ok;
}
Appelez-la directement depuis la prop action d'un formulaire ou après la fin d'une mutation — pas de fetch côté client, pas de route API à maintenir.
Recevoir des webhooks sur Vercel
Si vous voulez aussi le statut de livraison ou les réponses entrantes, il vous faut un Route Handler qui accepte les requêtes POST de TextMeFlow et vérifie la signature avant de faire confiance à la charge utile. Chaque requête de webhook porte une signature HMAC — consultez la documentation des webhooks pour l'en-tête exact et les étapes de vérification. Si vous sautez cette vérification, toute personne qui découvre l'URL de votre point de terminaison peut envoyer de faux événements de livraison.
// app/api/webhooks/textmeflow/route.ts
import crypto from 'crypto';
export async function POST(req: Request) {
const rawBody = await req.text();
const signature = req.headers.get('x-textmeflow-signature') ?? '';
const expected = crypto
.createHmac('sha256', process.env.TEXTMEFLOW_WEBHOOK_SECRET!)
.update(rawBody)
.digest('hex');
if (signature !== expected) {
return new Response('Invalid signature', { status: 401 });
}
const event = JSON.parse(rawBody);
// handle event.type: message.delivered, message.failed, message.received, ...
return new Response('ok', { status: 200 });
}
Deux détails propres au serverless comptent ici. D'abord, n'utilisez pas req.json() avant de vérifier la signature — il vous faut les octets bruts exacts signés par TextMeFlow, et resérialiser un objet analysé peut produire une chaîne d'octets différente qui échoue à la vérification. Ensuite, les fonctions Vercel ont un budget de démarrage à froid et de temps d'exécution : gardez le traitement des webhooks rapide (journaliser, mettre en file, accuser réception) et déléguez les tâches lentes, comme l'envoi d'un message de suivi ou l'écriture en base de données, à une tâche de fond ou à une file d'attente plutôt que de bloquer la réponse.
Idempotence en cas de nouvelles tentatives
TextMeFlow retente la livraison d'un webhook si votre point de terminaison ne répond pas à temps, ce qui arrive plus souvent sur une fonction serverless en démarrage à froid que sur un serveur déjà chaud. Chaque événement porte un event_id — conservez les identifiants traités (ne serait-ce que dans un magasin KV ou votre base de données) et ignorez les doublons, afin qu'un événement message.delivered retransmis ne déclenche pas une notification en double en aval. Le guide sur les nouvelles tentatives de webhook et l'idempotence détaille ce schéma.
Pour commencer
Il vous suffit d'une clé API pour commencer à envoyer : associez votre numéro WhatsApp via le flux QR, récupérez la clé dans le tableau de bord, et le Route Handler ci-dessus devient en quelques minutes une intégration fonctionnelle. Consultez le guide de démarrage pour l'étape d'association, puis essayez TextMeFlow gratuitement — le plan gratuit inclut 50 messages par mois pour tester tout le flux avant de vous engager.
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