Webhooks
O teste de webhook falhou
Diagnostique as falhas mais comuns ao confirmar um destino de webhook.
O teste envia um evento webhook.test e espera uma resposta 2xx com o mesmo challenge em JSON. A mensagem no histórico indica a causa:
| Mensagem | Causa e solução |
|---|---|
| O destino deve devolver o challenge do teste em JSON. | O receptor respondeu 2xx sem o challenge. Responda {"challenge": "<data.challenge>"}. |
| Não foi possível alcançar o destino. | Rede, DNS, certificado TLS inválido ou tempo acima de 10 segundos. Confira se a URL é pública e HTTPS. |
| Confira a autenticação do receptor. | O receptor respondeu 401. Confira o segredo e o Token Bearer do destino. |
| O receptor recusou a conexão. | O receptor respondeu 403. Confira regras de firewall, WAF ou listas de IPs permitidos. |
| Confira se a URL de produção do workflow está publicada. | O receptor respondeu 404, comum ao usar a Test URL do n8n ou um workflow inativo. |
| O endereço não atende à política de destinos públicos HTTPS. | A URL tem query string, porta diferente de 443, IP literal ou resolve para rede privada. |
Resposta esperada
if (event.type === "webhook.test") {
// Verifique a assinatura antes de responder.
return Response.json({ challenge: event.data.challenge });
}O valor deve ser idêntico ao recebido. Não envolva em outros campos como { "data": { "challenge": ... } }.
Ainda falhando?
- Teste o receptor localmente com os receptores de referência.
- Confirme que o receptor lê o corpo bruto para verificar a assinatura.
- Só um teste por vez pode ficar pendente, e há limite de 5 testes por minuto.