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 seus próprios agentes de IA, contatos, chats e configurações — enquanto você mantém a supervisão e o controle a partir do seu painel de agência.

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.

Uma subconta pode ter suas próprias subcontas? #

Não. Existe apenas um nível. Cada conta de cliente fica diretamente abaixo da sua agência, e uma subconta nunca pode criar suas próprias subcontas.

Se um de seus clientes revende para empresas próprias, você cria essas contas para eles a partir da sua página de Subcontas. Você pode colocar esse cliente em seu próprio domínio white label (veja Até Três White Labels), e com o Modo SaaS, eles compram seus créditos pelo preço por crédito que você definir (veja Contas de Agência).

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.

No topo da página, você encontrará seis blocos de estatísticas — Subcontas (com sua franquia do plano abaixo), Com problemas, Agentes ativos, Agentes inativos (quantos Agentes de IA dos seus clientes estão ligados e desligados no momento, em todas as contas), Alocados para clientes e Não alocados (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?) — 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) 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 for processado. Você não precisa intervir em cada nova inscrição, e um cliente que se inscreve através do seu checkout é criado automaticamente no modo de revenda, para que a página de Faturamento dele exiba seus planos e recargas desde o primeiro dia. Os planos podem ser cobrados mensal ou anualmente e, se o plano incluir um período de teste gratuito, o cliente começa sem pagar nada e é cobrado automaticamente quando o teste termina — veja Executando um teste gratuito.

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 correto desde o início. Apenas você pode alternar uma subconta de um modo para o outro (a configuração de Gerenciamento de Crédito em seu modal Editar, ou creditManagementMode via API); o cliente não pode. Um minuto de reflexão agora evita 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). 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). Defina isso por plano em Passo 3 — Configurar níveis de preços.
• 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.
• 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 na página de Subcontas ou via API. Nenhum pagamento está envolvido; ela começa no modo manual, consumindo do seu pool de agência dentro da franquia e do limite de gastos que você definir. O mesmo fluxo funciona para clientes “done-for-you”: crie a conta, aplique um snapshot e construa o agente antes mesmo de o cliente fazer login.
2. Quando decidir que o período de teste acabou, abra o modal Editar da subconta e alterne o Gerenciamento de Crédito para revenda (via API: PUT /v1/subaccounts/{uid}/limits com {"creditManagementMode": "reselling"}).
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), 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á o plano ou seus créditos a uma conta em modo manual, nada é reembolsado automaticamente e a assinatura do cliente permanece ativa na sua conta Stripe, portanto, eles continuarão sendo cobrados até que você cancele ou reembolse por lá. Alterne o modo primeiro, depois envie o link.

• O cliente deve pagar com o mesmo endereço de e-mail que sua subconta de teste utiliza. Mesmo e-mail = a assinatura atualiza a 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 pertence a uma conta fora da sua agência é recusado e reembolsado automaticamente.)
• Não existe um link de checkout vinculado a um ID de subconta e nenhuma chamada de API que coloque uma conta em um plano. O endereço de e-mail é o que conecta o pagamento à conta existente, portanto, use uma das duas rotas no passo 3.

O que o plano altera em uma subconta existente:

• Os créditos são acumulados. Os créditos do plano são adicionados ao saldo que a conta já possui; nada é redefinido. Cada renovação adiciona os créditos do plano novamente.
• Sua franquia mensal permanece. Uma franquia mensal que você definiu manualmente continua sendo creditada todo mês a partir do seu pool de agência, além do plano. Defina-a como zero no modal Editar se o plano deve ser a única fonte de créditos.
• Recursos são adicionados, não substituídos. A lista de recursos do plano é ativada, e os recursos que você concedeu manualmente permanecem ativos.
• Os limites do plano prevalecem. Os limites de assentos de equipe, agentes e canais do plano substituem os limites que você definiu manualmente no momento da compra.

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 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:

Etapa 1 — Conta #

• Nome e Sobrenome.
• Endereço de e-mail — este se torna o e-mail de login da subconta. Um e-mail pode ser proprietário de apenas uma conta, portanto, um cliente com vários locais precisa de um endereço diferente para cada local. Endereços com sinal de mais são a maneira mais fácil: [email protected] e [email protected] chegam à mesma caixa de entrada no Gmail e no Microsoft 365, mas cada um conta como seu próprio login. As pessoas que realmente gerenciam os locais são então convidadas para cada conta como membros da equipe em Configurações → Equipe com seus endereços reais, e elas alternam entre os locais a partir do seletor de contas na barra lateral (veja Gerenciamento de Equipe).

Clique em Continuar.

Passo 2 — Empresa #

• 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 #

Se você salvou pacotes, a etapa abre com um seletor de Pacote que preenche esta etapa para você.

Se você tiver snapshots, a seção Modelo vem a seguir. Ela escolhe o snapshot a partir do qual este cliente começa: seus agentes de IA, conhecimento, ferramentas, automações, pipelines e campos personalizados são copiados logo após a criação da conta. Seu snapshot padrão está marcado como (padrão) e selecionado para você. Escolha outro snapshot para dar a este cliente uma configuração diferente, por exemplo, uma por nicho, ou Sem modelo para criar a conta vazia.

• 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 para desenvolvedores, 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 um botão de 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 permanece após as renovações do plano. O mesmo grupo possui Criar e Editar Automações, Enviar Transmissões e Criar Listas Inteligentes: desative um e o cliente continuará usando o que você criou para ele, mas não poderá criar, editar ou excluir os seus próprios (consulte Configurar níveis de preços).
• O grupo Produtividade contém os dois botões de alternância do assistente do cliente. Assistente do cliente mostra seu assistente com sua marca dentro da conta deste cliente. Assistente do cliente pode fazer alterações também permite que ele altere a conta do cliente para ele após a confirmação; sem isso, o assistente responde e mostra onde clicar. Ambos começam desativados.
• 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 sozinho). 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 mostra uma mensagem clara indicando o limite; reconectar um canal que eles já possuem (digitalizar novamente um QR do WhatsApp, por exemplo) nunca é bloqueado. Um limite definido aqui conta como uma substituição manual, portanto, ele permanece após as renovações do plano.
• O grupo Tipos de Canal nessa lista decide quais canais de mensagens este cliente pode conectar — Widget de Chat, 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 nota para atualizar o plano dele.

• White label — exibido apenas quando você usa mais de um domínio white label. Escolhe a qual das suas marcas este cliente pertence: o logotipo, nome e domínio nos quais eles fazem login, os e-mails que recebem (enviados através da configuração de e-mail desse domínio) e seus links curtos. Ele começa na marca do domínio em que você está trabalhando, portanto, um cliente que você cria enquanto está logado no domínio da sua segunda marca pertence a essa marca; em qualquer outro endereço, ele começa em Principal, que segue o domínio que for o seu principal. Você pode alterá-lo posteriormente na tela Editar da subconta, onde a mesma opção se encontra em White label.
• 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 que você deseja: 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 você mesmo — a senha é então 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 faz login. Desative-o e eles serão direcionados para a tela inicial normal — o painel em um computador, seus chats em um telefone — com a entrada Assistente de Configuração oculta na barra lateral deles (veja Desativando o assistente de configuração).

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 Entrar que o leva diretamente para sua página de login com 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 é enviado — a senha chega a você, na sua própria 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 transmissões imediatamente sem esperar que você adicione créditos. Nada é retirado do seu pool da agência para configurar isso — veja O limite de gastos é um teto, não uma carteira. Ajuste o limite de gastos a qualquer momento no modal Editar daquela subconta — veja Alocação e Gerenciamento de Créditos.

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 isso para clientes com serviço completo (done-for-you), onde você cria o agente de IA, conecta os canais e carrega a base de conhecimento antes mesmo de o cliente fazer login. Esses clientes abrem o painel em uma conta finalizada, 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.

Pacotes: reutilize uma configuração de cliente #

Se a maioria dos seus clientes recebe a mesma configuração, salve-a uma vez como um pacote e selecione-a ao adicionar o próximo cliente, em vez de definir cada opção manualmente todas as vezes. Apenas contas de agência podem salvar pacotes, e você pode manter até 20.

Salvando um pacote #

1. Abra o modal Editar de uma subconta e configure-a da maneira que deseja que o pacote fique.
2. Clique em Salvar como pacote, logo acima de Salvar.
3. Digite um nome e confirme.

O pacote assume as configurações exibidas no modal naquele momento, incluindo alterações que você ainda não salvou:

• créditos mensais e o modo de crédito (manual ou revenda)
• recursos
• os limites de assentos da equipe, agente de IA e canais
• os modelos de IA que este cliente pode usar e a chave Permitir nível máximo de IA
• quais itens de menu estão ocultos
• quais widgets do painel estão ocultos e sua ordem

Ao lado do nome, você também pode escolher um modelo para o pacote: Modelo padrão (qualquer que seja o seu snapshot padrão quando você adiciona o cliente), Sem modelo ou um de seus snapshots. Escolher o pacote em Adicionar subconta seleciona esse modelo também. Se esse snapshot tiver sido excluído desde então, seu modelo padrão será selecionado e uma nota informará isso.

Salvar com um nome que você já usou atualiza esse pacote.

Usando um pacote em um novo cliente #

Em Adicionar subconta, a etapa Recursos abre com uma seção Pacote: Sem pacote mais cada pacote que você salvou. Escolher um pacote preenche os recursos e limites nessa etapa imediatamente, e uma linha abaixo lista o que mais é aplicado assim que a conta é criada: créditos, modo de crédito, modelos de IA, o nível máximo e itens de menu ocultos.

Depois de clicar em Criar conta, essas configurações extras são aplicadas ao novo cliente. Se uma delas não puder ser aplicada, a conta ainda será criada e a tela de sucesso mostrará um aviso sobre essa parte; abra o modal Editar do cliente e configure-a lá.

Sem pacote funciona exatamente como antes: você define tudo sozinho.

O modo de revenda precisa de white label. Um pacote definido para o modo de revenda só pode mudar um novo cliente para revenda quando sua agência tiver o white labeling configurado. Caso contrário, essa parte não é aplicada e a tela de sucesso mostrará um aviso sobre isso.

Excluindo um pacote #

Selecione o pacote na seção Pacote da etapa Recursos e clique em Excluir pacote ao lado dele, depois confirme. Clientes já criados com ele mantêm suas configurações.

Sem pacotes salvos, a seção Pacote exibe uma dica apontando para Salvar como pacote no modal de Edição.

Automatize o que acontece com as contas de clientes #

Contas de clientes podem iniciar uma Automação na sua conta de agência, para que a parte rotineira de integração e acompanhamento aconteça sem você. O formato é sempre o mesmo: o gatilho Subconta criada, seguido pelo que você faria manualmente em cada novo cliente.

1. Na sua conta de agência, vá para AI Studio → Automações → Nova automação, clique no gatilho na tela e depois em Alterar gatilho.
2. Abra Agência e escolha Subconta criada.
3. Adicione as etapas desejadas. Uma ação Atualizar subconta já aponta para a conta que acabou de ser criada, então você só preenche os valores que deseja alterar e deixa o restante vazio. Salve e, em seguida, ative a opção Habilitado.

Não existe uma sequência de e-mail de integração integrada para clientes: uma nova conta recebe um e-mail de boas-vindas com seus detalhes de login e o Assistente de Configuração no primeiro acesso. Se você deseja uma sequência de e-mails (drip), crie-a aqui: Sub-conta criada, depois uma etapa de E-mail (seu servidor de e-mail) para o e-mail do cliente (insira-o a partir do gatilho com o botão +), um Atraso de um ou dois dias, o próximo e-mail, e assim por diante.

O que você coloca na etapa 3 depende de você: dar as boas-vindas à pessoa de contato do cliente, avisar sua própria equipe, definir o limite mensal da conta ou configurar seu quadro e etiquetas (veja Exemplo: configurar o pipeline e as etiquetas de uma nova conta de cliente).

Um exemplo, se for adequado à forma como você vende: novas contas de clientes chegam com um limite de gastos de 100 créditos, então uma etapa de Atualizar subconta com o Limite de gastos definido como 0 mantém cada nova conta em zero até que você mesmo o aumente. Isso é opcional, e muitas agências preferem deixar o limite inicial como está para que o cliente possa experimentar o produto no momento em que fizer login.

Mais duas combinações que valem dez minutos cada: Atividade da subconta em Créditos baixos para uma mensagem no Slack ou um e-mail para você, para que saiba que um cliente está ficando sem saldo antes mesmo dele (defina o Limite de crédito baixo do gatilho para o saldo sobre o qual você deseja ser notificado e adicione uma Condição em Recarga automática ativada como falso para ignorar os clientes que fazem recargas automáticas); e o mesmo gatilho em Canal desconectado para uma etapa de Alertar humano, para que uma conexão do WhatsApp que cair seja detectada 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: ID, Conta, Status, Criado, Última redefinição, Créditos restantes, Mensal, Usado, Uso, BYOK (apenas quando pelo menos uma conta traz sua própria chave de IA), Agentes e Ações.

Status informa rapidamente quais clientes estão operando e quais não estão, sem precisar abrir cada conta:

• Ativo — a conta está em uso normal. Para uma conta gerenciada (faturada por você fora da plataforma), este é o estado normal; um cliente de revenda a exibe enquanto a assinatura dele com você estiver em dia.
• Teste — um cliente de revenda que ainda está no período de teste gratuito do seu plano.
• Problema de pagamento — um cliente de revenda cujo último pagamento falhou ou está atrasado e o Stripe está tentando realizar a cobrança novamente.
• Cancelado — um cliente de revenda cuja assinatura com você terminou. Nenhum novo crédito mensal é concedido; bloqueie a conta se ela precisar ser interrompida completamente.
• Pausado — você definiu a conta como Bloqueio leve: o envio está desativado, a IA ainda responde às mensagens recebidas.
• Bloqueado — você definiu a conta como Bloqueio total (ou um teste expirado resultou nisso): o envio e as respostas da IA estão desativados e o cliente vê a tela de bloqueio.

Passe o mouse sobre um indicador para ver a explicação resumida. Pausado e Bloqueado vêm do Status da conta que você define no modal de Edição (veja Bloqueando / Pausando uma Subconta); os outros quatro seguem a assinatura do cliente com você.

Agentes mostra quantos Agentes de IA do cliente estão ligados e quantos estão desligados (rascunhos que nunca foram finalizados não são contabilizados; passe o mouse para vê-los). Nenhum significa que o cliente ainda não possui agentes. O selo Com problemas na mesma célula sinaliza uma conta que precisa de atenção; passe o mouse sobre ele para ver o motivo. Em uma conta com agentes, isso vem da pontuação de prontidão dos agentes ligados: um canal que está configurado, mas offline (aguardando uma leitura de QR code, por exemplo), um agente que não pode trabalhar (sem instruções, agendamentos prometidos, mas não configurados, roteado apenas em canais que não estão conectados, como Instagram ou Messenger após a desconexão da Meta), ou nenhum agente ligado conectado a um ponto de entrada. Agentes desligados nunca geram esse aviso, pois desligá-los é uma escolha sua. Em uma conta que ainda executa campanhas clássicas e não possui agentes, a célula mostra a contagem de campanhas, e o selo sinaliza campanhas pausadas ou interrompidas.

Um cliente que se inscreveu por conta própria através de um link de pagamento com tags UTM exibe uma linha de Origem abaixo do seu e-mail, por exemplo Origem: facebook / paid / spring_sale (origem / meio / campanha; passe o mouse sobre ela para ver também as tags de conteúdo e termo). Os cartões exibem a mesma linha. Veja Compartilhe seus links de pagamento para saber como marcar um link. A API retorna as mesmas tags no campo acquisition da subconta.

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 aquela subconta.
• Detalhes de uso de crédito — um detalhamento do uso.
• Editar — o modal completo de Editar Subconta (créditos, notificações, recursos, visibilidade de menu, acesso).
• Copiar agente para cá — copie um de seus Agentes de IA para esta subconta. Veja Copiar um Agente de IA para uma Subconta.
• Entrar como usuário — acesse o painel da subconta diretamente.
• Excluir conta — remova permanentemente a subconta e tudo o que está nela.

Visualização em cartões #

Prefere visualizar seus clientes em vez de ler uma tabela? Use os dois pequenos botões na extremidade direita da barra de pesquisa para alternar entre Visualização em tabela e Visualização em cartões. A página memoriza a opção que você escolheu.

Cada cartão mostra o nome e o contato do cliente, os mesmos selos de Status e Agentes da tabela, os créditos restantes com a barra de uso deste mês e o gasto BYOK quando o cliente utiliza sua própria chave de IA. Um cliente que precisa de atenção recebe um contorno vermelho e seus problemas são descritos no cartão, para que você possa ver o que há de errado sem precisar passar o mouse.

Dois botões ficam na parte inferior de cada cartão:

• Abrir conta conecta você como esse cliente (o mesmo que Entrar como usuário).
• O botão de chat abre os chats do cliente, apenas para leitura.

O menu de três pontos no canto do cartão contém todas as outras ações da tabela.

Se seus clientes estiverem distribuídos em mais de uma marca white-label e nenhuma marca for selecionada no menu suspenso Marca, os cartões serão agrupados sob um cabeçalho por domínio de marca, com o número de clientes ao lado. Escolha uma marca no menu suspenso para ver apenas os clientes dessa marca.

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.

Demonstrando que uma conta de cliente está ativa, sem compartilhar conversas: não existe uma exportação apenas de registros (tanto a exportação da transcrição do chat quanto o download completo de dados incluem o texto das mensagens). Uma captura de tela da linha do cliente na tabela de Subcontas (Status, Créditos restantes, Usado, Uso, Agentes) ou do painel dele via Entrar como usuário resolve o problema.

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).

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 recarrega sob a identidade daquela subconta — acesso total aos agentes de IA, contatos, chats e configurações deles. Enquanto você estiver dentro de uma subconta, a pílula de alternância fica âmbar e mostra Assistindo: . Clique nela e escolha Voltar para minha agência para retornar ao seu próprio painel a qualquer momento. Uma barra âmbar de Assistindo no topo de cada página contém o mesmo botão Voltar para a conta principal. Se precisar desse 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 a pílula da barra lateral ainda mostra de qual conta você está cuidando.

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.

Alterando o e-mail de login de um cliente #

A tela Editar da subconta não altera seu e-mail. Faça isso de dentro da conta: use Entrar como usuário (acima), abra Configurações → Segurança e Geral e clique em Alterar e-mail (veja Configurações da Conta). Um código de confirmação é enviado para o endereço atual da conta e um segundo para o novo endereço; portanto, se você não conseguir acessar a caixa de entrada atual do cliente, peça a ele o primeiro código. Somente o proprietário da agência pode fazer isso; um membro da equipe conectado à conta do cliente não pode.

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.

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:

Em seguida, defina Atua dentro das contas de cliente como — Administrador, Editor ou Visualizador. Esta é a função que o membro tem uma vez que está dentro de uma conta de cliente concedida, e funciona exatamente como as funções na sua própria equipe (veja Funções). Uma concessão de Visualizador, por exemplo, significa que a pessoa pode ler todos os chats e agentes de IA do cliente concedido, 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 dele 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 — por exemplo, o agente de um cliente que deve ver apenas as conversas atribuídas a ele. Uma concessão define uma função única em todas as contas que ela cobre.
• O cliente deve manter suas próprias FAQs atualizadas sem tocar no bot. Convide-o para sua subconta, abra suas permissões (o ícone de controles deslizantes na linha dele em Configurações → Equipe), defina FAQs como Editar e Agentes de IA como Visualizar, e salve. Eles podem adicionar e editar FAQs na página da Base de Conhecimento e na etapa de FAQs e Conhecimento do agente, enquanto as instruções e configurações do agente permanecem apenas para visualização para eles. Veja Personalizando Permissões.

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 administra mais de um negócio e deseja que cada um seja mantido separado (contatos, agentes de IA e números separados) sem precisar fazer login e logout o dia todo. Você pode dar a eles um único login que acessa 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.

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).

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 por marca, roteado por Pontos de Entrada de Palavras-chave (as regras de palavras-chave são verificadas antes do padrão do canal) e links curtos 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), 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 de uma subconta sem excluir nada. Nada é perdido. Agentes de IA, contatos e histórico de chat permanecem exatamente como estão, e você pode desbloquear a qualquer momento.

1. Abra o modal 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 suave — impede que a subconta envie mensagens (transmissões, envios manuais, acompanhamentos). O bot de IA continua respondendo às mensagens recebidas normalmente, e o cliente ainda pode fazer login e usar o aplicativo.
   • Bloqueio rígido — impede o envio e impede que o bot de IA responda. O cliente ainda pode fazer login, mas vê 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 solicita que você confirme primeiro, já que é uma ação que restringe o acesso.

Algumas coisas que vale a pena saber:

• O encerramento da sua própria assinatura bloqueia todas as subcontas e as desativa. Se a sua assinatura de agência for cancelada, todas as suas subcontas serão bloqueadas automaticamente no momento em que o cancelamento entrar em vigor — os envios e as respostas de IA param e elas veem a tela de bloqueio. Seus números de telefone, canais e Agentes de IA são mantidos por 30 dias: assine novamente dentro desse período e cada subconta será desbloqueada automaticamente com tudo ainda no lugar. Após 30 dias, cada subconta é desativada da mesma forma que sua própria conta: qualquer número de telefone alugado através da plataforma é liberado para que o aluguel pare (um número liberado não pode ser recuperado, veja Números de Telefone de um Cliente), sua conexão com Instagram e Messenger é desconectada e seus Agentes de IA em execução são interrompidos. Contatos, chats, agentes e configurações permanecem. Assinar novamente após esse período ainda remove o bloqueio de cada subconta automaticamente; os canais precisarão ser conectados novamente e os agentes reativados.
• Pausar sua própria assinatura congela as recargas e o aluguel de números dos seus clientes. Enquanto sua assinatura de agência estiver pausada, a franquia mensal de créditos das contas dos seus clientes não é recarregada, e os números que eles alugam conosco não têm o aluguel cobrado nem são liberados. A recarga ocorre automaticamente logo após o término da pausa, e o aluguel volta a ser cobrado nesse momento também.
• O cliente não é notificado automaticamente por e-mail. 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 marca própria (white-label) em seus serviços.
• É totalmente reversível. Alterar o status de volta para Ativo restaura o acesso total imediatamente.
• Um cliente pausado para de contar para o seu plano. Uma subconta definida como Bloqueio rígido não ocupa uma das suas contas de cliente incluídas, e você não é cobrado pela taxa de conta extra por ela. A alteração é precificada por dia: pause uma conta extra no dia 10 e altere-a de volta para Ativo no dia 20, e você pagará apenas por esses dez dias. Portanto, rotacionar clientes é perfeitamente aceitável — você paga apenas pelos que estão ativos. Bloqueio suave é diferente: a IA continua respondendo, então a conta permanece na contagem. Nada mais sobre sua própria assinatura muda quando você bloqueia um cliente, e o que você cobra deles é algo inteiramente entre você e eles.
• Você nunca é bloqueado. A tela de bloqueio é para o login do próprio cliente. Quando você abre uma subconta com bloqueio rígido a partir da sua agência (Entrar como usuário), você obtém o aplicativo completo com a barra Assisting no topo, para que possa verificar configurações, exportar contatos ou corrigir o plano deles, e o botão Voltar para a conta principal leva você diretamente de volta para desbloqueá-los ou atribuir créditos.
• Faturamento e login permanecem sempre abertos. Mesmo em um bloqueio rígido, o cliente ainda pode acessar as telas de faturamento e login/logout — eles nunca são completamente bloqueados da conta em si.
• Um teste expirado com bloqueio rígido define esse bloqueio para você. Se um plano estiver com Bloqueio rígido após o teste ativado e o período de teste de um cliente terminar sem que ele assine, a conta será bloqueada automaticamente com a mensagem “Seu 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 limpar isso aqui como qualquer outro bloqueio. Um bloqueio que você aplicou manualmente nunca é sobrescrito ou limpo por isso, então seu próprio motivo sempre prevalece. Um bloqueio rígido também libera qualquer número que o cliente tenha alugado através da plataforma; um bloqueio que você mesmo aplica não faz isso — libere-o na seção Números de telefone do mesmo modal se quiser que ele seja removido (veja Números de Telefone de um Cliente). Veja Executando um teste gratuito.
• Você também pode pausar e despausar via API. POST /v1/subaccounts/{subAccountUid}/pause aplica o bloqueio rígido (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 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. Veja API para Agências.
• Quer colocar em um temporizador? Crie como uma Automação a partir da sua conta de agência. Em 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 Solicitação HTTP: método POST, endereço https://api.dmchamp.com/v1/subaccounts/{subAccountUid}/pause, cabeçalho X-API-Key com sua chave de API de agência (Configurações → API). Clique em Executar para valer 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.

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.

As taxas mensais de conexão para números do WhatsApp Web, Telegram e WhatsApp Business conectados por meio do aplicativo Meta da plataforma funcionam de maneira diferente: quando o saldo do cliente está muito baixo no dia do vencimento da taxa, esse mês é ignorado para o cliente e a sua parte também não é cobrada. O mesmo vale para o contrário: se o seu próprio saldo não puder cobrir a sua parte, o cliente não será cobrado por aquele mês. De qualquer forma, uma nova tentativa é feita cerca de 30 dias depois, um mês ignorado nunca é cobrado posteriormente e a conexão permanece ativa.

Roteamento de Notificações #

Quando algo acontece em uma subconta que justifica um alerta — um contato precisa de um humano, um bot atinge seu limite de mensagens, um modelo de WhatsApp é aprovado ou rejeitado, uma transmissão termina de enviar suas mensagens iniciais — a plataforma pode enviar um 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 sua agência — quando ativado, você (a agência) recebe esses e-mails de alerta para esta subconta. Desative para clientes que preferem que você não seja 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 da subconta (por exemplo, Mensagens de Contatos Pausados ou Mensagens Pausadas por IA), nem a subconta nem a agência receberão e-mail sobre isso, mesmo com Enviar notificações para sua agência ativado. Os alertas críticos 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 transmissão terminando suas mensagens iniciais. Elas não alteram o comportamento no aplicativo, alertas de faturamento ou a notificação de “nova subconta criada” que você recebe como agência (essa sempre é disparada).

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.

Widgets do painel #

Você também pode escolher quais painéis um cliente vê em seu Painel principal e em qual ordem. Um uso comum é ocultar o Uso de créditos, para que os clientes não vejam o painel de créditos.

1. Abra o modal Editar da subconta (menu Mais da linha → Editar).
2. Encontre a seção Widgets do painel.
3. Desative qualquer widget que o cliente não deva ver. Todos os interruptores começam ativados.
4. Use as setas para cima e para baixo ao lado de um widget para movê-lo para cima ou para baixo no painel dele.
5. Clique em Salvar.

Os widgets que você pode mostrar, ocultar e mover são Cartões de KPI, Desempenho ao longo do tempo, Uso de créditos, Funil de conversão, Instantâneo da caixa de entrada, Resultados da conversa, Saúde do canal, Custo de IA, IA vs humano, Horários mais ativos, Principais agentes, Contatos por país, Atividade recente e Tarefas e negócios.

Bom saber:

• Widgets ocultos simplesmente desaparecem e o restante sobe, para que o painel não tenha lacunas.
• Alguns widgets só aparecem quando se aplicam, independentemente do que você definir aqui. Por exemplo, Custo de IA só aparece em contas que usam sua própria chave de IA, Instantâneo da caixa de entrada precisa de acesso aos contatos e Resultados da conversa fica oculto enquanto um filtro de tag estiver ativado.
• Suas configurações se aplicam ao login do próprio cliente e aos membros de sua equipe. O painel da sua própria agência não é afetado.
• No modo de login, todos os widgets são exibidos, assim como os itens de menu ocultos, para que você possa verificar tudo. Para ver o que o cliente vê, use o login dele.
• O cliente vê a alteração na próxima vez que a página dele carregar.
• Salvar a subconta como um pacote também salva suas configurações de widget do painel.

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.

Três coisas decorrem disso, e elas pegam as agências de surpresa:

• 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 deles 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 coloca nada de volta. Não há transferência em nenhuma das direções, portanto, nada é perdido quando você reduz um limite — defina-o novamente 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.
• Excluir uma subconta também não lhe custa nada. O que quer que tenha restado no limite dela nunca saiu do seu saldo, portanto, ainda estará no saldo da sua agência após a exclusão.

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.

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 do seu pool da agência.
• Quando uma subconta usa créditos (respostas de IA, transmissões, etc.), a dedução vem do saldo da sua agência.
• As subcontas não veem o saldo de créditos — elas simplesmente usam a plataforma e você gerencia o pool.
• Defina a Mesada mensal, ajuste o Limite de gastos diretamente e escolha se uma mesada 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 em seu 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 no Modo SaaS).
• Os créditos comprados são rastreados separadamente por subconta e deduzidos do pool de créditos da sua agência no momento da compra.
• Todas as operações (respostas de IA, transmissões, taxas de WhatsApp, etc.) consomem créditos comprados primeiro antes de recorrer ao seu pool da 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.

A mesada mensal continua sendo aplicada no modo de revenda. Mudar uma subconta para revenda adiciona uma maneira para o cliente comprar seus próprios créditos — isso não desativa a mesada mensal que a conta já tinha. Todo mês, a mesada ainda chega como créditos novos, e o que o cliente gasta dela ainda sai do seu pool da agência, exatamente como no modo manual. Apenas os créditos comprados pelo cliente são protegidos: eles já foram deduzidos do seu pool quando foram comprados, então gastá-los nunca mais toca no seu pool. Para alterar ou zerar a mesada, abra o modal Editar da subconta — o campo Mesada mensal é exibido em ambos os modos. Se você definir como zero e o cliente não possuir créditos comprados, as respostas da IA dele param 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 uma chave própria, mas essas subcontas ainda consomem créditos na taxa normal. Uma subconta só obtém IA com custo zero 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 Max AI (ativado por padrão para cada subconta quando seu próprio plano inclui o Max, e alternável por subconta no modal Editar → Recursos; em um plano sem o Max, a opção não é oferecida e seus clientes permanecem no Pro) 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 Max (com uma assinatura do Champions Circle, seu pool paga 0,20 e 0,12, veja Definindo a taxa de um cliente para ações de IA Max e Mini). Para saber como o BYOK funciona, veja Modelo de IA e BYOK.

Quando a franquia mensal é renovada #

O campo Dia de renovação no modal Editar da subconta → Gerenciamento de Crédito define o dia do mês em que a Franquia mensal do cliente é creditada, de 1 a 31. Em meses mais curtos, um dia que não existe resulta na renovação no último dia daquele mês; portanto, o dia 31 renova em 28 de fevereiro. Deixe em branco para manter o dia em que a conta já é renovada.

• A renovação ocorre à meia-noite UTC nesse dia. Em um fuso horário atrás do UTC, isso corresponde à noite anterior no seu relógio: uma conta com renovação no dia 1 é renovada às 21:00 do último dia do mês anterior em São Paulo, por exemplo. A coluna Última redefinição na tabela de Subcontas mostra a data no seu próprio fuso horário.
• Com a opção “Acumular créditos não utilizados” desativada, o saldo é definido como o valor da franquia: um cliente com 10 créditos restantes e uma franquia de 100 começa o novo mês com 100. Os créditos que o cliente comprou através do seu checkout são mantidos além desse valor.
• Com a opção “Acumular créditos não utilizados” ativada, o valor da franquia é adicionado: o mesmo cliente começa com 110, sujeito aos limites abaixo.
• O valor utilizado neste mês volta a zero de qualquer maneira.

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), 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 Champions Circle (a Tarifa Insider agora se aplica ao seu pool para todos os seus clientes, sem necessidade de ativar nada).
• O que o cliente consome: a tarifa da plataforma por padrão (0,25 no Max, 0,15 no Mini), ou o preço que você definir para aquele cliente na seção Preços de ação do modal Editar da subconta (veja Um preço por ação, qualquer que seja o modelo que responda abaixo). Defina um valor acima do seu custo para incluir uma margem de lucro, por exemplo, 0,5 créditos por resposta de IA enquanto seu pool paga 0,2, ou exatamente o seu custo para repassar sua tarifa diretamente. Você também pode definir um valor abaixo do seu próprio custo: o aplicativo solicitará uma confirmação primeiro, e você pagará a diferença em cada ação. Limpe o preço para retornar à tarifa padrão da plataforma.

Contas mais antigas ainda podem ter uma tarifa de cliente única para o Max. Antes da tabela de Preços de ação, uma subconta possuía um campo, Tarifa do cliente por ação de IA Max, que também se aplicava ao Mini, pois o Mini é cobrado na mesma ramificação. Esse campo foi removido do modal Editar. Um cliente que ainda possui uma tarifa antiga exibe um selo Tarifa legada na tabela: ela continua sendo aplicada a cada ação Max e Mini cuja linha você deixar vazia, e qualquer preço que você digitar em uma linha a substituirá para aquela ação.

Um preço por ação, qualquer que seja o modelo que responda #

Um preço que você digita em uma linha de ação em Preços de ação é um preço fixo único por ação. O cliente é cobrado exatamente nesse valor toda vez que a ação ocorre, independentemente de qual modelo de IA tenha respondido: Mini, Pro ou Max. Se você inserir 0,6 para uma resposta de IA, o cliente pagará 0,6 créditos por resposta no Mini e 0,6 no Max.

• A coluna Seu custo é apenas o seu lado. Ela mostra um intervalo porque o que o pool da sua própria agência paga difere por modelo (o Mini é mais barato para você do que o Max). Esse intervalo nunca altera o que o cliente paga; a coluna Margem mostra o que você retém no pior cenário, calculado com base no modelo que lhe custa mais caro.
• Uma linha vazia significa o preço padrão do modelo que foi executado. Deixe uma linha em branco e o cliente pagará o preço de plataforma do modelo que respondeu, portanto, uma resposta Max custa mais para eles do que uma resposta Mini.
• Um preço em uma linha prevalece sobre a tarifa Max antiga. Onde um cliente ainda possui uma Tarifa legada, o preço da linha se aplica a essa ação em todos os modelos, e a tarifa legada cobre apenas as linhas que você deixou vazias.

As perguntas ao seu assistente do cliente são cobradas do seu pool na mesma tarifa Max (0,25, ou 0,2 com o Champions Circle) e não possuem tarifa de cliente: o cliente nunca é cobrado por elas. 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 o seu pool 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 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. Ambos os interruptores só aparecem quando seu próprio plano inclui o Max e o Mini; em um plano sem eles, um cliente não pode receber nenhum dos níveis.

Defina uma vez no plano em vez de por cliente. Se você vende planos através do Modo SaaS, os mesmos três interruptores ficam na lista de recursos de cada plano como a linha Modelos de IA do grupo Contatos & Agentes de IA (Etapa 3 — Configurar níveis de preços). O que você ativar lá é aplicado a cada cliente no momento em que ele assina e atualizado a cada renovação, para que uma nova inscrição nunca precise de um bloqueio manual. O modal Editar mostra Definido pelo plano do cliente abaixo da linha para esse cliente; altere uma opção lá e seu bloqueio definido manualmente assume o controle para aquele cliente e nunca mais será sobrescrito pelo plano.

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.

A mesma seção também possui uma linha de conexão WhatsApp Web, créditos por 30 dias: um preço fixo para cada número de WhatsApp Web que o cliente conecta, em vez da margem de lucro. Insira 0 para incluir a conexão no que você já cobra, 50 para repassar pelo preço de custo, ou qualquer valor até 2.500. Seu pool sempre paga 50 por número a cada 30 dias, independentemente do que você definir, portanto, qualquer valor acima de 50 é sua margem. Quando esta linha é preenchida, ela substitui a margem de lucro para números de WhatsApp Web (os dois nunca se acumulam); deixe-a vazia e a taxa de conexão seguirá a margem de lucro como antes. O cliente paga o seu preço quando o número é faturado pela primeira vez e a cada renovação de 30 dias, e o preço é o que a tela de pareamento e o cartão do número mostram a ele.

Você não precisa preencher isso por cliente. Modo SaaS → Preços de ação padrão para novos clientes é a mesma tabela no nível da agência: tudo o que você inserir lá é copiado para cada nova subconta no momento em que ela é criada, seja adicionando-a pela página de Subcontas, criando-a via API, ou se o cliente se inscrever pelo seu link de pagamento ou checkout incorporado. Clientes existentes não têm seus preços alterados quando você altera os padrões; eles mantêm os preços já definidos em suas contas até que você os edite aqui. Um padrão que você preenche funciona da mesma forma que um preço no cliente: um preço fixo único por ação, independentemente de qual modelo responda, e uma linha vazia mantém os novos clientes no preço padrão do modelo que foi executado.

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.

Vendendo IA Ilimitada no WhatsApp Web #

Um número de WhatsApp Web pode ser cobrado como uma taxa fixa de 250 créditos a cada 30 dias, em vez da taxa mensal de 50 créditos, com cada resposta de IA nesse número não custando nada. Você pode repassar isso a um cliente e definir seu próprio preço.

São necessárias duas configurações no modal Editar da subconta, e ambas só são oferecidas quando sua própria conta de agência é membro do Champions Circle:

• Recursos → IA Ilimitada no WhatsApp Web. Ative-o e o cliente verá a opção ao parear um número de WhatsApp Web, além do botão em cada cartão de número. Deixe desativado e eles não verão nada sobre isso.
• Preço da ação → IA Ilimitada no WhatsApp Web. O número de créditos que o cliente paga a cada 30 dias, por número que ele adicionar. O padrão é 250, pode chegar a 2.500, e 0 significa que você inclui sem custo adicional. Seu pool sempre paga 250, independentemente do que você definir, então qualquer valor acima disso é sua margem e qualquer valor abaixo disso é descontado do seu pool.

A mesma divisão se aplica à renovação a cada 30 dias e ao reembolso quando um cliente remove um número: o cliente recebe de volta o que pagou, pro-rata, e seu pool recebe de volta o que seu pool pagou. Se uma renovação não puder ser financiada, o número volta para a taxa medida de 50 créditos e tanto você quanto o cliente são notificados por e-mail; nada é desconectado.

Veja IA Ilimitada em um número de WhatsApp Web para saber o que o modo cobre e quanto custa uma alteração.

Quando um cliente fica sem créditos #

Na primeira vez que a IA de um cliente ignora uma mensagem por falta de créditos (o limite de gastos foi atingido ou seu pool está vazio), você recebe um e-mail identificando a conta do cliente: “Sua IA parou de responder: sem créditos”. Ele é enviado uma vez por interrupção, não por mensagem, e é reativado assim que a IA voltar a responder. O cliente recebe o mesmo alerta com a sua marca apenas quando Enviar notificações para a subconta estiver ativado no modal Editar da subconta → Notificações.

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.

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édito (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, a lista de gastos dos Principais agentes e uma tabela com filtro de intervalo de datas de cada cobrança e reembolso individual. Cada linha de cobrança mostra o modelo pelo qual foi faturado (Pro, Economy, Max ou Mini) e, nas linhas em que 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 seu pool de agência realmente pagou.
• Blocos de estatísticas no topo da página de Subcontas — quantos agentes de clientes estão ativos e inativos, e quantas subcontas apresentam problemas atualmente.

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 para os detalhes técnicos.

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

Uma vez que uma subconta está no modo de revenda, a página de Configurações → Faturamento do próprio cliente (no seu domínio white-label) mostra tudo o que eles precisam para pagar você diretamente — sem necessidade de link de checkout. Seus planos ficam mais abaixo na página, abaixo do saldo e uso deles, então, quando você vende planos nesse domínio, um botão Escolha seu plano no topo da página leva o cliente diretamente até eles (ele aparece como Alterar seu plano assim que eles estiverem inscritos):

• 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 com 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 avaliação gratuita é exibido como “Avaliação gratuita de X dias, depois $…” com um botão Iniciar avaliação gratuita em vez de um botão de preço — a mesma redação que seu link de pagamento e checkout incorporado usam. Uma avaliação é apenas para novas inscrições, portanto, uma subconta que já existe (criada por você, assinada anteriormente ou que já passou por avaliação) é cobrada imediatamente — veja Executando uma avaliação gratuita. Assim que o cliente está em um de seus planos, esse plano é marcado como Plano atual e os outros exibem Trocar plano, que abre o portal de faturamento — um cliente nunca pode abrir uma segunda assinatura além da que já possui. No topo da página, o primeiro bloco se transforma em Créditos do plano e mostra os créditos que seu plano adiciona a cada período de faturamento (eles são acumulados, ao contrário de uma franquia mensal), e Cartão registrado aparece como Sim assim que um cartão é salvo no checkout.
• 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 de forma independente: 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.

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.

Como um cliente cancela seu plano #

Não existe um botão de cancelamento dentro do próprio aplicativo — o cancelamento ocorre no seu portal do cliente Stripe, o mesmo local onde o cliente atualiza seu cartão:

1. O cliente abre Configurações → Faturamento em seu domínio e rola até o cartão Gerenciar faturamento na parte inferior.
2. Abrir portal de faturamento abre seu portal do cliente Stripe em uma nova guia.
3. Lá, eles escolhem Cancelar plano (termo utilizado pelo Stripe). O plano permanece ativo até o final do período já pago e, em seguida, é encerrado; a subconta é marcada como cancelada em sua página de Subcontas e nenhum crédito adicional é concedido.

O portal precisa ser ativado primeiro na sua conta Stripe. O Stripe só disponibiliza um portal do cliente depois que você salva suas configurações: no seu painel do Stripe, abra Configurações → Faturamento → Portal do cliente, certifique-se de que Cancelar assinaturas esteja ativado em Assinaturas e clique em Salvar. Até que isso seja feito, o botão Abrir portal de faturamento falhará com a mensagem “Não foi possível abrir o portal de faturamento”, e um portal salvo sem a opção de cancelamento mostrará ao cliente suas faturas e cartão, mas sem forma de cancelar. As outras configurações do portal que importam estão em Clientes alterando planos.

Você também pode cancelar o plano de um cliente por conta própria a partir do seu painel do Stripe (Clientes → o cliente → a assinatura dele → Cancelar assinatura). Como seu webhook carrega customer.subscription.deleted, a subconta é marcada como cancelada aqui no momento em que o Stripe a processa. Reembolsos também ficam a seu critério, a partir da mesma tela do Stripe. A plataforma só reembolsa um cliente em seu nome em um caso, descrito a seguir.

Um cliente que já possui um plano compra outro #

Os cartões de plano no seu aplicativo enviam um cliente que já possui um plano para o portal de faturamento para que ele possa alternar. Seu link de checkout público e a API de checkout não podem verificar isso primeiro, porque eles só descobrem quem é o comprador depois que o Stripe obtém o e-mail. Quando um cliente que já possui uma assinatura ativa conclui uma segunda, a nova assinatura é cancelada imediatamente no seu Stripe e o pagamento é reembolsado automaticamente. O cliente mantém o plano que já tinha, nenhum crédito é adicionado e nada é retirado do seu pool da agência. O cliente recebe um e-mail informando isso, e você recebe um com ambos os IDs de assinatura. Se o reembolso automático falhar, seu e-mail informará isso e o reembolso ficará pendente para você realizar no Stripe.

Excluir uma subconta cancela seu plano #

Quando você exclui uma subconta que lhe paga através de um plano, a assinatura dela na sua conta Stripe é cancelada ao mesmo tempo, sem fatura de rateio, portanto, o cliente não é cobrado novamente. Decidir se deve reembolsar parte do período atual cabe a você, a partir do seu painel do Stripe. Os créditos que o cliente comprou não são devolvidos ao seu pool. Se sua chave do Stripe mudou desde que o cliente assinou (por exemplo, de uma chave de teste para uma chave de produção, ou para uma conta Stripe diferente), a assinatura antiga não pode ser acessada com a nova chave: cancele-a você mesmo na conta Stripe em que foi criada.

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:

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.

Clientes pausados não contam. Uma subconta definida como Bloqueio total é excluída do total, portanto, não consome uma das suas contas incluídas nem custa a taxa de conta extra enquanto estiver pausada. O faturamento segue por dia, então um cliente pausado por dez dias só é excluído por esses dez dias. Uma conta com Bloqueio parcial ainda conta, porque sua IA continua respondendo. Veja Bloqueando / Pausando uma Subconta.

Planos vitalícios AppSumo:

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, 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ários Agentes de IA, e cada um funciona de forma independente. 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.

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 agentes de IA daquela conta — existe 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). 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 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 da IA devido ao esgotamento de créditos.
• Use a cópia de agentes 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 identificar picos inesperados antes que eles drenem seu pool.
• Mantenha o modo de Acesso para suporte — em vez de compartilhar as 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 desejar que as subcontas paguem pelo seu próprio uso, criando uma fonte 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 gerenciar suas próprias compras de crédito.

Precisa de ajuda? #

Se você tiver dúvidas sobre o gerenciamento de subcontas, entre em contato através do nosso suporte por e-mail.