Configurações do Widget

A aba Widget configura um pequeno widget de status de pedido que você pode incorporar em seu próprio site — geralmente o bloco “Onde está meu pedido?” no rodapé ou em uma página de ajuda. Os clientes inserem seu número de pedido e e-mail, e o widget mostra o status atual sem enviá-los para outro lugar.

O widget é uma incorporação hospedada e com marca: você escolhe uma cor primária, um título e uma descrição; o sistema fornece um snippet <script> para copiar e colar em seu site.

Abra a aba em Configurações do aplicativo → Widget.

Sumário

Para que serve esta aba
Habilitar / Desabilitar
Personalização
Código de incorporação
Prévia
A chave do widget
Diferença entre Widget e Portal do Cliente
Dicas e melhores práticas

Para que serve esta aba

Use esta aba para:

Adicionar um bloco de status de autoatendimento ao seu site sem escrever código.
Personalizá-lo com sua cor primária, texto do título e descrição.
Gerenciar ligar/desligar centralmente — alterne para desligado e o widget para de responder em todos os lugares onde está incorporado.

O widget complementa (em vez de substituir) os links de rastreamento do Portal do Cliente por pedido que você envia a clientes individuais.

Habilitar / Desabilitar

Uma alternância na parte superior da página ativa ou desativa o widget globalmente:

Ligado — o widget responde a consultas em todos os lugares onde está incorporado.
Desligado — o widget renderiza em um estado “atualmente indisponível”.

Útil para janelas de manutenção, ou para colocar o widget offline se você decidir desativá-lo.

Personalização

Abaixo da alternância está um formulário com três campos:

Campo	Notas
Título do Widget	Até 255 caracteres. Mostrado como o cabeçalho dentro do widget. “Rastreie seu pedido” ou “Status do pedido” é típico.
Descrição do Widget	Até 500 caracteres. Um subtítulo curto. “Digite seu número de pedido e e-mail para ver o status atual.”
Cor Primária	Controle duplo — um seletor de cores e um campo de texto hexadecimal, vinculados em ambos os sentidos. Controla o botão, os acentos e a cor da marca dentro do widget.

Clique em Salvar para aplicar. As alterações se propagam para cada widget incorporado em segundos (a incorporação puxa a configuração mais recente a cada carregamento).

Código de incorporação

Abaixo do formulário de personalização há um bloco somente leitura de código de incorporação — um único snippet <script> com seu widget_key e o embed_url.

Um botão Copiar copia todo o snippet para a sua área de transferência. Ele pisca brevemente “Copiado!” para confirmar.
Cole o snippet no HTML de qualquer página do seu site — geralmente perto da parte inferior do corpo, ou em um bloco HTML do CMS.

É isso — uma vez que o snippet está na página, o widget renderiza. Atualizar a página pega suas últimas alterações de personalização.

Prévia

Um botão Mostrar / Ocultar Prévia revela uma renderização simulada do widget em sua personalização atual:

Entradas de amostra para Número do Pedido e E-mail.
Um botão Rastrear desabilitado estilizado com sua cor primária selecionada.

A prévia é puramente visual — ela não consulta nenhum pedido. Use-a para verificar o título, a descrição e a cor antes de publicar.

Cada conta tem uma única chave de widget — um identificador estável que o snippet de incorporação usa para solicitar sua marca e dados. A chave:

É gerada uma vez quando a conta é criada.
É imutável — você não pode alterá-la pela UI.
Faz parte do snippet de incorporação, embutida no script.

Se você precisar rotacionar a chave do widget (incidente de segurança, vazamento de chave), entre em contato com o suporte.

Uma confusão comum:

	Widget	Portal do Cliente
Onde vive	No seu site, como uma incorporação.	No seu Board, acessado via uma URL de rastreamento exclusiva.
Como um cliente o alcança	Visita seu site, digita # do pedido + e-mail.	Clica no link de rastreamento que você enviou.
Autenticação	# do pedido + e-mail (qualquer um com ambos pode consultar).	Token de rastreamento exclusivo na URL (qualquer um com a URL pode visualizar).
URL por pedido	Não, um único widget compartilhado para todos os pedidos.	Sim, uma URL por pedido.
Atualização automática	A cada recarregamento da página.	Atualiza automaticamente a cada 2 minutos enquanto aberto.

A maioria das oficinas usa ambos: o Widget para o caso de uso “deixe os clientes encontrarem seu próprio status”, o link do Portal do Cliente para e-mails proativos de “aqui está sua página de rastreamento”.

Dicas e melhores práticas

Incorpore no rodapé ou em uma página dedicada “Rastrear pedido”. Não o enterre no fundo do seu site — o valor está em estar a um clique de distância.
Combine a cor primária com sua marca. O widget deve parecer parte do seu site, não um bloco estranho colocado nele.
Mantenha o título direto. “Rastreie seu pedido” é mais claro que “Utilitário de verificação de status do pedido”. Os clientes escaneiam, não leem.
A descrição define as expectativas. “Digite seu número de pedido e e-mail” diz ao cliente exatamente o que fazer. Pule a cópia de marketing.
Teste a incorporação em vários navegadores. Algumas políticas de segurança de conteúdo restritivas podem bloquear scripts de terceiros — o widget precisa estar em sua lista de permissões se você tiver CSP habilitado.
Desligue durante interrupções planejadas. O widget mostra graciosamente “atualmente indisponível” em vez de lançar erros.
Não compartilhe a chave do widget além do código de incorporação. Embora não seja uma credencial, qualquer pessoa que a use pode solicitar a marca da sua conta.