Dados de logs de Webhook: consulta de status e reenvios

A seção Dados de logs de Webhook mostra o histórico das comunicações automáticas entre o Pandapé e outros sistemas conectados à sua conta. Lá, você pode:

• Conferir se as informações foram enviadas e recebidas corretamente;

• Filtrar os registros por data ou tipo de evento;

• Enviar novamente uma informação que não foi entregue;

• E confirmar o resultado de cada novo envio.

Confira os tópicos abordados neste artigo:

• Como acessar os Dados de logs de Webhooks
• O que você pode consultar e gerenciar
• Reenvio de Webhooks
• Significado dos status HTTP

Como acessar os Dados de logs de Webhooks

1. Na página Dashboard da sua conta do Pandapé, vá até o menu de configuração (ícone de engrenagem).
2. Na seção Outras configurações, acesse Webhooks e APIs.

3. Na parte de Últimas 10 Requisições de Webhook, clique em Ver mais para abrir a lista completa de logs.

O que você pode consultar e gerenciar

Nesta seção, você pode revisar o histórico de chamadas de Webhooks, entender o que cada coluna exibe, aplicar filtros para restringir os resultados e abrir o detalhe de cada tentativa para diagnóstico ou reenvio.

Colunas da tabela (o que significa cada uma)

• Código de status: Resultado da entrega conforme as famílias HTTP (ex.: Informativo, Sucesso, Erro do servidor, etc.). Consulte a tabela de Significado dos status HTTP mais abaixo.
• Nome: Apelido que você atribuiu ao Webhook. Ao clicar sobre ele, é aberto o detalhe completo da tentativa.
• Tipo: Evento que disparou a chamada (ex.: Questionário concluído).
• URL: Endpoint HTTPS do seu sistema para o qual o Pandapé envia a notificação (ex.: https://api.suaempresa.com/webhooks/candidatos).
• Data: Momento em que a tentativa foi realizada.

Dicas

• Revise o detalhe do log: Clique no Nome (em azul) para abrir o registro completo. Será aberta uma nova janela que contém os seguintes dados: Código de status, Tipo de webhook, URL chamada, Data e hora, Headers enviados, Corpo (JSON enviado) e Resposta do endpoint.
• Se precisar reenviar o Webhook: Use essas informações para validar o endpoint, o token e o corpo da mensagem antes da nova tentativa. Para o passo a passo, consulte Reenvio de webhooks.

Filtros principais (para encontrar rápido)

• Período de datas: Limita o período a revisar (ex.: últimos 7 dias).
• Todos os eventos: Exibe apenas um evento específico (ex.: Candidato mudou de etapa em uma vaga).
• Todos os status: Filtra por famílias HTTP (ex.: 4XX para detectar erros de autenticação ou URL).
• Buscar: Texto livre por nome do webhook, parte da URL, etc.
• Mostrar: Ajusta quantos registros serão exibidos por página.

Reenvio de Webhooks

O reenvio permite enviar novamente qualquer comunicação do Webhook, mesmo as que já foram enviadas com sucesso, sem precisar refazer nenhuma configuração. Essa opção é útil quando o sistema que deveria receber a informação teve algum problema, quando você ajustou a integração e quer reenviar os dados, ou quando precisa manter registros para auditoria. 

Antes de reenviar um Webhook, use os filtros por data, status ou tipo de evento para localizar apenas as tentativas que deseja enviar novamente.

Reenvio individual:

Em cada linha, clique no ícone ↻ Reenviar para repetir a chamada para a mesma URL, com o mesmo corpo e parâmetros da tentativa original.

Reenvio em massa:

1. Selecione vários itens com as caixas de seleção (ou use Selecionar tudo).
2. Abra o menu de seleção e escolha Reenviar Webhooks.
3. Confirme o reenvio. Essa ação enviará uma nova tentativa para cada item selecionado.

Significado dos status HTTP

Cada Webhook enviado a partir do Pandapé recebe uma resposta do sistema receptor em forma de código HTTP, que indica se a entrega foi bem-sucedida ou se ocorreu algum erro.

A seguir, você encontrará um guia rápido com o significado de cada família de códigos:

Etiqueta	Código de status (HTTP)	Descrição
	1XX – Informativo	Indica que a solicitação foi recebida e está em processamento. É uma resposta temporária do servidor.
	2XX – Sucesso	O webhook foi entregue corretamente e o endpoint receptor respondeu de forma satisfatória.
	3XX – Redirecionamento	A solicitação foi redirecionada para outra URL. Pode ser necessário ajustar o endereço do endpoint.
	4XX – Erro do cliente	O erro vem do sistema receptor (ex.: token inválido, URL incorreta ou falta de permissões).
	5XX – Erro do servidor	O servidor do sistema receptor apresentou uma falha interna. Tente novamente quando o serviço estiver disponível.