Comment utiliser le noeud Webhook dans n8n

Le noeud Webhook est le point d'entree le plus utilise pour declencher un workflow n8n depuis l'exterieur. Il cree une URL HTTP que n'importe quel service, formulaire ou application peut appeler pour lancer l'execution d'un workflow. C'est la base pour connecter n8n a un site web, une application mobile ou tout systeme tiers.

Ce tutoriel couvre la configuration complete du noeud Webhook : les deux types d'URL (test et production), le choix de la methode HTTP, l'authentification, les modes de reponse et les options avancees de securite. Un cas pratique en fin de video illustre les erreurs courantes et comment les eviter.

Test URL vs Production URL

Le noeud Webhook expose deux URL distinctes avec des comportements differents :

• Test URL - utilisee pendant le developpement. Necessite de cliquer sur "Listen for test event" dans n8n pour etre active. L'URL change a chaque modification du workflow.
• Production URL - utilisee en conditions reelles. Necessite uniquement que le workflow soit actif (toggle en haut a droite). L'URL reste stable tant que le path ne change pas.

Erreur frequente : appeler la test URL sans avoir lance "Listen for test event", ou appeler la production URL sans avoir active le workflow. Dans les deux cas, n8n retourne une erreur 404.

Methode HTTP et Path

Le webhook accepte les methodes GET, POST, PATCH et DELETE. Le choix depend de l'usage :

• GET - pour les liens cliquables (newsletter, email, redirection). Les parametres passent dans l'URL.
• POST - pour les formulaires HTML, les appels JavaScript et les integrations d'applications. Les donnees sont dans le body, invisible pour l'utilisateur.

Si la methode HTTP est configuree sur POST et qu'un appel arrive en GET, le webhook l'ignore. L'option "Allow multiple HTTP methods" dans les Settings permet d'accepter toutes les methodes.

Le champ Path permet de personnaliser la fin de l'URL. Au lieu d'un identifiant aleatoire, on peut ecrire un nom lisible comme newsletter ou inscription. L'URL devient alors https://n8n.domaine.fr/webhook/newsletter.

Authentification

Par defaut, le webhook est accessible a tous. Trois types d'authentification sont disponibles pour securiser l'acces :

Type	Principe	Cas d'usage
Basic Auth	Identifiant + mot de passe envoyes dans le header Authorization	Acces restreint a une equipe interne
Header Auth	Cle API envoyee dans un header personnalise	Integration avec des services tiers
JWT	Jeton signe verifie par n8n	Applications avec systeme d'authentification existant

Modes de reponse

Le webhook offre 3 modes de reponse qui determinent quand et quoi renvoyer a l'appelant :

• Immediately - repond des que le webhook est declenche, sans attendre la fin du workflow. Ideal pour ne pas bloquer l'utilisateur.
• When Last Node Finishes - attend la fin complete du workflow avant de repondre. Permet de renvoyer le resultat du traitement.
• Using Respond to Webhook Node - attend un noeud specifique dans le workflow pour construire la reponse. Permet de renvoyer des reponses differentes selon les cas (succes, erreur, doublon).

Le troisieme mode est le plus puissant : il permet de creer de veritables API avec gestion d'erreurs, codes de statut personnalises (200, 400, 403, 404) et messages adaptes.

Options avancees

Option	Description
Allowed Origins (CORS)	Liste des domaines autorises a appeler le webhook depuis un navigateur
Binary Data Field Name	Nom de reference pour les fichiers recus (images, PDF) dans le workflow
Ignore Bots	Refuse les requetes identifiees comme venant de robots
IP Whitelist	N'accepte que les requetes provenant d'adresses IP specifiques
No Response Body	Retourne une reponse HTTP sans contenu (utile pour les pings)
Response Code	Code HTTP personnalise (200, 201, 400, 403, 404...)
Response Data	Donnees renvoyees immediatement a l'appelant
Response Headers	Headers HTTP personnalises dans la reponse