Rastreio Unificado & Notificações

Manter o cliente informado sem sobrecarregar a central de SAC. O BulkRoute resolve isso com o motor de rastreamento em 3 camadas.

As 3 Camadas de Atualização

1. Webhook Inbound (Push)

Transportadoras modernas enviam atualizações push imediatas para o BulkRoute:

Lalamove, Kombex, DHL, FedEx

O BulkRoute valida a assinatura HMAC de cada webhook, normaliza o status e dispara o webhook outbound para o seu sistema.

2. Polling Periódico Inteligente

Para transportadoras que não emitem webhooks (Braspress, Jadlog, SSW, Correios):

Cron job automático consulta o status a cada 15 minutos
Só consulta shipments ativos (PICKED_UP até OUT_FOR_DELIVERY)
Limite de concorrência por carrier para não estourar rate limit
Desativável via variável de ambiente TRACKING_POLL_ENABLED=false

3. App do Motorista (Frota Própria)

O motorista atualiza os eventos em tempo real direto do celular:

Saída para entrega
Tentativa frustrada com foto e motivo
Entrega concluída com assinatura digital
Geolocalização GPS de cada evento

Status Padronizados

Todos os eventos de todos os carriers são normalizados para um único padrão:

Status BulkRoute	Descrição	Cor
`CREATED`	Pedido criado no sistema	Verde
`PENDING`	Aguardando processamento inicial	Âmbar
`PROCESSING`	Em processamento pela transportadora	Âmbar
`LABEL_GENERATED`	Etiqueta gerada, pronto para despacho	Azul
`DISPATCHED`	Despachado para a transportadora	Sky
`PICKED_UP`	Carga coletada na expedição	Ciano
`IN_TRANSIT`	Em transferência entre filiais/CDs	Azul
`OUT_FOR_DELIVERY`	Em rota final de entrega	Violeta
`DELIVERED`	Entrega finalizada com sucesso	Verde
`FAILED`	Tentativa frustrada / ocorrência	Vermelho
`RETURNED`	Devolução em andamento	Laranja
`CANCELLED`	Envio cancelado	Vermelho

Página de Rastreio com a sua Marca (Branded Tracking)

Em vez de direcionar seu cliente para sites genéricos das transportadoras, envie o link de rastreamento do BulkRoute:

https://www.bulkroute.com.br/tracking/BRFMSF5NRT9S0M

A página exibe:

Logotipo da sua empresa (light e dark mode)
Cores da sua marca (cor primária e de destaque)
CSS customizado (opcional — para personalização avançada)
Título da página (ex: “Rastreio - Cliente X”)
Rodapé customizado com link para seu site
Linha do tempo visual limpa e descomplicada

Como configurar

Acesse Parceiros > Minha Empresa (/admin/my-tenant) → aba Branding
Faça upload do seu logo (light e dark mode)
Defina a cor primária (HEX ou OKLCH)
Defina a cor de destaque
(Opcional) Cole seu CSS customizado
Defina o título da página e rodapé
Use o Preview para ver como vai ficar antes de publicar

Domínio próprio (Enterprise)

Clientes Enterprise podem usar seu próprio domínio para a página de rastreio:

https://rastreio.suaempresa.com.br/tracking/BRFMSF5NRT9S0M

Para configurar:

Crie um CNAME rastreio.suaempresa.com.br → saas.bulkroute.com.br
Entre em contato com o suporte para ativar o Cloudflare for SaaS
Configure o domínio customizado no painel de Branding

Notificações Proativas ao Cliente Final

O BulkRoute envia notificações automáticas ao destinatário em eventos-chave:

Evento	Quando
`PICKED_UP`	Carga coletada na expedição
`OUT_FOR_DELIVERY`	Saiu para entrega
`DELIVERED`	Entrega concluída + link de avaliação NPS
`FAILED`	Ocorrência ou tentativa frustrada
`RESCHEDULED`	Reagendamento confirmado

As notificações são enviadas por E-mail e SMS. WhatsApp está em desenvolvimento e será disponibilizado em breve.

Configurar canais

Acesse Sistema > Notificações > Configuração (ou clique em “Configurar” na página de Logs)
Na aba Preferências, ative os canais disponíveis:
- SMS
- E-mail
Defina o rate limit por destinatário (padrão: 5/dia) — evita spammar o cliente
Acompanhe os envios na aba Logs e estatísticas na aba Stats

WhatsApp e templates customizados estão em desenvolvimento e serão disponibilizados em breve. Entre em contato com suporte@bulkroute.com.br para mais informações.

Opt-out

O destinatário pode cancelar as notificações:

Responde “SAIR” no SMS
Clica em “Cancelar notificações” no e-mail
O sistema respeita a preferência e não envia mais

NPS pós-entrega

24 horas após DELIVERED, o BulkRoute envia automaticamente um e-mail (e WhatsApp, quando ativo) pedindo ao destinatário que avalie a experiência de 0 a 10. O link no e-mail direciona para uma página de avaliação pública (/nps/:token), onde o cliente:

Seleciona a nota (0-10) em um grid visual
Pode escrever um comentário opcional (até 2000 caracteres)
Clica em “Enviar avaliação”

A resposta é armazenada no BulkRoute e fica disponível no dashboard de NPS.

Dashboard de NPS

Acesse Sistema > NPS (/admin/nps) para ver:

NPS Score (−100 a +100): %promotores − %detratores
Distribuição de notas: gráfico de barras 0-10
Por transportadora: nota média por carrier
Respostas recentes: tabela com código, cliente, nota, comentário e data

Filtre por período: 7, 30, 90 ou 365 dias.

Classificação NPS

Categoria	Nota	Significado
Promotor	9-10	Cliente satisfeito, recomenda
Neutro	7-8	Satisfeito, mas não promove ativamente
Detrator	0-6	Insatisfeito, pode prejudicar a marca

Como funciona o token

O link enviado ao cliente contém um token JWT assinado (válido por 7 dias):

O token identifica o shipment e o tenant
A resposta é vinculada ao shipment correto
Um shipment só pode ter uma resposta (idempotente)
O token expira após 7 dias ou após o envio

O NPS só é enviado se o tenant tiver opt_in_nps = true nas preferências de notificação (padrão: ativo). Desative em Sistema > Notificações > Configuração se não quiser enviar pesquisas.

Webhook Outbound (para seu sistema)

Sempre que o status muda, o BulkRoute envia um POST para a URL que você configurou:

{
  "event": "shipment.status_updated",
  "timestamp": "2026-09-06T18:30:00Z",
  "data": {
    "shipmentId": "shp_987654321",
    "trackingCode": "BR123456789BR",
    "carrierCode": "braspress",
    "previousStatus": "IN_TRANSIT",
    "currentStatus": "DELIVERED",
    "occurredAt": "2026-09-06T18:28:45Z"
  }
}

Cada requisição inclui o header X-BulkRoute-Signature com HMAC-SHA256 para validação. Veja Webhooks para detalhes.

Visão Geral

Como Usar

Primeiros Passos

Operação Diária

As 3 Camadas de Atualização

1. Webhook Inbound (Push)

2. Polling Periódico Inteligente

3. App do Motorista (Frota Própria)

Status Padronizados

Página de Rastreio com a sua Marca (Branded Tracking)

Como configurar

Domínio próprio (Enterprise)

Notificações Proativas ao Cliente Final

Configurar canais

Opt-out

NPS pós-entrega

Dashboard de NPS

Classificação NPS

Como funciona o token

Webhook Outbound (para seu sistema)

​As 3 Camadas de Atualização

​1. Webhook Inbound (Push)

​2. Polling Periódico Inteligente

​3. App do Motorista (Frota Própria)

​Status Padronizados

​Página de Rastreio com a sua Marca (Branded Tracking)

​Como configurar

​Domínio próprio (Enterprise)

​Notificações Proativas ao Cliente Final

​Configurar canais

​Opt-out

​NPS pós-entrega

​Dashboard de NPS

​Classificação NPS

​Como funciona o token

​Webhook Outbound (para seu sistema)

As 3 Camadas de Atualização

1. Webhook Inbound (Push)

2. Polling Periódico Inteligente

3. App do Motorista (Frota Própria)

Status Padronizados

Página de Rastreio com a sua Marca (Branded Tracking)

Como configurar

Domínio próprio (Enterprise)

Notificações Proativas ao Cliente Final

Configurar canais

Opt-out

NPS pós-entrega

Dashboard de NPS

Classificação NPS

Como funciona o token

Webhook Outbound (para seu sistema)