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.
Todos webhooks enviados: 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.
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.