
# Guia de Início Rápido White-Label

Um caminho focado de seis etapas, desde "acabei de atualizar para o plano Agency" até uma plataforma totalmente personalizada com sua marca, na qual seu primeiro cliente pode fazer login. Sem distrações, sem configurações avançadas — apenas o caminho mais curto entre um painel genérico e um produto que parece *seu*.

Cada etapa tem uma estimativa de tempo e um link para uma página mais detalhada, caso você queira mais informações depois. Reserve cerca de meia hora do seu tempo, além de até uma hora de espera para que o DNS entre em vigor em segundo plano. Se você encontrar um obstáculo em qualquer etapa, pule-a — você pode voltar a ela depois.

::: walkthrough white-label-quickstart
:::

***

## O que você terá ao final

- Seu próprio domínio personalizado (por exemplo, `app.youragency.com`) apontando para a plataforma
- Um certificado de segurança válido (o ícone de cadeado no navegador)
- O nome da sua empresa, logotipo, ícone (favicon), cores e texto de SEO substituindo os padrões
- Uma decisão clara sobre **como** você integrará os clientes (gerenciado vs. revenda)
- Uma subconta de teste logada no seu domínio personalizado

Assim que isso estiver funcionando, cada novo cliente terá a mesma experiência personalizada automaticamente — você só precisa fazer essa configuração uma vez.

***

## Antes de começar

Você precisa estar no nível de assinatura **Agency**. A personalização de marca (White-labeling) não está disponível em níveis inferiores. Se você ainda não está no plano Agency, vá para **Settings → Billing** (em Workspace) e faça o upgrade primeiro — a entrada **White Labeling** não aparecerá em Settings → Advanced até que você faça isso.

Você também precisará de:

- Um domínio que você possui (ou um subdomínio em um domínio que você possui). A maioria das agências usa algo como `app.youragency.com` em vez do `youragency.com` puro, para que o site de marketing e o aplicativo permaneçam separados.
- Acesso ao seu registrador de domínio (GoDaddy, Cloudflare, Namecheap, etc.) — especificamente, à página de configurações de DNS. Se você não tiver o login, obtenha-o antes de começar.
- Dois arquivos de imagem para sua marca:
  - **Logo** — um logotipo horizontal, PNG, WebP ou SVG, de até 5 MB.
  - **Favicon** — um ícone quadrado usado como favicon da aba do navegador, PNG, WebP ou SVG, de até 5 MB. 256×256 pixels funciona bem.

***

## Etapa 1 — Decida como você integrará os clientes (≈ 5 min)

Antes de tocar em qualquer configuração, tome uma decisão: como os clientes pagarão e se inscreverão? Isso afeta como o restante da jornada será percebido.

- **Modo gerenciado.** Você cria cada subconta manualmente na página **Sub Accounts**. Você fatura o cliente fora da plataforma (transferência bancária, sua ferramenta de contabilidade, o que você já usa). O cliente nunca vê uma página de preços. Ideal para configurações feitas por você, países que o Stripe não atende ou agências com faturamento já existente.
- **Modo de revenda.** Os clientes se inscrevem por conta própria através de um link de pagamento, configurado no **SaaS Mode**. Eles pagam através da sua conta Stripe conectada, com sua margem de lucro aplicada automaticamente. Ideal para autoatendimento em escala e pacotes de produtos.

Você não precisa se comprometer para sempre — mas alternar uma única subconta entre os modos mais tarde requer trabalho manual. Escolha o modelo que atende à *maioria* dos seus clientes. Detalhamento completo: [Gerenciando Subcontas de Clientes](sub-accounts.md).

***

## Etapa 2 — Escolha seu domínio personalizado (≈ 2 min)

Decida o endereço da web exato que seus clientes usarão para fazer login. Algumas regras práticas:

- **Um subdomínio é mais simples.** `app.youragency.com` é o padrão. Mantenha `youragency.com` para o seu site de marketing — é um único registro DNS, em vez de dois (e mais frágil se você mudar de provedor de DNS) para um domínio raiz/apex.
- **Mantenha curto e óbvio.** `app.`, `platform.`, `dash.` ou `clients.` funcionam bem. Evite nomes criativos que os clientes precisem memorizar.
- **Você pode executar até três white labels.** A maioria das agências só precisa de uma, mas você pode adicionar até **três** domínios na mesma conta de agência, cada um com seu próprio domínio, marca e envio de e-mail — uma segunda marca para um mercado diferente ou um domínio de Lead Finder para seus clientes. Domínios extras além do primeiro vêm com o [Champions Circle](../billing/champions-circle.md). Este guia de início rápido configura o seu primeiro; veja [Até Três White Labels](white-labeling.md#up-to-three-white-labels) para adicionar mais.

Anote o domínio escolhido — você o colará na próxima etapa.

***

## Passo 3 — Adicione o domínio no seu painel (≈ 2 min)

1. Na barra lateral principal, clique em **Settings** (perto da parte inferior, abaixo de Sub Accounts).
2. No menu Settings, role até o grupo **Advanced** e clique em **White Labeling**.
3. Role até o cartão **Custom domain**.
4. No campo **App domain**, digite o domínio que você escolheu na Etapa 2 (por exemplo, `app.youragency.com`). Não inclua `https://` ou uma barra ao final — apenas o domínio em si.
5. Clique em **Save**.

Após salvar, o cartão mostrará o registro CNAME que você precisa adicionar no seu registrador — seu domínio à esquerda, `tenants.youraiconnector.com` à direita.

::: master-only
<figure><img src="../.gitbook/assets/v2-whitelabel-domains.png" alt="O cartão de domínio personalizado na v2, mostrando o campo de domínio do App e as instruções CNAME para tenants.youraiconnector.com"><figcaption><p>O cartão de domínio personalizado após salvar: seu domínio, o destino CNAME para copiar e os domínios de app/API/docs assim que forem verificados.</p></figcaption></figure>
:::

**Mantenha esta aba aberta** — você está prestes a copiar esse valor para o seu registrador.

***

## Etapa 4 — Adicione o registro DNS no seu registrador (≈ 10 min)

Registros DNS são a agenda de endereços da internet — eles dizem aos navegadores onde encontrar seu domínio personalizado. Agora você está dizendo ao mundo que `app.youragency.com` deve apontar para a plataforma.

1. Faça login na empresa onde você comprou seu domínio (seu "registrador" — GoDaddy, Cloudflare, Namecheap, etc.) em uma **aba de navegador separada**.
2. Encontre a página de **configurações de DNS** para o seu domínio. Às vezes, é chamada de "gerenciamento de DNS" ou "registros DNS".
3. Adicione um registro **CNAME**:
   - **Host / Nome** — para um subdomínio como `app.youragency.com`, isso geralmente é apenas `app` na maioria dos registradores (eles adicionam o restante automaticamente).
   - **Valor / Destino / Aponta para** — `tenants.youraiconnector.com`, exatamente como mostrado no cartão Custom domain.
   - Deixe o **TTL** no padrão (ou 3600 / 1 hora, se solicitado).
4. Clique no botão **Save** do seu registrador.

> **Cuidado com conflitos.** Se um registro do mesmo tipo já existir para esse host (por exemplo, um registro A antigo apontando para outro lugar), exclua-o ou atualize-o primeiro — dois registros conflitantes impedirão a verificação.

> **Está usando o Cloudflare?** Você pode deixar o proxy (o botão da nuvem laranja ao lado do registro) ativado — a verificação e os certificados funcionam de qualquer maneira. No entanto, uma configuração é importante: vá para **SSL/TLS → Overview** e certifique-se de que o modo de criptografia esteja como **Full (strict)**, e não **Flexible**. No modo Flexible, seu domínio se recusará a carregar com um erro de "too many redirects".

> **NÃO visite seu domínio personalizado ainda.** Visitar antes que a configuração esteja concluída pode armazenar uma página com erro em cache no seu navegador. Aguarde até confirmar que ele carrega a tela de login na Etapa 5.

As alterações de DNS podem levar de alguns minutos a algumas horas para se propagarem, embora a maioria dos registradores (especialmente Cloudflare e Namecheap) atualize dentro de uma hora. Se ainda não estiver resolvendo após um dia, verifique novamente o registro em busca de erros de digitação e salve-o novamente.

***

## Passo 5 — Aguarde o certificado de segurança (≈ alguns minutos a uma hora, automático)

Assim que seu CNAME estiver ativo, a plataforma o detecta automaticamente, verifica a propriedade e provisiona um certificado de segurança (SSL) para seu domínio — é isso que lhe dá o ícone de cadeado no navegador e o prefixo `https://`.

- Você não precisa comprar ou instalar nada. O certificado é criado e renovado para você para sempre.
- Isso geralmente é concluído entre 5 a 30 minutos após o registro DNS entrar no ar.

Assim que estiver pronto, abra seu domínio personalizado em uma nova aba do navegador. Você deverá ver a tela de login da plataforma, servida via HTTPS, em seu próprio endereço web. A parte técnica está concluída.

::: master-only
<figure><img src="../.gitbook/assets/tenant-login.png" alt="Uma página de login com marca própria em um domínio personalizado, exibindo o nome e o logotipo da agência sem a marca da plataforma"><figcaption><p>O que seus clientes veem: a página de login em seu próprio domínio, com seu nome e logotipo — sem nenhum vestígio nosso.</p></figcaption></figure>
:::

> **Faça o upload do seu logotipo antes de compartilhar o link.** Até que um logotipo seja enviado na etapa de branding abaixo, a página de login exibirá um erro de imagem quebrada onde o logotipo deveria estar. Conclua a Etapa 6 antes de mostrar o domínio a qualquer pessoa.

***

## Passo 6 — Personalize a plataforma (≈ 15 min)

O domínio está ativo, mas a plataforma ainda mostra um nome de espaço reservado neutro ("DM Champ") e nosso ícone. É hora de corrigir isso. Tudo abaixo está no mesmo painel **Configurações → Avançado → White Labeling**, nos cartões acima do cartão de domínio personalizado.

### 6a. Marca

No cartão **Marca**, preencha:

- **Nome do aplicativo** — o nome da marca exibido em todo o aplicativo, em cada e-mail e no atalho da tela inicial. Obrigatório: até que seja definido, eles exibem "DM Champ" em vez disso.
- **Nome da empresa** — seu nome legal/da empresa, usado em rodapés e e-mails.
- **E-mail de suporte** — para onde "Contatar suporte" é direcionado e o endereço de resposta em e-mails do sistema.
- **URL dos termos de serviço** e **URL da política de privacidade** — suas próprias páginas legais. A página de inscrição no seu domínio vincula-se a elas; deixe-as vazias e nenhum link será exibido (nunca o nosso).
- **Título de SEO** e **Descrição de SEO** — o que aparece nas abas do navegador e nos resultados de pesquisa.

Clique em **Salvar** no cartão Marca.

::: master-only
<figure><img src="../.gitbook/assets/v2-whitelabel-settings.png" alt="O cartão Marca no painel de configurações de White Label, com os campos Nome do aplicativo, Nome da empresa, E-mail de suporte, URL dos termos de serviço, URL da política de privacidade, Título de SEO e Descrição de SEO e um botão Salvar no cabeçalho do cartão"><figcaption><p>O cartão Marca — Nome do aplicativo, Nome da empresa, E-mail de suporte, URL dos termos de serviço, URL da política de privacidade, Título de SEO e Descrição de SEO, tudo em um único Salvar.</p></figcaption></figure>
:::

### 6b. Logotipo e favicon

No cartão **Logotipo e Favicon**, clique em **Upload** em **Logotipo** e escolha seu logotipo horizontal (PNG/WebP/SVG, até 5 MB). Faça o mesmo para o **Favicon** (quadrado, 256×256 funciona bem). Eles são salvos imediatamente após o upload — não há um botão Salvar separado.

::: master-only
<figure><img src="../.gitbook/assets/v2-whitelabel-logo-favicon.png" alt="O cartão de Logotipo e favicon, mostrando quatro slots de upload — Logotipo, Logotipo (modo escuro), Favicon, Ícone do aplicativo (quadrado) — e um controle deslizante de tamanho do logotipo abaixo deles definido para 48 px"><figcaption><p>O cartão de Logotipo e Favicon — quatro slots (Logotipo, logotipo em modo escuro, Favicon, Ícone do aplicativo). Cada botão de Upload salva instantaneamente assim que você escolhe um arquivo. O tamanho do logotipo abaixo define o tamanho da renderização do seu logotipo; esse precisa ser salvo.</p></figcaption></figure>
:::

### 6c. Cores

No cartão **Cores**, clique no quadrado **Cor primária** e defina a cor principal da sua marca (o padrão é o verde do WhatsApp, `#25D366`), depois faça o mesmo para a **Cor de destaque**. Clique em **Salvar**.

::: master-only
<figure><img src="../.gitbook/assets/v2-whitelabel-colours.png" alt="O cartão de Cores na v2, mostrando amostras de cor Primária, cor de Destaque, Sucesso e Perigo, além de seis paletas predefinidas"><figcaption><p>O cartão de Cores — Primária e Destaque são as duas que você usará hoje; Sucesso, Perigo e as paletas predefinidas são atalhos opcionais.</p></figcaption></figure>
:::

### 6d. Ajustes finos posteriormente (opcional)

Fontes, densidade e um plano de fundo de login personalizado ficam mais abaixo no mesmo painel — eles não são necessários para um white-label funcional, então sinta-se à vontade para ignorá-los hoje e voltar mais tarde. Referência completa: [White-Labeling e domínios personalizados](white-labeling.md).

Após salvar, faça uma atualização forçada (hard-refresh) no seu domínio personalizado (Ctrl+Shift+R no Windows, Cmd+Shift+R no Mac) e confirme se a aba do navegador agora mostra seu nome e ícone, e se os botões usam sua cor primária.

***

## Passo 7 — Crie uma subconta de teste e faça login como ela (≈ 10 min)

Você não terminou até que uma experiência real de cliente funcione de ponta a ponta. Crie uma subconta para você mesmo (use um e-mail pessoal que você possa verificar) e confirme se o fluxo parece correto.

1. Na barra lateral principal, clique em **Subcontas** (sua própria página, logo acima de Configurações).

::: master-only
<figure><img src="../.gitbook/assets/v2-sub-accounts.png" alt="A página de Subcontas na v2, mostrando os blocos de estatísticas, barra de pesquisa e o botão Adicionar conta"><figcaption><p>A página de Subcontas — é aqui que você criará a conta de teste e, posteriormente, cada cliente real.</p></figcaption></figure>
:::

2. Clique no botão verde **Adicionar conta**, no canto superior direito.
3. Preencha seus detalhes de teste no modal de 3 etapas:
   - **Conta** — seu primeiro nome, sobrenome e um e-mail pessoal que você possa verificar.
   - **Empresa** — um nome de empresa (obrigatório); o restante pode ficar em branco para o teste.
   - **Recursos** — mantenha os padrões.

::: master-only
<figure><img src="../.gitbook/assets/v2-sub-account-add-modal.png" alt="O modal Adicionar subconta em sua etapa de Conta, mostrando o progresso de 3 etapas (Conta, Negócio, Recursos) com campos de nome, sobrenome e e-mail"><figcaption><p>O modal Adicionar conta, etapa 1 de 3. O e-mail que você inserir aqui se tornará o login do cliente de teste.</p></figcaption></figure>
:::

4. Clique em **Criar conta**.
5. Uma tela de confirmação mostra a **senha gerada**. **Copie-a agora** — você não poderá vê-la novamente. O cliente também recebe isso por e-mail.
6. Abra o e-mail — **verifique se ele mostra o seu Nome do App (Etapa 6a) como a marca remetente, não a nossa**. Se ainda mostrar nosso nome, sua marca ainda não foi propagada — aguarde 1 minuto e verifique novamente.
7. Saia da sua conta de agência (menu do usuário no canto superior direito → Sair).
8. Abra seu domínio personalizado em uma **janela anônima / de navegação privada** e faça login com o e-mail da subconta de teste e a senha copiada.
9. Percorra os primeiros 30 segundos da experiência da subconta:
   - A página de login mostra o nome e o logotipo da sua marca?
   - O chrome do painel usa sua cor primária?
   - Os títulos das páginas (aba do navegador) usam o seu Nome do App?
   - Se você desativou "Mostrar menu de ajuda", confirme se não há entrada de Ajuda na barra lateral.
   - Os links de Termos / Privacidade (se você os adicionou) levam para as suas URLs?

Se algo ainda estiver mostrando o nome ou a cor errada, volte ao Passo 6 e corrija. Guia completo para o fluxo de subconta: [Gerenciamento de Subcontas](sub-accounts.md).

***

## E agora?

Você tem um white-label funcional, ativo e com sua marca. O restante é escala e refinamento:

- **Defina seu preço de revenda.** Se você escolheu revenda no Passo 1, configure sua margem de lucro sobre créditos e o preço do plano em [Contas de Agência](agency-accounts.md#credit-reselling-aka-saas-mode) antes de enviar o link de pagamento para clientes reais. Cada plano pode ser cobrado **mensalmente, anualmente ou a cada N semanas** e pode começar com um **teste gratuito** — ambos são definidos no próprio plano em [Passo 3 — Configurar níveis de preços](agency-accounts.md#step-3--set-up-pricing-tiers).
- **Configure a recarga automática para clientes.** A [Recarga Automática de Subconta](sub-account-auto-recharge.md) evita que os clientes fiquem sem créditos às 2 da manhã.
- **Personalize o remetente de e-mail.** Por padrão, os e-mails transacionais vêm do nosso domínio. Conecte seu próprio domínio de envio na página [Provedor de E-mail Personalizado](../settings/email-provider.md) para que os e-mails dos clientes venham de `noreply@youragency.com` em vez disso. Existe uma opção Mailgun e uma opção SMTP (Postmark, SES, EmailIt, auto-hospedado).
- **Integre seu primeiro cliente real.** O [Gerenciamento de Subconta](sub-accounts.md) cobre o dia a dia da operação dos clientes — alocação de crédito, login como cliente, bloqueio e desbloqueio, etc.

Se algo neste guia não funcionou como esperado, a página [White-Labeling and Custom Domains](white-labeling.md) possui a seção completa de solução de problemas.

***

## Vendendo: O que nós fornecemos e o que é seu

Revendedores nos pedem materiais de vendas, estudos de caso, orientações de preços e modelos jurídicos. Aqui está a divisão honesta.

**O que existe hoje:**

- **Estudos de caso e playbooks** que você pode usar em seu próprio pitch, publicados em [dmchamp.com/resources](https://dmchamp.com/resources/) — incluindo o [playbook de $10 mil de MRR para agências](https://dmchamp.com/resources/agency-10k-mrr-playbook/). São páginas públicas, então você pode enviar o link para um potencial cliente ou extrair os números para sua própria apresentação.
- **Uma demonstração que você pode executar na frente de um potencial cliente** sem tocar em sua própria conta: o **Link de demonstração do cliente** do widget de chat coloca seu widget sobre o site *deles*. Veja [Mostrar o Widget no Site de Outra Pessoa](../get-started/chat-widget.md#show-the-widget-on-someone-elses-website).
- **[Snapshots](snapshots.md)** — uma configuração de cliente finalizada que você pode aplicar a cada nova subconta, para que seu segundo cliente leve minutos em vez de horas. Esta é a coisa mais próxima de uma oferta de produto que a plataforma lhe oferece.
- **As próprias ferramentas de precificação** — seus próprios planos, seus próprios preços, seu próprio checkout, no [Modo SaaS](agency-accounts.md#credit-reselling-aka-saas-mode).

**O que nós não fornecemos:**

- Apresentações de vendas ou folhetos prontos. A assinatura do [Champions Circle](../billing/champions-circle.md) inclui modelos de site de agência prontos, snapshots de agentes e as análises mensais, e essa é a extensão total do kit de vendas que fornecemos.
- Modelos jurídicos: sem modelos de MSA, SLA ou contrato com o cliente. Você é a parte contratante com seus clientes, portanto, eles devem ser seus e revisados pelo seu próprio advogado.
- Preços de varejo recomendados para o seu mercado. O valor de um cliente em Milão não é o mesmo que em Manila, e um número fornecido por nós seria apenas um palpite sobre o seu mercado.

**Uma regra que se aplica à sua precificação:** seus Termos de Serviço o comprometem a não praticar preços inferiores aos preços diretos oficiais da plataforma. Precificar acima disso, incluir em pacotes com seus serviços ou incorporar em um contrato de retenção é perfeitamente aceitável e é o que a maioria das agências faz.

Se você preferir indicar clientes em vez de administrar sua própria plataforma, também existe o [programa de afiliados](../billing/affiliate-program.md): 40% de comissão recorrente em cada pagamento de assinatura.

Bem-vindo à operação da sua própria plataforma.
