Ressources · Intégration n8n

Nœud Respond to Webhook n8nConfigurer Respond to Webhook dans n8n.

Un webhook sans réponse laisse l'appelant dans le vide. Le nœud Respond to Webhook n8n décide de ce qui repart : un JSON, un fichier, une redirection, un jeton ou rien du tout. Six paramètres couvrent le corps de la réponse, le code HTTP, les en-têtes et le streaming.

Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth

Pourquoi automatiser

À quoi sert le nœud Respond to Webhook n8n ?

Respond to Webhook renvoie une réponse à celui qui a appelé ton nœud Webhook, c'est-à-dire l'URL que n8n expose pour recevoir des requêtes. Sans lui, n8n renvoie son message standard une fois le workflow terminé. Avec lui, tu choisis le contenu, le code HTTP et les en-têtes, au moment précis où la réponse est prête. Il fonctionne avec le nœud Webhook et rien d'autre : dans un workflow qu'aucun webhook n'a déclenché, il est ignoré.

Premier scénario, un statut de commande interrogé par une boutique. Le site appelle l'URL du webhook avec un numéro de commande, le workflow va chercher la ligne, et Respond to Webhook renvoie un objet construit dans Response Body. Le client voit l'état réel de sa commande au lieu d'un accusé de réception vide. Un enregistrement dans Google Sheets peut se faire dans la foulée, après l'envoi de la réponse.

Deuxième scénario, un lien de désinscription. Le lien pointe vers le webhook, le workflow met à jour la base, puis Respond With réglé sur redirect envoie la personne vers la page de confirmation indiquée dans Redirect URL. Aucune page intermédiaire ne s'affiche. Une notification part en parallèle vers Gmail si l'équipe veut suivre les départs.

Troisième scénario, un document servi par le workflow. Un appel déclenche la récupération d'un fichier, et Respond With sur binary le renvoie directement grâce à Response Data Source. Le workflow devient un petit point de téléchargement, sans hébergement à côté, y compris pour un fichier récupéré sur un serveur Ftp.

Quand choisir autre chose. Si l'appelant se contente de ce que produit la fin du workflow, laisse ce nœud de côté et règle Respond sur When Last Node Finishes dans le nœud Webhook. Et si c'est toi qui appelles un service extérieur au lieu de répondre, le nœud HTTP Request prend le relais : il atteint n'importe quel endpoint HTTP et sert de recours quand un nœud dédié n'expose pas une opération d'API.

Les limites, connues et gênantes. Le nœud s'exécute une seule fois, sur le premier item entrant, expressions comprises. Le nœud Loop ne force rien : le workflow tourne, mais la réponse ne contient que la première exécution. Renvoyer plusieurs items par ces contournements est déprécié depuis n8n 1.22.0 : passe par allIncomingItems, ou place un nœud Aggregate avant, avec Aggregate sur All Item Data (Into a Single List). Un second Respond to Webhook plus loin est ignoré. Si le workflow échoue avant le premier, l'appelant reçoit un message d'erreur avec un statut 500. La comparaison avec les autres plateformes est détaillée dans l'Avis n8n.

Connexion

Comment brancher Respond to Webhook dans un workflow ?

  1. 01

    Démarrer le workflow par un nœud Webhook

    Respond to Webhook répond à un appel, il n'en déclenche jamais. Le workflow doit commencer par un nœud Webhook, le nœud qui ouvre l'exécution quand un service extérieur vient frapper son URL. Un workflow qui part d'un Schedule Trigger ou du trigger d'un outil n'a personne à qui répondre, et le nœud posé au milieu reste sans effet à l'exécution.

  2. 02

    Basculer le nœud Webhook en réponse manuelle

    Dans le nœud Webhook, règle Respond sur Using 'Respond to Webhook' node. n8n garde alors la connexion HTTP ouverte au lieu de la fermer avec son message par défaut. Tant que ce réglage n'est pas fait, le nœud Respond to Webhook reste décoratif sur le canevas. C'est de loin la première raison pour laquelle une réponse soigneusement construite n'arrive jamais.

  3. 03

    Placer le nœud après les données qu'il renvoie

    Respond to Webhook s'insère n'importe où dans le workflow, mais sa position décide de ce qu'il peut envoyer : pour renvoyer des données produites par d'autres nœuds, place-le après eux, puisqu'une expression ne lit que ce qui a déjà tourné. Tout ce qui suit continue de s'exécuter une fois la réponse partie : journalisation, alertes et écritures restent possibles.

Paramètres

Quels paramètres façonnent la réponse ?

Le nœud Respond to Webhook compte 6 paramètres. Pour chacun : le nœud tel que tu le configures dans n8n, ce que le paramètre change, et nos notes de terrain.

01

Enable Response Output Branch

enableResponseOutput

Ce que tu vois dans n8n

Notes & cas d'usage

Par défaut, le nœud ne sort que sur une seule branche, qui reprend ses données d'entrée. Cette option en ajoute une seconde, qui contient l'objet de réponse réellement envoyé au webhook. La suite du workflow voit donc ce que l'appelant a reçu. Le réglage se trouve dans l'onglet Settings du nœud, pas dans le panneau principal.

Paramètres clés

  • Enable Response Output Branch : un booléen qui active la seconde sortie. Le nœud expose alors Input Data, la branche d'origine qui repasse son entrée, et Response, l'objet renvoyé au webhook.
Cas d'usage
archiver la charge utile exacte transmise à un partenaire, ou tester le corps de la réponse avant d'écrire une ligne de journal.
02

Respond With

respondWith

Ce que tu vois dans n8n

Notes & cas d'usage

Tout le nœud se joue ici : ce sélecteur détermine ce qui repart dans la connexion HTTP restée ouverte. Huit choix, du dump JSON complet au corps vide.

Paramètres clés

  • Respond With : allIncomingItems renvoie tous les items JSON d'entrée, firstIncomingItem seulement le premier, json un corps défini dans Response Body, text un texte simple, envoyé par défaut en HTML avec Content-Type: text/html, binary un fichier, jwt un jeton construit depuis Payload, redirect un saut vers Redirect URL, noData un corps vide.
  • Response Data Source : pour un fichier, automatically prend l'unique donnée binaire de l'entrée, set attend le nom du champ dans Input Field Name.
Cas d'usage
renvoyer un objet de confirmation à une interface, ou rediriger un clic suivi.
03

Response Code

options.responseCode

Ce que tu vois dans n8n

Notes & cas d'usage

Un code de statut dit ce qu'un corps de réponse ne dit pas. Cette option fixe le code HTTP renvoyé à l'appelant, et vaut 200 si on n'y touche pas. Elle devient utile dès que la machine en face lit le code avant de lire quoi que ce soit d'autre, ce qui est le cas de presque tout le trafic entre applications.

Paramètres clés

  • Response Code : un nombre, 200 par défaut. La valeur peut venir d'une expression comme {{ $json.status }} quand un nœud précédent a déjà tranché.
Cas d'usage
répondre 404 quand la recherche n'a rien trouvé, pour que l'application appelante traite l'absence au lieu d'analyser une réponse de succès.
04

Response Headers

options.responseHeaders

Ce que tu vois dans n8n

Notes & cas d'usage

Certains appelants attendent plus qu'un corps : un type de contenu, une consigne de cache, une clé maison que leur client relit. Cette option ajoute des en-têtes à la réponse du webhook, un par un, via le bouton Add Response Header.

Paramètres clés

  • Name : le nom de l'en-tête, écrit exactement comme l'appelant l'attend.
  • Value : sa valeur, qui accepte une expression du type {{ $json.token }} quand elle change à chaque exécution.
Cas d'usage
déclarer un type de contenu sur une réponse texte pour que le navigateur cesse de deviner, ou renvoyer un identifiant de corrélation au système qui a lancé l'appel.
05

Put Response in Field

options.responseKey

Ce que tu vois dans n8n

Notes & cas d'usage

Des items posés à la racine d'une réponse, c'est pénible à consommer. Cette option les emballe : elle donne le nom du champ de réponse qui contient tous les items. Elle n'apparaît que si Respond With est sur allIncomingItems ou firstIncomingItem, et reste masquée sinon.

Paramètres clés

  • Put Response in Field : une chaîne qui nomme le champ enveloppe, par exemple data, la valeur proposée en exemple dans le panneau.
Cas d'usage
donner à une interface l'enveloppe stable pour laquelle elle a été codée, au lieu de la forcer à gérer un tableau à la racine.
06

Enable Streaming

options.enableStreaming

Ce que tu vois dans n8n

Notes & cas d'usage

Une réponse longue n'est pas obligée d'arriver d'un bloc. Activée, cette option renvoie les données en streaming, donc l'appelant affiche du contenu pendant que le workflow travaille encore. Une condition existe, à l'autre bout du flux.

Paramètres clés

  • Enable Streaming : un booléen. Il exige un trigger configuré avec Response mode sur Streaming, sans quoi le réglage n'a aucun canal par lequel diffuser.
Cas d'usage
un point d'entrée conversationnel où le texte s'affiche au fil de l'eau plutôt qu'après un long silence, exactement ce qui rend une interface Chat vivante.
Besoin d'aide

Besoin d'aide pour automatiser Respond to Webhook avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Les questions qui suivent

01Le nœud Respond to Webhook est-il inclus dans n8n ?
Oui. Respond to Webhook est un nœud core livré avec n8n : rien à installer, aucun coût supplémentaire côté n8n. Il se comporte de la même façon sur n8n Cloud, l'offre hébergée par n8n, et sur une instance auto-hébergée installée via Docker ou npm en Community Edition, sous licence Sustainable Use. Un workflow construit d'un côté tourne pareil de l'autre, ce qui compte ici : le nœud garde une connexion HTTP ouverte, et beaucoup de monde prototype sur le Cloud avant de basculer le flux sur son propre serveur.
02Que faut-il pour que le nœud fonctionne ?
Aucun credential. Le nœud n'a pas de sélecteur d'authentification et rien à connecter, puisqu'il répond à un appel déjà arrivé sur l'instance au lieu d'appeler un service extérieur. Ce qu'il lui faut, c'est un contexte : un nœud Webhook en déclencheur du workflow, avec son paramètre Respond réglé sur Using 'Respond to Webhook' node. Sans ce réglage, la connexion se referme toute seule et la réponse préparée part à la poubelle. Dans un workflow qu'aucun webhook n'a lancé, le nœud est ignoré.
03Quelles sont les limites du nœud Respond to Webhook n8n ?
La principale tient aux items. Le nœud s'exécute une seule fois, sur le premier item entrant, expressions comprises, et le nœud Loop ne le fait pas boucler : le workflow tourne, mais la réponse ne contient que la première exécution. Renvoyer plusieurs items par ces contournements est déprécié depuis n8n 1.22.0, d'où l'option All Incoming Items ou une agrégation en amont. Un second Respond to Webhook plus loin est ignoré. Si le workflow se termine sans l'atteindre, l'appelant reçoit un message standard avec un statut 200 ; s'il échoue avant, un 500.
04Quand préférer ce nœud au réglage de réponse du nœud Webhook ?
Ça dépend d'où vient la réponse. Si l'appelant veut seulement ce que le workflow produit à la fin, l'option When Last Node Finishes du nœud Webhook est plus simple et ne souffre pas de la limite sur les items. Respond to Webhook s'impose quand la réponse doit partir tôt, avant une branche lente, ou quand elle doit prendre une forme que la sortie du workflow n'a pas : un code de statut précis, des en-têtes, une redirection, un jeton JWT, un fichier binaire ou un corps vide. Ces huit types de réponse justifient à eux seuls le nœud.
05n8n ou Make pour répondre à un webhook ?
Les deux répondent à un appel entrant, et les vrais critères sont l'hébergement, la maîtrise des données, le modèle de coût et la logique visuelle. Make est une plateforme hébergée, sans auto-hébergement possible, facturée à l'opération : un point d'entrée très sollicité coûte donc proportionnellement au trafic. n8n tourne sur n8n Cloud ou sur ton installation Docker ou npm, ce qui garde les charges utiles reçues sur l'infrastructure de ton choix, avec un workflow identique dans les deux cas. Tranche là-dessus, pas sur une liste de fonctionnalités.
Hack'celeration Lab

Reçois nos tips intégration chaque semaine.

Pas de spam. Désinscription à tout moment.