> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stchat.app/llms.txt
> Use this file to discover all available pages before exploring further.

# White label passo a passo

> Configure a marca da agência (logo, cores, contato) e o domínio próprio, e veja o que o cliente enxerga.

## Para que serve

Com o white label, o app, o login, os e-mails, os extratos e relatórios em PDF e a página de vendas mostram a marca da agência no lugar da marca do STChat. As organizações usam esta marca.

## Quem pode

Só o Dono e o Admin da agência mudam a marca e o domínio. Os demais veem as telas com os campos travados e sem a barra de salvar.

## Onde clicar

No menu **Marca e conta**: **Marca** (`/white-label`) e **Domínio e e-mails** (`/dominio`).

## Passo a passo

### Marca

**1. Nome e logos**

Em **Nome da marca**, use de 2 a 80 caracteres. Envie **Logo · fundo claro** e, se quiser, **Logo · fundo escuro** (PNG, WebP ou JPEG, até 512 KB, com fundo transparente). Envie o **Ícone da aba**, quadrado: PNG de 64 a 1024 px (512 px é o recomendado) ou ICO, até 512 KB. Sem logo, o cliente vê o nome da marca em texto.

**2. Cores**

Escolha as quatro cores: **Primária** (botões, links e destaques), **Destaque** (selos e itens ativos), **Barra lateral** e **Barra do topo**. Use o formato `#RRGGBB`. Se uma cor tiver pouco contraste, aparece um aviso.

**3. Superfícies do app**

Em **Editar superfícies**, ajuste as 7 cores de fundo, cartões, mensagens e bordas, no claro e no escuro. Salve em **Salvar cores**. **Restaurar padrão** volta ao padrão STChat.

**4. Contato**

Preencha o **E-mail de suporte**. Ele aparece no login, no menu Ajuda e no rodapé dos e-mails e documentos.

**5. Confira e salve**

A prévia tem as abas **App**, **Login**, **E-mail** e **Documento**, no claro e no escuro. Nada vai para os clientes antes de **Salvar alterações**.

### Domínio próprio

**1. Informe o endereço**

Em **Domínio e e-mails**, clique em **Usar meu domínio**. Use um subdomínio, como `app.suaagencia.com.br`. O domínio principal não é aceito.

**2. Crie os registros no DNS**

No seu provedor de DNS, crie os dois registros mostrados, um CNAME e um TXT. Pode levar até 24 horas para valer.

**3. Verifique**

Clique em **Já criei, verificar**. O STChat tenta de novo a cada 5 minutos por 24 horas, e você pode fechar a página. Se algo estiver errado, a tela indica qual registro corrigir.

**4. Certificado**

Com o DNS certo, o certificado HTTPS sai sozinho e renova sozinho. Ao ver "Domínio pronto", clique em **Concluir**.

## O que acontece depois

Os clientes passam a ver a sua marca. O domínio vale para o app de todas as organizações, para formulários, páginas e agenda, e os e-mails de acesso saem com a marca da agência. Enquanto o DNS não verifica, os clientes usam o endereço padrão. Cada agência tem um domínio.

Ao usar **Remover domínio**, tudo volta ao endereço padrão. Quem estiver logado precisa entrar de novo, e links já enviados com o domínio antigo param de funcionar.

## Erros comuns

* "Use o formato #RRGGBB, por exemplo #1F7A4D."
* "Use PNG, WebP ou JPEG (ou ICO no ícone) de até 512 KB."
* "O ícone precisa ser um PNG quadrado de 64 a 1024 px, ou ICO."
* "O nome precisa ter de 2 a 80 letras."
* "Use um subdomínio, não o domínio principal."
* "Esse domínio já está em uso em outra agência."
* "Não encontramos o TXT de verificação." e "O CNAME aponta para outro lugar."
* "Sua agência já tem um domínio. Remova antes de cadastrar outro."

## Próximo passo

* [White label](https://docs.stchat.app/agencias/white-label.md)
* [Primeiros passos da agência](https://docs.stchat.app/agencias/primeiros-passos.md)
* [Hoje e o painel da agência](https://docs.stchat.app/agencias/hoje-e-painel-da-agencia.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.