Qu'est-ce qu'un webhook ? Le guide des non-développeurs pour connecter votre chatbot à vos outils
Un webhook est un message automatique qu'une application envoie à une autre dès qu'un événement se produit. Voici comment fonctionnent les webhooks d'un chatbot, en quoi ils…

Dans cet article
Alors, qu'est-ce qu'un webhook ? Un webhook est un message automatique qu'une application envoie à une autre dès qu'un événement se produit, par exemple quand votre chatbot capte un nouveau prospect. Au lieu que vos autres outils demandent « du nouveau ? » toutes les quelques minutes, le chatbot les prévient immédiatement.
C'est la différence entre aller vérifier sa boîte aux lettres toutes les heures et avoir une sonnette. La sonnette ne retentit que lorsque quelqu'un est vraiment là.
Au programme : comment fonctionnent les webhooks d'un chatbot, en quoi ils se distinguent d'une API, quels événements valent la peine d'être envoyés et comment les sécuriser.
À retenir
- Un webhook pousse des données vers un autre système quand un événement se produit ; une API est généralement quelque chose que vous appelez pour récupérer des données.
- Les webhooks de chatbot utiles se déclenchent sur des événements métier, comme un nouveau prospect, un transfert vers un humain ou une conversation clôturée.
- Les signatures HMAC prouvent qu'un message est authentique, et les nouvelles tentatives garantissent qu'une courte panne ne fait pas perdre de données.
Qu'est-ce qu'un webhook, en termes simples ?
Un webhook comporte trois éléments :
- Un événement : il se passe quelque chose dans l'application source, par exemple un visiteur laisse son e-mail dans le chat.
- Une URL : l'adresse du système destinataire, souvent appelée endpoint. Vous la collez dans les paramètres de l'application source.
- Un payload : un petit paquet de données, généralement au format JSON, qui décrit ce qui s'est passé.
Quand l'événement se produit, l'application source envoie le payload à cette URL. Le système destinataire le lit et en fait quelque chose d'utile : créer un contact, publier une alerte, ajouter une ligne à un tableur. Personne n'a besoin d'appuyer sur un bouton ni d'écrire un script qui guette les changements.
Vous n'avez pas non plus à construire vous-même la partie réceptrice. Des plateformes d'automatisation comme Zapier, Make et n8n peuvent générer une URL de webhook pour vous en quelques clics, et c'est précisément ce qui rend les webhooks accessibles aux non-développeurs.
Webhook ou API : quelle différence ?
On les présente souvent comme rivaux, mais ils fonctionnent en duo. Une API (interface de programmation d'application) est un ensemble de portes d'entrée dans une application, auxquelles vous frappez pour lire ou modifier des données. Un webhook, c'est l'application qui frappe à votre porte quand quelque chose se passe.
Sans webhooks, la seule façon d'être informé des nouveaux événements est le polling : interroger l'API encore et encore pour savoir si quelque chose a changé.
| Webhook (push) | Polling d'API (pull) | |
|---|---|---|
| Qui déclenche | L'application source, quand un événement se produit | Votre système, selon un calendrier |
| Rapidité | Quasi temps réel | Aussi rapide que votre intervalle de polling |
| Idéal pour | Alertes, synchronisation des nouveaux enregistrements, déclenchement de workflows | Exports en masse, rapports, recherches à la demande |
| Mise en place | Coller une URL, choisir les événements | Écrire un script ou une tâche planifiée |
| Risque principal | Messages manqués si le destinataire est indisponible (géré par les nouvelles tentatives) | Retards, requêtes inutiles, limites de débit |
Beaucoup d'intégrations utilisent les deux. Un webhook annonce « la conversation 123 vient d'être transférée », puis le système destinataire appelle l'API s'il a besoin de plus de détails.
Webhooks de chatbot : exemples d'événements à envoyer
Les meilleurs webhooks de chatbot correspondent à des moments qui comptent déjà pour votre équipe. Trois exemples courants :
Nouveau prospect capté
Un visiteur partage ses coordonnées et répond à une ou deux questions de qualification. Usages typiques : créer ou mettre à jour un contact dans le CRM, alerter votre canal commercial ou ajouter le prospect à une liste de nurturing (avec son consentement). Comme répondre vite aux nouveaux leads fait gagner plus de ventes, c'est généralement le premier webhook que les équipes configurent.
Conversation transférée à un humain
L'assistant a décidé qu'une personne devait prendre le relais, ou le client l'a demandé. Usages typiques : prévenir le conseiller de permanence, ouvrir un ticket dans le help desk ou signaler un compte prioritaire. Le payload doit transporter le contexte dont votre processus de transfert du chatbot vers un humain a besoin, comme l'intention, les tags et les coordonnées.
Conversation clôturée
Une conversation s'est terminée, résolue par l'IA ou par un conseiller. Usages typiques : l'enregistrer pour le reporting, mettre à jour un tableau de bord ou créer une tâche de suivi.
Une règle simple : abonnez-vous uniquement aux événements sur lesquels vous agirez. Chaque webhook activé est un élément de plus à surveiller.
Sécurité des webhooks : signatures, nouvelles tentatives et suivi des envois
Une URL de webhook n'est qu'une adresse sur Internet. Qu'est-ce qui empêche quelqu'un d'y envoyer de faux messages « nouveau prospect » ? Et que se passe-t-il si votre serveur est indisponible pendant dix minutes ? Trois protections répondent à ces questions.
Signatures HMAC. L'expéditeur et le destinataire partagent une clé secrète. L'expéditeur calcule une signature à partir du payload et du secret, et la joint à chaque requête. Le destinataire la recalcule et rejette tout ce qui ne correspond pas : les messages falsifiés ou altérés échouent.
Nouvelles tentatives. Si le destinataire ne confirme pas la réception, l'expéditeur réessaie plus tard, généralement avec des intervalles de plus en plus longs entre les tentatives. Une brève panne ne signifie pas une perte de données.
Disjoncteurs et suivi des envois. Si un endpoint échoue de manière répétée, un disjoncteur (circuit breaker) suspend les envois pendant un moment au lieu de bombarder un serveur en panne. Les journaux d'envoi montrent ce qui a été envoyé et si l'envoi a réussi, pour déboguer sans deviner.
Côté réception, quelques habitudes évitent la plupart des problèmes :
- Vérifiez la signature avant d'utiliser les données.
- Répondez rapidement avec un code de succès, puis effectuez les traitements lourds en arrière-plan.
- Attendez-vous à des doublons : une nouvelle tentative peut livrer deux fois le même événement, utilisez donc l'identifiant de l'événement pour ignorer les répétitions.
- Utilisez uniquement des endpoints en HTTPS.
- Ne transmettez que les données personnelles dont l'outil destinataire a besoin ; les règles du RGPD pour les chatbots IA s'appliquent toujours une fois que les données quittent le chat.
Comment Conviro gère les webhooks en temps réel
Conviro propose des webhooks en temps réel. Les événements atteignent votre endpoint au moment où ils se produisent, signés en HMAC pour que vous puissiez vérifier chaque requête, renvoyés automatiquement en cas d'échec et protégés par un disjoncteur. Le suivi des envois indique ce qui a été envoyé et si c'est bien arrivé.
Dirigez ces webhooks vers votre propre code ou vers un outil no-code : Conviro se connecte aussi à Zapier, Make et n8n, et propose une API REST avec authentification par jeton bearer et clés à périmètre restreint pour récupérer des données à la demande. Tout cela est disponible à partir de l'offre Pro. La documentation développeurs détaille les payloads et la vérification des signatures, et la page des intégrations d'automatisation présente les solutions no-code.
Questions fréquentes
C'est quoi un webhook, en termes simples ?
Un webhook est une notification automatique qu'une application envoie à une autre quand un événement précis se produit. Vous donnez une URL à l'application source, vous choisissez les événements, et elle envoie à chaque fois un petit paquet de données à cette URL. Cela fonctionne comme une sonnette pour les logiciels : le système destinataire est informé des changements instantanément au lieu de vérifier en boucle.
Faut-il un développeur pour utiliser des webhooks ?
Pas toujours. Les plateformes d'automatisation comme Zapier, Make et n8n génèrent une URL de webhook pour vous et vous permettent d'associer les données entrantes à des actions dans un éditeur visuel. Un développeur devient utile quand vous construisez votre propre endpoint, vérifiez les signatures dans le code ou connectez un système interne sans connecteur prêt à l'emploi.
Un webhook est-il plus rapide qu'une API ?
Pour être informé des nouveaux événements, oui. Un webhook arrive quelques instants après l'événement, alors que le polling d'une API n'est jamais plus rapide que la fréquence de vos vérifications. Pour les données historiques ou des détails supplémentaires, l'API est le bon outil. La plupart des intégrations bien conçues utilisent les webhooks pour notifier et l'API pour consulter.
Que se passe-t-il si mon endpoint de webhook est indisponible ?
Cela dépend de l'expéditeur. Les bons systèmes de webhooks renvoient les envois échoués pendant un certain temps, pour que les courtes pannes ne fassent pas perdre de données, et certains suspendent les envois vers un endpoint qui échoue de manière répétée. Vérifiez si votre fournisseur effectue de nouvelles tentatives, et assurez-vous que votre endpoint peut traiter sans risque le même événement reçu deux fois.
Prochaines étapes
Choisissez un événement sur lequel vous agiriez dès aujourd'hui, en général les nouveaux prospects, et connectez-le à l'outil où votre équipe travaille déjà. Une fois que cela tourne de façon fiable, ajoutez les transferts et les conversations clôturées. Commencez gratuitement avec Conviro pour configurer votre assistant, puis passez à l'offre Pro quand vous serez prêt à connecter des webhooks.
Publié par
Conviro
Partage des analyses sur le support client par IA, l'automatisation des chatbots et les stratégies de croissance SaaS.
Développez avec Conviro
Connectez les workflows conversationnels à votre stack technique
Consultez les ressources développeurs et les modèles d’intégration avant de concevoir l’implémentation.
Articles associés
Plus d'articles
Engineering
IMAP, POP3 et SMTP expliqués : connecter une boîte support à un assistant IA
7 min de lecture
Lire l'article

Engineering
7 usages d'une API chatbot : tirer parti de vos conversations de support
7 min de lecture
Lire l'article