Webhooks do n8n: endereço de teste, endereço de produção e porque não disparam

Um nó Webhook do n8n tem dois endereços: o de teste e o de produção. O de teste só responde enquanto o editor o tem à escuta; o de produção só responde quando o fluxo está activo. Usar um no lugar do outro é a causa mais comum de «o webhook não dispara».

Os dois endereços

Endereço de teste Endereço de produção
Quando responde Só enquanto o nó está à escuta no editor, para um pedido. Sempre que o fluxo está activo.
O que mostra Os dados chegam ao editor, para os ver e mapear. Cada pedido fica na lista de execuções.
Reconhece-se por Um caminho com webhook-test. Um caminho com webhook, sem o «test».
Onde usar Só enquanto desenha o fluxo. Nos serviços externos, em definitivo.

Se ainda não sabe bem o que é um webhook, comece por o que é um webhook e como testar um com curl.

Quando o webhook não dispara

1 Veja qual dos endereços está a usar. Se colou o de teste num serviço externo, ele deixa de responder assim que o editor deixa de estar à escuta. Copie o de produção.
2 Active o fluxo. Um fluxo desactivado não responde no endereço de produção. O nome do botão pode mudar entre versões do n8n: confirme na documentação oficial.
3 Confira o método. O nó Webhook aceita um método HTTP de cada vez (por exemplo GET ou POST). Se o serviço envia POST e o nó espera GET, o pedido é recusado.
4 Faça o pedido você, com curl, antes de acusar o outro serviço. Se o seu pedido funciona e o dele não, o problema está no serviço ou na configuração dele. Se o seu também falha, o problema é do n8n ou da rede.
5 Veja a lista de execuções. Se o pedido chegou, aparece lá, mesmo que o fluxo tenha falhado. Se não aparece, o pedido não chegou ao n8n.
6 Confirme o endereço público. Com WEBHOOK_URL errado, o n8n mostra um endereço que nenhum serviço externo alcança. Veja o n8n com HTTPS no seu domínio.

O que o curl diz

Resposta Significa O que fazer
200 O n8n recebeu e respondeu. Veja a execução; se o fluxo falhou, é dentro dele.
404 O endereço não existe: fluxo inactivo, nó não à escuta, ou caminho errado. Active o fluxo ou ponha o nó à escuta; confira o caminho.
405 O método não é o que o nó espera. Mude o método no nó ou no serviço.
401 ou 403 Pedem autenticação, ou o proxy ou a firewall barram. Confira a autenticação do nó e as regras do proxy.
502 ou 504 O proxy não chega ao n8n, ou o n8n demorou demasiado. Veja se o contentor está a correr e se o fluxo é lento.
Sem resposta O endereço, a porta ou a firewall. Veja portas e firewall num VPS.
Quem chama espera pouco. Muitos serviços desistem se a resposta demorar, e tentam outra vez. Se o fluxo é longo, responda logo ao pedido e continue o trabalho a seguir, em vez de fazer o serviço esperar. E prepare o fluxo para receber o mesmo pedido duas vezes sem fazer duas encomendas.
Desenhe com o de teste, entregue com o de produção, e escreva num sítio qual dos dois já deu a cada serviço. Quando o domínio mudar, é essa lista que lhe diz onde actualizar.

Pedido a falhar por causa do VPS (a máquina não responde, a rede)? Abra um pedido e diga-nos o que o curl devolve.

Abrir um pedido de suporte

VEJA TAMBÉM

O que é um webhook, e como testar um com curl

O n8n com HTTPS no seu próprio domínio

Proteger o n8n: acesso, credenciais e webhooks expostos

PRODUTO RECOMENDADO

Alojamento de sites com cPanel

Domínio e SSL incluídos, cópias diárias e o painel que já conhece. desde 321,75 MT/mês (plano de 3 anos, com cupão)

Ver planos
  • 0 Utilizadores acharam útil
Esta resposta foi útil?