Como configurar um Webhook pela n8n

Se você já entendeu como funciona uma integração através de webhooks e deseja colocá-la em prática utilizando a n8n como plataforma de integração, está no lugar certo! No tutorial abaixo você vai aprender a:

1. Configurar um código de webhook pela n8n;
2. Inserir o código de webhook no Respondi;
3. Conferir se a conexão foi feita com sucesso;

Para fazer esse processo, assista o tutorial em vídeo ou siga os passos abaixo:

Configure um webhook pela n8n

1. Faça seu login ou crie uma conta no n8n;
2. Na aba de "Workflows", clique em "Add workflow";
3. Se desejar, renomeie o título do novo fluxo criado clicando em "My workflow";

4. Clique em "Add first step..." e em seguida, selecione na parte de "Trigger" a opção "On webhook call";
5. Na página que abrir, altere a opção de "Http method" para "POST" em vez de "GET";
6. Clique em cima do link gerado para copiar seu código de webhook;

Insira o link de webhook no Respondi

1. Com o link de webhook copiado, acesse a aba de "Opções" do formulário desejado;
2. Desça com o mouse até a parte de "Integrações" e clique em "Configurar integrações";
3. Ative a opção "Webhooks" e cole o link de webhook copiado;
4. Clique em "Salvar";

Confira se a conexão foi feita com sucesso

1. Em fluxo do n8n, clique em "Listen for test event" para receber um disparo teste;
2. Abra o link de compartilhamento do seu formulário e envie uma resposta de exemplo;
3. No n8n, verifique se o cenário foi completo e se as respostas foram recebidas de acordo;
4. Caso positivo, clique em "Production URL" e copie o código de webhook para substituir a URL de teste pela URL de produção em seu formulário (repita os passos da seção anterior);
5. Ative o seu cenário no n8n para começar a receber os dados da URL de produção;

Depois de configurar seu webhook, o próximo passo é integrar com a outra plataforma que deseja dentro do n8n.

• Basta clicar no ícone de "+" ao lado do nó de webhook para adicionar uma nova etapa;
• Selecione a opção de "Action in an app" e pesquise pela plataforma que deseja integrar;

Resolvendo problemas comuns

Caso o webhook não esteja disparando no n8n ou o fluxo não esteja recebendo os dados corretamente, confira os pontos abaixo:

1. Verifique se está usando a URL correta (Teste x Produção)

O nó Webhook do n8n possui duas URLs diferentes:

• URL de Teste: usada quando você clica em "Listen for Test Event" ou executa o fluxo sem ativá-lo.
• URL de Produção: usada quando o fluxo está ativo.

Se você ativou o fluxo mas ainda está usando a URL de teste no Respondi, o webhook não será recebido. Para resolver, copie a Production URL do n8n e substitua a URL de teste no formulário do Respondi.

2. O fluxo não mostra os dados após a execução

Ao usar a URL de produção, o n8n não exibe os dados na tela de edição do fluxo. Neste caso, acesse a parte de Executions (Execuções) do seu fluxo para visualizar os dados recebidos.

Caso você esteja usando n8n em servidor próprio (VPS, Docker ou local):

3. Configure o corretamente o WEBHOOK_URL

Certifique-se de que a variável de ambiente WEBHOOK_URL  esteja definida com o endereço público que deve receber as solicitações do webhook (por exemplo, https://n8n.yourdomain.com);

4. Revise as configurações do proxy reverso

Se estiver usando um proxy reverso (como Nginx, Traefik, etc.):

• Defina N8N_PROXY_HOPS=1  (ou ajuste conforme a sua infraestrutura);
• Confirme se o proxy encaminha os cabeçalhos corretos ( X-Forwarded-For, X-Forwarded-Host, X-Forwarded-Proto).

5. Verifique se seu n8n é acessível pela internet:

Os webhooks só funcionam quando a URL está disponível publicamente. Confirme que:

• O servidor não está atrás de firewall bloqueando acesso;
• A porta está aberta;
• O DNS aponta corretamente para o domínio;
• O proxy está configurado para aceitar requisições externas;