Aller au contenu

Webhook

Dernière mise à jour:

Ce qu'est un webhook

On parle aussi de rappel HTTP (HTTP callback) ou d'API inversée. Avec un appel d'API classique, votre programme demande des données à un autre système. Avec un webhook, vous enregistrez une URL une seule fois, choisissez les événements qui vous intéressent, et l'autre système appelle cette URL chaque fois que l'un d'eux survient. Le message est généralement une requête POST avec un corps JSON qui décrit l'événement.

L'alternative est le polling : interroger une API toutes les quelques minutes pour détecter les changements. Le polling gaspille des requêtes quand rien ne s'est passé et retarde les mises à jour quand quelque chose a changé. Les webhooks évitent ces deux écueils.

Comment il fonctionne

Un webhook implique un émetteur et un destinataire :

  • Le destinataire crée un endpoint, une URL sur son propre serveur qui accepte les requêtes en HTTPS.
  • Dans les paramètres de l'émetteur, il enregistre cette URL et choisit les événements auxquels s'abonner.
  • Quand un événement se produit, l'émetteur envoie à l'URL un payload JSON avec le type d'événement et ses données.
  • Le destinataire vérifie que la requête est authentique, répond rapidement avec un code de statut 2xx, puis traite les données. Sans réponse de succès, l'émetteur réessaie généralement plus tard.

Exemple

Une boutique en ligne veut que son logiciel d'entrepôt connaisse chaque nouvelle commande. Au lieu que le logiciel interroge la boutique toutes les minutes, la boutique envoie un webhook à l'endpoint du logiciel à chaque commande. Le payload contient le numéro de commande, les articles et l'adresse de livraison, et la préparation peut commencer en quelques secondes.

Bonnes pratiques pour recevoir des webhooks

Un endpoint de webhook est une URL publique, il faut donc traiter chaque requête entrante avec prudence :

  • Vérifiez la signature. Beaucoup d'émetteurs signent chaque payload avec un secret partagé, souvent via HMAC, pour que vous puissiez confirmer que la requête vient bien d'eux et n'a pas été modifiée en route.
  • Utilisez HTTPS pour que les payloads, qui peuvent contenir des données personnelles, soient chiffrés pendant le transfert.
  • Répondez vite. Renvoyez immédiatement un statut 2xx et faites le travail long en arrière-plan, sinon l'émetteur risque de considérer l'envoi comme échoué.
  • Prévoyez les doublons. Les nouvelles tentatives peuvent livrer deux fois le même événement : utilisez son identifiant pour ne le traiter qu'une fois. On parle d'idempotence.

Pourquoi c'est important pour les chatbots d'entreprise

Les webhooks relient un chatbot au reste de l'entreprise sans que personne ait à surveiller un tableau de bord. Une plateforme de chatbot peut envoyer un webhook à la fin d'une conversation ou à la capture d'un lead, pour qu'un CRM, un tableur ou un outil d'automatisation le reçoive aussitôt. En comparant des outils de chatbot, vérifiez quels événements ils peuvent envoyer et si les payloads sont signés.

Les webhooks dans intoCHAT

intoCHAT envoie des webhooks signés (HMAC-SHA256) pour quatre événements : un nouveau lead (lead.created), une demande de transfert (handoff.requested), l'envoi d'un formulaire de chat (form.submitted) et un rendez-vous réservé (booking.created). Chaque agent peut les envoyer à 5 adresses https au maximum, les envois échoués sont relancés et un journal des envois montre ce qui a été transmis. Ils fonctionnent avec votre propre serveur ou avec les outils qui acceptent des webhooks entrants, comme Zapier, Make ou n8n. intoCHAT dispose aussi de sa propre application Zapier (dès l'offre Starter) ; il n'existe pas encore d'application pour Make ou n8n. Les nouveaux leads vous parviennent aussi par une alerte e-mail, envoyée au propriétaire et jusqu'à 5 autres adresses, et dans le tableau des leads, d'où vous pouvez les exporter en CSV.

Les actions API personnalisées d'intoCHAT fonctionnent autrement que les webhooks. L'agent appelle votre API HTTP pendant un chat quand la conversation le demande, par exemple pour vérifier un prix ou une disponibilité, et non automatiquement lors d'un événement fixe. Elles apportent des données en direct dans les réponses ; transmettre les leads à un autre système est le rôle des webhooks.

Questions fréquentes

Quelle est la différence entre un webhook et une API ?

Une API attend votre requête et y répond. Un webhook vous envoie des données de lui-même dès qu'un événement se produit. En pratique, les deux se complètent : le webhook signale qu'il s'est passé quelque chose, et votre système peut appeler l'API pour obtenir plus de détails.

Les webhooks sont-ils sûrs ?

Ils peuvent l'être, si le destinataire fait sa part. Utilisez un endpoint en HTTPS, vérifiez la signature que l'émetteur joint à chaque payload et rejetez les requêtes qui échouent au contrôle. Gardez le secret partagé côté serveur et remplacez-le s'il a fuité.

Que se passe-t-il si mon endpoint de webhook est indisponible ?

La plupart des émetteurs réessaient les envois échoués pendant un certain temps, et certains désactivent le webhook après des échecs répétés. Comme les nouvelles tentatives peuvent livrer plusieurs fois le même événement, enregistrez les identifiants d'événement et ignorez ceux déjà traités.

intoCHAT prend-il en charge les webhooks ?

Oui. intoCHAT envoie des webhooks signés, avec relances et journal des envois, pour les nouveaux leads, les demandes de transfert, les formulaires de chat envoyés et les rendez-vous réservés. Vous pouvez les recevoir sur votre propre serveur ou dans Zapier, Make ou n8n via leurs déclencheurs de webhooks entrants. Dès l'offre Starter, l'application Zapier d'intoCHAT peut aussi lancer un Zap pour chaque nouveau lead ; il n'existe pas encore d'application pour Make ou n8n.

Voyez-le répondre à partir de votre site

Collez l’adresse de votre site et discutez avec un agent créé à partir de vos pages. Cela prend environ une minute.

Créer votre agent gratuitement

Offre gratuite, sans carte bancaire.