Páginas Personalizadas

Como expor seus rastreios em uma página com a sua marca, sem precisar consumir a API.

Visão Geral

Cada time pode personalizar sua página pública de rastreio com logo, título, cores e textos. A página fica acessível em um subdomínio dedicado e responde por código de rastreio ou por número de pedido. É uma alternativa pronta ao consumo direto da API.

URLs disponíveis

Existem dois formatos de link público:

Subdomínio próprio

Após escolher o slug do seu time no dashboard, a página fica em https://{slug}.seurastreio.com.br. Esse domínio aparece com o seu logo e cores configuradas — é o link que você compartilha com clientes.

https://meutime.seurastreio.com.br
https://meutime.seurastreio.com.br/AA123456789BR

Link genérico /objetos

Cada chamada da API de rastreamento devolve um campo linkDetalhesCompletos apontando para https://seurastreio.com.br/objetos/{codigo}. Use esse link para abrir o detalhe completo (sem necessidade de chave de API) — ideal para enviar em e-mails transacionais.

https://seurastreio.com.br/objetos/AA123456789BR

O que dá pra personalizar

  • Slug do subdomínio — define o link público.
  • Logo — exibido no header da página de rastreio.
  • Título e descrição — texto principal e SEO.
  • Cor primária — destaque dos botões e badges de status.
  • Texto de boas-vindas — mostrado quando o cliente abre a página sem código.

A configuração fica em Dashboard → Time → Personalizar página. Mudanças propagam imediatamente.

Busca por número de pedido

Se o time importou pedidos via integração (Shopify, NuvemShop, Loja Integrada, LiveXa) ou adicionou manualmente, o cliente pode digitar o número do pedido em vez do código de rastreio. A página resolve para o rastreio associado e exibe o histórico.

API ou página personalizada?

  • Use a API quando você já tem app/site próprio e quer integrar os dados nativamente — controle total do layout.
  • Use a página personalizada quando quer um link pronto para colocar no e-mail transacional ou no rodapé do site, sem código.
  • Combinar os dois é comum: a página personalizada para clientes finais, a API para dashboards internos e automações.
A página pública não conta para a cota mensal de rastreios da API — é um recurso à parte, com seu próprio cache e rate limit.