
# Início Rápido de White-Label

Um caminho focado de seis passos, desde "acabei de atualizar para Agency" até uma plataforma totalmente personalizada com a sua marca, na qual o seu primeiro cliente pode iniciar sessão. Sem complicações, sem definições avançadas — apenas o caminho mais curto entre um painel genérico e um produto que parece *seu*.

Cada passo tem uma estimativa de tempo e uma ligação para a página detalhada, caso pretenda mais informações mais tarde. Reserve cerca de meia hora do seu tempo, mais até uma hora de espera para que o DNS fique ativo em segundo plano. Se encontrar um obstáculo em qualquer passo, avance — pode voltar atrás mais tarde.

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

***

## O que terá no final

- O seu próprio domínio personalizado (por exemplo, `app.youragency.com`) a apontar para a plataforma
- Um certificado de segurança válido (o ícone do cadeado no navegador)
- O nome da sua empresa, logótipo, ícone (favicon), cores e texto SEO a substituir os predefinidos
- Uma decisão clara sobre **como** irá integrar os clientes (gerido vs. revenda)
- Uma subconta de teste com sessão iniciada no seu domínio personalizado

Assim que estiver a funcionar, cada novo cliente obtém automaticamente a mesma experiência personalizada — só precisa de fazer esta configuração uma vez.

***

## Antes de começar

Precisa de ter o plano de subscrição **Agency**. A personalização da marca (white-labeling) não está disponível nos planos inferiores. Se ainda não tem o plano Agency, vá a **Settings → Billing** (em Workspace) e faça a atualização primeiro — a opção **White Labeling** não aparecerá em Settings → Advanced até o fazer.

Também precisará de:

- Um domínio que possua (ou um subdomínio num domínio que possua). A maioria das agências utiliza algo como `app.youragency.com` em vez do `youragency.com` simples, para que o site de marketing e a aplicação permaneçam separados.
- Acesso ao seu registador de domínios (GoDaddy, Cloudflare, Namecheap, etc.) — especificamente, à página de definições de DNS. Se não tiver os dados de início de sessão, obtenha-os antes de começar.
- Dois ficheiros de imagem para a sua marca:
  - **Logótipo** — um logótipo horizontal, PNG, WebP ou SVG, até 5 MB.
  - **Favicon** — um ícone quadrado utilizado como favicon no separador do navegador, PNG, WebP ou SVG, até 5 MB. 256×256 píxeis funciona bem.

***

## Passo 1 — Decida como irá integrar os clientes (≈ 5 min)

Antes de tocar em qualquer definição, tome uma decisão: como é que os clientes vão pagar e inscrever-se? Isto afeta a forma como o resto da jornada é percecionada.

- **Modo gerido (Managed mode).** Cria cada subconta manualmente a partir da página **Sub Accounts**. Fatura o cliente fora da plataforma (transferência bancária, a sua ferramenta de contabilidade, o que já utilizar). O cliente nunca vê uma página de preços. Ideal para configurações feitas por si, países onde o Stripe não opera ou agências com faturação própria.
- **Modo de revenda (Reselling mode).** Os clientes inscrevem-se sozinhos através de uma ligação de pagamento, configurada em **SaaS Mode**. Pagam através da sua conta Stripe ligada, com a sua margem de lucro aplicada automaticamente. Ideal para vendas self-service em escala e pacotes de produtos.

Não tem de se comprometer para sempre — mas mudar uma única subconta entre modos mais tarde requer trabalho manual. Escolha o modelo que melhor se adapta à *maioria* dos seus clientes. Descrição completa: [Gerir Subcontas de Cliente](sub-accounts.md).

***

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

Decida o endereço web exato que os seus clientes utilizarão para iniciar sessão. Algumas regras gerais:

- **Um subdomínio é mais simples.** `app.youragency.com` é o padrão. Mantenha o `youragency.com` para o seu site de marketing — é um único registo DNS, em vez de dois (e mais frágil se mudar de fornecedor de DNS) para um domínio raiz/apex.
- **Mantenha-o curto e óbvio.** `app.`, `platform.`, `dash.` ou `clients.` funcionam todos. Evite nomes criativos que os clientes tenham de memorizar.
- **Pode utilizar até três white labels.** A maioria das agências só precisa de uma, mas pode adicionar até **três** domínios na mesma conta de agência, cada um com o 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 os seus clientes. Domínios extra para 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; consulte [Até Três White Labels](white-labeling.md#up-to-three-white-labels) para adicionar mais.

Anote o domínio escolhido — irá colá-lo no passo seguinte.

***

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

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

Após guardar, o cartão mostrará o registo CNAME que precisa de adicionar no seu registador — o 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 da App e as instruções CNAME para tenants.youraiconnector.com"><figcaption><p>O cartão de domínio personalizado após guardar: o seu domínio, o destino CNAME a copiar e os domínios da app/API/docs assim que forem verificados.</p></figcaption></figure>
:::

**Mantenha este separador aberto** — está prestes a copiar esse valor para o seu registador.

***

## Passo 4 — Adicionar o registo DNS no seu registador (≈ 10 min)

Os registos DNS são a lista telefónica da internet — dizem aos navegadores onde encontrar o seu domínio personalizado. Está agora a dizer ao mundo que o `app.youragency.com` deve apontar para a plataforma.

1. Inicie sessão na empresa onde comprou o seu domínio (o seu "registador" — GoDaddy, Cloudflare, Namecheap, etc.) num **separador do navegador diferente**.
2. Encontre a página de **definições de DNS** para o seu domínio. Por vezes, é chamada de "gestão de DNS" ou "registos DNS".
3. Adicione um registo **CNAME**:
   - **Host / Name** — para um subdomínio como `app.youragency.com`, isto é geralmente apenas `app` na maioria dos registadores (eles adicionam o resto automaticamente).
   - **Value / Target / Points to** — `tenants.youraiconnector.com`, exatamente como mostrado no cartão Custom domain.
   - Deixe o **TTL** no valor predefinido (ou 3600 / 1 hora, se solicitado).
4. Clique no botão **Save** do seu registador.

> **Cuidado com conflitos.** Se já existir um registo do mesmo tipo para esse host (por exemplo, um registo A antigo a apontar para outro local), elimine-o ou atualize-o primeiro — dois registos em conflito impedirão a verificação.

> **Utiliza o Cloudflare?** Pode manter o proxy (o interruptor da nuvem cor de laranja junto ao registo) ligado — a verificação e os certificados funcionam de qualquer forma. No entanto, uma definição é importante: vá a **SSL/TLS → Overview** e certifique-se de que o modo de encriptação é **Full (strict)**, e não **Flexible**. Em Flexible, o seu domínio recusar-se-á a carregar com um erro de "too many redirects".

> **NÃO visite o seu domínio personalizado ainda.** Visitar antes de a configuração estar concluída pode colocar em cache uma página com erro no seu navegador. Aguarde até confirmar que carrega o ecrã de início de sessão no Passo 5.

As alterações de DNS podem demorar desde alguns minutos até algumas horas a propagar-se, embora a maioria dos registadores (especialmente Cloudflare e Namecheap) atualize dentro de uma hora. Se ainda não estiver a resolver após um dia, verifique novamente o registo quanto a erros ortográficos e guarde-o novamente.

***

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

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

- Não precisa de comprar ou instalar nada. O certificado é criado e renovado automaticamente para si, para sempre.
- Este processo demora normalmente entre 5 a 30 minutos após o registo DNS ficar ativo.

Assim que estiver pronto, abra o seu domínio personalizado num novo separador do navegador. Deverá ver o ecrã de início de sessão da plataforma, servido via HTTPS, no 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 início de sessão com marca branca num domínio personalizado, exibindo o nome e o logótipo da agência sem qualquer marca da plataforma"><figcaption><p>O que os seus clientes veem: a página de início de sessão no seu próprio domínio, com o seu nome e logótipo — sem qualquer vestígio nosso.</p></figcaption></figure>
:::

> **Carregue o seu logótipo antes de partilhar a ligação.** Até que um logótipo seja carregado no passo de personalização da marca abaixo, a página de início de sessão apresenta um erro de imagem em falta onde o logótipo deveria estar. Conclua o Passo 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 apresenta um nome de marcador de posição neutro ("DM Champ") e o nosso ícone. Está na hora de corrigir isso. Tudo o que se segue encontra-se no mesmo painel **Settings → Advanced → White Labeling**, nos cartões acima do cartão Custom domain.

### 6a. Marca

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

- **Nome da aplicação** — o nome da marca apresentado em toda a aplicação, em cada e-mail e no atalho do ecrã inicial. Obrigatório: até ser definido, aparece "DM Champ" em vez disso.
- **Nome da empresa** — o seu nome legal/da empresa, utilizado em rodapés e e-mails.
- **E-mail de suporte** — para onde é encaminhado o "Contactar Suporte" e o endereço de resposta nos e-mails do sistema.
- **URL dos termos de serviço** e **URL da política de privacidade** — as suas próprias páginas legais. A página de registo no seu domínio contém ligações para as mesmas; se os deixar vazios, não será apresentada nenhuma ligação (nunca a nossa).
- **Título SEO** e **Descrição SEO** — o que aparece nos separadores do navegador e nos resultados de pesquisa.

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

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

### 6b. Logótipo e favicon

No cartão **Logótipo e Favicon**, clique em **Carregar** em **Logótipo** e escolha o seu logótipo horizontal (PNG/WebP/SVG, até 5 MB). Faça o mesmo para o **Favicon** (quadrado, 256×256 funciona bem). Estes são guardados imediatamente após o carregamento — não existe um botão Guardar separado.

::: master-only
<figure><img src="../.gitbook/assets/v2-whitelabel-logo-favicon.png" alt="O cartão do Logótipo e favicon, mostrando quatro ranhuras de carregamento — Logótipo, Logótipo (modo escuro), Favicon, Ícone da aplicação (quadrado) — e um controlo deslizante de tamanho do Logótipo abaixo, definido para 48 px"><figcaption><p>O cartão de Logótipo e Favicon — quatro ranhuras (Logótipo, logótipo em modo escuro, Favicon, Ícone da aplicação). Cada botão Carregar guarda instantaneamente assim que seleciona um ficheiro. O tamanho do logótipo por baixo define a dimensão de renderização do seu logótipo; essa opção requer que clique em Guardar.</p></figcaption></figure>
:::

### 6c. Cores

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

::: 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 irá utilizar hoje; Sucesso, Perigo e as paletas predefinidas são atalhos opcionais.</p></figcaption></figure>
:::

### 6d. Ajustes posteriores (opcional)

Tipos de letra, densidade e um fundo personalizado para o início de sessão encontram-se mais abaixo no mesmo painel — não são necessários para um white-label funcional, por isso sinta-se à vontade para os ignorar hoje e voltar mais tarde. Referência completa: [White-Labeling e Domínios Personalizados](white-labeling.md).

Após guardar, faça um hard-refresh no seu domínio personalizado (Ctrl+Shift+R no Windows, Cmd+Shift+R no Mac) e confirme que o separador do navegador mostra agora o seu nome e ícone, e que os botões utilizam a sua cor primária.

***

## Passo 7 — Criar uma subconta de teste e iniciar sessão como tal (≈ 10 min)

Não terminou até que uma experiência real de cliente funcione de ponta a ponta. Crie uma subconta para si (utilize um e-mail pessoal que possa verificar) e confirme que o fluxo parece correto.

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

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

2. Clique no botão verde **Adicionar conta**, no canto superior direito.
3. Preencha os seus detalhes de teste através do modal de 3 passos:
   - **Conta** — o seu nome, apelido e um e-mail pessoal que possa consultar.
   - **Empresa** — um nome de empresa (obrigatório); o resto pode ficar em branco para o teste.
   - **Funcionalidades** — mantenha as predefinições.

::: master-only
<figure><img src="../.gitbook/assets/v2-sub-account-add-modal.png" alt="O modal Adicionar subconta no seu passo de Conta, mostrando o progresso de 3 passos (Conta, Negócio, Funcionalidades) com campos para nome, apelido e e-mail"><figcaption><p>O modal Adicionar conta, passo 1 de 3. O e-mail que introduzir aqui torna-se o login do cliente de teste.</p></figcaption></figure>
:::

4. Clique em **Criar Conta**.
5. Um ecrã de confirmação mostra a **palavra-passe gerada**. **Copie-a agora** — não a poderá ver novamente. O cliente também recebe esta informação por e-mail.
6. Abra o e-mail — **verifique se apresenta o seu Nome da Aplicação (Passo 6a) como a marca remetente, e não a nossa**. Se ainda mostrar o nosso nome, a sua marca ainda não foi propagada — aguarde 1 minuto e verifique novamente.
7. Termine a sessão da sua conta de agência (menu de utilizador no canto superior direito → Terminar sessão).
8. Abra o seu domínio personalizado numa **janela de navegação anónima / privada** e inicie sessão com o e-mail da subconta de teste e a palavra-passe copiada.
9. Percorra os primeiros 30 segundos da experiência da subconta:
   - A página de início de sessão mostra o nome e o logótipo da sua marca?
   - O painel de controlo utiliza a sua cor primária?
   - Os títulos das páginas (separador do navegador) utilizam o seu Nome da Aplicação?
   - Se desativou "Mostrar menu de ajuda", confirme que não existe nenhuma entrada de Ajuda na barra lateral.
   - As ligações de Termos / Privacidade (se as tiver adicionado) redirecionam para os seus URLs?

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

***

## E agora?

Tem uma marca branca funcional, ativa e personalizada. O resto é escala e refinamento:

- **Defina o seu preço de revenda.** Se escolheu a revenda no Passo 1, configure a sua margem de crédito e o preço do plano em [Contas de Agência](agency-accounts.md#credit-reselling-aka-saas-mode) antes de enviar a ligação de pagamento a clientes reais. Cada plano pode ser faturado **mensalmente, anualmente ou a cada N semanas** e pode começar com um **período experimental 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 o carregamento automático para clientes.** O [Carregamento Automático de Subcontas](sub-account-auto-recharge.md) evita que os clientes fiquem sem créditos às 2 da manhã.
- **Personalize o remetente do e-mail.** Por predefinição, os e-mails transacionais são enviados a partir do nosso domínio. Ligue o seu próprio domínio de envio na página [Fornecedor de E-mail Personalizado](../settings/email-provider.md) para que os e-mails dos clientes sejam enviados a partir de `noreply@youragency.com`. Existe uma opção Mailgun e uma opção SMTP (Postmark, SES, EmailIt, alojamento próprio).
- **Integre o seu primeiro cliente real.** A [Gestão de Subcontas](sub-accounts.md) abrange o dia-a-dia da gestão de clientes — alocação de créditos, iniciar sessão como cliente, bloquear e desbloquear, etc.

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

***

## Vender: O que fornecemos e o que é seu

Os revendedores pedem-nos material de vendas, estudos de caso, orientações de preços e modelos legais. Eis a divisão honesta.

**O que existe atualmente:**

- **Estudos de caso e manuais** que pode utilizar na sua própria apresentação, publicados em [dmchamp.com/resources](https://dmchamp.com/resources/) — incluindo o [manual de 10 mil dólares de MRR para agências](https://dmchamp.com/resources/agency-10k-mrr-playbook/). São páginas públicas, por isso pode enviar o link a um potencial cliente ou utilizar os números na sua própria apresentação.
- **Uma demonstração que pode realizar perante um potencial cliente** sem tocar na sua própria conta: o **Link de demonstração para clientes** do widget de chat coloca o seu widget sobre o site *deles*. Consulte [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 concluída que pode aplicar a cada nova subconta, para que o seu segundo cliente demore minutos em vez de horas. Esta é a funcionalidade mais próxima de uma oferta de produto que a plataforma lhe oferece.
- **As próprias ferramentas de preços** — os seus próprios planos, os seus próprios preços, o seu próprio checkout, no [Modo SaaS](agency-accounts.md#credit-reselling-aka-saas-mode).

**O que não fornecemos:**

- Apresentações de vendas ou brochuras prontas a usar. A adesão ao [Champions Circle](../billing/champions-circle.md) inclui modelos de website para agências, instantâneos de agentes e análises mensais, e essa é a extensão total do kit de vendas que fornecemos.
- Modelos legais: sem minutas de MSA, SLA ou contratos de cliente. Você é a parte contratante com os seus clientes, por isso esses documentos têm de ser seus e revistos pelo seu próprio advogado.
- Preços de retalho recomendados para o seu mercado. O valor de um cliente em Milão não é o mesmo que em Manila, e um número da nossa parte seria apenas uma suposição sobre o seu mercado.

**Uma regra que se aplica aos seus preços:** os seus Termos de Serviço obrigam-no a não praticar preços inferiores aos preços diretos oficiais da plataforma. Definir preços superiores, incluir o serviço num pacote com os seus serviços ou integrá-lo numa avença é perfeitamente aceitável e é o que a maioria das agências faz.

Se preferir recomendar clientes em vez de gerir a sua própria plataforma, existe também o [programa de afiliados](../billing/affiliate-program.md): 40% de comissão recorrente em cada pagamento de subscrição.

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