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
- Acesse o painel de administração da plataforma (super admin).
- Abra a configuração de marca/whitelabel.
- Defina o nome da instalação que aparece nos textos e títulos.
- Faça upload dos logotipos (claro/escuro) e do ícone/favicon.
- Ajuste as cores de destaque para combinar com a identidade visual.
- Configure o domínio próprio (e o certificado), apontando o DNS conforme as instruções.
- 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.