Webhook
Notification automatique envoyée d'une application à une autre lorsqu'un événement se produit.
Un webhook est une notification HTTP automatique envoyée d'une application à une autre quand un événement spécifique se produit. Par exemple : un paiement Stripe déclenche un webhook qui ajoute le client dans votre CRM.
Webhook vs API
L'API fonctionne en demande : vous interrogez régulièrement un service pour savoir si quelque chose a changé. Le webhook fonctionne en notification : le service vous prévient au moment même de l'événement. Le webhook réduit la latence et la charge serveur, tandis que l'appel API reste utile pour rattraper l'historique ou vérifier un état. En pratique, les deux se combinent.
Mettre en place proprement
Exposez une adresse dédiée, répondez immédiatement un code 200 puis traitez la charge en tâche de fond : un traitement lent provoque des renvois en boucle. Vérifiez la signature envoyée par l'émetteur pour rejeter les appels frauduleux, et journalisez chaque réception avec son identifiant d'événement. Testez toujours avec un outil de capture avant de brancher votre production.
Gérer les échecs et doublons
Un webhook peut arriver deux fois, dans le désordre, ou pas du tout si votre serveur était indisponible. Rendez donc le traitement idempotent en stockant les identifiants d'événements déjà traités. Prévoyez une file d'attente avec relances espacées et une alerte au-delà de quelques échecs consécutifs. Ajoutez enfin une synchronisation de rattrapage quotidienne pour combler les événements perdus.
Exemple concret
Une boutique reçoit environ 900 webhooks de paiement par mois. Sans contrôle d'idempotence, 2 % de renvois créent 18 doublons de commande et autant d'emails de confirmation en double. En stockant l'identifiant d'événement, le taux de doublon tombe à zéro pour une heure de développement.
Termes associés
API
Application Programming Interface. Interface permettant à deux applications de communiquer.
iPaaS
Integration Platform as a Service. Plateforme connectant des applications entre elles (Make, Zapier…).
Workflow
Flux de travail. Séquence d'actions automatisées déclenchée par un événement.
CES
Customer Effort Score - score mesurant l'effort qu'un client a dû fournir pour accomplir une action.
CRM
Customer Relationship Management. Outil de gestion de la relation client centralisant données et interactions.
Webhook en pratique : CRM & Automation
Pour aller au-delà de la définition, découvrez notre pilotage segmentation et flows.