Webhook

Qu’est-ce qu’un webhook ?

Vous attendez un colis. Vous pouvez descendre toutes les dix minutes voir s’il est arrivé, ou laisser votre numéro au livreur pour qu’il vous appelle. La première option revient à interroger une API encore et encore. La seconde, c’est un webhook : le système qui détient l’information vous prévient dès qu’elle existe.

Techniquement, un webhook est un appel HTTP, presque toujours un POST, qu’un service envoie vers une URL que vous lui avez fournie. Il transporte un petit paquet de données décrivant l’événement. Votre système le reçoit, répond « bien reçu » et agit.

Comment ça marche

1. Abonnement. Dans le service source, vous choisissez les événements qui vous intéressent (message reçu, paiement confirmé, appel terminé) et l’URL à prévenir.
2. Événement. Quand il se passe quelque chose, le service envoie un JSON à cette URL.
3. Réponse rapide. Votre système confirme avec un code 200. Sans réponse, l’émetteur réessaie en général.
4. Action. À partir des données, votre système fait ce qu’il faut : créer une fiche, envoyer un e-mail, lancer un scénario.

Une notification type ressemble à ceci :

{
  "event": "appointment.created",
  "occurred_at": "2026-10-07T09:30:00Z",
  "data": { "customer": "Claire Martin", "service": "Contrôle" }
}

Deux précautions de base : vérifier la signature et ne pas traiter deux fois le même événement s’il arrive en double.

Ne confondez pas le webhook avec ses voisins. Une API attend qu’on l’interroge. Le MCP et le function calling permettent à un modèle d’IA d’utiliser des outils quand il le décide. Le webhook fonctionne à l’inverse : c’est l’extérieur qui réveille votre système.

Exemple

Une auto-école de Bordeaux utilise un outil de réservation en ligne. À chaque leçon de conduite réservée, l’outil déclenche un webhook. Un petit scénario d’automatisation IA le reçoit, rédige un message de bienvenue avec la date et le nom du moniteur, puis l’enregistre dans la fiche de l’élève. Avant, quelqu’un au secrétariat vérifiait les réservations deux fois par jour.

Ce que ça change pour votre entreprise

Les webhooks sont la colle entre vos outils. Si vous voulez qu’un agent IA réagisse à ce qui se passe dans votre boutique en ligne, votre agenda ou votre ERP, il faut bien que quelqu’un le prévienne, et c’est généralement ainsi qu’on procède.

Chez UTIO, l’API d’IA est l’autre moitié de cet échange : votre système reçoit la notification, puis appelle l’API pour transcrire un audio, générer un texte ou envoyer un message par WhatsApp, voix ou e-mail. Les appels qui envoient par un canal exigent l’en-tête Idempotency-Key : si votre scénario réessaie parce qu’un webhook est arrivé deux fois, le client ne reçoit pas le message en double.