Testes

Verifique se a integração do seu webhook funciona antes de implantá-la em produção. Esta página mostra como receber webhooks na sua máquina local e como diagnosticar falhas comuns de entrega e verificação.

Os webhooks exigem uma URL acessível publicamente, então você precisará expor seu servidor local à internet durante o desenvolvimento.

O Cloudflare Tunnels oferece uma forma gratuita de expor seu servidor local sem abrir portas no firewall:

cloudflared tunnel --url localhost:3000

Você receberá uma URL pública como https://abc123.trycloudflare.com. Use essa URL na configuração do seu webhook:

{  "url": "https://abc123.trycloudflare.com/webhook"}

• Endpoint inacessível - Verifique se seu servidor é acessível publicamente e se os firewalls permitem conexões de entrada
• Usando HTTP - URLs de webhook devem usar HTTPS
• Eventos incorretos - Verifique o filtro de events na configuração do seu webhook
• Erros de tempo limite - Garanta que seu endpoint responda em até 10 segundos

A causa mais comum é usar o corpo JSON já parseado em vez do corpo bruto da requisição. Outra causa é usar o segredo errado, então confirme se o seu corresponde ao valor nas configurações da conta.

// ❌ Incorreto – usando o corpo já parseadoconst signature = crypto  .createHmac('sha256', secret)  .update(JSON.stringify(req.body))  .digest('hex');// ✅ Correto – usando o corpo bruto (raw)app.use('/webhook', express.raw({ type: 'application/json' }));app.post('/webhook', (req, res) => {  const signature = crypto    .createHmac('sha256', secret)    .update(req.body) // Buffer bruto (raw)    .digest('hex');});