
# Gerenciamento de Subcontas

## Visão geral

Subcontas são contas de clientes individuais gerenciadas sob sua agência. Cada subconta opera como uma conta totalmente funcional com suas próprias campanhas, contatos, chats e configurações — enquanto você mantém a supervisão e o controle a partir do seu painel da agência.

::: walkthrough sub-accounts
:::

> **Quem pode gerenciar subcontas?** O proprietário da agência sempre pode. Membros da equipe também podem, desde que tenham alternado para a conta da agência (usando o controle **Alternar conta** na parte superior da barra lateral). Por padrão, isso significa membros com acesso de Gerenciamento de Equipe — a função de Administrador ou uma substituição personalizada que a conceda; outros membros não veem a página **Subcontas**. Você também pode conceder a um membro específico acesso a algumas ou a todas as suas contas de cliente sem torná-lo um Administrador — veja [Concedendo acesso de membros da equipe a contas de cliente](#giving-team-members-access-to-client-accounts).

---

## Onde encontrar as Subcontas

Clique em **Subcontas** na barra lateral principal — ela fica sozinha, logo acima de **Configurações**, perto da parte inferior do menu. Não é necessário abri-la dentro de Configurações, e ela só fica visível em contas com a função de agência.

::: master-only
<figure><img src="../.gitbook/assets/v2-sub-accounts.png" alt="A página de Subcontas na v2, mostrando os seis blocos de estatísticas (Subcontas, Com problemas, Campanhas ativas, Campanhas pausadas, Alocado para clientes, Não alocado), a barra de pesquisa e uma linha de cliente na tabela"><figcaption><p>A página de Subcontas: blocos de estatísticas no topo (os dois à direita dividem seu pool de créditos entre o que os limites dos clientes já reivindicam e o que ainda está livre), um botão <strong>Adicionar conta</strong> e um atalho para o <strong>Modo SaaS</strong>.</p></figcaption></figure>
:::

No topo da página, você encontrará seis blocos de estatísticas — **Subcontas** (com sua franquia do plano abaixo), **Com problemas**, **Campanhas ativas**, **Campanhas pausadas**, **Alocado para clientes** e **Não alocado** (os dois últimos são seu pool de créditos dividido entre o que os limites de gastos dos seus clientes já reivindicam e o que ainda está livre — veja [Quanto do meu pool está comprometido?](#how-much-of-my-pool-is-spoken-for)) — uma caixa de pesquisa (**Pesquisar conta por nome ou e-mail…**) e dois botões à direita: um botão que leva diretamente ao **Modo SaaS** (veja [Contas de Agência](agency-accounts.md#credit-reselling-aka-saas-mode)) e o botão verde **Adicionar conta**.

---

## Duas maneiras de integrar uma subconta

Antes de criar sua primeira subconta, decida qual modelo de integração se adapta ao relacionamento. Existem dois modos distintos, e eles se comportam de maneira muito diferente posteriormente:

### Modo gerenciado

Você cria a subconta diretamente na página de Subcontas, define o limite de crédito mensal e compartilha uma senha temporária com o cliente. O faturamento ocorre fora da plataforma — você fatura o cliente por meio da sua configuração de faturamento existente (transferência bancária, sua própria ferramenta de contabilidade, o que você já usa). O cliente nunca vê um seletor de planos ou uma página de pagamento na plataforma.

**Bom para:**

- Agências em países que o Stripe não atende.
- Agências com infraestrutura de faturamento existente que desejam continuar usando.
- Configurações "prontas para uso" onde o cliente nunca deve se preocupar com a seleção de planos ou recargas.

### Modo de revenda

Conectado ao Stripe, via **Modo SaaS**. O cliente se inscreve por conta própria através de um link de pagamento, paga via sua conta Stripe conectada (com sua margem de lucro aplicada automaticamente) e é direcionado diretamente para o onboarding assim que o pagamento é processado. Você não precisa intervir em cada nova inscrição. Os planos podem ser cobrados mensal ou anualmente e, se o plano oferecer um teste gratuito, o cliente começa sem pagar nada e é cobrado automaticamente quando o teste termina — veja [Executando um teste gratuito](#running-a-free-trial).

**Bom para:**

- Autoatendimento em escala.
- Pacotes de produtos onde cada cliente recebe a mesma oferta.
- Estratégias de SaaS com marca própria (white-label) onde a experiência do cliente deve parecer um produto independente.

> **Escolha o modo certo desde o início.** Mudar uma subconta de um modo para o outro posteriormente requer intervenção manual sua — não é um botão que o cliente pode alternar. Um minuto de reflexão agora economiza um ticket de suporte depois.

### Executando um teste gratuito

A maneira mais simples de executar um teste é colocar um no próprio plano. Cada plano em **SaaS Mode → Pricing Tiers** possui um campo **Free trial (days)** — qualquer valor de 1 a 90, ou 0 para nenhum teste — e um valor de **Trial credits** que assume como padrão os créditos mensais do plano.

Uma vez que um plano possui um teste, todo o processo é self-service e você não precisa intervir:

1. **O cliente se inscreve através do seu link de pagamento ou checkout incorporado** e escolhe o plano. O checkout exibe como *"Teste gratuito de X dias, depois $…"* com um botão **Iniciar teste gratuito**.
2. **Não é feita nenhuma cobrança.** A subconta é criada, eles recebem os créditos de teste no primeiro dia e podem usar o plano imediatamente. Por padrão, o checkout ainda solicita o cartão (nada é cobrado ainda); desative **Exigir cartão para iniciar teste** no plano e isso ignora o cartão completamente — o cliente começa apenas com um e-mail.
3. **Quando o teste termina, o Stripe cobra o preço do plano automaticamente** e o cliente passa a ter a franquia mensal completa de créditos a partir de então. Nada precisa ser alterado manualmente. Em um teste sem cartão, isso só acontece se o cliente tiver adicionado um cartão até lá; caso contrário, o plano termina, a subconta é marcada como cancelada e nenhum crédito adicional é concedido (eles mantêm o que restou dos créditos de teste, a menos que o plano esteja com **Expiração rígida após o teste** ativada — veja abaixo).

Algumas coisas que vale a pena saber antes de definir o número:

- **Os créditos de teste saem do seu pool de agência**, exatamente como qualquer outro crédito de plano. Um teste que você promove amplamente tem um custo real — defina o valor deliberadamente em vez de deixá-lo na franquia mensal completa.
- **Um teste é para novas inscrições.** Uma inscrição através do seu link de pagamento ou checkout incorporado aplica o teste conforme configurado no plano. Uma subconta que já existe — uma que você mesmo criou na página de Subcontas, uma que já teve uma assinatura com você ou uma que já usou um teste — é cobrada imediatamente quando assina a partir de sua própria página **Configurações → Faturamento**; não há um segundo teste.
- **Cancelar durante o teste não custa nada ao cliente.** Eles nunca são cobrados e mantêm quaisquer créditos de teste que ainda estejam na conta — a menos que o plano tenha a expiração rígida ativada, caso em que os não utilizados retornam ao seu pool quando o teste termina (veja o próximo ponto).
- **Você escolhe o que acontece com os créditos de teste não utilizados.** Por padrão, um teste que termina sem um upgrade deixa o cliente cancelado, mas ainda mantendo quaisquer créditos de teste restantes, para que sua IA continue respondendo até que eles acabem. Ative **Expiração rígida após o teste** no plano (fica ao lado de **Exigir cartão para iniciar o teste**) e o oposto acontece: os créditos de teste não utilizados retornam ao seu pool de agência no momento em que o teste termina, e a conta do cliente é bloqueada — o envio e as respostas da IA param, e eles veem *"Seu teste gratuito terminou. Entre em contato com seu provedor para continuar."* Apenas o que eles não gastaram retorna. Qualquer número de telefone que o cliente alugou através da plataforma durante o teste é liberado no mesmo momento, portanto, seu aluguel mensal para — o cliente e você são notificados por e-mail sobre isso, e um número liberado não pode ser recuperado (veja [Números de Telefone de um Cliente](#a-clients-phone-numbers)). Comprar qualquer plano desbloqueia a conta automaticamente, e você pode remover ou alterar o bloqueio por conta própria no modal **Editar** da subconta (veja [Bloqueando / Pausando uma Subconta](#blocking-pausing-a-sub-account)). Defina isso por plano em [Passo 3 — Configurar níveis de preços](agency-accounts.md#step-3--set-up-pricing-tiers).
- **Em um plano com preço de teste ou barato, limite o que é transferido.** Um cliente que mal usa o produto ainda recebe sua franquia todos os meses e, com a transferência, ela se acumula contra seu pool indefinidamente. Defina **Manter no máximo** ou **Expirar créditos não utilizados após** no plano (ou naquele cliente específico) para que o saldo não saia do controle — veja [Limitando o que é transferido](#capping-what-rolls-over).
- Uma vez que eles estejam pagando, a lista de recursos do plano torna-se autoritativa: quaisquer recursos extras que você concedeu manualmente durante o teste são redefinidos para a lista do plano na próxima renovação.

#### O teste executado manualmente (gerenciado → revenda)

Se você preferir gerenciar o teste por conta própria — para dar a um cliente em potencial um período mais longo ou uma quantidade diferente de créditos — você ainda pode fazer isso combinando os dois modos. Nada expira automaticamente aqui; você decide quando o teste termina.

1. **Crie a subconta você mesmo** a partir da página de Subcontas. Nenhum pagamento é envolvido; ela começa no modo manual, gastando do seu pool da agência dentro do limite de gastos e da franquia que você definir.
2. **Quando decidir que o período de teste acabou**, abra o modal **Editar** da subconta e altere o **Gerenciamento de Crédito** para **revenda**.
3. **Peça para o cliente assinar** — ele pode escolher um plano diretamente na própria página **Configurações → Faturamento** (veja [O que o cliente vê na página de Faturamento](#what-the-client-sees-on-their-billing-page)), ou você pode enviar seu link de pagamento (ou incorporar o checkout) a partir de **Modo SaaS → Pagamentos**.

Duas coisas precisam acontecer na ordem correta:

> **Alterne a conta para revenda _antes_ que o cliente pague.** Um pagamento feito através do seu checkout enquanto a subconta ainda está no modo manual não pode ser processado — a plataforma não concederá créditos a uma conta em modo manual, e nada é reembolsado automaticamente. Alterne o modo primeiro, depois envie o link.

- **O cliente deve pagar com o mesmo endereço de e-mail que sua subconta de avaliação utiliza.** Mesmo e-mail = a assinatura atualiza aquela conta existente, e eles mantêm seus canais, contatos e histórico de chat. Um e-mail diferente cria uma subconta nova e vazia. (Um e-mail que pertença a uma conta fora da sua agência é recusado e reembolsado automaticamente.)

Uma coisa a planejar: o teste integrado em um plano é apenas para novas inscrições através do seu link de pagamento ou checkout. Uma subconta que você mesmo criou nunca recebe o teste gratuito do plano quando assina a partir de sua página de Faturamento — ela já teve seu teste executado manualmente — portanto, é cobrada imediatamente. Se um cliente de teste manual demorar para assinar, você pode [bloquear a subconta](#blocking-pausing-a-sub-account) com uma mensagem de bloqueio personalizada até que ele escolha um plano.

---

## Criando uma subconta

Clique no botão verde **Adicionar conta** (canto superior direito da página de Subcontas — ou **Criar subconta** no estado vazio, caso ainda não tenha nenhuma). Um modal de 3 etapas será aberto:

::: master-only
<figure><img src="../.gitbook/assets/v2-sub-account-add-modal.png" alt="O modal Adicionar subconta na etapa Conta, mostrando o progresso de 3 etapas (Conta, Negócio, Recursos) com campos para nome, sobrenome e e-mail"><figcaption><p>O modal Adicionar subconta. Três etapas: Conta → Negócio → Recursos. O e-mail que você insere torna-se o endereço de login do cliente.</p></figcaption></figure>
:::

### Etapa 1 — Conta

- **Nome** e **Sobrenome**.
- **Endereço de e-mail** — este se tornará o e-mail de login da subconta.

Clique em **Continuar**.

### Passo 2 — Empresa

::: master-only
<figure><img src="../.gitbook/assets/v2-sub-account-add-modal-business.png" alt="O modal Adicionar subconta na etapa Negócio, mostrando nome da empresa, descrição, preenchimento automático de endereço, cidade/estado/CEP, seletor de país, idioma e fuso horário"><figcaption><p>A etapa Negócio: o preenchimento automático de endereço preenche a cidade, estado, CEP e país para você; todos os campos permanecem editáveis manualmente.</p></figcaption></figure>
:::

- **Nome da empresa** (obrigatório).
- **Descrição** (opcional).
- **Endereço** — comece a digitar e escolha entre as sugestões de preenchimento automático; cidade, estado, código postal e país são preenchidos automaticamente. Todos os campos ainda podem ser editados manualmente.
- **País** (obrigatório) — lista pesquisável com bandeiras; isso define a moeda e os padrões da conta.
- **Idioma** e **Fuso horário** da conta.

Clique em **Continuar**.

### Passo 3 — Recursos

::: master-only
<figure><img src="../.gitbook/assets/v2-sub-account-add-modal-features.png" alt="O modal Adicionar subconta em sua etapa de Recursos, mostrando o seletor de limite de canais e o grupo de Tipos de Canal com alternadores por canal"><figcaption><p>A etapa de Recursos, no topo: o seletor de limite de canais e os alternadores de Tipos de Canal. Rolar para baixo revela compreensão de IA, recursos de IA e Contatos e Agentes de IA. A maioria dos padrões começa ativada.</p></figcaption></figure>
:::

- Um editor de recursos categoria por categoria — o mesmo conjunto de recursos que os seus próprios níveis de plano usam (canais, contatos e agentes de IA, compreensão de IA, recursos de desenvolvedor, tamanho de contexto do agente de IA, assentos de equipe e assim por diante). Cada subconta começa com um pacote padrão sensato já ativado; desative qualquer coisa que você não queira que este cliente tenha. O grupo **Contatos e Agentes de IA** também contém o **limite de Agentes de IA** da conta — um número em vez de uma alternância: deixe como **Não definido**, escolha **Ilimitado** ou insira o número exato de agentes de IA que este cliente pode ter. Um limite definido aqui conta como uma substituição manual, portanto, ele persiste após a renovação do plano.
- O grupo **Canais** contém o **limite de Canais** da conta — um número, como o limite de Agentes de IA: quantos canais de mensagens este cliente pode ter **conectados ao mesmo tempo**. Ele começa em **1** para uma nova subconta; escolha **Ilimitado** ou insira qualquer contagem exata (incluindo **0**, para clientes cujos canais você gerencia inteiramente por conta própria). O limite controla *quantos*, não *quais* — um cliente limitado a um canal ainda vê o menu completo de canais e escolhe qual conectar. Ele conta **conexões**, não tipos de canal: cada número do WhatsApp é um slot próprio, enquanto o Instagram e o Messenger compartilham o único slot da conexão da página Meta deles. Quando atingem o limite, conectar outro canal exibe uma mensagem clara indicando o limite; reconectar um canal que eles já possuem (digitalizar novamente um QR code do WhatsApp, por exemplo) nunca é bloqueado. Um limite definido aqui conta como uma substituição manual, portanto, ele persiste após a renovação do plano.
- O grupo **Tipos de Canal** nessa lista decide quais canais de mensagens este cliente pode conectar — Chat Widget, WhatsApp Business API, WhatsApp Web, Instagram, Facebook Messenger, Telegram, LINE, Viber, E-mail, SMS e iMessage. Os tipos de canal são ativados por padrão, a menos que você desative alguns; um canal desativado aparece como bloqueado na página de Canais do cliente com uma observação para atualizar o plano dele.

::: master-only
<figure><img src="../.gitbook/assets/v2-sub-account-add-modal-features-2.png" alt="A parte inferior da etapa Recursos, mostrando os alternadores de Resumos Diários e Biblioteca de Mídia, o seletor de limite de Agente de IA, os alternadores de Desenvolvedor, seletores de Contexto de Agente de IA e nível de Equipe, o alternador Enviar informações da conta para a subconta e o alternador Assistente de configuração guiada acima do botão Criar conta"><figcaption><p>A parte inferior da etapa Recursos: o final de Contatos e Agentes de IA (Resumos Diários, <strong>Biblioteca de Mídia</strong>, o seletor de <strong>limite de Agente de IA</strong>), alternadores de Desenvolvedor, seletores de Contexto de Agente de IA / nível de Equipe, e os alternadores de e-mail de boas-vindas e assistente de configuração logo acima de <strong>Criar conta</strong>.</p></figcaption></figure>
:::

- **White label** — exibido apenas quando você usa mais de um [domínio white label](white-labeling.md#up-to-three-white-labels). Escolhe a qual dos seus domínios este cliente pertence: os e-mails dele carregam a marca desse domínio e são enviados através da [configuração de e-mail](white-labeling.md#email-sending-per-domain) desse domínio. O padrão é o seu domínio principal, e você pode alterá-lo posteriormente na mesma tela de edição.
- **Enviar informações da conta para a subconta** — ativado por padrão. O cliente recebe um e-mail de boas-vindas com seus próprios detalhes de login, o que geralmente é o desejado: a senha pertence à pessoa a quem a conta se destina. Sua própria notificação de "nova subconta" apenas confirma que a conta foi criada, sem repetir a senha. Desative se preferir entregar as credenciais pessoalmente — a senha será enviada por e-mail para você e também exibida uma vez na tela.
- **Assistente de configuração guiada** — ativado por padrão. Quando ativado, o cliente é guiado pelo Assistente de Configuração na primeira vez que fizer login. Desative-o e ele será direcionado para o painel, com a entrada **Assistente de Configuração** oculta na barra lateral (veja [Desativando o assistente de configuração](#turning-the-setup-wizard-off)).

Clique em **Criar conta**.

### O que acontece a seguir

- Uma tela de confirmação mostra a **senha temporária** gerada — clique em **Copiar senha** agora, você não a verá novamente. Clique em **Concluído** para fechar.
- O cliente recebe um e-mail com suas credenciais de login e um botão **Fazer login** que o leva diretamente para sua página de login white label (seu próprio domínio, totalmente personalizado — não o aplicativo DM Champ). Se você desativou a opção **Enviar informações da conta para a subconta**, este e-mail não será enviado — a senha chegará a você, na sua notificação de "nova subconta criada" e na tela de confirmação acima.
- A subconta aparece imediatamente na lista de Subcontas, com um **limite de gastos de 100 créditos** para que o cliente possa testar respostas de IA e campanhas imediatamente, sem esperar que você adicione créditos. Nada é retirado do seu pool de agência para configurar isso — veja [O limite de gastos é um teto, não uma carteira](#the-spending-limit-is-a-cap-not-a-wallet). Ajuste o limite de gastos a qualquer momento no modal **Editar** da subconta — veja [Alocação e Gerenciamento de Créditos](#credit-allocation-and-management).

> Quando o cliente faz login pela primeira vez com suas credenciais enviadas por e-mail, ele é direcionado ao Assistente de Configuração, que o orienta na criação de seu primeiro agente de IA e na conexão com seus canais. Eles podem reabri-lo a qualquer momento a partir da entrada **Assistente de Configuração** próxima à parte inferior de sua própria barra lateral.

### Desativando o assistente de configuração

Mantenha o **Assistente de configuração guiada** ativado para clientes que configurarão sua própria conta — é o caminho mais rápido desde o primeiro login até um agente de IA funcional, e é o que a maioria das subcontas deve receber.

Desative-o para clientes que recebem um serviço completo, onde você cria a campanha, conecta os canais e carrega a base de conhecimento antes mesmo de o cliente fazer login. Esses clientes abrem o painel em uma conta pronta, em vez de serem solicitados a configurar algo que você já fez.

Com o assistente desativado:

- O primeiro login vai direto para o painel.
- A entrada **Setup Wizard** fica oculta na barra lateral desse cliente.
- Nada mais muda — mesmos recursos, mesmos créditos, tudo igual.

Você pode trazer o assistente de volta para um cliente a qualquer momento: abra o modal **Editar** da subconta, encontre a lista de visibilidade do menu e exiba novamente o item **Assistente de Configuração**. Eles poderão executá-lo por conta própria sempre que quiserem.

---

## Automatize o que acontece com as contas de clientes

As contas de clientes podem iniciar uma [Automação](../automations/automations.md) na sua conta de agência, para que a parte rotineira de integração e monitoramento aconteça sem você. A que a maioria das agências cria primeiro: novas subcontas chegam com um limite de gastos de 100 créditos, e se você preferir que elas comecem com zero até que você diga o contrário, isso substitui fazer manualmente todas as vezes.

1. Na sua conta de **agência**, vá para **AI Studio → Automations → New automation**, clique no gatilho na tela e depois em **Change trigger**.
2. Abra **Agency** e escolha **Sub-account created**.
3. Adicione uma ação **Update sub-account** e defina seu **Spending limit** para `0`. Ela já aponta para a conta que acabou de ser criada, então não há mais nada para preencher. Salve e, em seguida, ative a opção **Enabled**.

A partir de então, cada novo cliente — criado a partir desta página, via API ou através da sua página de inscrição — começa com zero, e você aumenta o limite quando estiver pronto.

Mais duas combinações que valem dez minutos cada: **Sub-account activity** em **Credits low** enviando uma mensagem no Slack ou um e-mail para você, para que você saiba que um cliente está ficando sem créditos antes mesmo dele; e o mesmo gatilho em **Channel disconnected** para uma etapa **Alert human**, para que uma conexão do WhatsApp que caiu seja retomada no mesmo dia, em vez de esperar até a próxima vez que o cliente reclamar.

---

## A Tabela de Subcontas

Assim que você tiver contas, a página exibirá uma tabela com estas colunas: **Conta**, **ID**, **Criado**, **Campanhas** (ativas/pausadas/nenhuma), **Créditos restantes**, **Mensal**, **Usado**, **Uso**, **Última redefinição**, **BYOK** e **Ações**.

As linhas são classificadas alfabeticamente pelo nome da empresa (o nome da empresa da etapa Negócio; o nome da pessoa de contato aparece abaixo dele). A barra de paginação na parte inferior possui um seletor de **Linhas por página** (12, 25, 50 ou 100; a página memoriza sua escolha) e, se seus clientes estiverem distribuídos por mais de uma marca white-label, um menu suspenso **Marca** ao lado da caixa de pesquisa restringe a lista a um domínio.

A coluna **Ações** de cada linha possui um menu **Mais** de três pontos com:

- **Ver chats** — uma caixa de entrada somente leitura para essa subconta.
- **Detalhes de uso de créditos** — um detalhamento do uso.
- **Editar** — o modal completo de Editar Subconta (créditos, notificações, recursos, visibilidade do menu, acesso).
- **Copiar campanha para cá** — copie uma de suas campanhas comprovadas para esta subconta.
- **Copiar agente para cá** — copie um de seus Agentes de IA para esta subconta. Veja [Copiar um Agente de IA para uma Subconta](#copy-an-ai-agent-to-a-sub-account).
- **Entrar como usuário** — acesse o painel da subconta diretamente.
- **Excluir conta** — remova permanentemente a subconta e tudo o que estiver nela.

---

## Visualizando os Chats de uma Subconta

Clique no menu **Mais** da linha → **Ver chats** para abrir uma caixa de entrada somente leitura para essa subconta — pesquise as conversas deles por contato e abra uma para ler o tópico completo (com um botão **Carregar mais antigos** para históricos longos). Nada aqui pode ser editado ou respondido; é para verificar um cliente sem sair do painel da sua agência. Para responder como o cliente, use **Entrar como usuário**.

---

## Gerenciando o acesso à subconta

### Login do cliente

Cada subconta vem com credenciais de login. Você pode:

- **Compartilhe as credenciais com o cliente** para que ele gerencie sua própria conta.
- **Mantenha as credenciais para si mesmo** e gerencie tudo em nome dele.
- **Use o modo Entrar** para acessar a subconta a partir do seu próprio painel como se você fosse o cliente, sem precisar das credenciais dele — veja [Modo Entrar (agindo como uma subconta)](#sign-in-mode-acting-as-a-sub-account).

### Modo de Acesso (atuando como uma subconta)

O modo de Acesso permite que você entre em uma subconta diretamente — como se você fosse o cliente — sem precisar das credenciais de login dele. (Algumas outras plataformas chamam isso de "assistir" ou "personificar".) Existem duas maneiras de fazer isso:

**A partir da página de Subcontas:**

1. Clique em **Subcontas** na barra lateral.
2. Encontre a subconta na lista. Nessa linha, clique no menu **Mais** (três pontos, na extrema direita).
3. Clique em **Entrar como usuário**.

**De qualquer lugar, através do seletor de contas:**

1. No topo da barra lateral, clique em **Trocar conta**.
2. Pesquise a subconta por nome ou e-mail, ou role a lista.
3. Clique na subconta.

De qualquer forma, o painel é recarregado sob a identidade daquela subconta — com acesso total às campanhas, contatos, chats e configurações dela. Enquanto você estiver dentro de uma subconta, o seletor na barra lateral fica âmbar e exibe **Assisting: <name>**. Clique nele e escolha **Back to my agency** para retornar ao seu próprio painel a qualquer momento. Uma barra âmbar de **Assisting** no topo de cada página contém o mesmo botão **Back to main account**. Se precisar de espaço, clique no **×** na extremidade direita da barra para ocultá-la; ela permanece oculta naquela aba do navegador até que você saia da subconta, e o seletor na barra lateral ainda mostra em qual conta você está.

> **O modo Entrar como mostra mais do que o seu cliente vê.** Para que você possa corrigir qualquer coisa sem precisar ativar ou desativar configurações, o Entrar como ignora deliberadamente as chaves de **Visibilidade do Menu** — cada barra lateral oculta e item de configuração reaparece durante a duração da sua sessão. Itens desativados em **Recursos** permanecem desativados, pois são direitos reais, e não uma configuração de exibição. Se você estiver verificando o que um cliente realmente vê, avalie a partir do login dele, não do modo Entrar como.

---

## Concedendo acesso de membros da equipe a contas de cliente

Sua própria equipe — um gerente de conta, um agente de suporte, um redator — geralmente precisa trabalhar dentro de várias contas de seus clientes. Existem duas maneiras de organizar isso, e escolher a correta economiza muito trabalho administrativo:

1. **Conceda a eles contas de cliente a partir da página da sua equipe de agência.** Uma configuração no assento da agência deles, cobrindo quantos clientes você desejar. Esta é a escolha certa para sua própria equipe.
2. **Convide-os diretamente para uma subconta de cliente**, como membro dessa conta. Esta é a escolha certa para a própria equipe do *cliente* — veja [Quando convidar alguém para uma conta de cliente](#when-to-invite-someone-into-a-client-account-instead).

### Configurando uma concessão

**Como chegar lá:** alterne para sua conta de **agência**, vá para Configurações → **Equipe** e clique no **ícone de controles deslizantes** na linha do membro. O editor de Permissões tem uma seção **Contas de cliente** (ela só aparece em contas de agência).

Escolha uma das quatro opções:

| Opção | O que o membro recebe |
|--------|---------------------|
| **Padrão (apenas administradores)** | Nenhuma mudança em relação a como as coisas sempre funcionaram: membros com acesso de Gerenciamento de Equipe alcançam todas as contas de cliente, todos os outros não alcançam nenhuma. |
| **Todos os clientes** | Todas as suas contas de cliente, incluindo as que você criar posteriormente. |
| **Clientes selecionados** | Apenas as contas que você marcar na lista. Pesquise por nome ou e-mail — útil quando você tem muitos clientes. |
| **Sem acesso** | Nenhuma conta de cliente, mesmo que o membro seja um Administrador na sua agência. Use isso para manter um gerente totalmente fora do trabalho do cliente. |

Em seguida, defina **Atua como dentro das contas de cliente** — **Administrador**, **Editor** ou **Visualizador**. Esta é a função que o membro tem *uma vez que ele está dentro* de uma conta de cliente concedida, e funciona exatamente como as funções na sua própria equipe (veja [Funções](../settings/team-management.md#roles)). Uma concessão de Visualizador, por exemplo, significa que a pessoa pode ler os chats e campanhas de todos os clientes concedidos, mas não pode alterar nada em lugar nenhum.

Clique em **Salvar permissões**. A linha do membro mostrará então quantos clientes foram concedidos a ele.

### O que o membro vê

- As contas de cliente concedidas aparecem no controle **Alternar conta** na parte superior da barra lateral, ao lado da conta da sua agência.
- Clicar em uma leva o membro diretamente para dentro — sem convite para aceitar, sem login separado, nada para o cliente aprovar.
- Lá dentro, eles trabalham com a função que você escolheu. Áreas que a função deles não cobre ficam ocultas ou apenas para leitura, exatamente como na sua própria equipe.
- A página **Subcontas** em si ainda pertence ao acesso de Gerenciamento de Equipe. Um membro que possui apenas uma concessão acessa seus clientes através do alternador de contas; um membro que possui ambos pode gerenciar os clientes que lhe foram concedidos a partir da página também.

Algumas coisas que vale a pena saber:

- **As concessões não consomem os assentos da equipe do seu cliente.** A pessoa está na equipe da sua agência; nada é adicionado à lista de membros do cliente.
- **A remoção de uma concessão entra em vigor imediatamente.** Desmarque um cliente, altere o membro para **Sem acesso** ou suspenda/remova-o da equipe da sua agência, e o acesso dele a essas contas será encerrado imediatamente — incluindo qualquer sessão que ele já tenha aberta.
- **As concessões são por membro.** Dois gerentes de conta podem ter listas de clientes completamente diferentes, com funções diferentes.
- **A criação de contas de cliente ainda requer acesso de Gerenciamento de Equipe.** Uma concessão permite que alguém trabalhe nos clientes que você entregou a ele; não permite que ele adicione novos.

### Quando convidar alguém para uma conta de cliente

Uma concessão serve para *sua* equipe alcançar *seus* clientes. Convide uma pessoa diretamente para uma subconta (de dentro dessa conta, Configurações → **Equipe**) quando:

- **Elas pertencem ao cliente, não a você.** O próprio gerente ou agente do cliente deve ser um membro da conta do cliente, para que o acesso deles sobreviva independentemente da equipe da sua agência e permaneça caso você transfira a conta.
- **Você precisa ajustar uma pessoa dentro de um cliente.** Uma associação direta pode conter substituições por área e sua própria [visibilidade de chat e contato](../settings/team-management.md#limiting-a-member-to-their-own-chats) — por exemplo, o agente de um cliente que deve ver apenas as conversas atribuídas a ele. Uma concessão define uma função em todas as contas que ela cobre.

Os dois podem coexistir. Se alguém tiver a conta concedida e também for membro dela, sua própria associação a essa conta prevalece enquanto estiver dentro dela — portanto, um convite direto também é a maneira de dar a uma pessoa um nível de acesso diferente em um cliente específico.

---

## Um cliente com vários negócios

Às vezes, um único cliente gerencia mais de um negócio e deseja manter cada um deles separado (contatos, campanhas e números distintos) sem precisar fazer login e logout o dia todo. Você pode fornecer a ele um único login que dá acesso a todos eles:

1. Crie uma subconta para cada negócio, cada uma com seu próprio endereço de e-mail (veja Criando uma Subconta acima).
2. Dentro de cada subconta, vá para **Configurações > Gerenciamento de Equipe** e convide o e-mail pessoal do cliente como um membro da equipe com a função de **Administrador**. Repita isso para cada negócio.
3. O cliente aceita cada convite a partir dos e-mails que receber.

A partir de então, o cliente faz login uma única vez com seu e-mail pessoal e obtém um **seletor de conta** próximo ao topo da barra lateral esquerda, listando todos os seus negócios. Escolher um deles o leva diretamente para a conta, sem necessidade de fazer logout.

Duas coisas para ter em mente:

- **Use um e-mail que ainda não possua sua própria conta.** Uma vez que um e-mail se torna membro de uma equipe em algum lugar, o login sempre o levará para uma conta à qual ele pertence; portanto, um e-mail que também é proprietário de uma conta separada pode acabar sem conseguir acessar essa conta.
- **Cada negócio permanece como sua própria subconta** para fins de faturamento, créditos e limites. O seletor é uma conveniência para a pessoa, não uma fusão dos negócios.

Funções, permissões e o fluxo de convite são abordados detalhadamente em [Gerenciamento de Equipe](../settings/team-management.md).

> **Este é o login do próprio cliente, portanto, convites são a ferramenta certa aqui.** Para sua *própria* equipe trabalhando em vários clientes, não os convide para cada conta — conceda-lhes as contas a partir da página da sua equipe de agência (veja [Concedendo acesso a membros da equipe às contas de clientes](#giving-team-members-access-to-client-accounts)).

### Um número de WhatsApp para todas as marcas, ou um por marca?

O fator decisivo é o que o cliente em potencial vê, não a tecnologia. No WhatsApp, o nome de exibição e o perfil comercial estão vinculados ao número: todos que enviam mensagens para ele veem o mesmo nome, logotipo e perfil, e cada conversa cai no mesmo tópico de chat no telefone deles — portanto, um número compartilhado sempre apresenta uma única identidade pública, mesmo que você separe as marcas internamente.

- **Um número funciona** quando as marcas são, na verdade, um único negócio com várias ofertas. Mantenha-o em uma única conta e separe as ofertas com um [Agente de IA](../ai-agents/ai-agents.md) por marca, roteado por [Pontos de Entrada de Palavras-chave](../ai-agents/entry-points.md) (as regras de palavras-chave são verificadas antes do padrão do canal) e [links curtos](../settings/short-links.md) por fonte com diferentes abridores pré-preenchidos. Tags, listas e campos personalizados mantêm os contatos segmentados.
- **Uma subconta com seu próprio número por marca** é a estrutura correta no momento em que as marcas precisam de identidades públicas distintas — seu próprio nome de exibição, perfil e seus próprios modelos de mensagem aprovados. Cada subconta mantém seus próprios contatos, chats, agentes, limite de crédito e acesso da equipe, para que os relatórios e os limites de gastos permaneçam organizados por marca.

Planeje em torno de duas restrições: cada conta ou subconta precisa de sua própria Conta do WhatsApp Business no lado da Meta (uma WABA só pode ser vinculada a uma conta por vez — consulte [WhatsApp Business API](../messaging-channels/whatsapp-business.md#each-account-needs-its-own-whatsapp-business-account)), e cada número tem seu próprio aluguel mensal, portanto, números por marca custam mais infraestrutura em troca da separação organizada.

---

## Bloqueando / Pausando uma Subconta

Se um cliente atrasar os pagamentos para você, ou se você precisar pausar a conta dele temporariamente, bloqueie o acesso da subconta sem excluir nada. Nada é perdido — campanhas, contatos e histórico de chat permanecem exatamente como estão, e você pode desbloquear a qualquer momento.

1. Abra o modal de **Editar** da subconta (menu **Mais** da linha → **Editar**).
2. Role até a seção **Acesso** e escolha um **Status da conta**:
   - **Ativo** — acesso normal.
   - **Bloqueio leve (Soft blocked)** — impede que a subconta envie mensagens (campanhas, transmissões, envios manuais, acompanhamentos). O robô de IA continua respondendo às mensagens recebidas normalmente, e o cliente ainda pode fazer login e usar o aplicativo.
   - **Bloqueio rígido (Hard blocked)** — interrompe o envio *e* impede que o robô de IA responda. O cliente ainda pode fazer login, mas verá uma mensagem de bloqueio em tela cheia em vez do aplicativo, com um botão **Sair** como sua única opção.
3. Opcionalmente, adicione uma **mensagem de bloqueio** que o cliente verá (em um bloqueio rígido) ou que explique a situação.
4. Clique em **Salvar**. Ativar um bloqueio solicitará que você confirme primeiro, já que é uma ação que restringe o acesso.

Algumas coisas que vale a pena saber:

- **O término da sua própria assinatura bloqueia todas as subcontas.** Se a assinatura da sua agência for cancelada, todas as suas subcontas são bloqueadas automaticamente no momento em que o cancelamento entra em vigor — os envios e as respostas de IA param e eles veem a tela de bloqueio — e elas são desbloqueadas automaticamente assim que você assinar novamente. Nada é excluído nesse intervalo.
- **O cliente não é notificado por e-mail automaticamente.** Se você quiser que eles saibam que foram bloqueados e o motivo, informe-os você mesmo — isso fica a seu critério, já que muitas agências utilizam white-label em seus serviços.
- **É totalmente reversível.** Alterar o status de volta para Ativo restaura o acesso total imediatamente.
- **Isso é separado do faturamento do DM Champ.** Bloquear uma subconta afeta apenas o seu relacionamento com o seu cliente — não tem efeito sobre a sua própria assinatura ou faturamento via Stripe conosco.
- **O faturamento e o login permanecem sempre acessíveis.** Mesmo em um bloqueio total, o cliente ainda pode acessar as telas de faturamento e login/logout — eles nunca são completamente impedidos de acessar a conta em si.
- **Um teste com expiração rígida define esse bloqueio para você.** Se um plano estiver com a opção **Expiração rígida após o teste** ativada e o período de teste de um cliente terminar sem que ele assine, a conta dele é bloqueada automaticamente com a mensagem *"Seu período de teste gratuito terminou. Entre em contato com seu provedor para continuar."* — e desbloqueada novamente no momento em que comprarem um plano. Você ainda pode alterar ou remover isso aqui como qualquer outro bloqueio. Um bloqueio que você aplicou manualmente nunca é sobrescrito ou removido por isso, então o seu motivo sempre prevalece. Uma expiração rígida também libera qualquer número que o cliente tenha alugado através da plataforma; um bloqueio que você aplica manualmente não faz isso — libere-o na seção **Números de telefone** do mesmo modal se quiser removê-lo (veja [Números de telefone de um cliente](#a-clients-phone-numbers)). Veja [Executando um teste gratuito](#running-a-free-trial).
- **Você também pode pausar e retomar via API.** `POST /v1/subaccounts/{subAccountUid}/pause` aplica o bloqueio total (com uma mensagem opcional para a tela de bloqueio do cliente) e `POST /v1/subaccounts/{subAccountUid}/unpause` o remove — útil quando um cliente suspende a assinatura dele no seu próprio sistema de faturamento e você deseja que a pausa ocorra automaticamente. As mesmas duas ações estão disponíveis como `pause_subaccount` / `unpause_subaccount` no [servidor MCP](../integrations/connect-ai-clients.md). Veja [API para Agências](api-for-agencies.md#pause-a-client-who-has-suspended-their-subscription).
- **Quer colocar em um temporizador? Crie como uma Automação a partir da sua conta de agência.** No AI Studio → Automações, crie uma com um gatilho de **Execução manual**, uma etapa de **Atraso** (por exemplo, 30 dias) e uma etapa de **Requisição HTTP**: método `POST`, endereço `https://api.dmchamp.com/v1/subaccounts/{subAccountUid}/pause`, cabeçalho `X-API-Key` com a sua chave de API da agência (**Configurações → API**). Clique em **Executar** no dia em que o acesso do cliente começar e a conta será bloqueada automaticamente quando o atraso terminar. Como a automação reside na *sua* conta, o cliente nunca a vê e não pode removê-la — o `{subAccountUid}` é a coluna **ID** na página de Subcontas. Uma segunda automação chamando `/unpause` faz o inverso.

---

## Números de Telefone de um Cliente

Cada número conectado na conta de um cliente é listado na seção **Números de telefone** do modal **Editar** da subconta (menu **Mais** da linha → **Editar**), para que você possa liberar um sem precisar entrar como o cliente:

- Um número que o cliente **alugou através da plataforma** mostra um botão **Liberar**. Liberá-lo interrompe seu aluguel mensal, retorna o número para a operadora e não pode ser desfeito; o mesmo número não pode ser recomprado por 7 dias.
- Um número que o cliente **trouxe por conta própria** (sua própria Conta Comercial do WhatsApp, aplicativo Meta ou conta Twilio) e uma conexão **WhatsApp Web** mostram **Remover** em vez disso: a linha é apenas removida aqui e permanece com seu provedor.

::: master-only
<figure><img src="../.gitbook/assets/v2-sub-account-edit-phone-numbers.png" alt="O modal de edição de subconta rolado para sua seção de Números de telefone, listando a Linha de Agendamento Nova +14155550123 marcada como Alugado aqui, com um botão vermelho Liberar na linha e a seção Acesso acima dela"><figcaption><p>A seção <strong>Números de telefone</strong> fica abaixo de <strong>Acesso</strong> no modal Editar — um número alugado através da plataforma recebe um botão <strong>Liberar</strong>, um número que o cliente trouxe recebe <strong>Remover</strong>.</p></figcaption></figure>
:::

Duas coisas acontecem por conta própria, para que um número alugado nunca continue custando aluguel em uma conta que não pode pagar por ele:

- **Um teste com expiração rígida libera seus números alugados.** Quando um plano com **Expiração rígida após o teste** termina sem um upgrade, cada número que o cliente alugou é liberado no momento em que a conta é bloqueada. O cliente e você recebem um e-mail informando o número.
- **Aluguel que não pode ser cobrado por dois meses seguidos libera o número.** Se o saldo de um cliente estiver muito baixo para o aluguel mensal de um número, o aluguel é ignorado e ambos recebem um e-mail de aviso. Se o saldo ainda estiver muito baixo na próxima tentativa mensal, cerca de um mês depois, o número é liberado e ambos recebem um e-mail novamente. Recarregar o cliente antes disso mantém o número.

Um bloqueio que você coloca não libera nada — um cliente pausado mantém seus números até que você ou ele os libere.

---

## Roteamento de Notificações

Quando algo acontece em uma subconta que justifica um alerta — um contato precisa de um humano, um robô atinge seu limite de mensagens, um modelo do WhatsApp é aprovado ou rejeitado, uma campanha termina de enviar suas mensagens iniciais — a plataforma pode enviar e-mail tanto para você (a agência) quanto para o próprio usuário da subconta. Você decide quem recebe esses alertas por subconta.

Abra o modal de **Editar** da subconta e encontre duas chaves em **Notificações**:

- **Enviar Notificações para a Subconta** — quando ativado, o próprio usuário da subconta recebe esses e-mails de alerta. Desative se o seu cliente não deve ser incomodado com alertas operacionais e você prefere lidar com tudo sozinho.
- **Enviar Notificações para a Agência** — quando ativado, você (a agência) recebe esses e-mails de alerta para esta subconta. Desative para clientes que você gerencia de forma independente e sobre os quais não deseja ser alertado.

Ambas as chaves estão **ligadas por padrão**, portanto, uma subconta recém-criada notifica ambos os lados até que você altere isso. As duas são independentes: direcione alertas apenas para a subconta, apenas para sua agência, para ambos ou para nenhum.

A cópia da agência também segue as configurações de canal por categoria da própria subconta. Se a coluna E-mail estiver desativada para uma categoria na página de [Notificações](../settings/notifications.md#notification-categories) da subconta (por exemplo, **Mensagens de Contatos Pausados** ou **Mensagens Pausadas por IA**), nem a subconta nem a agência receberão e-mails sobre isso, mesmo com a opção **Enviar Notificações para a Agência** ativada. Os alertas críticos que estão sempre ativos (créditos, faturamento, agendamentos, alertas humanos, erros de chave de API) ainda chegarão à agência, independentemente disso.

> **Desative ambos e ninguém receberá esse e-mail.** Se ambas as chaves estiverem desativadas, os e-mails de alerta da subconta serão suprimidos completamente — nem você nem o cliente serão notificados. Deixe pelo menos uma ativada se esses alertas forem importantes para você.

Essas duas chaves controlam apenas os **e-mails** de alerta da subconta — um contato precisando de um humano, um bot atingindo seu limite de mensagens, um modelo de WhatsApp aprovado ou rejeitado, uma campanha terminando suas mensagens de abertura. Elas não alteram o comportamento dentro do aplicativo, alertas de faturamento ou a notificação de "nova subconta criada" que você recebe como agência (essa sempre é enviada).

---

## Ocultando Páginas de uma Subconta

Por padrão, cada subconta pode ver a barra lateral completa e o menu de Configurações. Se um cliente não deve ter acesso a determinadas páginas — Faturamento, por exemplo, ou um canal que você gerencia em nome dele —, abra o modal **Editar** dele, expanda **Visibilidade do Menu** e desative qualquer item da **Navegação Lateral** ou **Navegação de Configurações** que você deseja ocultar dele. Cada interruptor começa **ligado**, o que significa que o cliente vê aquele item; um interruptor desligado o oculta. Itens ocultos simplesmente desaparecem dos menus daquela subconta; nada sobre seus dados ou permissões é alterado internamente.

Um item oculto é puramente cosmético para um recurso ao qual a subconta já tem acesso — ele não concede acesso a algo que o conjunto de recursos dela não inclui. Se um recurso estiver desativado em **Recursos**, ocultar ou mostrar sua entrada no menu não faz diferença; ele permanece inacessível de qualquer maneira.

Por causa disso, uma linha da **Navegação Lateral** cuja página precisa de um recurso que o cliente ainda não possui — **Automações**, **Tarefas** ou **Resumos Diários** — fica esmaecida, com uma nota informando qual recurso ativar primeiro. Marque esse recurso em **Recursos** e a linha será desbloqueada imediatamente, antes mesmo de você salvar.

### Recursos vs. visibilidade do menu

O modal **Editar** oferece dois controles separados sobre o que um cliente encontra em sua conta, e eles não são intercambiáveis:

- **Recursos** — ao que a conta tem direito. Desativar um deles remove a capacidade, e qualquer página que exista apenas para configurá-lo desaparece junto. **Traga sua própria chave de API (BYOK)** fica aqui: deixe desativado e o cliente nunca verá a página **Configurações → Avançado → Chaves de API BYOK**, nem no próprio login nem no modo Entrar como.
- **Visibilidade do Menu** — quais entradas da barra lateral e de configurações são mostradas, para capacidades que a conta ainda possui. Use-o para organizar a navegação de um cliente, não para ocultar algo: é uma configuração de exibição e não se aplica enquanto você estiver no modo Entrar como.

Portanto, se você deseja que um cliente nunca acesse uma parte do produto, desative o **recurso**. Se você apenas deseja que o menu dele seja mais curto, use a **visibilidade do menu**.

---

## Alocação e gerenciamento de créditos

### O limite de gastos é um teto, não uma carteira

O **Limite de gastos** que você define em uma subconta é um teto sobre quanto do *seu* saldo de créditos aquele cliente pode gastar. Não é um pote separado de créditos entregue a ele. Cada ação de IA consome um crédito do limite do cliente **e** a mesma quantia do saldo da sua agência, no momento em que é usada.

Duas coisas decorrem disso, e elas costumam confundir as agências:

- **Um cliente pode exibir um limite saudável e ainda assim parar de funcionar.** Se o saldo da sua agência estiver vazio, o limite não pode ser gasto e o bot do cliente para com um erro de créditos insuficientes, não importa quão alto seja o número. O saldo da sua agência é o que você deve monitorar.
- **Alterar o limite não move créditos.** Aumentá-lo não retira nada do seu saldo; diminuí-lo não devolve nada. Não há transferência em nenhuma direção, portanto, nada é perdido quando você diminui um limite — defina-o de volta para o valor que desejar, sem custo. Deliberadamente, não existe uma ação de "mover créditos de volta para a agência", porque não há nada para mover.

Pense nisso como um cartão corporativo que você emitiu para o cliente: o limite diz quanto do seu dinheiro ele pode gastar, e o dinheiro permanece na sua conta até que ele o gaste.

#### Quanto do meu pool está comprometido?

Como os limites nunca saem do seu saldo, o número na sua página de Faturamento não informa quanto dele já está prometido aos clientes. Os dois blocos de estatísticas à direita no topo da página de **Subcontas** fazem isso:

- **Alocado para clientes** — o limite de gastos atual de cada cliente somado, em todas as suas subcontas. A linha abaixo indica quantas contas estão incluídas nessa soma.
- **Não alocado** — o saldo da sua agência menos esse total: a parte do seu pool que nenhum cliente pode tocar ainda, e o número a ser observado antes de aumentar um limite ou integrar outro cliente.

Se os limites dos seus clientes somados ultrapassarem o seu saldo, o **Não alocado** ficará negativo e vermelho. Nada está quebrado quando isso acontece — significa apenas que, se cada cliente gastasse até o seu limite, o pool se esgotaria antes. Recarregue em **Configurações > Faturamento** ou reduza alguns limites até que o valor volte a ficar verde.

Os créditos que um cliente comprou através do seu próprio checkout (modo de revenda) são excluídos de **Alocado para clientes**: eles foram pagos no momento da compra e nunca mais consomem o seu pool. Apenas a parte do saldo de um cliente de revenda que vem da sua franquia mensal é contabilizada.

Para tornar esse relacionamento visível, a seção **Gerenciamento de Crédito** do modal **Editar** mostra o **Seu saldo da agência** logo acima do seletor de modo: o pool ativo do qual este cliente gasta. Se o cliente precisar de mais espaço, aumente o **Limite de gastos** dele; se o próprio pool estiver ficando baixo, esse número é o seu sinal para recarregar em **Configurações > Faturamento**. Não há uma etapa de "transferência" intermediária, porque os créditos nunca saem da sua conta até que o cliente os utilize.

> **Mantenha o saldo da agência abastecido.** Como cada subconta gasta do seu saldo, a solução para um cliente que parou de usar créditos é quase sempre recarregar a conta da sua agência, e não aumentar o limite do cliente. Ative a **Recarga Automática** em **Configurações > Faturamento** na conta da sua agência para que o saldo seja recarregado antes que os clientes comecem a perder mensagens. Em uma licença vitalícia ou AppSumo, não há franquia mensal de créditos, portanto, o saldo só é recarregado quando você compra créditos ou a recarga automática é acionada.

Isso descreve o **modo manual**, o padrão. No modo de revenda, os créditos comprados pelo cliente são deduzidos do seu saldo no momento da compra — veja [Modos de gerenciamento de crédito](#credit-management-modes).

### Modos de gerenciamento de crédito

Cada subconta usa um dos dois modos de crédito, definidos no seu modal **Editar**, em **Gerenciamento de Crédito**:

**Modo manual (padrão):**

- Os créditos são compartilhados a partir do saldo da sua agência.
- Quando uma subconta usa créditos (respostas de IA, campanhas, etc.), a dedução ocorre no saldo da sua agência.
- As subcontas não veem o saldo de créditos — elas simplesmente usam a plataforma e você gerencia o saldo.
- Defina a **Franquia mensal**, ajuste o **Limite de gastos** diretamente e escolha se a franquia não utilizada **acumula** para o próximo mês.

> **As compras de crédito do cliente e o portal de faturamento do cliente só funcionam no modo de revenda.** Enquanto uma subconta estiver no modo manual (o padrão), ela não pode comprar seus próprios créditos nem abrir um portal de faturamento — em vez disso, você gerencia o saldo dela no modal Editar. Mude para o modo de revenda primeiro se quiser que o cliente gerencie suas próprias compras.

**Modo de revenda de créditos:**

- Oferecido apenas quando sua agência possui white-label no plano (ou a subconta já está no modo de revenda).
- As subcontas compram seus próprios créditos através da sua página de checkout personalizada (configurada em **Modo SaaS**).
- Os créditos comprados são rastreados separadamente por subconta e deduzidos do pool de crédito da sua agência no momento da compra.
- Todas as operações (respostas de IA, campanhas, taxas do WhatsApp, etc.) consomem créditos comprados primeiro antes de recorrer ao pool da sua agência.
- Os pagamentos são processados através do **Stripe** ou através de um **webhook** para seu próprio provedor de pagamento personalizado — veja [Contas de Agência — Provedor de Pagamento Personalizado](agency-accounts.md#option-2-custom-payment-provider).

> **A franquia mensal continua sendo aplicada no modo de revenda.** Mudar uma subconta para revenda adiciona uma forma de o cliente comprar seus próprios créditos — isso não desativa a franquia mensal que a conta já possuía. Todos os meses, a franquia ainda é creditada como novos créditos, e o que o cliente gasta dela ainda é descontado do seu pool de agência, exatamente como no modo manual. Apenas os créditos *comprados* pelo cliente são protegidos: eles já foram deduzidos do seu pool no momento da compra, portanto, gastá-los nunca afetará seu pool novamente. Para alterar ou zerar a franquia, abra o modal **Editar** da subconta — o campo **Franquia mensal** é exibido em ambos os modos. Se você defini-lo como zero e o cliente não possuir créditos comprados, a IA e as campanhas dele serão interrompidas até que ele compre créditos através do seu checkout.

> **Sua chave BYOK de agência NÃO torna a IA da subconta gratuita.** O BYOK é definido por workspace. Uma chave conectada na conta da agência é usada para executar a IA para subcontas que não possuem sua própria chave, mas essas subcontas ainda consomem créditos na taxa normal. Uma subconta só obtém IA com custo zero de créditos quando sua própria chave da Anthropic é conectada nessa subconta. A chave própria de uma subconta sempre tem prioridade sobre a chave da agência. Para adicionar uma, use **Entrar como usuário** (menu da linha ou alternador de conta) para acessar a subconta e, em seguida, vá para **Configurações → Avançado → Chaves de API BYOK**. Isso pega muitas agências de surpresa, então planeje a alocação de créditos para qualquer subconta que não tenha sua própria chave. Se você preferir não gerenciar uma chave por cliente, o **Nível de IA Máximo** (ativado por padrão para cada subconta e alternável por subconta no modal Editar → Recursos) mantém o custo o mais baixo possível: 0,25 créditos por ação, e traz consigo o nível **Mini** a 0,15 para Agentes que não precisam da precisão total do nível Máximo. Para saber como o BYOK funciona, consulte [Modelo de IA e BYOK](../ai-automation/ai-model-and-byok.md#setting-up-byok).

### Limitando o que é transferido

A transferência por si só não tem teto. Um cliente que mal usa o produto continua acumulando franquia sobre franquia, e cada um desses créditos ainda é seu para cobrir sempre que eles finalmente forem gastos — o que torna um plano barato ou com preço de teste caro mais tarde. Dois campos colocam um limite nisso, e eles ficam logo abaixo da chave **Transferir créditos não utilizados** no modal **Editar** da subconta → **Gerenciamento de Crédito** (ambos são mostrados no modo manual e no modo de revenda):

- **Manter no máximo** — quantos meses de franquia este cliente pode carregar. A cada renovação, seu saldo não utilizado é reduzido para, no máximo, esse número de vezes a franquia que a renovação concede, e então os créditos do novo período são adicionados. **1** mantém o valor de um mês, **0.5** meio mês, **0** significa que nada é transferido. Deixe vazio para não ter limite.
- **Expirar créditos não utilizados após** — um número de dias. Créditos que ficaram sem uso por tanto tempo são descartados na primeira renovação após atingirem essa idade. O gasto sempre desconta dos créditos mais antigos primeiro, então um cliente que usa sua franquia todos os meses nunca perde nada: apenas os créditos que genuinamente não foram usados durante todo o período expiram. Deixe vazio e nada nunca expirará.

Os mesmos dois campos existem em um plano, no grupo **Créditos não utilizados** do editor de planos (veja [Passo 3 — Configurar níveis de preços](agency-accounts.md#step-3--set-up-pricing-tiers)), onde se aplicam a todos os clientes naquele plano. **Um valor no cliente prevalece sobre o do plano** — preencha um campo na subconta e é isso que se aplica a eles; deixe vazio e eles seguem o que o plano diz.

Algumas coisas que vale a pena saber antes de definir qualquer um deles:

- **Uma renovação é o que aciona isso.** Isso significa a redefinição da franquia mensal quando a transferência está ativada, ou uma renovação de plano — incluindo um teste convertendo para um plano pago, e a concessão de crédito mensal em um plano anual. Nada acontece nesse meio tempo, e um cliente sem franquia e sem plano nunca é afetado. Mudar um cliente para um plano diferente no meio do período também não aciona isso; a próxima renovação dele fará.
- **Recargas nunca são afetadas.** Apenas créditos recorrentes — a franquia mensal e os créditos de um plano — estão sujeitos ao limite e à expiração. Créditos que o cliente comprou como recarga, uma recarga automática ou créditos que você adicionou manualmente ou via API permanecem no saldo pelo tempo que for necessário para usá-los, e eles são gastos por último, então os créditos recorrentes sempre saem primeiro.
- **Cada ajuste fica registrado.** Ele aparece na lista de uso na página **Configurações → Faturamento** do cliente como **Ajuste de Crédito de Limite de Transferência** ou **Ajuste de Crédito de Créditos Expirados**, e nunca conta como uso.
- **Créditos já no saldo quando você ativa um limite** são tratados como se tivessem sido concedidos na última renovação do cliente, então essa é a data a partir da qual a janela de expiração é contada.

### Definindo a taxa do cliente para ações de IA Max e Mini

As ações de IA Max e Mini em uma subconta possuem **dois preços**: quanto o saldo de créditos do próprio cliente consome por ação e quanto o saldo da sua agência realmente paga por isso. A diferença é sua margem, integrada à plataforma.

- **O que você paga**: 0,25 créditos por ação Max e 0,15 por ação Mini — ou **0,2** e **0,12** automaticamente em cada subconta se sua agência possuir uma assinatura do **Champions Circle** (a Taxa Insider agora se aplica ao seu saldo para todos os seus clientes, nada para ativar).
- **O que o cliente consome**: a taxa da plataforma por padrão (0,25 no Max, 0,15 no Mini), ou qualquer taxa que você definir por cliente. Abra o modal **Editar** da subconta → **Recursos** → **Taxa do cliente por ação de IA Max** e insira um número de créditos (até 10). Defina um valor acima do seu custo para incluir uma margem de lucro — por exemplo, em 0,5, um cliente em uma agência Circle consome 0,5 créditos por ação enquanto seu saldo paga 0,2 — ou defina exatamente o seu custo para repassar sua taxa diretamente. Não pode ser menor que seu próprio custo, então você nunca precificará um cliente com prejuízo. Limpe o campo para voltar à taxa padrão da plataforma.

> **A taxa que você define cobre tanto o Mini quanto o Max.** O campo é rotulado como **Taxa do cliente por ação de IA Max**, mas as ações Mini são precificadas na mesma categoria, então uma margem que você inserir aqui também será cobrada pelas ações Mini daquele cliente — uma taxa de 0,5 significa 0,5 créditos por ação, esteja o Agente no Max ou no Mini. Se você quiser que o Mini permaneça barato para um cliente, deixe o campo vazio para que ambos os níveis sejam cobrados em suas respectivas taxas de plataforma.

A taxa do cliente aplica-se apenas a ações nos níveis **Max** e **Mini** (nunca altera a precificação Pro ou Economy). O histórico de uso da sua página de faturamento mostra ambos os lados por ação: o que o cliente consumiu e o que seu saldo pagou.

O que o cliente vê segue o preço que você definiu: os cartões de **Qualidade de IA** no editor de agentes deles citam seu preço por ação para cada nível (nunca a taxa da plataforma ou seu desconto), e o cartão **Quanto custa cada ação** na página de Faturamento deles lista seus preços sem sua margem de lucro — uma margem de taxa do WhatsApp aparece lá como uma taxa por mensagem que varia de acordo com o país, não como um múltiplo da taxa da operadora.

### Bloqueando um cliente em um modelo de IA específico

Por padrão, cada cliente escolhe seu próprio modelo de IA nos cartões de **Qualidade de IA** do editor de agentes, e um cliente que muda para um modelo mais caro consome seu pool de créditos mais rapidamente. Se você preferir tomar essa decisão por eles, abra o modal **Editar** da subconta → **Recursos** → **Modelos de IA que este cliente pode usar** e ative os modelos que eles podem escolher. Um modelo ativado fica disponível para eles, um modelo desativado não; a dica abaixo das chaves confirma que o cliente está limitado aos modelos ativados.

- **Deixe todos os interruptores desligados** e não haverá bloqueio — o cliente escolhe qualquer modelo incluído em seu plano. É assim que todas as subcontas começam.
- **Ative exatamente um** (digamos, **Max**) e o cliente ficará fixado nele. Os outros modelos desaparecem de seus cartões de Qualidade da IA. A única exceção é um modelo que o cliente já estava usando quando você definiu o bloqueio: esse cartão permanece visível para que ele ainda possa ver em qual modelo seu agente está.
- **Ative mais de um** para oferecer a eles uma lista restrita em vez de um único modelo.

O bloqueio é aplicado do nosso lado, não apenas oculto na interface. Um cliente não pode contorná-lo editando um agente de uma tela diferente, do aplicativo móvel ou através da API — o salvamento é recusado com a mensagem "Este modelo de IA não está disponível em seu plano. Entre em contato com o provedor da sua conta."

Ativar **Max** ou **Mini** aqui também ativa a opção **Permitir nível de IA Max** acima, porque um cliente não pode ser fixado em um modelo que sua conta não tem permissão para ver. Desativar **Permitir nível de IA Max** novamente remove o Max e o Mini do bloqueio.

::: master-only
<figure><img src="../.gitbook/assets/v2-sub-account-edit-lock-ai-models.png" alt="A seção de Recursos do modal Editar subconta, mostrando a linha de Modelos de IA que este cliente pode usar com as chaves Pro, Max e Mini todas desativadas, acima da seção de precificação de Ação"><figcaption><p>A linha <strong>Modelos de IA que este cliente pode usar</strong>, diretamente abaixo de <strong>Permitir nível de IA Max</strong>. Cada chave desativada, como aqui, significa sem limite: a linha abaixo informa em qual estado você está.</p></figcaption></figure>
:::

> **Bloquear um cliente que já escolheu outra coisa não interrompe seus agentes.** Um agente que utiliza um modelo que você bloqueou posteriormente continua respondendo — ele simplesmente passa a rodar em um dos modelos que você permitiu. Seu cartão antigo permanece visível no editor, com uma nota informando ao cliente que ele não está mais disponível e solicitando que escolha um dos modelos que você permitiu. Eles podem continuar editando e publicando esse agente nesse meio tempo; nada para de funcionar e nenhuma conversa é descartada.

### Definindo uma margem de lucro nos custos do WhatsApp de um cliente

O mesmo modal possui uma seção de **Precificação de Ação** (recolhida por padrão, logo abaixo de **Modelos de IA que este cliente pode usar**) com uma linha de **Markup de taxa do WhatsApp**. É um multiplicador sobre o que o WhatsApp realmente nos custa para aquele cliente — o aluguel mensal do número (50 créditos para um número padrão) e, a partir de 1º de outubro de 2026, as taxas de operadora por mensagem em um número gerenciado, incluindo modelos e a taxa em cada mensagem recebida. Insira **1.5** e o cliente consome 1,5x o nosso custo em cada uma dessas cobranças, enquanto seu pool ainda paga apenas o custo; a diferença é creditada de volta ao seu pool à medida que cada cobrança ocorre, exatamente como a taxa de cliente Max. Não pode ser inferior a **1** (você nunca pode cobrar de um cliente menos do que a taxa custa para você), e limpar o campo repassa os custos do WhatsApp pelo preço de custo. Isso se aplica independentemente de o cliente gastar créditos comprados ou sua franquia, e um reembolso (um modelo que nunca foi enviado, por exemplo) devolve ao cliente a cobrança total, enquanto seu pool recebe de volta apenas o que pagou.

::: master-only
<figure><img src="../.gitbook/assets/v2-sub-account-edit-features-rate.png" alt="O modal Editar subconta com a seção de precificação de Ação expandida, mostrando os preços de crédito por ação que este cliente é cobrado"><figcaption><p>A seção <strong>Precificação de Ação</strong>, expandida. Cada linha representa o que este cliente é cobrado por aquela ação; deixe uma linha vazia e ela será faturada pelo preço padrão, e qualquer valor acima do que seu pool paga é sua margem.</p></figcaption></figure>
:::

> A taxa altera a velocidade com que a alocação de créditos do cliente é consumida, não de onde os créditos vêm originalmente — o gasto da subconta é sempre garantido pelo seu pool de agência. Para clientes que compram créditos através do seu checkout (modo de revenda), a margem é creditada de volta ao seu pool à medida que cada crédito pré-pago é gasto, além da margem que você já definiu no preço do seu crédito.

### Uma resposta de espera enquanto um cliente está sem créditos

Quando o limite de gastos de um cliente é atingido (ou seu próprio saldo está vazio), a IA não pode responder e o contato não recebe nada: o chat na caixa de entrada exibe um marcador de limite de crédito e nenhuma mensagem é enviada. Se você preferir que o contato receba uma resposta, abra o modal **Editar** da subconta → **Créditos** e ative a opção **Resposta de espera quando sem créditos**, em seguida, digite a mensagem na caixa **Mensagem de espera** que aparece (até 500 caracteres, enviada exatamente como escrita em todos os canais).

- Cada contato que escrever durante a interrupção recebe a mensagem de espera **uma vez**. Uma segunda ou terceira mensagem do mesmo contato enquanto o saldo ainda estiver vazio não recebe nada extra, para que ninguém seja incomodado com spam.
- A mensagem aparece no chat como qualquer outro balão de saída, marcada como enviada pela IA, e não custa créditos.
- Assim que os créditos retornarem (uma recarga, a chegada da franquia mensal ou um limite de gastos maior), a IA retoma essas conversas e as responde de verdade, da mesma forma que já faz para chats interrompidos durante uma falta de crédito. Um contato que um membro da equipe respondeu manualmente nesse meio tempo não é afetado.
- Desativar a resposta mantém o texto que você digitou, para que você possa ativá-la novamente mais tarde sem precisar redigitar.

::: master-only
<figure><img src="../.gitbook/assets/v2-sub-account-edit-zero-credit-reply.png" alt="A seção de Créditos do modal Editar subconta com a opção Resposta de espera quando sem créditos ativada e uma caixa de Mensagem de espera lendo Obrigado pela sua mensagem! Estamos ausentes agora e retornaremos em breve."><figcaption><p>O interruptor <strong>Resposta de espera quando sem créditos</strong> fica abaixo de <strong>Acumular créditos não utilizados</strong>; ativá-lo revela a caixa <strong>Mensagem de espera</strong>. Nada é enviado até que você clique em Salvar.</p></figcaption></figure>
:::

O mesmo interruptor está disponível via API para agências: `PUT /v1/subaccounts/{subAccountUid}/zero-credit-reply` com `{ "enabled": true, "message": "…" }`.

### Rastreamento de uso

- **Detalhes de uso de créditos** (menu **Mais** da linha) — um detalhamento por subconta: total de créditos usados, custo em USD (oculto quando a subconta utiliza sua própria chave BYOK), um gráfico de uso por motivo, principais campanhas por gasto e uma tabela com intervalo de datas filtrável de cada cobrança e reembolso individual. Cada linha de cobrança mostra o **modelo** em que foi faturado (Pro, Economy, Max ou Mini) e, nas linhas onde você reajustou o preço da ação para aquele cliente, uma linha **Faturado ao cliente** mostra quanto foi debitado do saldo do cliente ao lado do que sua conta de agência realmente pagou.
- **Blocos de estatísticas** na parte superior da página de Subcontas — contagens agregadas de campanhas ativas/pausadas e quantas subcontas apresentam problemas no momento.

### Valor de gastos BYOK por subconta

Se você revende BYOK (sua própria chave de provedor de IA) para subcontas, defina um valor de gasto mensal — em dólares americanos — por subconta, para que você possa rastrear quanto cada cliente está consumindo na sua chave. Defina ou limpe-o no modal **Editar** daquela subconta (exibido apenas quando a subconta possui uma chave BYOK ou já tem um limite definido); deixe em branco para nenhum valor. O valor é redefinido no início de cada mês de faturamento.

> **Este é um indicador de orçamento, não um limite rígido.** Ele ajuda você a ficar de olho no que cada cliente está gastando — ele não interrompe automaticamente uma subconta quando ela ultrapassa o valor.

---

## Faturamento de Subconta

### Checkout personalizado da agência

Se você configurou a revenda de créditos no **Modo SaaS**, existem duas maneiras de lidar com os pagamentos:

**Stripe (padrão):** conecte sua conta Stripe no assistente de configuração do Modo SaaS, configure os níveis de preços e as subcontas serão direcionadas para seu checkout com sua marca quando precisarem de créditos. Os pagamentos vão para sua conta Stripe e os créditos são entregues automaticamente.

**Webhook (provedor de pagamento personalizado):** insira uma URL de webhook no Modo SaaS em vez de conectar o Stripe. Quando os créditos de uma subconta caem abaixo do limite de recarga automática, a plataforma envia os detalhes para sua URL de webhook; seu servidor processa o pagamento e chama a API para conceder créditos. Veja [Recarga Automática de Subconta](sub-account-auto-recharge.md) para os detalhes técnicos.

### O que o cliente vê na página de Faturamento

Assim que uma subconta estiver no **modo de revenda**, a própria página **Configurações → Faturamento** do cliente (no seu domínio white-label) mostrará tudo o que ele precisa para pagar você diretamente — sem necessidade de link de checkout:

- **Seus planos** — os planos que você configurou no Modo SaaS, com seus preços, com um botão **Assinar** que abre seu checkout do Stripe personalizado. Os créditos do plano são renovados mensalmente. Um plano que você definiu para cobrança anual é rotulado como *"por ano · N créditos por mês"*, para que o cliente possa ver que paga uma vez por ano e ainda recebe sua franquia a cada mês. Um plano com teste gratuito é exibido como *"Teste gratuito de X dias, depois $…"* com um botão **Iniciar teste gratuito** em vez de um botão de preço — a mesma redação que seu link de pagamento e checkout incorporado usam. Um teste é apenas para novas inscrições, portanto, uma subconta que já existe (criada por você, assinada anteriormente ou que já passou por um teste) é cobrada imediatamente — veja [Executando um teste gratuito](#running-a-free-trial).
- **Comprar créditos adicionais** — uma recarga única pelo seu preço por crédito, com a observação que você definiu abaixo dele (se houver — por exemplo, um preço de referência em outra moeda). Isso funciona por conta própria: um cliente não precisa de um plano antes de comprar créditos, e os créditos comprados são acumulados.
- **Recarga automática** — o cliente pode salvar uma forma de pagamento e ter créditos recarregados automaticamente sempre que seu saldo cair abaixo de um limite definido por ele.
- **Gerenciar faturamento** — após a primeira compra, um botão de portal onde eles visualizam faturas, atualizam seu cartão e gerenciam sua assinatura.

::: master-only
<figure><img src="../.gitbook/assets/v2-sub-billing-reselling-plans.png" alt="A página Configurações → Faturamento de uma subconta de revenda, mostrando o cartão 'Quanto custa cada ação' e o cartão 'Planos' da agência com três planos, cada um listando créditos mensais, recursos incluídos e um botão 'Escolher plano'"><figcaption><p>A página de <strong>Faturamento</strong> do cliente no modo de revenda: seus planos, com seus preços, cada um com um botão <strong>Escolher plano</strong> que abre seu checkout.</p></figcaption></figure>
:::

::: master-only
<figure><img src="../.gitbook/assets/v2-sub-billing-reselling-topup.png" alt="O cartão 'Comprar créditos adicionais' mostrando o preço por crédito e um campo de entrada 'Quantos créditos' com um botão 'Comprar créditos', e abaixo dele o cartão 'Recarga automática' com um botão 'Adicionar método de pagamento'"><figcaption><p><strong>Comprar créditos adicionais</strong> funciona sem qualquer plano — compras únicas pelo seu preço por crédito. A <strong>Recarga automática</strong> é ativada assim que o cliente adiciona um método de pagamento.</p></figcaption></figure>
:::

::: master-only
<figure><img src="../.gitbook/assets/v2-sub-billing-reselling-manage.png" alt="A parte inferior da página de Faturamento de revenda com o cartão 'Gerenciar faturamento' lendo: Escolha um plano mensal, compre créditos adicionais ou ambos. Sua primeira compra configura o faturamento para este espaço de trabalho com segurança."><figcaption><p>Antes da primeira compra, <strong>Gerenciar faturamento</strong> explica que comprar qualquer coisa configura o faturamento; depois, torna-se um botão de portal para faturas e alterações de cartão.</p></figcaption></figure>
:::

Isso se aplica igualmente a contas que você criou manualmente: altere uma subconta manual existente para o modo de revenda a partir do seu modal **Editar** e sua página de Faturamento ganhará tudo o que foi mencionado acima. Nada mais na conta muda — sua configuração, canais e histórico de conversas permanecem exatamente como estavam, e a primeira compra do cliente conecta seu faturamento nos bastidores. Membros da equipe da subconta com permissão de faturamento também podem fazer compras para o espaço de trabalho — a compra sempre é vinculada ao espaço de trabalho, não à pessoa que está pagando.

### Portal de cobrança do cliente

O portal de faturamento do cliente está disponível apenas para subcontas no **modo de revenda**. Uma subconta ainda no modo manual não pode abrir um portal — em vez disso, você gerencia o saldo dela no modal Editar.

Subcontas que realizaram uma compra através da sua agência podem abrir o portal de faturamento a partir da sua própria página **Configurações → Faturamento** para visualizar o histórico de faturamento, atualizar formas de pagamento e gerenciar sua assinatura. Você também pode gerar um link para este portal a partir do Modo SaaS e compartilhá-lo com o cliente.

---

## Copiar uma campanha para uma subconta

Criou uma campanha que funciona? Copie-a para uma ou mais de suas subcontas com alguns cliques em vez de reconstruí-la manualmente.

**Quem pode fazer isso:** você e membros da equipe com permissão para editar campanhas. Você pode copiar de sua conta de agência ou de qualquer subconta para outra subconta — e, enquanto estiver conectado a uma subconta, você também pode copiar uma campanha lateralmente para outra subconta.

### Como copiar

Na página **Subcontas**, abra o menu **Mais** da linha do cliente e escolha **Copiar campanha para cá**. O destino já está selecionado; você escolhe a campanha de origem.

Está criando algo novo? Copie o **Agente** em vez disso — veja [Copiar um Agente de IA para uma Subconta](#copy-an-ai-agent-to-a-sub-account) abaixo. Para entregar ao cliente uma configuração completa de uma só vez, em vez de um único Agente, um **Snapshot** a empacota como um modelo reutilizável que você pode instalar em qualquer subconta. Veja [Snapshots](snapshots.md).

O modal então mostra:

1. **Campanha de origem** — um menu suspenso com suas campanhas.
2. **Alternância da base de conhecimento de FAQ** (ativada por padrão) — copia as FAQs da campanha para a conta de destino.
3. **Alternância de funções personalizadas** (desativada por padrão) — copia as funções personalizadas anexadas. Desativada por padrão porque as funções geralmente contêm configurações específicas da conta (chaves de API, endpoints).
4. **Novo nome da campanha** (opcional) — deixe em branco para manter o nome original.
5. **Subcontas** — uma lista pesquisável de seleção múltipla das suas subcontas. Marque quantas quiser para copiar a campanha para todas de uma vez. Precisa de um cliente que ainda não existe? Clique em **+ Nova subconta** ali mesmo para criar uma sem sair do modal — ela é adicionada à sua seleção automaticamente assim que você terminar.

Clique em **Copiar para N subconta(s)**. Uma tela de resultados confirma cada destino como **Copiado** ou mostra o erro se algum falhar — uma falha parcial não desfaz as contas que tiveram sucesso.

### O que é copiado

- A **configuração completa do bot** — persona, objetivo, regras, fluxo de conversa, informações da empresa, limite de mensagens e cronograma de disponibilidade.
- A **mensagem de abertura** e as instruções do bot.
- **FAQs e a base de conhecimento** (quando a alternância está ativada) — incluindo arquivos carregados e fontes da web.
- **Funções personalizadas** (quando a alternância está ativada).
- Quaisquer **arquivos de mídia** carregados na campanha.
- Suas **configurações de acompanhamento**, incluindo a redação das mensagens de acompanhamento.

### O que você precisará refazer na subconta

Algumas coisas estão vinculadas a cada conta individual e não podem ser transferidas:

- **Modelos de mensagem do WhatsApp** devem ser recriados e reenviados para aprovação. Os modelos estão vinculados à configuração de WhatsApp/Twilio de cada conta, portanto, a cópia não pode reutilizá-los.
- **Canais e o número de telefone** precisam ser selecionados novamente — a cópia não traz as conexões de canal.
- A **lista de contatos** deve ser escolhida (ou importada) na subconta; contatos nunca são copiados.

> **A cópia chega como um Rascunho.** Nada é enviado até que você revise, conclua as etapas acima e coloque em modo Ativo — assim, você tem tempo para verificar tudo primeiro.

---

## Copiar um Agente de IA para uma Subconta

Passou uma semana configurando um Agente de IA para responder exatamente como você deseja? Copie-o para uma ou mais de suas subcontas em vez de reconstruí-lo manualmente na conta de cada cliente.

### Como copiar

Existem dois pontos de entrada, e eles abrem a mesma janela com campos diferentes pré-preenchidos:

- **Na página Agentes de IA**, na linha do agente, clique no ícone de duas setas ao lado de Duplicar — a dica de ferramenta diz **Copiar este agente para uma subconta**. O agente já está selecionado; você escolhe o(s) destino(s).
- **Na página Subcontas**, abra o menu **Mais** de uma linha e escolha **Copiar agente para cá**. O destino já está selecionado; você escolhe qual agente copiar.

A janela então solicita:

1. **Agente** (se ainda não estiver selecionado) — uma lista suspensa dos seus agentes.
2. **Alternância de FAQs e conhecimento** (ativada por padrão) — copia as FAQs, arquivos enviados e fontes de conhecimento do agente para a conta de destino.
3. **Alternância de funções personalizadas e ferramentas conectadas** (desativada por padrão) — copia as funções personalizadas e as ferramentas de servidor MCP do agente. Desativada por padrão porque geralmente contêm detalhes específicos da conta (chaves de API, endpoints) que pertencem à sua conta e não à do cliente.
4. **Novo nome do agente** (opcional) — deixe em branco para manter o nome original.
5. **Subcontas** — uma lista na qual você pode marcar quantas entradas desejar, para que uma cópia possa ser enviada para várias contas de clientes de uma só vez.

Clique no botão de copiar e uma tela de resultados confirmará cada conta como copiada, ou nomeará o erro caso alguma não tenha sido concluída.

### O que é copiado

Tudo o que o agente precisa para funcionar na conta do cliente:

- Suas **Instruções de IA** — persona, objetivo, contexto de negócios, regras, escalonamento, ritmo de resposta, limites de mensagens e idioma principal.
- Suas **FAQs e base de conhecimento** (quando a alternância está ativada), incluindo arquivos enviados e fontes da web vinculadas.
- Suas **funções personalizadas e ferramentas conectadas** (quando a alternância está ativada).
- Sua **mídia** — as imagens, vídeos, GIFs, notas de voz e documentos que ele pode enviar.
- Seus **horários ativos**, **regras de tags** e **configurações de acompanhamento**, incluindo a redação das mensagens de acompanhamento.

### O que você precisará fazer na subconta

- **Conectar os canais do cliente.** As conexões de canal nunca são copiadas — a cópia não possui número de telefone, caixa de entrada ou página própria até que você aponte um para ela.
- **Recriar modelos de mensagem do WhatsApp.** Os modelos pertencem à configuração de WhatsApp de cada conta, portanto, os modelos de acompanhamento precisam ser gerados e enviados para aprovação novamente na conta do cliente.
- Contatos nunca são copiados.

> **A cópia chega desativada.** Ela entra na conta do cliente como um agente pausado, para que nada responda a ninguém até que você a tenha revisado, conectado os canais e ativado por conta própria.

> **Uma cópia que encontra problemas não deixa nada para trás.** Se algo falhar no meio do caminho — um arquivo de conhecimento que não é transferido, por exemplo — a cópia inteira para aquela conta é desfeita, em vez de deixar um agente parcialmente construído para você encontrar mais tarde. A cópia para várias contas ao mesmo tempo é avaliada por conta: uma falha não desfaz as que funcionaram.

---

## Limites de Subconta

Seu plano determina quantas subcontas você pode criar. As subcontas vêm com os planos Agency e Agency Unlimited, e são desbloqueadas progressivamente nos planos AppSumo.

**Onde verificar o que você utilizou:** o bloco **Subcontas** no topo da página de Subcontas mostra quantas você tem atualmente, com o seu limite abaixo — seja *de {limit} no seu plano* ou *Ilimitado no seu plano* caso não haja um teto. Se estiver como Ilimitado, não há um total para contagem regressiva e você não atingirá um limite, independentemente de quantas adicionar. Sua lista completa de direitos também aparece em **Configurações → Faturamento** em **O que está incluído no seu plano**.

**Planos atuais:**

| Plano | Limite de subcontas |
|---|---|
| Business | 0 |
| Agency | 10 incluídas, depois $29 por mês para cada uma extra |
| Agency Unlimited | Ilimitado, sem taxa por conta |

Nota: os planos Starter, Growth, Pro e Agency em que algumas contas ainda estão foram descontinuados em agosto de 2026 e não representam mais os preços atuais. Os assinantes existentes mantêm o plano em que estão, incluindo a franquia de subcontas.

**Planos vitalícios AppSumo:**

| Plano AppSumo | Limite de Subconta |
|---|---|
| Plano 1 | 0 |
| Plano 2 | 3 |
| Plano 3 | 10 |
| Plano 4 | 20 |
| Plano 5 | 100 |
| Plano 6 | Ilimitado |

Se você atingir seu limite e precisar de mais subcontas, faça o upgrade para o plano Agency ou Agency Unlimited em [dmchamp.com/pricing](https://dmchamp.com/pricing/), ou entre em contato com o suporte para um contrato personalizado. A oferta vitalícia do AppSumo terminou em 14 de agosto de 2026, portanto, alterações de nível através do AppSumo não estão mais disponíveis.

> Uma subconta é um espaço de trabalho separado, não um único agente de IA. Dentro de qualquer conta ou subconta, você pode criar várias campanhas (ou [Agentes de IA](../ai-agents/ai-agents.md)), e cada uma atua como seu próprio agente de IA. Portanto, um Plano 4 com 20 subcontas pode executar dezenas de agentes distintos no total.

---

## Perguntas comuns

**Não vejo a página Subcontas na minha barra lateral.** O gerenciamento de subcontas é um recurso do plano de Agência. Se sua conta não tiver a função de agência, não há nada para mostrar — verifique seu plano em **Configurações → Espaço de trabalho → Faturamento** ou pergunte ao proprietário da conta.

**Posso dar a um membro da equipe acesso a apenas alguns dos meus clientes?** Sim — abra o editor de Permissões dele na página da sua equipe de agência, defina **Contas de cliente** como **Clientes selecionados** e marque aqueles aos quais eles devem ter acesso, depois escolha a função que eles desempenham dentro delas. Veja [Concedendo acesso a membros da equipe às contas de clientes](#giving-team-members-access-to-client-accounts).

**Posso alternar entre subcontas sem voltar à lista toda vez?** Sim — o controle **Alternar conta** na parte superior da barra lateral funciona de qualquer lugar no aplicativo, não apenas na página Subcontas, e é pesquisável.

**Excluí a subconta errada.** A exclusão é permanente e remove todos os chats, contatos e campanhas dessa conta — há uma etapa de confirmação justamente porque não pode ser desfeita. Se isso acontecer, entre em contato com o suporte imediatamente; não espere.

**Os créditos de uma subconta acabaram e o bot parou de responder.** Verifique primeiro o saldo da sua própria agência — no modo manual, o cliente gasta do seu saldo, portanto, um saldo vazio interrompe todas as subcontas, não importa quão alto seja o **Limite de gastos** delas ([por que](#the-spending-limit-is-a-cap-not-a-wallet)). Recarregue a conta da sua agência em **Configurações > Faturamento** e aumente o limite do cliente em **Editar → Gerenciamento de Créditos** se for isso que está limitando o uso. No modo de revenda, o cliente precisa comprar mais através do seu checkout, ou você pode configurar a [recarga automática](sub-account-auto-recharge.md) para que isso aconteça automaticamente.

---

## Melhores práticas

- **Configure a recarga automática** em sua conta de agência (via Modo SaaS) para que as subcontas nunca percam a funcionalidade de IA devido ao esgotamento de créditos.
- **Use a cópia de campanhas** para integrar novos clientes rapidamente com configurações que já funcionam.
- **Monitore o uso de crédito regularmente** através dos **Detalhes de uso de crédito** de cada subconta para detectar picos inesperados antes que eles drenem seu saldo.
- **Mantenha o modo de login para suporte** — em vez de compartilhar credenciais da agência, use **Entrar como usuário** para ajudar os clientes diretamente do seu painel.
- **Configure a revenda de créditos** no Modo SaaS se quiser que as subcontas paguem pelo seu próprio uso, criando um fluxo de receita para sua agência.
- **Escolha o modo de crédito certo por cliente** — manual para clientes que você gerencia de ponta a ponta, revenda para clientes que devem lidar com suas próprias compras de crédito.

---

## Precisa de ajuda?

If you have questions about sub-account management, reach out via our [email support](mailto:hi@dmchamp.com).
