Respond to Webhook n8n: como devolver a resposta

Aprenda a usar o Respond to Webhook no n8n: ligação ao Webhook, opções de Respond With, código e cabeçalhos, comportamento com erro e como testar e publicar.

Por Redação Eleven Host · @robson.direitodigital · 31 de outubro de 2026 · 8 min de leitura

O Respond to Webhook n8n é o nó que define o que o sistema que chamou o seu webhook recebe de volta: dados do fluxo, texto, um arquivo, um redirecionamento, além do código HTTP e dos cabeçalhos da resposta.

Este guia mostra quando usar o Respond to Webhook n8n em vez das outras formas de responder, como ligá-lo ao nó Webhook passo a passo, o que cada opção de Respond With faz, como definir código e cabeçalhos, o que acontece quando o nó não roda e como testar e publicar. Os nomes das telas seguem a documentação do n8n.

Quando usar o Respond to Webhook

Um webhook é um endereço que recebe chamadas de outros sistemas. Quem chama espera uma resposta, e o n8n precisa decidir qual. No nó Webhook, o campo Respond tem estas três opções, além do modo de streaming:

• Immediately: devolve o código de resposta e a mensagem Workflow got started.
• When Last Node Finishes: devolve o código de resposta e os dados de saída do último nó executado no fluxo.
• Using 'Respond to Webhook' Node: o nó Webhook responde como foi definido no nó Respond to Webhook.

Existe ainda a opção Streaming response, que exige nós com suporte a streaming no fluxo.

A terceira opção é a que você escolhe quando quer controlar a resposta: qual conteúdo, qual código, quais cabeçalhos, e em que ponto do fluxo ela sai. Um exemplo neutro: o sistema que chamou precisa receber de volta o número de um pedido criado pelo fluxo, e esse número só existe depois de alguns nós. Responder logo no início não resolve, porque o dado ainda não existe. O Respond to Webhook entra depois dessa etapa e devolve o dado.

Passo a passo: ligar o Webhook ao Respond to Webhook

A ordem abaixo é um roteiro nosso, montado a partir do que a documentação do nó descreve.

1. Adicione o nó Webhook como início do fluxo.
2. No nó Webhook, mude o campo Respond para Using 'Respond to Webhook' Node.
3. Adicione os nós que fazem o trabalho do fluxo. Por exemplo, uma chamada de API com o guia HTTP Request no n8n: como chamar uma API no fluxo.
4. Adicione o nó Respond to Webhook no ponto em que a resposta deve sair.
5. No Respond to Webhook, escolha a opção de Respond With, descrita na próxima seção.
6. Se precisar, abra as opções do nó e defina Response Code e Response Headers.
7. Execute o fluxo pela Test URL, confira a resposta e, quando estiver certo, publique o fluxo.

Há um detalhe sobre o código de resposta. No nó Webhook, a opção Response Code vale para os modos de Respond, exceto Using 'Respond to Webhook' Node. Com o nó Respond to Webhook, o código é definido nele, e não no Webhook.

As opções de Respond With

O parâmetro Respond With escolhe o conteúdo da resposta. A documentação lista estas oito opções:

• All Incoming Items: responde com os itens JSON da entrada.
• Binary File: responde com um arquivo binário definido em Response Data Source.
• First Incoming Item: responde com o JSON do primeiro item que chega.
• JSON: responde com um objeto JSON definido em Response Body.
• JWT Token: responde com um JSON Web Token (JWT).
• No Data: sem conteúdo na resposta.
• Redirect: redireciona para uma URL definida em Redirect URL.
• Text: responde com o texto definido em Response Body. Por padrão, envia HTML, com o cabeçalho Content-Type: text/html.

Montando o corpo da resposta

Quando você quer montar a resposta à mão, use JSON e escreva o objeto em Response Body. Como exemplo, uma resposta simples poderia ser:

{"status": "ok"}

Para devolver um campo do fluxo dentro do corpo, você usa uma expressão do n8n. Como exemplo nosso (a página do nó não mostra essa expressão pronta), um campo chamado pedido da entrada ficaria assim:

{{ $json.pedido }}

O n8n Essencial sai a partir de R$ 19,90/mês; confira na loja o que cada plano inclui. Ver planos de n8n

Código de resposta e cabeçalhos

Nas opções do nó, duas definem o formato HTTP da resposta:

• Response Code: define o código de resposta a usar.
• Response Headers: define os cabeçalhos a enviar.

Um exemplo neutro: um fluxo que cria um registro e avisa o sistema que chamou pode responder com o código 201. Nos cabeçalhos, você pode definir Content-Type como application/json, se a resposta for um JSON.

O que acontece quando o nó não roda, dá erro ou responde duas vezes

A documentação descreve quatro situações no comportamento do fluxo. Vale conhecê-las antes de publicar, porque o sistema que chama vê o resultado de cada uma.

• O fluxo termina sem executar o Respond to Webhook: devolve uma mensagem padrão com status 200.
• O fluxo dá erro antes de o primeiro Respond to Webhook executar: devolve uma mensagem de erro com status 500.
• Um segundo Respond to Webhook executa depois do primeiro: o fluxo ignora o segundo.
• Um Respond to Webhook executa, mas não houve webhook: o fluxo ignora o nó.

Uma dedução a partir do primeiro caso (não é um exemplo da documentação): se um caminho do fluxo, por exemplo depois de uma condição do nó IF (veja IF no n8n: como criar condições no seu fluxo), termina sem passar pelo Respond to Webhook, a regra acima indica que quem chamou recebe a mensagem padrão com status 200. Se cada caminho precisa devolver algo diferente, uma opção é colocar um Respond to Webhook em cada um deles.

O segundo caso pede cuidado com a ordem. Se algum nó antes do Respond to Webhook falhar, quem chamou recebe o erro com status 500. Para tratar erros do fluxo, veja também o guia Tratar erros no n8n: Error Trigger e alertas no fluxo.

Um item por execução

O nó Respond to Webhook roda uma vez, usando o primeiro item de dados que chega.

Outras opções do nó

Além de Response Code e Response Headers, a documentação descreve mais opções e uma configuração:

• Put Response in Field: disponível quando você responde com All Incoming Items ou First Incoming Item. Define o nome do campo que contém os dados da resposta.
• Enable Streaming: quando ligada, envia os dados de volta para quem chamou usando streaming. Exige um gatilho configurado com o modo de resposta Streaming.
• Enable Response Output Branch: fica na aba Settings do nó. Ao ligar a opção, o nó passa a ter duas saídas: Input Data e Response.

Usar o Respond to Webhook no Chat Trigger

O nó também aparece na documentação do Chat Trigger. Nele, o campo Response Mode tem a opção Using Response Nodes. Segundo a documentação, o Chat Trigger responde como definido em um nó Chat ou em um nó Respond to Webhook.

Para o Chat Trigger, a documentação diz que esse modo substitui o antigo modo "Using Respond to Webhook Node". Se você já tem um fluxo de chat montado com o modo antigo, confira qual modo o seu Chat Trigger mostra hoje. Para montar um agente de IA no fluxo, veja o guia AI Agent no n8n: como criar um agente de IA no fluxo.

Testar e publicar

O nó Webhook tem um endereço de teste e um de produção, e cada um serve a uma fase do trabalho.

Test URL: para montar e conferir a resposta

O n8n registra um webhook de teste quando você seleciona Listen for Test Event ou Execute workflow, se o fluxo ainda não estiver publicado. Use a Test URL para chamar o webhook e conferir o que o Respond to Webhook devolve: o conteúdo, o código e os cabeçalhos.

Webhook de produção: depois de publicar

O n8n registra o webhook de produção quando você publica o fluxo. Os outros sistemas devem chamar esse endereço de produção, e não o de teste. Antes de publicar, repita o teste com o caminho normal, o caminho sem Respond to Webhook e o caminho com erro.

Quer conhecer o n8n da Eleven Host? O n8n Essencial sai a partir de R$ 19,90/mês; confira na loja o que cada plano inclui. Conhecer o n8n Essencial

Perguntas frequentes

Para que serve o Respond to Webhook no n8n?

Ele define a resposta que o sistema que chamou o webhook recebe: dados, texto, arquivo, redirecionamento, código de resposta e cabeçalhos.

Como faço o Webhook usar o Respond to Webhook?

No nó Webhook, mude o campo Respond para Using 'Respond to Webhook' Node e adicione o nó Respond to Webhook no ponto do fluxo em que a resposta deve sair.

O que acontece se o fluxo termina sem passar pelo Respond to Webhook?

Segundo a documentação, o fluxo devolve uma mensagem padrão com status 200.

Posso usar dois Respond to Webhook no mesmo caminho?

Pode colocar, mas o segundo que executa depois do primeiro é ignorado pelo fluxo. A resposta enviada é a do primeiro.

Em qual endereço devo chamar o webhook depois de pronto?

No endereço de produção, que o n8n registra quando você publica o fluxo. Durante a montagem, use a Test URL.