Qu'est-ce qu'un webhook ?
Un webhook est un mecanisme qui permet a une application d'envoyer automatiquement des donnees a une autre application lorsqu'un evenement specifique se produit. C'est une forme de communication en temps reel entre systemes, sans avoir besoin d'interroger continuellement une source de donnees.
Imaginez un systeme d'alerte. Plutot que de verifier manuellement toutes les 5 minutes si quelque chose s'est passe, le systeme vous previent instantanement des que l'evenement survient. C'est exactement ce que fait un webhook.
Le terme "webhook" vient de la contraction de "web" et "callback". C'est essentiellement un callback HTTP : une URL que vous fournissez a un service, et vers laquelle ce service enverra des donnees quand quelque chose se passe.
Comment fonctionne un webhook ?
Le fonctionnement d'un webhook suit un schema simple en trois etapes :
1. Configuration : Vous fournissez une URL (appellee "endpoint" ou "callback URL") au service qui doit vous notifier. Cette URL pointe vers votre serveur ou votre outil d'automatisation.
2. Declenchement : Un evenement se produit dans le service source. Par exemple, un nouveau client s'inscrit, une commande est passee, ou un paiement est recu.
3. Notification : Le service envoie automatiquement une requete HTTP (generalement POST) a l'URL que vous avez configuree. Cette requete contient les donnees relatives a l'evenement, souvent au format JSON.
Cote reception, votre systeme recoit la requete, traite les donnees, et peut declencher des actions en consequence. Tout cela se passe en quasi temps reel, generalement en quelques secondes.
Webhook vs API : quelle difference ?
Webhooks et APIs sont complementaires mais fonctionnent differemment :
API (mode Pull) : Vous interrogez regulierement un service pour obtenir des informations. Vous demandez activement des donnees. C'est vous qui initiez la communication.
Webhook (mode Push) : Le service vous envoie des informations quand quelque chose se passe. Vous recevez passivement des donnees. C'est le service qui initie la communication.
L'avantage du webhook est l'instantaneite et l'efficacite. Pas besoin de requetes repetees qui consomment des ressources et peuvent manquer des evenements entre deux interrogations.
Cependant, les webhooks necessitent que vous ayez un endpoint accessible publiquement pour recevoir les notifications. C'est la que les outils comme Make et n8n sont precieux : ils fournissent des URLs de webhook pretes a l'emploi.
Cas d'usage courants des webhooks
Les webhooks sont partout dans l'automatisation moderne. Voici des exemples concrets :
E-commerce : Quand un client passe commande sur Shopify, un webhook peut automatiquement creer une tache dans votre outil de gestion, mettre a jour votre CRM, et envoyer une notification a votre equipe logistique.
Paiements : Stripe envoie des webhooks pour chaque evenement de paiement. Paiement reussi, echec, remboursement : vous etes notifie instantanement et pouvez reagir en consequence.
Formulaires : Quand quelqu'un soumet un formulaire Typeform ou Google Forms, un webhook peut declencher l'ajout du contact dans votre CRM et l'envoi d'un email de bienvenue.
Git et CI/CD : GitHub envoie des webhooks a chaque push, pull request ou merge. Ces notifications peuvent declencher des pipelines de tests et de deploiement.
Chat et collaboration : Slack permet de recevoir des webhooks pour poster des messages automatiquement dans des channels, centralisant les notifications de vos differents outils.
Implementer un webhook dans Make ou n8n
La mise en place d'un webhook dans les outils d'automatisation est simple :
Dans Make :
1. Creez un nouveau scenario et ajoutez le module "Webhooks" > "Custom webhook"
2. Make genere automatiquement une URL unique pour votre webhook
3. Copiez cette URL et configurez-la dans le service source
4. Cliquez sur "Determine data structure" et envoyez une premiere requete test pour que Make comprenne le format des donnees
5. Ajoutez les modules suivants pour traiter les donnees recues
Dans n8n :
1. Ajoutez un node "Webhook" a votre workflow
2. Configurez le path et la methode HTTP (generalement POST)
3. n8n genere l'URL complete que vous pouvez copier
4. Envoyez une requete test pour visualiser la structure des donnees
5. Connectez les nodes suivants pour le traitement
Securiser ses webhooks
Les webhooks exposent un endpoint public. Il est essentiel de les securiser :
Verification de signature : La plupart des services serieux signent leurs requetes webhook avec une cle secrete. Verifiez cette signature pour vous assurer que la requete provient bien du service attendu.
HTTPS obligatoire : Utilisez toujours des URLs HTTPS pour vos webhooks. Les donnees transitent sur internet et doivent etre chiffrees.
Validation des donnees : Ne faites jamais confiance aveugle aux donnees recues. Validez leur format et leur contenu avant de les traiter.
Timeouts et retries : Implementez une gestion des erreurs robuste. Si le traitement echoue, les services renvoient generalement le webhook. Gerez les doublons potentiels.
Logging : Conservez des logs de tous les webhooks recus pour pouvoir debugger et auditer en cas de probleme.
Les webhooks sont puissants mais demandent une attention particuliere a la securite. Bien configures, ils deviennent le moteur de vos automatisations en temps reel.
