Histórico de eventos

O BreezeAuth registra cada tentativa de entregar um evento aos seus webhooks, com sucesso ou não. Você pode consultar esses registros no console de administração para confirmar que o seu endpoint está recebendo os eventos, ou para descobrir por que não está.

Abrir o histórico de eventos

Lendo a lista

Cada linha é uma tentativa de entrega, da mais recente para a mais antiga:

Coluna	O que mostra
Evento	O tipo do evento, por exemplo Associação criada.
Tentativas	Qual tentativa é esta linha: 1 tentativa para a entrega original, 2 tentativas para a primeira nova tentativa, e assim por diante.
Status	Sucesso se o seu endpoint respondeu 2xx em até 15 segundos, Falhou caso contrário.
Criado em	Quando a tentativa foi feita.

Assim, um evento que falhou e foi repetido aparece em várias linhas, uma por tentativa. Um evento entregue na primeira tentativa aparece uma única vez, com 1 tentativa e Sucesso.

Detalhes da tentativa

Selecione uma linha para abrir os detalhes daquela tentativa:

Campo	O que mostra
Tentativa	O número da tentativa (de 1 a 3).
Evento	O tipo do evento.
ID do evento	O identificador único do evento. É o cabeçalho webhook-id e o campo uuid que o seu endpoint recebeu. Use-o para encontrar a mensagem nos seus próprios logs. Todas as tentativas do mesmo evento o compartilham.
URL	O endereço para onde esta tentativa foi enviada. Se a URL do webhook foi alterada nesse meio-tempo, mostra o endereço usado na época.
Status	Sucesso ou Falhou.
Código do erro	Em tentativas que falharam: o status HTTP que o seu endpoint retornou, ou um código de erro de rede. Veja a tabela abaixo.
Mensagem de erro	Em tentativas que falharam: uma descrição técnica do erro.
Disparado em	Quando a tentativa foi feita.
Dados	O data da mensagem: os identificadores dos recursos envolvidos no evento.

Erros comuns

Código do erro	O que significa	O que fazer
301, 302, 307, 308	O seu endpoint respondeu com um redirecionamento, que o BreezeAuth não segue.	Atualize o webhook com a URL final, normalmente a versão https:// ou com barra no final.
400, 401, 403	O seu endpoint rejeitou a mensagem.	Consulte os logs do endpoint. A verificação de assinatura ou de organização pode estar falhando; veja Verificar assinaturas.
404, 405	Nada nesse endereço aceita requisições POST.	Confira o caminho da URL e se o endpoint aceita POST.
500, 502, 503, 504	O seu endpoint, ou um proxy na frente dele, teve um erro ou está indisponível.	Consulte os logs e a disponibilidade do endpoint.
ECONNABORTED, ETIMEDOUT	Nenhuma resposta em até 15 segundos.	Responda primeiro e processe em segundo plano. Veja Receber eventos com confiabilidade. Se você usa uma lista de permissões de IP, confira se um firewall não está descartando os endereços do BreezeAuth.
ECONNREFUSED	O servidor recusou a conexão: nada está escutando nesse endereço e porta, ou um firewall a rejeitou.	Confira se o serviço está no ar, se a porta está aberta para a internet e se os endereços do BreezeAuth estão liberados.
ENOTFOUND	Não foi possível resolver o nome de domínio da URL.	Procure erros de digitação na URL e confira os registros DNS do domínio.
ECONNRESET	A conexão foi encerrada inesperadamente.	Confira firewalls, balanceadores de carga e proxies entre a internet e o seu endpoint.
CERT_HAS_EXPIRED, DEPTH_ZERO_SELF_SIGNED_CERT, UNABLE_TO_VERIFY_LEAF_SIGNATURE	O certificado TLS do endpoint está vencido, é autoassinado ou está incompleto.	Instale um certificado válido de uma autoridade certificadora pública, incluindo a cadeia intermediária.

Checklist de diagnóstico

Se o seu endpoint não está recebendo eventos:

• O webhook está Ativado e assina o evento esperado.
• O evento realmente aconteceu nesta organização.
• O Histórico de eventos mostra tentativas para o evento. Se não mostrar nenhuma, confira os dois itens acima.
• A URL pode ser acessada pela internet, e não apenas pela sua rede interna.
• Se você restringe o acesso por endereço IP, todos os endereços do BreezeAuth estão liberados.
• A URL é o endereço final e não redireciona.
• O endpoint responde 2xx em menos de 15 segundos.
• O endpoint verifica a assinatura usando o corpo bruto e a chave pública correta.