Rastreio Unificado & Notificações

​

As 3 Camadas de Atualização

​

1. Webhook Inbound (Push)

• Lalamove, Kombex, DHL, FedEx

​

2. Polling Periódico Inteligente

• 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)

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

​

Status Padronizados

​

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

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

• 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

1. Acesse Configurações da Empresa > Branding
2. Faça upload do seu logo (light e dark mode)
3. Defina a cor primária (HEX ou OKLCH)
4. Defina a cor de destaque
5. (Opcional) Cole seu CSS customizado
6. Defina o título da página e rodapé
7. Use o Preview para ver como vai ficar antes de publicar

​

Domínio próprio (Enterprise)

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

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

​

Notificações Proativas ao Cliente Final

​

Configurar canais

1. Acesse Configurações > Notificações
2. Ative os canais disponíveis:
   • WhatsApp (usa provider integrado)
   • SMS (Twilio)
   • E-mail (AWS SES)
3. Edite os templates por evento (suporta i18n pt-BR e en)
4. Defina o rate limit por destinatário (padrão: 5/dia)

​

Opt-out

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

​

NPS pós-entrega

• Link de avaliação (1-10)
• Campo de feedback opcional
• O resultado fica disponível no dashboard de NPS

​

Webhook Outbound (para seu sistema)

{
  "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"
  }
}