Logs de entrega e testes
O painel de configurações de webhooks inclui um registro de entregas para cada endpoint. Use-o para conferir se os eventos chegam ao servidor, diagnosticar falhas e enviar uma nova carga de exemplo sem gerar atividade real.
Consultando registros de entrega
1
Abrir Configurações → Webhooks
Acesse
Dashboard → Settings → Webhooks.2
Expanda uma linha de webhook
Clique no Logs de entrega botão no cartão webhook. As últimas 50 tentativas aparecem da mais nova à mais antiga.
3
Inspecionar cada entrada
Cada linha mostra o tipo de evento, código de status HTTP, tempo de resposta, data e hora e qualquer mensagem de erro.
Campos do registro
| Campo | Descrição |
|---|---|
| Evento | O tipo de evento disparado (por exemplo, post.saved) |
| Status | Status HTTP retornado pelo endpoint. null se houver timeout ou conexão recusada. |
| Tempo de resposta | Tempo de ida e volta em milissegundos, do envio ao último byte da resposta. |
| Sucesso | Marca verde = HTTP 2xx. Cruz vermelha = qualquer outro resultado. |
| Erro | Erro legível para entregas com falha (por exemplo, Request timed out (10s)). |
| Entregue em | Data e hora UTC da tentativa de entrega. |
Enviando um evento de teste
1
Expanda o cartão de webhook
Em
Settings → Webhooks, encontre seu webhook e clique em Enviar evento de teste.2
Confira o registro de entrega
A entrega de teste aparece no topo dos registros em poucos segundos. Confirme se você vê
200 status.Eventos de teste são solicitações HTTP reais
O evento de teste percorre exatamente o mesmo fluxo de um evento real, incluindo a assinatura HMAC. Seu código de verificação de assinatura é exercitado por completo no teste.
Sem nova tentativa automática
Cada entrega é tentada uma vez. O log serve apenas para diagnóstico; não há botão para repetir um evento real que falhou. Depois de corrigir um endpoint, use Testar para verificar o reparo.
Motivos comuns de falha
| Erro / status | Causa provável | Corrigir |
|---|---|---|
Request timed out (10s) | O servidor levou mais de 10 s para responder | Voltar 200 imediatamente, depois processe de forma assíncrona |
401 | Falha na verificação da assinatura | Leia o corpo bruto antes de interpretar o JSON |
404 | O caminho da URL do endpoint não existe | Confira novamente a URL nas configurações de Webhooks do Savebase |
500 | Erro não tratado no seu receptor | Confira a exceção nos logs do servidor |
| Conexão recusada / status null | O servidor está fora do ar ou a URL está errada | Confira se o servidor está funcionando e acessível publicamente |