Na seção de Webhooks e APIs, você pode acompanhar o histórico de logs realizados para os endereços configurados.
Nessa área, que no Pandapé chamamos de "Dados de Logs de Webhooks", é possível ver se cada envio foi concluído com sucesso ou não, filtrar os registros por data ou tipo de evento, reenviar um envio específico ou vários de uma vez e confirmar o resultado de cada reenvio.
Isso facilita o acompanhamento e a correção de eventuais problemas, garantindo que as informações cheguem corretamente ao seu sistema.
Confira os tópicos abordados neste artigo:
- Como acessar o histórico de logs dos Webhooks
- O que você pode consultar e gerenciar
- Como fazer o reenvio de Webhooks
- Significado dos status HTTP
Nota:
- Permissões: O acesso aos Dados de Logs Webhook está disponível apenas para usuários com perfil de Administrador ou Supervisor.
Como acessar o histórico de logs dos Webhooks
- Na página Dashboard da sua conta do Pandapé, vá até o menu de configuração (ícone de engrenagem).
- Na seção Outras configurações, entre em Webhooks e APIs.
- Na tela de Gestão de Webhooks e APIs, estará disponível a lista das Últimas 10 Solicitações de Webhook. Vá em Ver mais para abrir a lista completa de logs.
4. Pronto! Agora você tem acesso à lista completa dos Dados de Logs Webhooks e pode usar os filtros e visualizações disponíveis para fazer as consultas necessárias, como mostramos no próximo tópico a seguir.
O que você pode consultar e gerenciar
Nesta seção, é possível acompanhar o histórico de envios de Webhooks, entender o que cada coluna representa e usar filtros para encontrar informações específicas.
Também é possível abrir os detalhes de cada envio para verificar o que aconteceu, identificar possíveis problemas e, se necessário, realizar um novo envio.
Descritivo da tabela
|
Coluna |
O que significa? |
| Código de status | Número de três dígitos que indica o resultado do envio. O primeiro dígito define a família e seu significado: 100–199 (1XX) Informativo, 200–299 (2XX) Sucesso, 300–399 (3XX) Redirecionamento, 400–499 (4XX) Erro do cliente e 500–599 (5XX) Erro do servidor. Consulte a tabela de Significado dos status HTTP mais abaixo. |
| Nome | Título atribuído ao Webhook. Ao clicar nele, é aberto o detalhe completo da tentativa. |
| Tipo | Evento que disparou a chamada (ex.: O questionário foi 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
-
Acesse os dados do log: Clique no nome (em azul) para abrir as informações completas do envio. Nessa tela, é possível conferir:
Código de status;
Tipo de Webhook;
URL acionada;
Data e horário do envio;
Cabeçalhos enviados;
Conteúdo da mensagem (JSON enviado);
Resposta retornada pelo endpoint.
-
Para reenviar um 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-chave para encontrar informações rapidamente
Use os filtros abaixo para localizar exatamente o que você precisa:
Datas
Define o período que você deseja analisar. Exemplo: Últimos 7 dias.Eventos
Mostra apenas um tipo específico de evento. Exemplo: Candidato mudou de etapa em uma vaga.-
Status
Filtre pelos grupos de códigos de resposta:1XX (100–199) – Informações
2XX (200–299) – Sucesso
3XX (300–399) – Redirecionamento
4XX (400–499) – Erro do cliente
5XX (500–599) – Erro do servidor
Exemplo: Selecione 4XX para encontrar erros como 400, 401, 404 ou 429.
Pesquisar
Busca livre por nome do webhook, trecho da URL ou outros termos.Exibir
Ajuste a quantidade de registros exibidos por página.
Como fazer o reenvio de Webhooks
O reenvio permite enviar novamente um ou mais Webhooks, mesmo que eles já tenham sido enviados com sucesso ou não, sem precisar refazer nenhuma configuração.
Esse recurso é útil quando:
O sistema que recebe o Webhook perdeu as informações;
Ocorreu ajuste em uma integração e é necessário reprocessar um evento;
Precisa gerar evidências para auditoria.
Você pode realizar 2 tipos de reenvios:
Reenvio individual: Para reenviar uma Webhook específico.
Reenvio em massa: Para reenviar vários Webhooks de uma só vez.
Antes de realizar esse processo, recomendamos usar os filtros disponíveis (como intervalo de datas, status e tipo de evento) para localizar e selecionar apenas as tentativas que fazem sentido para você.
Nota:
Registro original: O log original não é alterado nem excluído. Ele permanece como o registro histórico da tentativa, exatamente como aconteceu.
Novos logs a cada reenvio: Cada reenvio gera um novo log, com sua própria data e status. Assim, é possível acompanhar todo o histórico de tentativas e manter a rastreabilidade completa.
1. Reenvio individual
Na lista de Logs, clique no ícone indicado a seguir para reenviar o Webhook. O reenvio repete a solicitação para a mesma URL, usando o mesmo corpo e os mesmos parâmetros da tentativa original.
2. Reenvio em massa
- Na lista de Logs, selecione os itens desejados (ou use a opção Selecionar tudo).
- Abra o menu de seleção e selecione a opção Reenviar Webhooks.
- Confirme o reenvio e pronto! Essa ação enviará uma nova tentativa para cada item selecionado.
Significado dos status HTTP
Cada Webhook enviado pelo 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, apresentamos a descrição de cada status.
Status |
Código do status (HTTP) |
Descrição |
| 1XX (100–199) – Informativo | A solicitação foi recebida e está sendo processada. Resposta temporária. | |
| 2XX (200–299) – Sucesso | O webhook foi entregue corretamente e o endpoint receptor respondeu de forma satisfatória. | |
| 3XX (300–399) – Redirecionamento | A solicitação foi redirecionada para outra URL. | |
| 4XX (400–499) – Erro do cliente | O erro ocorre no sistema receptor. | |
| 5XX (500–599) – Erro do servidor | O servidor do sistema receptor apresentou uma falha interna. |