Este artigo explica o que são webhooks, os benefícios do uso, e traz um passo a passo prático para criar, configurar, testar, monitorar e resolver problemas em webhooks na plataforma Intelipost.
Webhooks são notificações automáticas enviadas pela Intelipost para endpoints externos quando determinados eventos acontecem (por exemplo: pedido despachado, atualização de rastreamento, pré-fatura gerada). Em vez de consultar a API constantemente, você recebe informações em tempo real, o que torna o processo mais eficiente.
A plataforma oferece uma tela dedicada para gestão dos disparos e configurações de webhooks, onde você pode acompanhar histórico, status de entrega e corrigir possíveis falhas.
Benefícios:
Monitoramento centralizado: visualize todos os disparos em um só lugar.
Agilidade na identificação de falhas: veja rapidamente quais eventos não foram entregues.
Facilidade para reenvio: dispare manualmente webhooks que falharam.
Rastreabilidade: mantenha histórico dos últimos 30 dias de disparos.
Controle de regras: defina quais eventos irão disparar webhooks.
Passo a passo: como visualizar seus Webhooks:
Acesse o menu
Comunicação> Webhook.
Defina o período de análise:
No topo esquerdo, clique no seletor de datas (ícone de calendário) e escolha o intervalo desejado (ex.:
02/09/2025 até 09/09/2025).
IMPORTANTE: os registros de webhook ficam disponíveis por 30 dias após a geração.
Escolha a aba que deseja visualizar:
Envios com erro: total de disparos que retornaram erro no período e a % de falha.
Envios em processamento: total de disparos que ainda não tiveram retorno do endpoint e permanecem em andamento.
Envios com sucesso: total de disparos concluídos com sucesso no período e a % de sucesso.
Todos envios: total de disparos realizados (com sucesso + com erro) no período filtrado.
Pesquise por um pedido específico
Use o campo “Pesquisar por número do pedido” para localizar rapidamente todos os disparos relacionados a um pedido.
Digite o identificador do pedido e pressione Enter.
A tabela apresenta, por linha, um disparo realizado:
Pedido: link para detalhes do pedido.
Status do pedido: situação do pedido no momento do disparo (quando exibido).
Data do disparo do Webhook: data e hora da notificação.
Id da regra de evento: link (ex.:
61856) para a configuração/regra que originou o disparo.Status do disparo: indica Sucesso ou Falha (ícone com ponto colorido). Em caso de falha, valide a regra, o endpoint e os logs do seu servidor.
URL: endpoint de destino que recebeu a requisição.
Confira os detalhes do webhook
Clique nos três pontinhos do pedido que deseja ver o detalhamento e aperte em "conferir mais detalhes"
No detalhamento é possivel visualizar:
No detalhamento é possível visualizar:
Erro identificado: Indica qual foi o problema ocorrido no disparo do webhook.
Pedido:Mostra qual pedido originou o disparo do webhook.
Status do pedido: Exibe em qual situação o pedido se encontra no momento.
Data do disparo: Registra a data e hora em que o webhook foi enviado.
ID da regra de evento: Representa a identificação da regra configurada que gerou o disparo do webhook..
URL de destino: Mostra para qual endereço (endpoint) o webhook foi enviado.
Status HTTP: Exibe o código de resposta retornado pelo endpoint.
Hash: É um identificador único gerado para cada requisição de webhook
Aba de Request: exibe os detalhes do envio, incluindo:
Header:
contém informações como autenticação (ex.: api-key) e formatação dos dados (ex.: Content-Type).
Body: contém o conteúdo principal enviado no webhook, geralmente em formato JSON.
Aba de Response (Aba)
Exibe a resposta devolvida pelo endpoint após o recebimento do webhook.
Reenvie manualmente um Webhook
Clique em Enviar Webhook manualmente (botão no topo direito).
No modal, preencha as informações solicitadas (ex.: número do pedido, tipo de evento e/ou a regra aplicável) e confirme o envio.
Acompanhe o resultado na Lista de Webhooks; o novo disparo aparecerá com a data/hora atual
A tela de gestão de webhooks permite acompanhar em tempo real os disparos realizados, identificar falhas e realizar reenvios manuais sempre que necessário. Dessa forma, você garante que seus sistemas externos recebam as notificações corretas da Intelipost e mantém suas integrações atualizadas e confiáveis.