Log de Webhook
O Log de Webhook registra cada tentativa de entrega de webhook de saída, para que você possa monitorar taxas de sucesso e depurar falhas.
Abrindo o Log de Webhook
Vá para Integrações → Log de Webhook.
Entradas do Log
Cada entrada mostra:
| Coluna | Descrição |
|---|---|
| Webhook | Qual configuração de webhook de saída acionou esta entrega |
| Evento | O tipo de evento (ex.: lead.created) |
| URL | A URL de destino |
| Status | Sucesso (2xx) ou Falhou (não 2xx ou timeout) |
| Código de Resposta | Código de status HTTP retornado pelo endpoint |
| Tentativas | Quantas tentativas de entrega foram feitas |
| Entregue Em | Timestamp da última tentativa de entrega |
Filtragem
Filtre o log por:
- Status — Sucesso ou Falhou
- Webhook — um webhook de saída específico
- Intervalo de Datas — um período específico
Visualizando Detalhes Completos
Clique em qualquer entrada do log para ver:
- Payload completo da requisição (corpo JSON enviado)
- Corpo completo da resposta
- Todas as tentativas de nova entrega com timestamps
Tentando Novamente uma Entrega com Falha
Clique em Tentar Novamente em uma entrada com falha para reenviar imediatamente o webhook com o payload original. Útil quando seu endpoint externo estava temporariamente fora do ar.
Causas Comuns de Falha
| Problema | Solução |
|---|---|
| Resposta 401 | Verifique se o seu segredo HMAC corresponde em ambos os lados |
| Resposta 404 | Verifique se a URL do webhook está correta e ativa |
| Resposta 500 | Seu endpoint externo tem um bug — verifique seus logs |
| Timeout | Seu endpoint externo está demorando muito para responder |
| Nenhuma entrada | Verifique se o cron job está em execução (a fila processa a entrega de webhooks) |