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:

MensagemCausa 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.