Skip to main content
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.

Desenvolvimento local

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

Usando o Cloudflare Tunnels

O Cloudflare Tunnels oferece uma forma gratuita de expor seu servidor local sem abrir portas no firewall:
Você receberá uma URL pública como https://abc123.trycloudflare.com. Use essa URL na configuração do seu webhook:

Solução de problemas

Webhooks Não Estão Chegando

  • 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

Falha na verificação de assinatura

A causa mais comum é usar o corpo JSON já parseado em vez do corpo bruto da requisição.

Outros problemas

  • Secret incorreta - Verifique se você está usando o secret correto nas suas configurações de conta
  • Erros de timeout - Certifique-se de que seu endpoint responda em até 10 segundos