Receba chamadas com webhooks
Antes de começar
Receber uma chamada externa em um workflow publicado e devolver a resposta certa ao sistema que chamou.
- Instância do n8n acessível pelo sistema que vai chamar o webhook.
O node Webhook cria um endereço que outros sistemas chamam para iniciar o workflow. Formulários, plataformas de pagamento, CRMs e ferramentas de atendimento costumam avisar eventos dessa forma.
Duas URLs para cada webhook
| URL | Como ativar | Por quanto tempo escuta | Aparece no editor |
|---|---|---|---|
| Teste | Selecionar Listen for test event | 120 segundos | Sim |
| Produção | Publicar o workflow | Até despublicar | Não |
Use a URL de teste enquanto monta o workflow. Na hora de configurar o sistema externo de verdade, use a URL de produção e publique o workflow. As execuções de produção ficam na lista de execuções.
Método HTTP
O node aceita um método por padrão, como GET ou POST. Para aceitar mais de um, ligue Allow Multiple HTTP Methods na aba Settings. O node ganha uma saída para cada método.
Como responder
O campo Respond define o que o chamador recebe:
| Opção | Resposta |
|---|---|
| Immediately | Responde na hora com a mensagem de que o workflow começou |
| When Last Node Finishes | Responde com a saída do último node executado |
| Using ‘Respond to Webhook’ Node | Responde do jeito definido em um node Respond to Webhook |
Plataformas que esperam resposta rápida funcionam melhor com Immediately. Quando o chamador precisa de um valor calculado pelo workflow, use uma das outras duas.
Teste com curl
curl --request POST https://seu-n8n/webhook/caminho \ --header "Content-Type: application/json" \ --data '{"evento":"teste"}'Troque o endereço pela URL do seu node. Para a URL de teste, selecione Listen for test event antes de enviar.
Confira o resultado
Uma chamada para a URL de produção aparece na lista de execuções, e o sistema chamador recebe a resposta configurada.
Fontes e conferência
Conteúdo conferido na documentação oficial do n8n em 28 de outubro de 2026.