A tela Personalização fica no menu lateral, no grupo Agente (endereço
/personalizacao). É onde você ajusta a aparência do widget no site: cores, avatar, nome do
agente, formato e posição do balão.
Nada vai para o site do cliente antes de você salvar.
A personalização vale para o site selecionado no alto da tela. Só o dono e os administradores
da conta podem editar (permissão agent:manage). Se a conta ainda não tem site, a tela pede que
você crie o primeiro em Instalação.

Cores
O bloco Cores tem dois campos, cada um com uma amostra clicável (que abre o seletor do sistema) e o hexadecimal editável ao lado:
| Campo | O que pinta |
|---|---|
| Cor primária | O balão, o cabeçalho do painel e os textos de destaque |
| Cor do balão do visitante | O balão das mensagens que o visitante envia |
Só é aceito hexadecimal de seis dígitos, no formato #RRGGBB. Um valor fora disso mostra
"Use uma cor no formato #RRGGBB, como #0052CC." O aviso só aparece depois que o campo perde o
foco, para não acusar um valor ainda pela metade.
Aviso de contraste
Se a cor primária não alcançar o contraste mínimo de 4,5:1 sobre fundo claro, aparece um aviso com a razão medida e um botão Usar a cor ajustada (#…), que troca a cor por uma variação com contraste suficiente. A cor primária também é usada como texto nas pílulas de sugestão do painel — por isso o contraste importa mesmo quando o balão parece legível.
Identidade do agente
- Nome do agente: de 2 a 40 caracteres. É o nome que o visitante vê no topo do painel.
- Fonte: fixa em Padrão do sistema. O widget não carrega fontes externas, para manter o carregamento leve e não mudar o layout do seu site.
- Avatar do agente: clique em Escolher imagem (ou Trocar imagem). Aceita PNG, JPEG ou WebP, até 200 KB. Sem SVG. O botão Remover volta ao ícone padrão.
O arquivo é conferido pelo conteúdo, não pela extensão: uma imagem fora dos três formatos é recusada com "Envie um PNG, JPEG ou WebP válido.", e acima do limite com "A imagem deve ter no máximo 200 KB." — a recusa acontece antes do envio, por maior que seja o arquivo, e nada do que você já editou no formulário se perde. O upload acontece na hora, mas só passa a valer no site depois de você clicar em Salvar.
Widget no site
- Raio dos cantos (px): de 0 a 24. Zero deixa o balão quadrado; 16 é o padrão.
- Posição do balão: Direita ou Esquerda. Mudar o lado só aparece na prévia depois de salvar.
- Remover "Powered by Data Lead": recurso pago (veja abaixo).
A marca "Powered by Data Lead" e o plano
Por padrão o rodapé do painel exibe Powered by Data Lead. A caixa Remover "Powered by Data Lead" só fica disponível nos planos Pro e Full. No plano Grátis ela aparece desabilitada, com um cadeado e a dica "Remover a marca está disponível nos planos Pro e Full."
A regra é conferida no servidor, não só na tela: uma tentativa de remover a marca sem o plano é recusada com a mesma frase. O widget também decide isso no servidor a cada carregamento — uma mudança de plano pode levar até um minuto para refletir no site.
Consulte Planos para ver o que cada plano libera.
Prévia ao vivo
O painel à direita é o widget de verdade — o mesmo arquivo que roda no seu site, montado dentro de um quadro isolado. Cada alteração no formulário repinta a prévia em cerca de 150 milissegundos, sem recarregar nada.
Dois pontos importantes:
- Nenhuma mensagem digitada na prévia é enviada ou salva. O composer responde com uma frase fixa; nenhuma conversa é gravada e nenhum crédito é consumido.
- A posição do balão é a única exceção: trocar entre Direita e Esquerda só aparece na prévia depois de salvar.

Salvar
O botão Salvar grava tudo de uma vez (cores, raio, avatar, nome, posição e marca) e mostra "Personalização salva." Salvar o tema também conta como o passo Personalizar a aparência na lista de primeiros passos da visão geral.
O botão nunca fica apagado por causa de um campo errado — clique nele. Se algo estiver fora da faixa, o clique não envia nada e a mensagem que diz o quê aparece logo abaixo do campo:
| Mensagem | O que fazer |
|---|---|
| Use de 2 a 40 caracteres. | O nome do agente está muito curto ou muito longo. |
| O raio vai de 0 a 24. | O raio dos cantos aceita só esses valores, em pixels. |
| Use uma cor no formato #RRGGBB, como #0052CC. | A cor precisa de seis dígitos hexadecimais. |
Corrigido o campo, a mensagem some sozinha e o próximo clique salva.
Perguntas frequentes
A personalização vale para todos os meus sites? Não. Cores, avatar, nome e posição são por site. Troque o site no seletor do alto da tela para personalizar outro.
Posso usar CSS próprio no widget? Não. O widget aceita apenas os campos desta tela (cores em hexadecimal, raio de 0 a 24, avatar do nosso repositório de imagens). Isso protege o seu site de mudanças de layout e de código de terceiros injetado no visual do assistente.
Posso usar uma imagem hospedada no meu site como avatar? Não. O avatar precisa ser enviado pelo formulário; uma URL externa é recusada com "Envie o avatar pelo formulário". Uma imagem carregada de outro domínio dentro do widget funcionaria como um rastreador embutido no seu site.
Mudei a cor e o site continua igual. Confira se você clicou em Salvar e recarregue a página do site. Cores, avatar, nome e posição valem já no próximo carregamento; só a remoção de "Powered by Data Lead" pode levar até um minuto, porque é o plano que fica em cache.
Veja também
Precisa de ajuda?
Fale com o suporte da Data Stone pelo canal combinado com a sua conta.
Tenha à mão o nome do site e as cores (em #RRGGBB) que você tentou aplicar.