Notificação Instantânea (Webhook)
Como a Kanglu recebe atualizações em tempo real das transportadoras
Notificação Instantânea (Webhook)
O webhook é o mecanismo mais rápido de atualização. A transportadora envia uma notificação para a Kanglu automaticamente sempre que o status de um envio muda.
Como funciona na prática?
- A transportadora atualiza o status do seu pedido (ex: "saiu para entrega")
- A transportadora envia essa informação automaticamente para a Kanglu
- A Kanglu processa e atualiza a timeline do pedido
- Você vê a atualização no painel em tempo real
Você não precisa fazer nada! Basta configurar o webhook uma vez na transportadora (veja abaixo) e todas as atualizações chegam automaticamente.
URLs de Webhook por Transportadora
Cada transportadora tem um endereço específico para enviar as notificações. Ao configurar o webhook no painel da transportadora, use a URL correspondente:
| Transportadora | URL do Webhook |
|---|---|
| FM Transportes | https://api.rasttro.com.br/api:osIXebOT/webhook/fm |
| J&T Express | https://api.rasttro.com.br/api:Z8gLFmwz/webhook |
| Mandaê | https://api.rasttro.com.br/api:osIXebOT/webhook/mandae |
Essas URLs também estão disponíveis na página de Integrações do seu painel administrativo Kanglu.
Como configurar o webhook?
A configuração varia de acordo com a transportadora:
FM Transportes
Solicite à FM Transportes que configure a URL de webhook no seu cadastro. Informe a URL acima.
J&T Express
No painel da J&T ou via contato com seu representante comercial, solicite a ativação do webhook com a URL acima.
Mandaê
No painel da Mandaê, acesse Configurações > Webhooks e adicione a URL acima.
Segurança
A Kanglu suporta autenticação nos webhooks para garantir que apenas a transportadora legítima envie dados. Isso pode ser configurado com:
- Header customizado — A transportadora envia um cabeçalho secreto que a Kanglu valida
- BasicAuth — Autenticação por usuário e senha
Recomendamos sempre configurar autenticação no webhook quando a transportadora suportar. Consulte a seção de cada transportadora para detalhes.
E se o webhook parar de funcionar?
Não se preocupe. A Kanglu detecta automaticamente quando o webhook está inativo e ativa a verificação periódica com maior frequência para compensar. Veja mais em Verificação Periódica.