Les webhooks WhatsApp dans l'e-commerce : ce qu'il faut savoir

Un webhook WhatsApp est une notification HTTP que Meta envoie à votre serveur chaque fois qu'un événement survient sur votre numéro WhatsApp Business : message reçu, statut de livraison mis à jour, bouton cliqué, opt-out enregistré. Dans un contexte e-commerce, ces événements sont le carburant de l'automatisation conversationnelle. Comprendre leur structure et leur comportement, c'est la différence entre une intégration réactive et une qui reste au niveau d'un simple envoi de SMS enrichi.

Ce que les webhooks WhatsApp transportent en e-commerce

L'API WhatsApp Business émet plusieurs types d'événements. En e-commerce, les plus importants sont :

Événements entrants (messages reçus)

• messages : un client envoie un texte libre, un emoji, un document ou une image.
• button : le client clique sur un bouton interactif (réponse rapide ou CTA).
• interactive : réponse à une liste interactive ou à un bouton de liste.

Événements de statut (messages envoyés)

• sent : le message a quitté les serveurs Meta.
• delivered : le message est arrivé sur le téléphone du destinataire.
• read : le client a ouvert le message.
• failed : la livraison a échoué (numéro invalide, compte inactif, etc.).

Événements système

• Opt-out d'un utilisateur.
• Changement de numéro de téléphone associé à un compte.

En e-commerce, la lecture de ces événements permet de déclencher des actions précises : un read sur un message de confirmation de commande peut démarrer un timer pour l'envoi du suivi de livraison ; un button sur "Je retourne mon article" déclenche le flux de retour sans intervention humaine.

Architecture webhook dans une plateforme e-commerce

Pour exploiter les webhooks, votre backend doit exposer un endpoint HTTPS capable de recevoir des requêtes POST de Meta. Voici les étapes clés :

1. Déclaration du webhook : lors de la configuration via Whakup, vous renseignez l'URL de votre endpoint et un token de vérification. Meta envoie une requête GET pour valider l'endpoint avant d'activer les notifications.
2. Vérification de signature : chaque payload webhook est signé avec votre app secret. Votre backend doit valider la signature HMAC-SHA256 avant de traiter le payload.
3. Réponse immédiate : votre endpoint doit retourner un HTTP 200 dans les 20 secondes. Si Meta ne reçoit pas de 200, il retentera la livraison selon une politique d'exponentielle backoff.
4. Traitement asynchrone : ne traitez pas la logique métier dans le handler HTTP. Mettez le payload en file d'attente (Redis, RabbitMQ, SQS) et traitez-le dans un worker séparé.
5. Idempotence : Meta peut livrer le même événement plusieurs fois. Votre logique doit dédupliquer sur l'identifiant unique du message (wamid).

Pour les plateformes e-commerce multi-marchands, l'API WhatsApp Business de Whakup gère nativement le multi-tenant : chaque marchand a son numéro dédié et ses webhooks sont routés de façon isolée.

Cas d'usage concrets : de l'événement à l'action métier

Événement webhook	Action déclenchée	Valeur métier
Message reçu : "Où est ma commande ?"	Envoi automatique du lien de tracking	Réduction des tickets SAV
Bouton cliqué : "Confirmer la commande"	Mise à jour statut commande + envoi reçu	Fluidification du tunnel
Statut failed sur message livraison	Alerte au marchand + tentative sur autre canal	Réduction des litiges livraison
Message reçu : texte libre hors flux	Transfert vers agent humain ou bot NLU	Continuité de service
Bouton cliqué : "Retourner l'article"	Création automatique du dossier retour	Autonomisation du client
Statut read sur relance panier abandonné	Arrêt de la séquence de relance	Réduction des envois inutiles

Ce dernier point est particulièrement utile : savoir qu'un client a lu votre relance panier vous évite d'envoyer deux autres messages. Le statut read couplé à un timer vous permet d'espacer intelligemment vos séquences.

Consultez également les templates WhatsApp et leurs catégories pour comprendre comment structurer les messages qui déclenchent ces interactions, et le guide complet de l'API WhatsApp Business pour le contexte d'ensemble.

Points de vigilance pour les équipes techniques e-commerce

Volume et scalabilité : un site e-commerce avec 50 000 commandes par mois peut générer des centaines de milliers d'événements webhooks. Votre endpoint doit tenir la charge. Prévoyez une architecture de file de messages dès le départ.

Gestion des erreurs : un endpoint qui retourne des 500 de façon répétée peut être suspendu temporairement par Meta. Monitorez votre taux d'erreur webhook.

Sécurité : votre endpoint webhook est public. Validez systématiquement la signature Meta et rejetez les requêtes non signées.

Données personnelles : les payloads webhooks contiennent des numéros de téléphone et des contenus de messages. Ils sont soumis au RGPD. Whakup héberge ses infrastructures en EU, mais votre propre traitement de ces données doit être conforme.

Numéros invalides : les événements failed avec un code d'erreur lié à un numéro inactif doivent déclencher une procédure de nettoyage de votre base de contacts. Un taux trop élevé de messages non délivrés peut affecter la qualité de votre compte WhatsApp Business.

FAQ

Combien de temps Meta conserve-t-il un événement webhook non livré ?

Meta retente la livraison pendant environ 7 jours avec un backoff exponentiel. Au-delà, l'événement est abandonné. Votre endpoint doit donc être hautement disponible.

Peut-on filtrer les types d'événements reçus ?

Oui. Lors de la configuration du webhook dans l'interface Whakup ou via l'API Graph, vous choisissez les champs auxquels vous vous abonnez (messages, statuts, etc.). Abonnez-vous uniquement à ce dont vous avez besoin pour limiter le volume de traitement.

Un webhook peut-il déclencher un envoi WhatsApp en réponse ?

Oui, c'est le principe des conversations automatisées. Votre worker traite l'événement entrant et appelle l'API Whakup pour envoyer la réponse. Attention : si la fenêtre de conversation de 24h est ouverte, vous pouvez envoyer n'importe quel message. Si elle est fermée, vous devez utiliser un template approuvé.

Comment tester les webhooks en local pendant le développement ?

Utilisez un outil de tunnel comme ngrok ou Cloudflare Tunnel pour exposer votre serveur local à une URL HTTPS publique que Meta peut appeler. C'est la méthode standard pour le développement et les tests d'intégration.

---

Les webhooks WhatsApp sont le système nerveux de toute intégration e-commerce sérieuse. Bien configurés, ils transforment WhatsApp en canal conversationnel automatisé, réactif et mesurable. Explorez l'API WhatsApp de Whakup et démarrez votre intégration avec un accès direct à la documentation technique et au support.