Guia
Webhooks de rastreio: eventos, segurança e o que a sua operação configura
Para quem lidera a operação e quem implementa a integração.
Com webhooks, a sua infra recebe HTTP POST quando o último evento de rastreio muda, no modelo (eventos, cabeçalhos HTTP, corpo, reentregas) descrito em /api-docs/webhooks. Gestão coloca a operação a proativa (e-mail, CRM, tarefas). Tecnologia aplica HMAC no corpo bruto, resposta 2xx imediata, idempotência pelo id de entrega e, em produção, acompanhamento de 2xx, 4xx e 5xx.
A documentação cobre ainda o gerenciamento (criar, testar, trocar segredo, entregas quando a página listar). Fique com ela como fonte única de campos — versões evoluem.
Padrão de entrega, do rascunho à produção
- Definir o endpoint receptor. Receber POST, validar assinatura, idempotência por id de entrega, 2xx rápido, processar em fila se precisar.
- Cadastrar no Seu Rastreio. Inclua URL, eventos e segredo, conforme /api-docs/webhooks e o fluxo de criação.
- Monitorar saúde. 2xx, reentregas (se a doc listar) e indicadores mínimos no seu SRE, principalmente pós-feriado e picos de e-commerce.
Segurança e latência: o mínimo que a TI não pode pular
Segredo jamais em repositório aberto. Assinatura (timestamp e HMAC) como na doc, comparando o corpo exatamente como a doc indica, antes de tratar a mensagem. Responda rápido com 2xx; processe o peso em fila do seu lado, senão tempo estourado e reentregas podem inchar, como a própria visão geral de webhooks explica. Tipos e estados (por exemplo em trânsito ou entregue, quando documentados) estão na tabela: cruzar com a jornada de CX e canal é tarefa sua.
Túnel em desenvolvimento e go-live com domínio próprio
A API cria a URL, rotaciona segredo quando existir e oferece teste — tudo descrito na página. Em desenvolvimento, túneis (por exemplo com ngrok) dão HTTPS estável; em produção, use domínio e certificado (SSL) válidos e alerta de queda. A doc descreve ainda a desativação automática após falhas em sequência: planeje a recuperação e o reprocesso internos.
Perguntas frequentes
Dúvidas comuns de quem coloca a integração em produção.
- Ainda preciso consultar a API de rastreio além do webhook?
- Muitas equipes usam o webhook como gatilho e mantêm GET de rastreio para reconciliação e casos excepcionais — padrão comum e sólido.
Próximo passo: documentação oficial
Parâmetros, tabelas de resposta, limites e exemplos em código — tudo na referência de API pública.
Atualizado em 23/04/2026