Qu'est-ce qu'un webhook ? Explication simple
Un webhook est un mécanisme par lequel une application notifie automatiquement une autre application qu'un événement vient de se produire. C'est une requête HTTP POST envoyée vers une URL prédéfinie, avec les données de l'événement dans le corps de la requête.
Analogie : si l'API classique est un appel téléphonique ("je t'appelle pour savoir si tu as du nouveau"), le webhook est un SMS automatique ("j'ai du nouveau, voici les détails").
Pourquoi les webhooks sont-ils si importants pour N8N ?
Sans webhook, vous devez interroger régulièrement chaque service pour détecter les nouveautés (polling). Avec un webhook, le service vous notifie immédiatement dès qu'un événement se produit :
- Réactivité en temps réel vs délai de polling
- Économie de ressources (pas de requêtes inutiles)
- Déclenchement précis à l'événement exact
Les types de déclencheurs disponibles dans N8N
| Type de trigger | Fonctionnement | Exemples | Latence |
|---|---|---|---|
| Webhook | Reçoit une requête HTTP externe | Formulaire soumis, paiement Stripe, nouveau ticket | Temps réel (<1s) |
| Schedule Trigger | Exécution planifiée (cron) | Rapport quotidien, nettoyage données hebdo | Planifié |
| Email Trigger (IMAP) | Surveille une boîte email | Traitement automatique des emails entrants | 1-5 min |
| App Triggers natifs | Webhooks gérés automatiquement | Gmail, HubSpot, Slack, GitHub, Typeform | Temps réel |
| Polling Trigger | Vérifie périodiquement les changements | Services sans webhook, Google Sheets | 1 à 60 min |
Configurer un webhook N8N pas à pas
Étape 1 — Créer le nœud Webhook
Dans le canvas N8N, cherchez "Webhook" dans la liste des triggers. Ajoutez-le comme premier nœud. N8N génère immédiatement deux URLs :
- Test URL :
https://votre-n8n.com/webhook-test/[uuid]— pour le développement - Production URL :
https://votre-n8n.com/webhook/[uuid]— pour la production
Étape 2 — Configurer les options du webhook
- HTTP Method : POST pour recevoir des données, GET pour les intégrations basiques
- Response Mode : "On Received" pour répondre immédiatement (200 OK), "Last Node" pour répondre avec le résultat du workflow
- Response Data : ce que vous renvoyez à la source (utile pour les APIs qui attendent une réponse)
Étape 3 — Tester le webhook
Cliquez sur "Listen for test event". N8N attend une requête pendant 120 secondes. Envoyez une requête depuis votre source ou via Postman. N8N capture les données et les affiche dans l'éditeur.
Sécuriser vos webhooks — indispensable en production
Un webhook non sécurisé est une porte ouverte. N'importe qui connaissant l'URL peut déclencher votre workflow.
Méthode 1 — Header Authentication (recommandée)
Configurez un en-tête HTTP secret. La source envoie l'en-tête X-Webhook-Secret: votre-secret. N8N vérifie que l'en-tête est présent et correct avant d'exécuter le workflow. La source doit connaître le secret — ne partagez-le jamais en clair.
Méthode 2 — Basic Authentication
L'URL webhook inclut un couple identifiant/mot de passe. Plus simple à configurer mais moins flexible que le header auth.
Méthode 3 — Validation de signature (HMAC)
Les services professionnels (Stripe, GitHub, Shopify) signent leurs webhooks avec une signature HMAC. Utilisez un nœud Code pour vérifier la signature avant de traiter les données. C'est la méthode la plus sécurisée pour les sources critiques.
Attention : Ne testez jamais les webhooks Stripe ou PayPal avec de vraies transactions en production. Ces services fournissent un mode sandbox avec des numéros de carte de test. Utilisez-le systématiquement pendant le développement.
Tester et déboguer vos webhooks
Outils de test indispensables
- Postman ou Insomnia — envoyez des requêtes HTTP manuelles vers votre URL webhook avec des données personnalisées
- ngrok — expose votre N8N local sur internet pour les tests en développement. Commande :
ngrok http 5678 - webhook.site — service gratuit pour inspecter les webhooks entrants (utile pour analyser le format d'une source avant de configurer N8N)
Diagnostiquer un webhook qui ne fonctionne pas
- Vérifiez que le workflow est en mode "Test" ou activé selon le cas
- Vérifiez la méthode HTTP (POST vs GET)
- Vérifiez le Content-Type de la requête (application/json)
- Vérifiez l'authentification (header ou Basic Auth)
- Consultez les logs d'exécution N8N pour voir si la requête arrive
- Testez avec Postman pour isoler le problème côté N8N vs côté source
Les déclencheurs planifiés : syntaxe cron
Le Schedule Trigger exécute votre workflow selon un calendrier. Il utilise la syntaxe cron standard.
Exemples de planifications courantes
| Expression cron | Signification | Cas d'usage |
|---|---|---|
0 8 * * 1-5 | Tous les jours de semaine à 8h00 | Rapport journalier |
0 9 * * 1 | Tous les lundis à 9h00 | Récapitulatif hebdomadaire |
*/15 * * * * | Toutes les 15 minutes | Polling fréquent |
0 0 1 * * | Le 1er de chaque mois à minuit | Facturation mensuelle |
30 17 * * 5 | Tous les vendredis à 17h30 | Rapport hebdomadaire |
Bon à savoir : N8N propose une interface visuelle pour configurer le Schedule Trigger sans écrire de cron manuellement. Choisissez "Every Day", "Every Week", ou configurez manuellement avec l'interface de sélection. Utilisez crontab.guru pour vérifier vos expressions cron.
Déclencheurs événementiels natifs N8N
N8N gère automatiquement les webhooks pour plusieurs services populaires. Vous n'avez pas à configurer l'URL manuellement — N8N le fait pour vous.
- Gmail Trigger — se déclenche quand un email est reçu (filtrable par label, expéditeur, objet)
- HubSpot Trigger — événements CRM (nouveau contact, deal mis à jour, ticket créé)
- Slack Trigger — messages dans un canal, mentions, réactions
- Typeform Trigger — soumission de formulaire
- GitHub Trigger — push, PR, issues, releases
- Stripe Trigger — paiement réussi, abonnement créé, remboursement
Polling vs webhook : lequel choisir ?
| Critère | Webhook | Polling |
|---|---|---|
| Latence | Temps réel (<1 seconde) | 1 min à 1 heure |
| Ressources consommées | Faibles (seulement lors d'événements) | Élevées (requêtes constantes) |
| Support du service | Seulement les services qui supportent les webhooks | Tout service avec une API |
| Fiabilité | Dépend de la source | Contrôlée par N8N |
| Recommandation | ✅ Préférer quand disponible | ⚠️ Uniquement si webhook impossible |
Recevoir des webhooks depuis vos formulaires web
Les formulaires web sont la source de webhook la plus courante pour les PME. Voici comment connecter les principaux outils :
Typeform → N8N
Dans Typeform : Settings → Integrations → Webhooks → Add a webhook → collez l'URL N8N. Sélectionnez "All responses". Typeform envoie un POST JSON à chaque soumission.
Tally → N8N
Dans Tally : Integrations → Webhooks → New webhook → URL N8N. Tally supporte les webhooks sur le plan gratuit, contrairement à Typeform.
WordPress / Contact Form 7 → N8N
Installez le plugin CF7 Webhooks. Dans les paramètres du formulaire, ajoutez l'URL webhook N8N. Configurez les champs à envoyer.
💡 Des workflows N8N opérationnels dès cette semaine
AutomateIA configure vos webhooks et crée vos workflows N8N de A à Z. Formation de votre équipe incluse.
🚀 Obtenir mon audit gratuit10 cas d'usage de webhooks N8N pour PME
- Formulaire contact → CRM + email confirmation (webhook Typeform → N8N → HubSpot + Gmail)
- Paiement Stripe → onboarding client automatique (webhook Stripe → N8N → création espace client)
- Nouveau ticket support → attribution + notification équipe (webhook Zendesk → N8N → Slack)
- Signature de contrat → déclenchement facturation (webhook DocuSign → N8N → création facture)
- Avis Google → analyse sentiment + réponse brouillon (webhook reviews → N8N → GPT → Gmail)
- Candidature reçue → tri automatique + accusé (webhook formulaire → N8N → scoring → email)
- Commande e-commerce → préparation logistique (webhook WooCommerce → N8N → ERP)
- Erreur monitoring → alerte immédiate équipe (webhook Sentry → N8N → Slack + PagerDuty)
- Nouvel abonné newsletter → séquence de bienvenue (webhook Brevo → N8N → séquence emails)
- Deal gagné CRM → facturation automatique (webhook HubSpot → N8N → Stripe ou QuickBooks)