Abra primeiro Webhooks no painel: cada entrega mostra a resposta HTTP ou o erro que recebemos. A maioria dos problemas é um dos casos abaixo.
Nada é enviado
O projeto não tem URL do webhook. Adicione nas configurações do projeto; só enviamos para o endereço salvo no projeto.
As entregas falham
- Não é um endereço https público. http simples, endereços locais e redes privadas são recusados.
- Redirecionamentos. Não seguimos redirecionamentos. Use o endereço final, com o www e a barra final corretos.
- Bloqueio por firewall ou proteção contra bots. Libere os nossos POSTs nesse caminho.
- Resposta errada. Só um status 2xx conta. Responda em poucos segundos e faça o trabalho demorado depois.
- O seu código quebra. Veja o log de erros do servidor no horário da entrega que falhou.
A assinatura não confere
- Use o segredo de assinatura do webhook, não o segredo da API.
- Calcule sobre o corpo bruto exatamente como chegou, antes de qualquer parsing.
- Depois de gerar um novo segredo do webhook, atualize o seu servidor.
Novas tentativas e alertas
Entregas que falham são reenviadas por cerca de dois dias. Depois de três falhas seguidas em eventos live, o dono do projeto recebe um único e-mail; o alerta é rearmado após a próxima entrega bem-sucedida.
Resolveu?
Clique em Reenviar nas entregas que falharam, em Webhooks, ou em Enviar test.ping na página do projeto para testar o endpoint. Ainda com problemas? Fale com a gente pela página de contato informando o ID da entrega.