## Visão geral

O **whitelabel** permite substituir a marca padrão pela **sua marca**: nome da instalação,
logotipos, cores de destaque, ícones e domínio próprio. O resultado é uma plataforma que parece
inteiramente sua para a equipe e para os clientes finais.

A configuração de whitelabel é feita em **nível de operador/administração da plataforma** (não é uma
preferência por conta de cliente comum), porque afeta a aparência de toda a instalação.

## Pré-requisitos

- Acesso de **operador/super administração da plataforma** (ou solicitação ao responsável pela
  instalação).
- Os recursos de marca prontos: logotipo claro e escuro, ícone/favicon, paleta de cores.
- Para domínio próprio, o acesso ao DNS do domínio que será usado.

## Passo a passo

1. Acesse o painel de **administração da plataforma** (super admin).
2. Abra a configuração de **marca/whitelabel**.
3. Defina o **nome da instalação** que aparece nos textos e títulos.
4. Faça upload dos **logotipos** (claro/escuro) e do **ícone/favicon**.
5. Ajuste as **cores** de destaque para combinar com a identidade visual.
6. Configure o **domínio próprio** (e o certificado), apontando o DNS conforme as instruções.
7. Salve e valide em uma aba anônima, conferindo logo, cores e título da página.

## Configurações & opções

O painel tem dois nomes independentes: **Nome da instalação** controla o login e os títulos;
**Nome da marca** identifica a marca em e-mails e no widget. Para uma identidade uniforme,
preencha os dois com a mesma grafia. Espaços no nome são permitidos. Nomes personalizados
são preservados quando os arquivos padrão da plataforma são atualizados.

Ativar o recurso **white label** de uma conta oculta a assinatura nas superfícies que o suportam;
isso não preenche os campos de identidade nem troca os logotipos automaticamente. No painel
super admin, configure cada campo e salve. **Remover Powered by** aplica a ocultação à instalação.

O painel não configura DNS, certificados, remetente de e-mail ou a identidade de aplicativos
móveis já distribuídos. As cores atuam nos componentes compatíveis; estilos legados compilados
podem exigir ajuste próprio. Cores e CSS aplicados por scripts dependem de Custom Scripts
habilitado. Conteúdo digitado manualmente e imagens com a marca antiga não são reescritos.
Recarregue as páginas após salvar e confira separadamente login, e-mails, widget e Central de Ajuda.

A identidade de **ConversaLabs** é configurada nos logotipos claro/escuro, no ícone,
nos favicons e nos ícones de instalação. Os arquivos enviados no painel de whitelabel têm
prioridade sobre os padrões: atualizar os arquivos padrão não substitui um upload existente.
Confira as duas versões do logotipo, o login da super administração e o ícone ao recarregar.

- **Nome da instalação**: substitui referências ao produto na interface e nos e-mails.
- **Logotipos e ícone**: aparecem no login, na barra lateral e na aba do navegador.
- **Cores**: alinham a interface à sua identidade.
- **Domínio próprio**: usa a sua URL em vez do domínio padrão.

### Cartão de compartilhamento

Em **Compartilhamento público**, defina uma **Descrição pública** de até 300 caracteres (recomendado: 160), um
**Título de compartilhamento** opcional e, se necessário, a **URL da imagem de compartilhamento**.
Quando o título fica vazio, a plataforma usa o Nome da instalação. Se a descrição pública ficar vazia,
a plataforma mantém a descrição pública padrão, independentemente da configuração do aplicativo instalável. A URL da imagem deve ser HTTPS e
pública; o servidor não baixa nem testa essa imagem. Se ela ficar vazia, o cartão reutiliza o ícone
gerenciado da marca, quando disponível.

A referência recomendada para a imagem é 1200 × 630 px. A prévia no painel confirma os valores que
serão publicados no HTML, mas não confirma quando WhatsApp, redes sociais ou outros serviços vão
renovar seus próprios caches. Valide o HTML publicado e trate a atualização remota do cartão como
uma etapa separada.

## Casos de uso

- Uma agência que entrega a plataforma como **produto próprio** aos clientes.
- Uma empresa que quer a central de atendimento com a **identidade corporativa**.
- Padronizar e-mails e telas de login com a marca da empresa.

## Dicas, limites e boas práticas

- Use logotipos com fundo transparente e versões para temas claro e escuro.
- Teste em telas pequenas: o ícone e o nome também aparecem em dispositivos móveis.
- Após mudar o domínio, confirme que os links (inclusive desta Central de Ajuda) continuam válidos.
- Não coloque dados pessoais, tokens ou links de gestão na descrição, no título ou na URL pública.

## Solução de problemas

- **Não encontro as opções de whitelabel**: elas ficam na administração da plataforma — peça acesso
  ao responsável pela instalação.
- **O logo não atualizou**: limpe o cache do navegador e recarregue; confirme o upload correto.
- **O domínio próprio não abre**: revise o apontamento de DNS e o certificado conforme as
  instruções.

### Ícones do navegador e atualizações

As páginas públicas de pesquisa, pagamento, contrato e widget usam o mesmo ícone de aba do painel.
A Central de Ajuda mantém o logo próprio do portal quando configurado; sem ele, a aba acompanha
o ícone da instalação. O endereço legado `/favicon.ico` redireciona para esse ícone sem cache.
Uma instalação personalizada sem ícone utilizável não recebe o ícone padrão do produto.
São aceitos apenas URLs HTTP(S) e caminhos locais seguros; configuração de marca ilegível não derruba
essas páginas. O visualizador de API permite a origem exata do armazenamento do ícone, sem liberar
outras origens de imagem externas.

Após uma atualização, os scripts de marca gerenciados já existentes recebem o conteúdo produzido
pelas configurações atuais. Scripts desativados continuam desativados, scripts apagados não são
recriados, e o alcance e os incidentes registrados ficam preservados. Conteúdo igual não gera um
novo salvamento. Sem marca configurada para scripts, a atualização não toca nos registros.
Salvar no painel de whitelabel continua sendo a ação explícita para criar ou reativar scripts gerenciados.

## Veja também

- [Custom Scripts: injetar JS/CSS](/hc/ajuda/articles/administration-custom-scripts-pt-br)
- [Visão geral de Administração](/hc/ajuda/articles/administration-overview-pt-br)
- [Conta, agentes e equipes](/hc/ajuda/articles/administration-conta-agentes-equipes-pt-br)
- [Tours guiados (Guided Tours)](/hc/ajuda/articles/administration-guided-tours-pt-br)