Cada webhook mostra quantos eventos chegaram ao seu endpoint e quantos falharam depois de 3 tentativas. Use o histórico para descobrir se o problema está no endpoint e qual é.
Na lista de webhooks
Ao lado de cada webhook aparecem as entregas dos últimos 7 dias e a taxa de erro, como "2% de erro". Se não houve nenhum evento, aparece Sem entregas em 7 dias.
No histórico do webhook
Clique em Editar no webhook para abrir o Histórico de entregas. Escolha o período de 7 dias ou 30 dias e, se quiser, um Evento específico.
Indicador | O que significa |
Entregues | Eventos que o seu endpoint confirmou com status 2xx. |
Com erro | Eventos que falharam nas 3 tentativas e não serão reenviados. |
Taxa de erro | Com erro dividido pela soma de Entregues e Com erro. |
Novas tentativas | Tentativas que falharam e voltaram para a fila. O mesmo evento depois vira Entregue ou Com erro, por isso não entra na taxa. |
O gráfico mostra um dia por barra, no seu fuso horário. Passe o mouse ou o foco do teclado sobre um dia para ver os números. A tabela Por evento mostra os eventos com mais erros primeiro. Clique num evento para filtrar o histórico e clique de novo para voltar a todos.
Erros recentes
Esta lista mostra os eventos que não foram entregues depois de 3 tentativas. Eles ficam disponíveis por 30 dias. Cada erro traz:
data e hora;
o status HTTP que seu endpoint respondeu, ou Sem resposta;
o motivo, como O endpoint recusou o evento;
o evento e o ID do envio, que é o
traceIddo corpo. Use esse ID para procurar o evento nos registros do seu sistema;a Resposta do endpoint: o início do que o seu servidor respondeu. Valores de headers e credenciais da URL aparecem como
[redacted].
Use Carregar mais para ver erros mais antigos.
Erros comuns
O que aparece | Causa provável | O que fazer |
404 · O endpoint recusou o evento | A URL não existe no seu servidor: caminho errado, rota removida ou serviço desligado. | Confira o Endpoint do webhook. Se o endereço mudou, edite o webhook. Se não usa mais, pause ou exclua. |
401 ou 403 · O endpoint recusou o evento | O seu servidor não aceitou a autenticação. | Confira o nome e o valor em Headers de autenticação. Se o token foi trocado ou expirou, atualize o valor. |
429 · O endpoint recusou por excesso de requisições | O seu servidor limitou a quantidade de chamadas. Acontece muito com serviços de teste, como Beeceptor e Webhook.site, que têm limite baixo nos planos gratuitos. | Aumente o limite no seu servidor. Para testes, use um serviço com limite maior e desligue o webhook de teste quando terminar. |
Sem resposta · O endpoint demorou para responder | O endpoint não respondeu em 8 segundos. | Responda 2xx logo ao receber e processe o evento depois. |
Sem resposta · Não foi possível conectar ao endpoint | Endereço que não existe, servidor fora do ar, conexão recusada ou certificado HTTPS inválido. | Confira se a URL abre de fora da sua rede e se o certificado é válido. |
5xx · O endpoint respondeu com erro | Erro interno no seu servidor. | Veja a Resposta do endpoint e os registros do seu sistema. |
Outros 4xx · O endpoint recusou o evento | O seu servidor recusou o conteúdo, por exemplo por validação. | Veja a Resposta do endpoint e compare com o artigo Referência de eventos e campos. |
A configuração do webhook é inválida | A chamada nem saiu, por exemplo por um nome de header com caractere inválido. | Revise os nomes em Headers de autenticação: use só letras, números e hífens. |
Envio pausado após falhas seguidas | O webhook falhou 10 vezes seguidas e as entregas foram pausadas. Veja Como a entrega funciona. | Corrija a causa dos erros anteriores. As entregas voltam sozinhas quando o endpoint responder. |
Histórico vazio
Se aparecer Nenhuma entrega neste período, confira se o webhook está Ativo e se os eventos marcados aconteceram no período. O histórico de entregas começa em 21/10/2026. Entregas anteriores a essa data não aparecem.