definition en une ligne
Les webhooks sont des rappels HTTP qui envoient automatiquement des données d'un système à un autre lorsqu'un événement spécifique se produit – une alternative basée sur le push à l'interrogation répétée d'une API.
formule : Aucune formule. Indicateurs clés : taux de réussite de la livraison (cible : 99 % et plus), délai de livraison moyen et taux de nouvelles tentatives. Suivez les livraisons ayant échoué : elles représentent des données que votre partenaire d'intégration n'a jamais reçues.
tl;dr
Les webhooks sont la fonctionnalité d'intégration la moins chère que vous puissiez créer. Un point de terminaison unique qui déclenche JSON sur des événements clés permet à vos utilisateurs de connecter votre produit à Zapier, Make, n8n ou à leur propre code personnalisé. Cela transforme votre produit d'un outil autonome en une partie d'un flux de travail – et les outils de flux de travail sont beaucoup plus difficiles à annuler.
Définition simple
Sans webhooks, si le système B a besoin des données du système A, il doit continuer à demander : « Quelque chose de nouveau ? Quelque chose de nouveau ? Quelque chose de nouveau ? C’est du sondage, et cela gaspille des ressources des deux côtés. Les webhooks retournent le modèle. Vous dites au système A : "Lorsque X se produit, POSTez les données sur cette URL." Désormais, le système A transmet les données au moment où l'événement se produit. Aucune demande inutile. Aucun retard. Votre application déclenche un HTTP POST avec une charge utile JSON vers l'URL configurée par l'utilisateur. Le destinataire le traite comme il le souhaite : envoyer un message Slack, mettre à jour une feuille de calcul, déclencher un autre flux de travail.
Comment le calculer
Suivez l’état du webhook avec ces métriques :
- Taux de réussite des livraisons : Livraisons réussies ÷ Total des tentatives de livraison. Cible : 99 %+. En dessous de 95 %, cela signifie que quelque chose ne va pas systématiquement avec votre infrastructure de livraison ou les points de terminaison de vos utilisateurs.
- Délai de livraison moyen : délai entre l'événement et la réponse du webhook reçue. Doit durer moins de 5 secondes pour la plupart des événements.
- Taux de tentatives : livraisons retentées ÷ Livraisons totales. Des taux de tentatives élevés (supérieurs à 10 %) suggèrent que les points de terminaison de vos utilisateurs sont instables ou que votre délai d'attente est trop agressif.
Enregistrez chaque livraison de webhook avec l'horodatage, le code d'état, le temps de réponse et la taille de la charge utile. Ce journal devient votre bouée de sauvetage en matière de débogage.
Exemple
Vous construisez un outil de facturation. Les utilisateurs continuent de demander des notifications à Slack lorsque les factures sont payées. Au lieu de créer une intégration Slack native (OAuth, autorisations, UI — semaines de travail), vous ajoutez des webhooks en 2 jours. Lorsque le statut d'une facture change, votre système POST une charge utile JSON sur l'URL fournie par l'utilisateur. La charge utile comprend : l’identifiant de la facture, le montant, le statut, le nom du client, l’horodatage. Les utilisateurs pointent cela vers un déclencheur de webhook Zapier et le connectent à Slack en 5 minutes. Trois mois plus tard, 34 % de vos utilisateurs payants ont au moins un webhook actif. Ces utilisateurs ont un taux de désabonnement 40 % inférieur à celui des utilisateurs non-webhooks, car votre outil est désormais intégré à leur flux de travail quotidien, et non dans un onglet qu'ils oublient d'ouvrir.
Lecture connexe
- Latence API
- [Adoption de fonctionnalités](/glossaire/adoption de fonctionnalités)
Termes associes
- Latence de l'API
- Adoption des fonctionnalités
- Taux d'activation
FAQ
Quand dois-je ajouter des webhooks à mon produit ?+
Lorsque les utilisateurs commencent à demander des intégrations. Les webhooks constituent le moyen le plus simple de permettre à d'autres outils de réagir aux événements de votre système. Si les utilisateurs souhaitent recevoir des notifications Slack lorsque quelque chose se produit ou doivent synchroniser les données avec leur CRM, les webhooks sont moins chers à créer qu'une intégration complète d'API. Commencez par 3 à 5 événements qui couvrent les cas d'utilisation les plus courants.
Comment gérer les échecs de livraison de webhooks ?+
Implémentez des tentatives d'attente exponentielles : réessayez après 1 minute, 5 minutes, 30 minutes, 2 heures, puis 24 heures. Stockez les charges utiles ayant échoué pendant 72 heures afin que les utilisateurs puissent réessayer manuellement. Incluez toujours un ID d’événement webhook afin que le destinataire puisse effectuer la déduplication. Et donnez aux utilisateurs un journal de webhook dans votre tableau de bord : cela vous permet d'économiser des dizaines de tickets d'assistance.