FRENES

Glossaire · Protocole MCP

Webhook

Un webhook est un mécanisme par lequel un service envoie automatiquement une notification à une adresse web lorsqu’un événement se produit. Il permet par exemple de prévenir votre agent qu’un formulaire vient d’être rempli, sans lui faire vérifier régulièrement si une nouvelle réponse est arrivée.

Webhook : l'explication

Pour configurer un webhook, vous choisissez généralement les événements à suivre et indiquez une adresse capable de recevoir des requêtes. Lorsqu’un événement survient, le service émetteur envoie des données à cette adresse. L’application destinataire vérifie la demande, puis traite le contenu ou programme une tâche. Le message peut contenir les détails utiles ou seulement une référence à consulter. La documentation présente ce fonctionnement événementiel ici : https://docs.github.com/en/webhooks/about-webhooks. Il évite certaines vérifications répétées, sans supprimer tous les échanges.

Un webhook sert à relier une action à une autre dans un processus automatisé. L’arrivée d’un fichier peut déclencher sa classification, et la fin d’une transcription peut lancer un résumé. Le service qui reçoit l’événement n’est pas obligatoirement le modèle lui-même. Il peut s’agir d’un serveur intermédiaire qui filtre les données, applique des règles et décide si un agent doit intervenir. Cette organisation permet de garder les déclenchements distincts de la production des réponses.

La réception d’un webhook ne prouve pas, à elle seule, que le message est authentique ni que l’action demandée doit être exécutée. L’intégration doit vérifier l’origine selon les mécanismes du service, souvent une signature. Elle doit aussi prévoir les retards, les échecs et les événements reçus plusieurs fois. L’ordre de livraison et les nouvelles tentatives dépendent du fournisseur. Une opération importante doit donc rester correcte même si une notification arrive tard ou est répétée.

Un exemple concret

Vous recevez des demandes de dépannage par formulaire. Lorsqu’une personne envoie sa demande, un webhook avertit votre système de suivi. Celui-ci vérifie le message, transmet le texte utile à un agent et prépare une proposition de réponse. Vous la relisez avant l’envoi. Si la même notification arrive une seconde fois, le système reconnaît la demande déjà traitée et évite de créer un nouveau dossier ou de répondre deux fois.

Pourquoi c'est important

Les webhooks rendent les agents plus réactifs, mais ils créent aussi une porte d’entrée pour des données externes. Vérifiez quels événements déclenchent des actions, quelles informations sont transmises et comment les doublons sont gérés. Pour les opérations sensibles, distinguez la notification de l’autorisation d’agir. Un événement peut annoncer qu’un document existe sans autoriser son partage, sa suppression ou l’exécution des instructions qu’il contient.

Idées reçues

  • Un webhook ne garantit pas une livraison immédiate et unique : selon le service et les conditions réseau, une notification peut arriver en retard, être répétée ou nécessiter une nouvelle tentative avant que votre application puisse la traiter.
  • Recevoir un webhook ne signifie pas que le modèle doit suivre son contenu comme une instruction : les données transmises peuvent provenir d’utilisateurs externes et doivent être traitées selon les permissions et les règles de votre application.

Autres termes : protocole mcp

MCP (Model Context Protocol)
Le MCP, ou Model Context Protocol, est un protocole qui organise les échanges entre une application IA et des services proposant des données ou des fonctions.
serveur MCP
Un serveur MCP est un composant logiciel qui expose des données ou des fonctions au moyen du Model Context Protocol.
client MCP
Un client MCP est le composant d’une application qui communique avec un serveur au moyen du Model Context Protocol.
API
Une API, ou interface de programmation d’application, définit comment un logiciel peut utiliser les fonctions ou les données d’un autre composant.
SDK
SDK signifie kit de développement logiciel.
sortie structurée
Une sortie structurée est une réponse organisée selon un format défini, avec des champs et des types de données prévus.
protocole A2A
Le protocole A2A est un ensemble ouvert de règles qui permet à des agents IA indépendants de communiquer et de se confier des tâches.

Où le site en parle

Le terme apparaît dans 28 pages du site. Quelques-unes :

Pour aller plus loin

Questions fréquentes

Est-ce différent d’une API ?

Une API définit une interface entre programmes. Un webhook est une façon de notifier un événement en envoyant une requête vers une adresse prévue. Les deux se complètent souvent : la notification peut déclencher une consultation d’API.

Faut-il un serveur accessible ?

Il faut un point de réception joignable par le service émetteur. Il peut être fourni par votre application, un hébergeur ou une plateforme d’automatisation. Vous n’avez donc pas nécessairement à administrer vous-même un serveur dédié.

Comment éviter les actions en double ?

L’application peut mémoriser l’identifiant d’un événement ou vérifier l’état du dossier avant d’agir. La bonne méthode dépend du service. L’objectif est qu’une notification répétée ne provoque pas plusieurs fois la même opération avec des conséquences.

Neutralité. Aucun lien d'affiliation. Aucun éditeur ne paie pour être évalué, noté ou classé. Les évaluations sont dirigées par François Chollet, neutres et factuelles, et chaque donnée est datée et sourcée. Comment nous notons