A seção Dados de Logs Webhook permite auditar e operar cada chamada enviada pelo Pandapé aos seus endpoints: ver o status, filtrar por data ou tipo de evento, reenviar uma tentativa de forma individual ou várias tentativas em massa, e confirmar o resultado de cada reenvio.
Este artigo aborda os seguintes temas:
Nota:
- Permissões: o acesso a Dados de Logs Webhook está disponível apenas para usuários com perfil de Administrador ou Supervisor.
Como acessar
- Na sua conta do Pandapé ATS, acesse Configurações.
- Em Outras configurações, entre em Webhooks e APIs.
- No cartão Últimas 10 Solicitaçõ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 webhook, entender o que mostra cada coluna, aplicar filtros para refinar resultados e abrir o detalhe de cada tentativa para diagnóstico ou reenvio.
Colunas da tabela (o que significa cada uma)
|
Coluna |
O que significa? |
| Código de status | Número de três dígitos que indica o resultado da entrega. 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 | Apelido que você atribuiu ao webhook. Ao clicar nele, abre-se 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
- Revise o detalhe do log: clique no Nome (em azul) para abrir a ficha completa. Você verá: Código de status, Tipo de webhook, URL chamada, Data e hora, Cabeçalhos enviados, Corpo (JSON enviado) e Resposta do endpoint.
-
Se você precisar reenviar: 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 rápido)
-
Intervalo 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: filtre por famílias numéricas de códigos: 1XX/100–199 (Informativo), 2XX/200–299 (Sucesso), 3XX/300–399 (Redirecionamento), 4XX/400–499 (Erro do cliente) e 5XX/500–599 (Erro do servidor).
Exemplo: selecione 4XX para localizar erros do cliente como 400, 401, 404 ou 429.
-
Pesquisar: texto livre por nome do webhook, parte da URL, etc.
- Exibir: ajuste quantos registros ver por página.
Reenvio de webhooks
O reenvio permite enviar novamente qualquer chamada de webhook (tenha ela falhado ou sido bem-sucedida), sem refazer a configuração. É útil quando o sistema receptor perdeu as informações, você corrigiu uma integração e deseja reprocessar o evento, ou precisa de evidências para auditoria.
Você pode realizar dois tipos de reenvio:
Antes de reenviar, recomendamos aplicar filtros para refinar (intervalo de datas, status, tipo de evento) e focar nas tentativas de seu interesse que deseja reenviar.
Nota:
- Registro original: o log original nunca é modificado nem apagado; é o registro histórico da tentativa exatamente como ocorreu.
- Novos logs por reenvio: cada reenvio gera um novo log com sua data e status resultante, mantendo a rastreabilidade completa.
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:
- Selecione várias linhas com as caixas de seleção (ou use Selecionar tudo).
- Abra o menu de seleção ▾ e escolha Reenviar Webhooks.
- Confirme o reenvio. Essa ação enviará uma nova tentativa para cada linha selecionada.
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, você encontrará um guia rápido com o significado de cada família de códigos:
Rótulo |
Código de status (HTTP) |
Descrição |
| 1XX (100–199) – Informativo | Indica que 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 vem do sistema receptor. | |
| 5XX (500–599) – Erro do servidor | O servidor do sistema receptor apresentou uma falha interna. |