Webhook
Un webhook est un callback HTTP automatisé, par lequel un système en informe un autre en temps réel d'un événement survenu. Dès que l'événement déclencheur a lieu, par exemple un paiement reçu ou un nouvel enregistrement, le système source envoie de lui-même une requête HTTP à une URL préconfigurée du système cible et transmet les données pertinentes dans le corps de la requête. Contrairement à l'interrogation classique par polling, le système cible n'a pas à demander régulièrement mais est notifié par l'événement, ce qui fait des webhooks une brique centrale des intégrations et de l'automatisation modernes. Comme aucune requête à vide inutile n'apparaît et que la notification est quasi immédiate, les webhooks sont à la fois économes en ressources et réactifs, pour autant que le point d'entrée destinataire soit exploité et sécurisé de façon fiable.
Également connu sous : HTTP callback, web callback, reverse API
Qu'est-ce qu'un webhook ?
Un webhook inverse le schéma de communication habituel. Dans une API un client demande activement des données au serveur. Avec un webhook, c’est l’inverse : le serveur appelle le client dès que quelque chose se passe. D’où les appellations reverse API ou HTTP callback.
Le déroulement est simple. Le système cible met à disposition une URL de point d'entrée publiquement accessible et l'enregistre auprès du système source pour certains types d'événements. Quand l'un de ces événements survient, le système source envoie une requête HTTP POST à cette URL, dont le corps contient les données de l'événement, le plus souvent en JSON.
L'avantage décisif est la capacité temps réel avec une consommation minimale : les données circulent exactement quand il y a du nouveau, au lieu de créer charge et latence par des interrogations permanentes.
Webhook face au polling
Dans le polling, un système interroge une API de façon répétée à intervalles fixes, pour vérifier si de nouvelles données existent. C'est simple à mettre en œuvre mais cela gaspille des ressources, la plupart des requêtes restant sans nouveau résultat, et crée nécessairement un délai entre l'événement et la réaction.
Un webhook résout les deux problèmes. Il n'y a pas de requêtes à vide, et la notification est quasi immédiate. Le prix en est une complexité un peu plus élevée : le système cible doit exploiter un point d'entrée accessible, sécuriser les requêtes entrantes et être préparé aux échecs de livraison.
Pour des scénarios événementiels, le webhook est donc presque toujours le choix le plus efficace, tandis que le polling convient plutôt à des interrogations rares ou non critiques. En pratique, les deux approches se combinent parfois : les webhooks livrent les événements en temps réel, et un polling occasionnel sert de filet de sécurité pour rattraper d'éventuelles notifications manquées.
Sécurité et fiabilité
Comme un point d'entrée de webhook est publiquement accessible, il doit être protégé des abus. Une vérification de signature est répandue : le système source signe les données utiles avec une clé secrète, le système cible recalcule la signature et n'accepte que les requêtes correspondantes. L'authenticité de chaque notification se vérifie ainsi.
Pour la fiabilité, les relances et l'idempotence sont décisives. Si une livraison échoue, le système source devrait réessayer l'appel. Le système cible doit de son côté s'attendre à recevoir plusieurs fois la même notification et la traiter de façon idempotente, afin qu'aucun événement n'agisse deux fois.
Il est en outre conseillé d'accepter rapidement les webhooks entrants et de déporter le traitement réel en file d'attente asynchrone, pour éviter les dépassements de délai.
Les webhooks dans l'automatisation et l'IA
Les webhooks sont le trait d'union de beaucoup d'automatisations. Les plateformes d'automatisation de workflows lancent des chaînes de processus entières dès qu'un webhook arrive, par exemple quand un formulaire est rempli ou une commande déclenchée. Naissent ainsi des systèmes réactifs, qui répondent aux événements sans intervention manuelle.
Dans Solutions IA les webhooks relient les modèles et agents au monde réel de l’entreprise. Un webhook entrant peut déclencher une analyse par un Modèle de langage déclencher, dont le résultat est ensuite redistribué par webhook ou API aux systèmes suivants. Les workflows LLM s’intègrent ainsi par événement dans les processus existants.
Pour les tâches d'IA de longue durée en particulier, les webhooks sont pratiques : plutôt que d'attendre de façon synchrone le résultat d'un calcul de modèle lourd, le système lance la tâche et se fait notifier par webhook dès que le résultat est là. Cela garde les interfaces réactives et découple le traitement de la requête initiale.
Construire un endpoint de webhook
Un point d'entrée de webhook est techniquement un point d'entrée HTTP ordinaire, qui reçoit des requêtes POST. Il importe qu'il confirme rapidement la requête par un code de statut de succès, afin que le système source ne considère pas la livraison comme échouée et ne la répète pas inutilement. Le traitement métier devrait s'en découpler.
En pratique, une démarche en trois temps a fait ses preuves : recevoir, valider, mettre en file. La signature est d'abord vérifiée et la charge utile grossièrement contrôlée pour sa plausibilité. L'événement est ensuite écrit dans une file d'attente et aussitôt confirmé. Ce n'est qu'après qu'un processus d'arrière-plan assure le traitement proprement dit, éventuellement long.
Pour le diagnostic, il est utile d'enregistrer les webhooks entrants avec un journal et un identifiant d'événement unique. Les livraisons se retracent ainsi et, en cas de problème, se retraitent de façon ciblée sans solliciter le système source.
Questions fréquentes
Qu'est-ce qu'un webhook ?
Un webhook est un callback HTTP automatisé par lequel un système en informe un autre d'un événement en temps réel. Quand l'événement survient, le système source envoie une requête HTTP avec les données à une URL préconfigurée du système cible. Il n'est donc pas nécessaire d'interroger activement.
Quelle est la différence entre un webhook et une API ?
Avec une API classique, le client interroge activement le serveur. Avec un webhook, c'est l'inverse : le serveur appelle le client dès qu'un événement survient. C'est pourquoi un webhook est aussi appelé API inversée. Les deux se complètent souvent en pratique.
Quand un webhook vaut-il mieux qu'un polling ?
Les webhooks sont supérieurs quand des réactions en temps réel comptent et que les événements surviennent de façon irrégulière. Ils évitent les requêtes à vide et réduisent charge et latence. Le polling convient plutôt à des interrogations rares ou non critiques, pour lesquelles un point d'entrée en permanence accessible serait trop lourd.
Comment sécuriser un webhook ?
Une vérification de signature est courante : le système source signe les données utiles avec une clé secrète, le système cible vérifie la signature. En complément, les points d'entrée devraient utiliser HTTPS, valider les données entrantes et traiter les notifications de façon idempotente, pour absorber les livraisons multiples.
Quel rôle les webhooks jouent-ils dans l'automatisation ?
Ils sont le trait d'union de nombreux processus automatisés. Les plateformes d'automatisation de workflows lancent des déroulements complets dès qu'un webhook arrive. Dans les solutions d'IA, les webhooks déclenchent des analyses de modèle et en distribuent les résultats aux systèmes suivants selon les événements.
Que faire si un webhook n'est pas délivré ?
La plupart des systèmes sources relancent automatiquement les livraisons échouées, à intervalles croissants. Le point d'entrée devrait confirmer les requêtes rapidement et déporter le traitement en asynchrone, pour éviter les dépassements de délai. Un journal avec un identifiant d'événement unique aide en complément à retraiter de façon ciblée les événements manqués.
Termes associés
Une interface par laquelle des systèmes logiciels communiquent entre eux et échangent des données.
Association d'une automatisation de type RPA et de l'IA afin d'automatiser de bout en bout même les tâches non structurées qui demandent un jugement.
Approche stratégique consistant à automatiser de bout en bout de nombreux processus par la combinaison de plusieurs technologies.
La capacité d'un LLM à produire des appels structurés de fonctions prédéfinies, avec leurs arguments, au format JSON.
Langage de requête et environnement d'exécution pour API, qui permet aux clients de ne demander que les données nécessaires.
Mettre l'IA au service de votre entreprise ?
Nous vous aidons à intégrer l'intelligence artificielle dans vos processus, votre marketing et votre site — de manière stratégique et sûre.
Votre interlocuteur
Stefan
J'ai hâte de découvrir votre projet et de trouver ensemble la meilleure solution.
