Aller au contenu
Logiciel & données

Webhook : définition

Aussi appelé : rappel HTTP, notification web, HTTP callback, web callback.

Mis à jour le

Rédigé par

Schéma d'un webhook : un événement survient dans un logiciel, un message est poussé automatiquement vers un autre logiciel, qui déclenche une action.
Fonctionnement d'un webhook : un événement déclenche un message automatique

Définition

Un webhook est un message envoyé automatiquement par un logiciel à une adresse web dès qu'un événement survient, pour déclencher une action ailleurs.

On le compare souvent à une sonnette : au lieu d'aller vérifier toutes les cinq minutes si un colis est arrivé, vous êtes prévenu au moment où il est déposé. Paiement reçu, formulaire envoyé, message entrant, rendez-vous annulé : chaque événement peut ainsi réveiller instantanément un autre système.

En détail

Le fonctionnement se résume en trois temps :

  • l'abonnement : dans le logiciel source (plateforme de paiement, agenda, messagerie, CRM…), on indique l'adresse web qui doit être prévenue et les événements concernés ;
  • l'événement : quand il se produit, le logiciel envoie immédiatement une requête HTTP à cette adresse, avec les détails de l'événement dans un format structuré ;
  • le traitement : le système qui reçoit le message (un workflow dans n8n, une application sur mesure, un chatbot) exécute l'action prévue.

Le webhook est l'inverse d'un appel d'API : l'information vient à vous au lieu d'être demandée. Les deux se combinent souvent : le webhook signale « nouvelle commande n° 1042 », puis l'API sert à récupérer le détail complet de la commande. Le protocole HTTP sous-jacent est documenté sur MDN.

C'est une brique centrale de l'intégration logicielle et des outils comme n8n, Make ou Zapier. Les messageries professionnelles fonctionnent aussi ainsi : un chatbot WhatsApp ou Telegram reçoit chaque message de client sous forme de webhook. Notre article pour relier un chatbot à l'agenda, au CRM et à la facturation en montre des usages.

Exemple (cas type)

Imaginons un organisateur de stages sportifs qui encaisserait les inscriptions en ligne. Chaque soir, il vérifierait les paiements pour envoyer les confirmations et mettre à jour ses listes.

Avec un webhook, la plateforme de paiement enverrait un message à chaque règlement réussi. Un scénario automatisé enregistrerait le participant dans le tableau des inscrits et décrémenterait les places affichées sur le site. Il enverrait la convocation par e-mail et préviendrait l'encadrant lorsque le groupe est complet. En cas de remboursement, un autre webhook déclencherait l'opération inverse.

Points d'attention

Recevoir des webhooks en production suppose de vérifier leur origine, de tolérer les doublons, de répondre rapidement et de surveiller les échecs.

  • Vérifier l'authenticité : l'adresse de réception est publique. Contrôlez la signature ou le secret fourni par l'émetteur pour rejeter les faux messages.
  • Gérer les doublons : un même événement peut être envoyé plusieurs fois. Le traitement doit reconnaître un message déjà traité.
  • Répondre vite : l'émetteur attend un accusé de réception rapide ; les traitements longs se font ensuite, en arrière-plan.
  • Surveiller : journalisez les réceptions et alertez en cas d'erreurs répétées.
  • Limiter les données : ne transmettez et ne conservez que les informations utiles, surtout s'il s'agit de données personnelles.

Pour aller plus loin

Vous voulez que vos outils réagissent en temps réel, sans intervention manuelle ? Découvrez notre offre d'automatisation des processus, qui relie vos logiciels entre eux, ou nos solutions de développement logiciel sur mesure pour les besoins plus spécifiques.

Webhook : vos questions.

Quelle différence entre un webhook et une API ?

Avec une API, votre outil interroge un autre logiciel quand il le souhaite. Avec un webhook, l'autre logiciel vous envoie l'information de lui-même, en temps réel, dès que l'événement survient. Les deux se complètent souvent.

Faut-il savoir coder pour utiliser un webhook ?

Pas forcément. Les outils d'automatisation comme n8n, Make ou Zapier fournissent une adresse de réception prête à l'emploi. Il suffit de la renseigner dans le logiciel source et de construire le scénario qui suit.

Que se passe-t-il si le webhook n'est pas reçu ?

Beaucoup de services réessaient l'envoi pendant un certain temps. Il faut néanmoins surveiller les échecs et prévoir un moyen de rattrapage, par exemple une vérification périodique via l'API, pour ne perdre aucun événement.

Besoin d'aide sur ce sujet ?

Parlez-nous de votre projet : réponse rapide et devis détaillé.