# Contas de Agência ## O que são Contas de Agência? As contas de agência permitem que você gerencie várias contas de clientes a partir de um único painel. Em vez de fazer login em contas separadas para cada cliente, você obtém uma visão centralizada onde pode criar subcontas, monitorar campanhas, alocar créditos e alternar entre clientes instantaneamente. Isso foi projetado para agências de marketing, consultores e revendedores que gerenciam o aplicativo em nome de várias empresas. ::: walkthrough agency-accounts ::: As duas páginas que fazem isso funcionar — **Subcontas** e **Modo SaaS** — têm cada uma seu próprio lugar na barra lateral, em vez de ficarem escondidas dentro de Configurações. Esta página é a visão geral; a mecânica do dia a dia reside em [Gerenciamento de Subcontas](sub-accounts.md). --- ## Sistema de Crédito Compartilhado Uma das principais diferenças entre contas de agência e contas regulares é como os créditos funcionam: - **Os créditos são compartilhados** entre sua conta de agência e todas as subcontas. - Quando uma subconta usa créditos (para respostas de IA, campanhas, etc.), os créditos são deduzidos do saldo da sua agência. - As subcontas não veem o saldo de créditos — elas veem apenas o seu uso. Você, como agência, gerencia o pool geral de créditos. **Exemplo:** Você tem 1.000 créditos em sua conta de agência. O Cliente A envia uma campanha para 50 contatos (50 créditos). O bot de IA do Cliente B responde a 30 conversas (30 créditos). Seu saldo restante é de 920 créditos. --- ## Criando Subcontas ::: master-only
A página de Subcontas na v2, mostrando os seis blocos de estatísticas (Subcontas, Com problemas, Campanhas ativas, Campanhas pausadas, Alocado para clientes, Não alocado), a barra de pesquisa e uma linha de cliente na tabela

A página de Subcontas: blocos de estatísticas no topo (os dois à direita dividem seu pool de créditos entre o que os limites dos clientes já reivindicam e o que ainda está livre), um botão Adicionar conta e um atalho para o Modo SaaS.

::: 1. Clique em **Subcontas** na barra lateral principal — é sua própria página, logo acima de **Configurações**. 2. Clique no botão verde **Adicionar conta** (canto superior direito). 3. Preencha os detalhes do seu cliente nas 3 etapas do modal: conta (nome, e-mail), empresa (nome da empresa, endereço, descrição) e recursos. ::: master-only
O modal Adicionar subconta na etapa Conta, mostrando o progresso de 3 etapas (Conta, Negócio, Recursos) com campos para nome, sobrenome e e-mail

O modal Adicionar subconta. Três etapas: Conta → Negócio → Recursos. O e-mail que você insere torna-se o endereço de login do cliente.

::: 4. Clique em **Criar conta**. Uma tela de confirmação mostra a senha de login gerada — copie-a antes de fechar. O cliente também a recebe por e-mail. Passo a passo completo: [Gerenciamento de Subcontas — Criando uma Subconta](sub-accounts.md#creating-a-sub-account). --- ## Mostrando uma demonstração ao vivo para um cliente em potencial Antes de um cliente se inscrever, você pode oferecer a ele uma prévia ao vivo do assistente de chat rodando no próprio site dele — sem necessidade de instalação por parte dele. Use o **Link de demonstração para cliente**. > **Atualmente não disponível.** A seção **Link de demonstração do cliente** da versão anterior do aplicativo não faz parte da tela de Gerenciamento do widget de chat hoje, portanto, as etapas abaixo ainda não podem ser concluídas. Elas são mantidas aqui como uma descrição de como o link de demonstração funciona. **Como funciona:** você cola o endereço do site do cliente e a plataforma gera um link compartilhável. Quando o cliente abre esse link, ele vê seu próprio site com seu widget de chat flutuando por cima — totalmente ativo e pronto para conversar. Nada muda no site real deles, e eles não precisam tocar em nenhum código. A visualização vive inteiramente no seu link. **Como chegar lá:** abra **Configurações → Canais → Canais**, clique no cartão **Widget de Chat**, encontre a seção **Link de demonstração para o cliente**, digite ou cole o endereço do site do cliente (por exemplo, `theirbusiness.com`) e clique em **Copiar link de demonstração**. Em seguida, envie esse link para o cliente como preferir — e-mail, WhatsApp, uma mensagem, em qualquer lugar. ::: master-only
Configurações → Canais → página Canais mostrando o cartão do widget de chat do site com um botão Gerenciar

Configurações → Canais → Canais: o cartão Widget de chat do site é o ponto de entrada para a configuração do widget.

::: ::: master-only
O modal Gerenciar do widget de Chat, mostrando as configurações de Aparência e um painel de visualização ao vivo — ele não possui uma seção Link de demonstração do cliente

O modal Gerenciar hoje: seções Aparência, Comportamento, Captura de Leads e Canais & Incorporação, mas sem Link de demonstração do cliente.

::: Algumas coisas para saber: - Alguns sites não permitem ser exibidos dentro de outra página (uma configuração de segurança deles). Quando isso acontece, o link de demonstração ainda funciona — ele mostra uma moldura de prévia limpa com o endereço do site, e o assistente de chat continua totalmente funcional para testes. A experiência de conversação é idêntica; apenas o plano de fundo do site difere. - A demonstração usa sua configuração real de widget, portanto, quaisquer mensagens que o cliente enviar durante o teste chegarão até você como qualquer outra conversa de widget de chat. --- ## Credenciais de Login do Cliente Ao criar uma subconta: - O cliente recebe um e-mail e uma senha que pode usar para fazer login em sua própria conta, na sua página de login com marca própria (white-label). - Dar acesso de login aos clientes é **opcional** — você pode gerenciar tudo em nome deles, se preferir. - Se o cliente fizer login, ele verá seu próprio painel com suas campanhas, contatos e chats. Ele não vê o painel da sua agência ou outras subcontas. - O saldo de créditos fica oculto para as subcontas, já que você gerencia o pool de créditos compartilhado. --- ## Alternando entre Subcontas Existem duas maneiras de alternar para a conta de um cliente: **O alternador de contas, de qualquer lugar:** 1. No topo da barra lateral, clique em **Trocar conta**. ::: master-only
O menu suspenso Alternar conta aberto na barra lateral, mostrando um campo de pesquisa para subcontas

O menu suspenso Alternar conta, aberto de qualquer lugar na barra lateral. Esta agência ainda não tem subcontas, então a lista está vazia — assim que você criar uma, ela aparecerá aqui, pesquisável por nome ou e-mail.

::: 2. Pesquise a subconta por nome ou e-mail, ou role a lista. 3. Clique nela. O painel será recarregado sob a identidade dessa subconta. **A partir da página de Subcontas:** 1. Na barra lateral, clique em **Subcontas**. 2. Encontre a subconta na lista. Nessa linha, clique no menu **Mais** (ícone de três pontos na extrema direita). 3. Clique em **Entrar como usuário**. De qualquer forma, enquanto você estiver dentro de uma subconta, a pílula de alternância na barra lateral fica âmbar e mostra **Assistindo: **. Clique nela e escolha **Voltar para minha agência** para retornar ao seu próprio painel. A barra âmbar **Assistindo** no topo da página tem a mesma opção de saída; clique no **×** dela para ocultar a barra pelo restante da sua visita, caso precise de espaço. Se o cliente estiver com a autenticação de dois fatores ativada, você não precisará fornecer o código dele: você já iniciou sessão como você mesmo, e o código seria enviado para o cliente, não para você. --- ## Rastreamento de Uso de Créditos Como agência, você pode rastrear como os créditos estão sendo consumidos em todas as subcontas: - **Blocos de estatísticas na página de Subcontas** — contagem agregada de campanhas ativas/pausadas e quantas subcontas têm problemas. - **Rastreamento por subconta** — quantos créditos cada subconta está usando, a partir do menu **Mais** daquela linha. - **Detalhes de uso de créditos** — uma visualização dedicada por subconta mostrando créditos comprados, créditos consumidos, saldo restante, uso por motivo, principais campanhas por gasto e uma tabela de transações filtrável. ::: master-only
A página de Subcontas na v2, mostrando os seis blocos de estatísticas: Subcontas, Com problemas, Campanhas ativas, Campanhas pausadas, Alocado para clientes, Não alocado

Os blocos de estatísticas no topo da página de Subcontas — uma leitura geral da integridade das campanhas em todos os clientes, além de quanto do seu pool de crédito os limites de gastos dos clientes já reivindicam (Alocado para clientes / Não alocado). O menu Mais em cada linha (não mostrado — requer pelo menos uma subconta) é onde ficam o rastreamento de crédito por conta e os detalhes de uso de crédito.

::: Essa visibilidade ajuda você a entender seus custos, identificar clientes de alto consumo e definir preços apropriados para seus serviços. --- ## Revenda de Créditos (também conhecido como Modo SaaS) A revenda de créditos permite que você venda créditos para suas subcontas com seus próprios preços, criando uma fonte de receita para sua agência. Toda essa área reside em sua própria página na barra lateral chamada **Modo SaaS** — o mesmo recurso que você talvez conheça como "Revenda de Créditos", sob seu nome padrão da indústria. Ele está disponível no plano **Agência** e é protegido pela flag de recurso **white-labeling**. Se o seu plano inclui white labeling — o que todo nível de oferta vitalícia que o lista possui — a revenda já é sua: você não está limitado a gerenciar o aplicativo para clientes, você pode vender planos sob sua própria marca, com seus próprios preços, através do seu próprio Stripe ou PayPal. Nada extra para comprar. ### Como Funciona 1. **Abra o Modo SaaS** — clique na entrada na barra lateral principal (fica ao lado de Subcontas, perto da parte inferior do menu), ou clique no botão **Modo SaaS** na parte superior da página de Subcontas. 2. **Ative a revenda de créditos para uma subconta** no modal **Editar** (página de Subcontas → menu **Mais** da linha → **Editar** → **Gerenciamento de Créditos**) alterando o modo de Manual para Revenda. A revenda só é oferecida quando sua agência tiver o white-labeling em seu plano. 3. **Defina seus preços** — defina pacotes de créditos e preços por crédito que suas subcontas verão quando comprarem créditos. 4. **Aplicação de preço mínimo** — a plataforma aplica um preço mínimo de crédito para garantir preços sustentáveis em toda a plataforma. 5. **As subcontas compram créditos** através do seu checkout personalizado, alimentado por qualquer provedor de pagamento que você conectar — Stripe, PayPal ou ambos. Os pagamentos vão diretamente para sua própria conta com esse provedor. 6. **Os créditos são entregues automaticamente** à subconta após a compra. Os créditos caem no saldo comprado do cliente, e o mesmo número de créditos é deduzido do pool da sua agência — essa dedução é o custo da venda para você, enquanto o pagamento do cliente vai para sua própria conta de pagamento. ### Economia de créditos Quando um cliente compra créditos, esses créditos são adicionados ao saldo próprio do cliente, e o mesmo número de créditos é **deduzido do pool da sua agência**. O dinheiro do cliente vai para a sua conta Stripe; a dedução do pool é o seu custo de plataforma para a venda. Seu lucro é a diferença entre o preço que você definiu e quanto esses créditos custaram para você — que é também o motivo pelo qual o preço mínimo por crédito existe (você não pode precificar um pacote abaixo do custo de crédito da própria plataforma). Mantenha seu pool coberto: o checkout exige que o pool da sua agência contenha pelo menos a mesma quantidade de créditos do pacote que está sendo comprado. Se no momento do pagamento o seu pool ainda não puder cobrir a compra, a plataforma cobra automaticamente o cartão da sua agência registrado para recarregá-lo — e se essa cobrança automática falhar, o pagamento do cliente é reembolsado e nenhum crédito é entregue. **Exemplo:** Você vende 150 créditos por US$ 25. Os 150 créditos caem no saldo próprio do cliente, os US$ 25 vão para a sua conta Stripe, e 150 créditos são deduzidos do pool da sua agência. Se esses créditos do pool custaram US$ 15 para você, sua margem na venda é de US$ 10. Os créditos adquiridos cobrem **tudo o que o cliente gasta** — respostas de IA, ferramentas, acompanhamentos e também os custos de WhatsApp que não são de IA (aluguel de número e, a partir de 1º de outubro de 2026, as taxas da operadora por mensagem). Tudo isso é deduzido primeiro do saldo adquirido pelo cliente; o pool da sua agência cobre apenas o que esse saldo não puder cobrir. Não há uma margem de lucro separada por cliente nos custos de WhatsApp (o campo **Taxa do cliente** apenas reajusta o preço das ações de IA Max e Mini), portanto, se você revende o WhatsApp, inclua esses custos em seus planos. SMS não faz parte disso: o SMS sempre é executado em uma conta Twilio que você mesmo conecta, então a Twilio cobra você diretamente por isso e nenhum crédito está envolvido. ### O que acontece quando o saldo de um cliente chega a zero O gasto de um cliente de revenda permanece isolado aos créditos que ele comprou **desde que sua franquia mensal seja zero**. Sem uma franquia, no momento em que o saldo adquirido chega a zero, **o bot de IA para de responder para aquela subconta** — ele não recorre ao pool da sua agência — e o cliente compra outro plano ou pacote de créditos através do seu checkout para retomar. Esse é o corte rígido que impede que o uso de um cliente drene o saldo da sua agência. Se a subconta ainda tiver uma **Franquia mensal** definida (veja [Modos de gerenciamento de crédito](sub-accounts.md#credit-management-modes)), essa franquia continuará sendo aplicada todos os meses e será gasta do seu pool exatamente como no modo manual, portanto, o cliente continuará operando após o término de seus créditos adquiridos. Defina a franquia como zero no modal **Editar** da subconta se você quiser o comportamento puro de pague-para-usar. (O SMS é cobrado diretamente de você pela Twilio de qualquer maneira, portanto, não há cobrança de crédito envolvida.) ### O Fluxo de Cadastro Self-Service O objetivo da revenda de créditos é que você **não** gerencie cadastros manualmente. O fluxo funciona assim: 1. Você publica um link de pagamento (em um e-mail, no seu site, em um anúncio). 2. Um novo cliente clica nele, paga e uma subconta é criada automaticamente. (Se o plano tiver um teste gratuito, ele começa sem pagar nada — a cobrança ocorre automaticamente quando o teste termina.) 3. O cliente recebe um e-mail de login com uma senha temporária. 4. Ele faz login, passa pelo processo de integração e segue a partir daí. Você só intervém se eles precisarem de ajuda — recargas de faturamento, novas tentativas de pagamento, etc., tudo funciona no piloto automático. Existem três maneiras de configurar isso: **Stripe** (recomendado, totalmente integrado), **PayPal** (também totalmente integrado, e a resposta usual quando o Stripe não está disponível onde você está), ou um **Provedor de Pagamento Personalizado** (qualquer outro sistema que você já use — requer um pouco de trabalho de integração). --- ### Configurando a Revenda de Créditos ::: master-only
Assistente de configuração do Modo SaaS, etapa 1 de 5: Criar uma conta Stripe, com botões Abrir Stripe e Tenho uma conta e uma alternativa de provedor de pagamento personalizado

O assistente de configuração do Modo SaaS (etapa 1 de 5). O Stripe é o caminho padrão; a caixa na parte inferior oferece a rota de provedor de pagamento personalizado se o Stripe não estiver disponível em seu país.

::: 1. Clique em **Modo SaaS** na barra lateral principal. 2. Se esta é sua primeira vez aqui, você cairá no assistente de configuração. Escolha um dos três caminhos: - **Eu tenho uma conta / Conectar Stripe** — recomendado. Veja [Opção 1: Conectar Stripe](#option-1-connect-stripe) abaixo. - **Usar um Provedor de Pagamento Personalizado** — para qualquer outro provedor de pagamento que você queira gerenciar. Veja [Opção 2: Provedor de Pagamento Personalizado](#option-2-custom-payment-provider) abaixo. - **Conectar PayPal em vez disso** — integrado como o Stripe, com o dinheiro caindo na sua conta PayPal Business. Veja [Opção 3: Conectar PayPal](#option-3-connect-paypal) abaixo. > O Stripe é o caminho de menor resistência. Se o Stripe não estiver disponível em seu país, ou se seus clientes simplesmente preferirem o PayPal, conecte o PayPal — ele é tão integrado quanto e não precisa de trabalho de integração. Mantenha a rota de provedor de pagamento personalizado para um sistema de cobrança que você já possui e deseja manter (Mollie, Paddle, GoCardless, seu próprio backend, etc.). Você pode conectar o Stripe e o PayPal ao mesmo tempo. Seus clientes então recebem um botão para cada um e escolhem o que preferirem. --- ### Opção 1: Conectar Stripe Este é o caminho recomendado. A plataforma cuida do checkout, da criação da conta e da entrega de créditos para você — você apenas fornece as chaves ao Stripe. #### Passo 1 — Criar uma chave de API restrita do Stripe 1. No assistente do Modo SaaS, você será solicitado a inserir sua **Chave Secreta do Stripe**. 2. Abra seu painel do Stripe em uma nova aba → **Desenvolvedores** → **Chaves de API** → **Criar chave restrita**. 3. Dê um nome à chave (por exemplo, *DM Champ Revenda*) e conceda estas permissões: - **Sessões de Checkout** → Gravar - **Produtos** → Gravar - **Preços** → Gravar - **Assinaturas** → Gravar (marca a assinatura de cada cliente para que as renovações — e avaliações gratuitas convertidas em pagas — creditam a conta correta, e permite que a plataforma verifique um nível para assinantes ativos antes de você excluí-lo) - **Clientes** → Gravar, **Intenções de Configuração** → Ler e **Portal do cliente** → Gravar (usado quando um cliente salva um cartão para recarga automática ou gerencia sua assinatura) - **Conta** → Ler - **Endpoints de Webhook** → Gravar (permite que a plataforma verifique se seu webhook está registrado com os eventos corretos e corrija isso para você, caso não esteja — veja [Verificação de integridade do Webhook](#webhook-health-check) abaixo) 4. Clique em **Criar chave**, depois copie a chave. > **Já conectado com menos permissões?** Você não precisa de uma nova chave. No Stripe, abra **Developers → API keys**, clique na sua chave restrita existente, marque as permissões ausentes e salve — a plataforma as detectará na próxima solicitação. O sintoma revelador de uma chave sem a permissão **Subscriptions** é o erro *"Could not verify if this tier has active subscribers"* ao tentar excluir um nível de preço. 5. Cole-a no assistente e clique em **Save & Continue**. #### Passo 2 — Registrar o webhook do Stripe 1. O assistente mostrará uma **URL de webhook**. Copie-a. 2. No Stripe → **Developers** → **Webhooks** → **Add endpoint**. 3. Cole a URL do webhook como o destino. 4. Para os eventos, selecione **`checkout.session.completed`** (compras iniciais), **`invoice.paid`** (renovações e a primeira cobrança após o término de um teste gratuito — sem isso, a renovação de um cliente é cobrada no Stripe, mas seus créditos não são recarregados), **`customer.subscription.updated`** (mudanças de plano feitas no portal do cliente Stripe — sem isso, um cliente que faz upgrade mantém sua franquia antiga até que você a corrija manualmente) e **`customer.subscription.deleted`** (cancelamentos — sem isso, um cliente que cancela no Stripe continua aparecendo como assinante aqui). 5. O Stripe mostrará um **signing secret** para o novo webhook. Copie-o e cole-o no assistente, então clique em **Save & Continue**. ##### Verificação de integridade do Webhook Assim que você salva o segredo de assinatura, e uma vez por dia após isso, a plataforma usa sua chave do Stripe para verificar se o seu endpoint de webhook está habilitado e inscrito em todos os quatro eventos. Se houver eventos faltando e sua chave tiver a permissão **Webhook Endpoints → Write**, eles serão adicionados automaticamente para você. Se a plataforma não conseguir corrigir (nenhum endpoint encontrado, endpoint desabilitado, a chave não tem a permissão ou o Stripe rejeita a chave porque ela expirou ou foi revogada), o painel do Modo SaaS exibirá um aviso de **"Webhook precisa de atenção"** informando exatamente o que fazer. Corrija prontamente: enquanto o aviso estiver ativo, as renovações dos seus clientes ainda serão cobradas no Stripe, mas os créditos deles não serão recarregados. #### Passo 3 — Configure os níveis de preços 1. Defina os pacotes de créditos que seus clientes podem comprar (até 20 níveis — ex.: *Inicial — 1.000 créditos / $29*, *Pro — 5.000 créditos / $99*), e opcionalmente os recursos que cada nível desbloqueia. - **Precisa do mesmo plano em duas cadências de cobrança — digamos mensal e anual?** Configure uma vez, depois clique no ícone **Duplicar** (ao lado do ícone de lixeira no nível) em vez de criá-lo novamente. A cópia carrega todas as configurações do original — créditos, preço, recursos, limites, teste — com *(cópia)* adicionado ao seu rótulo, e ainda não está publicada: altere seu **Faturamento** para Anual, ajuste o preço e o rótulo, depois salve, e ele terá seu próprio produto e preço no Stripe. A cópia é sempre adicionada ao **final** da sua lista de Planos propositalmente: seus links de pagamento e código de incorporação apontam para planos por sua posição na lista (veja [Passo 4 — Compartilhe seus links de pagamento](#step-4--share-your-payment-links)), então nada que você já colocou em seu site se move. 2. Escolha como o plano cobra com o seletor de **Faturamento**: **Mensal**, **Anual** ou **A cada N semanas**. No Mensal nada muda — o preço que você insere é cobrado todo mês. No **Anual**, o preço que você insere é o preço para um **ano inteiro**, enquanto o campo **Créditos por mês** ainda significa exatamente isso — os créditos que o cliente recebe **por mês**. Então *1.000 créditos / $290 / Anual* é um cliente pagando a você $290 uma vez por ano e recebendo 1.000 créditos todo mês. Sua franquia é concedida mês a mês — o primeiro mês quando eles compram, depois automaticamente a cada mês seguinte, com a contagem reiniciando a cada renovação anual — em vez de doze meses de créditos entregues no primeiro dia. Isso importa para o seu pool: uma venda anual não retira um ano de créditos dele de uma vez. Se o cliente cancelar, as concessões mensais param. **A cada N semanas** é para qualquer outra cadência: escolha-a e insira as **Semanas entre pagamentos** (1 a 52) — *a cada 4 semanas*, digamos, o que são 13 pagamentos por ano em vez de 12. Em um plano de estilo semanal, o preço e os créditos se aplicam **por período de faturamento**: um plano de *1.000 créditos / $29 / a cada 4 semanas* cobra $29 a cada quatro semanas e concede 1.000 créditos a cada quatro semanas. Alterar a cadência de faturamento de um plano salvo cria um novo preço no seu Stripe, então os assinantes existentes permanecem no que se inscreveram. 3. Dê ao plano um **teste gratuito** se desejar. **Teste gratuito (dias)** aceita qualquer valor de 1 a 90 — deixe em **0** para nenhum teste — e **Créditos de teste** define com quantos créditos o cliente começa (o padrão é o crédito mensal do plano, e você pode reduzi-lo — para um mínimo de 1, porque uma conta de teste sem créditos não conseguiria terminar sua própria configuração). Com um teste definido, um novo cliente **não é cobrado na inscrição**: eles recebem os créditos de teste no primeiro dia e podem usar o plano imediatamente. Quando o período de teste termina, o Stripe cobra o preço do plano automaticamente e o cliente passa a receber a franquia mensal completa a partir de então. Algumas coisas para manter em mente: - **Créditos de teste saem do pool da sua agência**, exatamente como qualquer outro crédito de plano. Um teste generoso em um plano que você promove amplamente é um custo real, então defina o número 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 recebe o teste exatamente como configurado no plano. Uma subconta que já existe — criada por você, assinada anteriormente ou já testada — comprando em sua própria página de Faturamento é cobrada imediatamente, sem segundo teste. Um cliente que cancela durante o teste nunca é cobrado e mantém os créditos de teste restantes. - **Cartão ou sem cartão — você decide.** Por padrão, o teste ainda pede ao cliente um cartão na inscrição, e o Stripe o cobra quando o teste termina. Desative **Exigir cartão para iniciar o teste** e o checkout pula o cartão completamente: o cliente começa apenas com um e-mail. Se eles não adicionaram um cartão até o momento em que o teste termina, o plano simplesmente acaba — sua subconta é marcada como cancelada, nenhum crédito adicional é concedido, e eles mantêm o que restou dos créditos de teste. Um teste sem cartão converte menos automaticamente do que um com cartão em arquivo, então vale a pena lembrar o cliente de adicionar seu cartão antes do fim. - **Expiração rígida após o teste — recupere os créditos não utilizados.** Ao lado do botão de cartão fica **Expiração rígida após o teste**: *quando o teste termina sem um upgrade, os créditos de teste não utilizados voltam para o seu pool e a conta do cliente é bloqueada até que eles assinem.* Deixe-o desligado (o padrão) e nada muda em relação ao parágrafo acima — o plano é cancelado, nenhum crédito adicional é concedido, e o cliente mantém os créditos de teste restantes, então sua IA continua respondendo até que eles acabem. Ligue-o e, no momento em que um teste termina sem um upgrade, os créditos de teste não utilizados voltam **para o pool da sua agência** 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 volta — um teste que eles realmente usaram custa a você o que eles usaram. O bloqueio é levantado automaticamente assim que eles compram qualquer plano, e você pode levantá-lo ou alterá-lo manualmente no modal **Editar** da subconta, usando os mesmos [controles de bloqueio](sub-accounts.md#blocking-pausing-a-sub-account) que para um cliente que atrasa os pagamentos. (Um bloqueio que você já colocou manualmente nunca é tocado por nada disso — seu motivo para ele supera o nosso.) A expiração rígida funciona tanto em testes com cartão quanto sem cartão; em um teste sem cartão, o checkout informa ao comprador antecipadamente que seu plano **e** quaisquer créditos de teste restantes terminarão automaticamente após o teste, a menos que eles adicionem um método de pagamento. 4. O grupo **Canais** carrega o **Limite de canais** do plano — um número, não uma alternância, funcionando exatamente como assentos de equipe e o limite de Agentes de IA. Escolha **Não definido** (o padrão — o plano não gerencia o número, então o que a conta já possui permanece como está), **Ilimitado**, ou **Personalizado** com o número exato de canais de mensagens que os clientes neste plano podem ter conectados de uma vez — incluindo **0**, para planos onde você conecta e gerencia os canais por conta própria. O limite é aplicado quando um cliente assina e atualizado a cada renovação, e um limite que você definiu manualmente em uma subconta específica (em seu modal Editar) nunca é sobrescrito por uma renovação. Ele controla *quantos* canais, não *quais* — esse é o próximo grupo. A contagem é por **conexão**, não por tipo de canal: cada número do WhatsApp ocupa um slot próprio (WhatsApp Web e a API Business da mesma forma), enquanto Instagram e Messenger chegam através da mesma conexão de página Meta e juntos ocupam um único slot. Um cliente no seu limite vê uma mensagem clara quando tenta conectar outro canal; reconectar um que eles já possuem nunca é bloqueado. 5. Dentro da lista de recursos de cada nível, você também encontrará um grupo **Tipos de Canais** listando os tipos de canal que podem ser dados a um cliente — 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, para que você possa reservar canais específicos para níveis superiores — digamos, um plano inicial apenas com widget e WhatsApp Business API a partir do seu nível Pro. Clientes em um nível que exclui um canal o veem bloqueado em sua página de Canais com uma nota para fazer upgrade. 6. A lista de recursos também carrega um grupo **Equipe**, para que cada plano possa definir sua própria franquia de assentos de equipe. Um seletor, **Assentos de equipe**, decide se os clientes no plano recebem membros da equipe e quantos: escolha **Não incluído** (o padrão — clientes neste plano não podem convidar colegas de equipe), um dos predefinidos (3 / 5 / 10 / Ilimitado), ou **Personalizado** com qualquer número exato — Inicial com 3 assentos, Profissional com 10, Enterprise ilimitado, ou o que se adequar ao seu preço. A franquia é aplicada automaticamente quando um cliente assina e atualizada a cada renovação, então não há nada para definir manualmente por cliente. Duas coisas a saber: **Não definido** significa que os membros da equipe estão incluídos, mas o plano não gerencia o número — qualquer limite de assento que a conta já tenha é deixado em paz — e um limite de assento que você definiu manualmente em uma subconta específica (em seu modal Editar ou via API) nunca é sobrescrito por uma renovação, então exceções únicas sobrevivem aos ciclos de faturamento. Há também um grupo **Produtividade** (Tarefas, Resumos Diários, Biblioteca de Mídia de IA) se você quiser reservá-los para planos superiores. 7. O grupo **Contatos e Agentes de IA** carrega o **Limite de Agentes de IA** do plano — um número, não uma alternância, funcionando exatamente como assentos de equipe. Escolha **Não definido** (o padrão — o plano não gerencia o número, então o que a conta já possui permanece como está), **Ilimitado**, ou **Personalizado** com o número exato de agentes de IA que os clientes neste plano podem ter — incluindo **0**, para planos onde você constrói e gerencia os agentes por conta própria e os clientes não devem criar os seus próprios. O limite é aplicado quando um cliente assina e atualizado a cada renovação, e um limite que você definiu manualmente em uma subconta específica (em seu modal Editar) nunca é sobrescrito por uma renovação. Um cliente no seu limite vê uma mensagem clara quando tenta criar ou duplicar um agente; copiar um agente para uma subconta do lado da sua agência nunca é bloqueado por isso. 8. O grupo **Créditos não utilizados** decide o que acontece com os créditos restantes de um cliente quando o plano renova. **Manter no máximo** é quantos meses de franquia um cliente neste plano pode carregar: a cada renovação, seu saldo não utilizado é reduzido para no máximo esse número de vezes a franquia mensal, e então os novos créditos caem por cima — `1` mantém o valor de um mês, `0.5` metade de um mês, `0` não carrega nada. **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, e como o gasto sempre sai dos créditos mais antigos primeiro, um cliente que usa sua franquia todo mês nunca perde nada. Deixe ambos vazios — o padrão, e o que todo plano que você já vende mantém — e nada é limitado ou expirado. Vale a pena defini-los em um plano barato ou com preço de teste, onde um cliente que mal usa o produto acumula um saldo pelo qual seu pool é responsável. Um valor definido em uma subconta específica supera o do plano, então você ainda pode abrir uma exceção para um único cliente. Veja [Limitando o que é transferido](sub-accounts.md#capping-what-rolls-over). 9. Defina o **preço por crédito** — é isso que os clientes pagam por recargas ad-hoc. 10. Clique em **Salvar e Continuar**. > **Contatos são um recurso de sim/não, não um número.** O mesmo grupo **Contatos e Agentes de IA** contém **Contatos ilimitados** como um item simples de ligar/desligar, e propositalmente não há campo para digitar um número de contatos. Desativá-lo não oferece um limite de contatos para definir — portanto, a menos que você tenha um motivo específico, deixe-o ativado. Os três limites que você pode expressar como um número real são **Limite de canais**, **Limite de agentes de IA** e **Assentos da equipe**, cada um com Não definido / Ilimitado / Personalizado. > **Não há limite por plano para campanhas ou transmissões.** Agentes são o item a ser limitado se você quiser manter um nível inicial pequeno — use o **Limite de agentes de IA** acima. > **Os níveis são assinaturas, não compras únicas.** Cada nível de preço é uma assinatura recorrente — cobrada todo mês, uma vez por ano ou a cada N semanas, dependendo do seu seletor de **Faturamento** — e dura até que o cliente cancele. Planos mensais e anuais concedem a franquia de crédito **todo mês**; um plano de estilo semanal a concede **a cada período de faturamento**. Para recargas únicas, use a opção de valor personalizado por crédito. Como os níveis são assinaturas ativas, um nível que ainda possui assinantes ativos não pode ser excluído — cancele ou migre esses clientes primeiro. > ⚠️ **A lista de recursos do nível prevalece em cada renovação.** Quando um cliente assina um nível, e novamente cada vez que ele é renovado, seus recursos são redefinidos exatamente para o que aquele nível inclui. Portanto, se você ativar um recurso extra para um cliente em **Editar Subconta**, adicione-o também ao nível dele — caso contrário, ele será removido na próxima renovação. (Compras de crédito únicas e personalizadas não alteram os recursos.) #### Vendendo um plano em um domínio white label específico Se você opera mais de um [domínio white label](white-labeling.md#up-to-three-white-labels), cada nível recebe um seletor **Vendido em** (ele só aparece quando você tem dois ou mais domínios). Deixe em **Domínio principal** e nada muda. Escolha um dos seus outros domínios — digamos, seu domínio do Lead Finder — e: - O **checkout** desse nível carrega a identidade visual do domínio e, após o pagamento, o comprador é redirecionado para esse domínio, não para o seu principal. - A subconta do comprador é **atribuída automaticamente a esse domínio**, para que seus e-mails e a identidade visual de login o sigam desde o primeiro dia (a mesma atribuição que você pode definir manualmente no seletor **White label** da subconta). - Clientes conectados nesse domínio veem um cartão de **Planos** na página de Créditos listando apenas os planos vendidos lá, com um botão de upgrade — assim, um cliente no seu domínio do Lead Finder pode assinar sem nunca ver sua marca principal. Planos vendidos no seu domínio principal nunca aparecem nos seus outros domínios, e vice-versa. Se você posteriormente [tornar outro domínio o seu principal](white-labeling.md#changing-which-domain-is-main), todos os planos que estavam no **Domínio principal** serão fixados ao domínio no qual estavam sendo vendidos, portanto, nada muda para os clientes que compram lá. Você chegará a uma tela de **Tudo pronto!** com uma lista de verificação (conta Stripe conectada, níveis de preço configurados, webhook registrado) e uma dica para testar com o cartão de teste do Stripe `4242 4242 4242 4242`. A partir daí, **Ver Painel** leva você ao painel do Modo SaaS. #### Clientes mudando de plano Se você permite que os clientes gerenciem sua própria assinatura a partir do portal do cliente Stripe, eles mesmos podem alternar entre seus planos. Veja o que isso faz com os créditos deles. - **O upgrade no meio do ciclo recarrega os créditos imediatamente.** Um cliente no plano Starter (100 créditos por mês) que muda para o Professional (1.000 por mês) no 10º dia recebe a diferença — 900 créditos — imediatamente, e os 1.000 completos a partir da próxima renovação. O Stripe cobra a diferença de preço pelo restante do período; os créditos saem do seu pool, como sempre. - **O downgrade nunca retira créditos.** O que o cliente já recebeu permanece com ele, e nada retorna ao seu pool. A franquia menor é aplicada a partir da próxima renovação. - **Alternar entre planos repetidamente não permite ganhar a franquia duas vezes.** A plataforma lembra a maior franquia com a qual o período atual do cliente já foi financiado, portanto, Starter → Professional → Starter → Professional dentro de um mês entrega a diferença de 900 créditos apenas uma vez, não duas. - **Recursos, assentos e limites do plano seguem o novo plano imediatamente**, em ambas as direções. Duas coisas para configurar corretamente nas definições do seu portal do cliente Stripe: - **Mantenha "customers can change quantity" desativado.** A quantidade multiplica o que é cobrado do cliente, mas nunca os créditos que eles recebem — um cliente que define a quantidade como 3 paga três vezes o preço e ainda recebe a franquia de um único plano. - **Agendar downgrades para o final do período de faturamento é o padrão sensato do ponto de vista financeiro.** Um downgrade que entra em vigor imediatamente coloca o cliente em um plano menor por um período pelo qual ele já pagou o preço mais alto, e nenhum dos créditos já concedidos retorna para você. #### Passo 4 — Compartilhe seus links de pagamento A aba **Pagamentos** do painel lista seus links de pagamento. Os links usam o domínio no qual você está conectado: abra o painel a partir de `app.youraiconnector.com` e eles começarão com `app.youraiconnector.com`; faça login a partir do seu próprio domínio white-label e eles usarão o seu domínio — uma nota abaixo dos links lembra você disso. (Você também pode simplesmente trocar a parte do domínio de uma URL copiada manualmente.) A página de checkout em si é sempre white-labeled com seu logotipo e marca. Há também **Copiar Código de Incorporação** na mesma guia se você quiser colocar os cartões de preços diretamente no seu próprio site. Está veiculando anúncios no Meta? O código de incorporação também encaminha o ID de clique de anúncio do Meta (`fbclid`) da sua página para os botões de checkout, e um link de pagamento simples também o aceita (`...&fbclid=...`). Juntamente com um **ID do Pixel do Meta** no seu domínio white-label, isso permite que o Meta atribua a inscrição ao anúncio. Veja [Rastreamento de conversões de anúncios do Meta](white-labeling.md#tracking-meta-ads-conversions). Se você tiver o PayPal conectado também, cada plano carrega um link do PayPal ao lado do seu link do Stripe, e o código de incorporação coloca um botão por método de pagamento conectado em cada cartão de preço. Cada link de pagamento aponta para um plano de acordo com sua posição na sua lista de Planos (o primeiro plano é `tier=0`, o segundo `tier=1`, e assim por diante). Se você excluir um plano, os planos seguintes sobem uma posição — portanto, copie novamente seus links e o código de incorporação da aba Pagamentos após excluir um plano, caso contrário, um botão em seu site pode acabar apontando para o plano errado ou para um que não existe mais. Os planos são exibidos para seus clientes na ordem em que aparecem na sua lista de Planos. **O que os compradores podem inserir no checkout.** Além do cartão, a página de checkout do Stripe solicita o e-mail, número de telefone e endereço de cobrança do comprador, e oferece um campo opcional de **Nome da Empresa**, além de uma caixa de seleção **"Estou comprando como empresa"** onde eles podem adicionar seu VAT / ID fiscal. O nome da empresa e o ID fiscal são armazenados no cliente em sua conta Stripe, para que você possa recuperá-los para seu próprio faturamento. O número de telefone é solicitado por padrão, e você pode desativá-lo. Na aba **Pagamentos**, em **Campos de Checkout**, desative **Solicitar um número de telefone no checkout** e os compradores inserirão apenas seu e-mail, cartão e endereço de cobrança. Isso se aplica aos seus links de pagamento e ao seu checkout incorporado imediatamente — não há necessidade de copiar nada novamente — e as contas que se inscreverem com essa opção desativada simplesmente não terão um número de telefone registrado, o que não altera nada mais em seu funcionamento. > ⚠️ **Não exclua os produtos que a plataforma cria dentro da sua conta Stripe.** Ao configurar níveis de preço, a plataforma cria automaticamente produtos e preços correspondentes no Stripe. Excluí-los no Stripe quebrará seus links de pagamento. Gerencie seus preços no painel do Modo SaaS, não dentro do Stripe. --- ### Opção 2: Provedor de Pagamento Personalizado Escolha este caminho se o Stripe não for uma opção. A plataforma fornece um único campo de URL de webhook — você é responsável pelo restante da integração. Existem **duas** coisas que você precisa conectar por conta própria: 1. **Cadastro inicial** — quando um novo cliente paga pelo seu link de pagamento, você chama a API da plataforma para criar a subconta. 2. **Recargas automáticas** — quando os créditos de uma subconta ficam baixos, a plataforma chama seu webhook para que você possa cobrar o cartão e conceder mais créditos. #### O que você mesmo constrói - **Produtos / links de pagamento** no seu próprio provedor de pagamento (Stripe fora do Stripe Connect, Mollie, Paddle, GoCardless, faturamento manual, etc.). - **Um fluxo de trabalho que é executado após o pagamento bem-sucedido**, que chama a API da plataforma para: - Criar a subconta ([POST `/v1/sub-accounts`](https://help.dmchamp.com/api/reference)). - Opcionalmente, enviar por e-mail a senha temporária para o cliente. - **Um fluxo de trabalho que lida com webhooks de recarga automática** da plataforma: cobre o cartão salvo em arquivo e, em seguida, chame a API da plataforma para adicionar créditos. Você não precisa programar isso do zero — Zapier, Make, n8n ou qualquer ferramenta low-code pode chamar a API REST da plataforma e a API do seu provedor de pagamento em sequência. #### Passo 1 — Encontre a referência da API A documentação completa da API está em **help.dmchamp.com → API Reference → Sub Accounts**. > Abra o `help.dmchamp.com` diretamente, não a URL da sua documentação white-label. A referência da API é filtrada da documentação white-label para que seus clientes não a vejam. A seção Sub Accounts mostra o endpoint de criação de subconta, o formato da resposta (incluindo a senha temporária que você pode usar em seu e-mail de boas-vindas) e as flags de recursos disponíveis que você pode passar ao criar uma conta. #### Passo 2 — Configure o webhook de recarga automática 1. No assistente do Modo SaaS, escolha **Usar um Provedor de Pagamento Personalizado**. 2. Insira sua **URL de webhook** — o endpoint no seu servidor (ou Zapier / Make / n8n) que lidará com eventos de saldo baixo. 3. Clique em **Enviar Evento de Teste** para verificar se o endpoint está acessível. O painel de resultados mostra o status HTTP que seu servidor retornou, a latência de ida e volta, o corpo da resposta e o payload JSON exato enviado — para que você possa criar e depurar seu manipulador de ponta a ponta sem esperar que um cliente real fique com saldo baixo. Eventos de teste têm `test: true` no payload para que seu servidor possa interromper o processo antes de cobrar alguém. 4. Clique em **Salvar URL do Webhook**. Uma vez configurado, sempre que o saldo de créditos de uma subconta cair abaixo do limite de recarga automática: - A plataforma envia uma notificação para sua URL de webhook com os detalhes da subconta e quantos créditos eles precisam. - Seu servidor processa o pagamento da maneira que desejar (cobrar o cartão do cliente, criar uma fatura, deduzir de um saldo pré-pago, etc.). - Após a confirmação do pagamento, seu servidor chama a API para conceder os créditos à subconta. Para detalhes técnicos sobre o payload do webhook e a chamada de API, consulte [Sub-Account Auto-Recharge (Custom Payment Provider)](sub-account-auto-recharge.md). --- ### Opção 3: Conectar PayPal Escolha este caminho se o Stripe não estiver disponível em seu país, ou se seus clientes preferirem pagar com PayPal. Ele é integrado exatamente como o Stripe — a plataforma executa o checkout, cria a subconta e entrega os créditos — e o dinheiro vai direto para **sua própria conta PayPal Business**. Você precisa de uma conta PayPal Business com um aplicativo REST criado nela; não há nada para construir. Conectar o PayPal não substitui o Stripe. Se você tiver ambos, seus clientes recebem ambos os botões, em sua página de Faturamento e em seus cartões de preço. #### Passo 1 — Conecte seu aplicativo PayPal 1. No assistente do Modo SaaS, escolha **Conectar PayPal em vez disso**. 2. Em uma nova aba, abra seu painel de desenvolvedor do PayPal e crie um **aplicativo REST** em sua conta Business. 3. Copie o **ID do Cliente** e o **Segredo** do aplicativo e cole-os no assistente. 4. Escolha o ambiente: **Live** para pagamentos reais, ou **Sandbox** se você quiser testar todo o fluxo primeiro com compradores de teste do PayPal. O ID do Cliente e o Segredo devem vir do mesmo ambiente que você escolher, e os pagamentos em Sandbox não são dinheiro real — altere a conexão para Live antes de compartilhar seus links. 5. Clique em **Salvar e Continuar**. A plataforma verifica as credenciais com o PayPal imediatamente; se o PayPal as rejeitar, nada é salvo e você pode colá-las novamente. #### Passo 2 — Registre o webhook do PayPal O webhook é como sua conta PayPal informa à plataforma que um pagamento foi concluído, uma assinatura foi renovada ou um pagamento foi reembolsado. Sem ele, seus clientes pagam, mas seus créditos não são entregues. 1. O assistente mostrará uma **URL de webhook**. Copie-a. 2. No mesmo aplicativo PayPal REST, adicione um webhook com essa URL e inscreva-o nestes eventos: - `CHECKOUT.ORDER.APPROVED` - `PAYMENT.CAPTURE.COMPLETED`, `PAYMENT.CAPTURE.DENIED`, `PAYMENT.CAPTURE.REFUNDED`, `PAYMENT.CAPTURE.REVERSED` - `PAYMENT.SALE.COMPLETED`, `PAYMENT.SALE.REFUNDED` - `BILLING.SUBSCRIPTION.ACTIVATED`, `BILLING.SUBSCRIPTION.CANCELLED`, `BILLING.SUBSCRIPTION.SUSPENDED`, `BILLING.SUBSCRIPTION.EXPIRED`, `BILLING.SUBSCRIPTION.PAYMENT.FAILED` - `VAULT.PAYMENT-TOKEN.DELETED` 3. O PayPal fornecerá um **ID** para o novo webhook. Copie-o, cole-o no assistente e clique em **Salvar**. Seus planos são os mesmos de qualquer maneira — configure-os uma vez como no [Passo 3 — Configurar níveis de preços](#step-3--set-up-pricing-tiers) e eles serão vendidos através de quaisquer métodos de pagamento que você tiver conectado. #### O que seus clientes veem - **Recargas** — um botão **Pagar com PayPal** na página de Faturamento deles, ao lado da opção de cartão, pelo mesmo preço por crédito que você definiu. - **Planos** — cada nível recebe um link de checkout do PayPal ao lado do link do Stripe na aba **Pagamentos**, e **Copiar Código de Incorporação** emite um botão por método de pagamento conectado, para que um cartão de preços no seu site possa oferecer cartão e PayPal lado a lado. - **Recargas automáticas** — veja abaixo. #### Recargas automáticas no PayPal Uma configuração, **Cobrança de recargas automáticas**, decide qual dos seus métodos conectados lida com as recargas automáticas: Stripe, PayPal ou seu próprio webhook. Apenas um deles pode fazer isso por vez, mesmo quando você tem Stripe e PayPal conectados — todo o resto (recargas manuais, checkout de planos) continua oferecendo ambos. Defina como **PayPal** e cada cliente conecta sua própria conta PayPal uma vez, a partir do cartão **Recarga automática** na página de Faturamento deles. A partir daí, sempre que o saldo deles cair abaixo do limite, a plataforma cobra essa conta PayPal salva pela recarga no seu preço por crédito e entrega os créditos automaticamente, exatamente como o fluxo de cartão do Stripe faz. Um cliente que ainda não conectou o PayPal simplesmente não é cobrado — o saldo dele diminui até que ele conecte uma conta ou compre créditos manualmente — e, se o PayPal recusar uma cobrança, nenhum crédito é entregue e a plataforma tenta novamente na próxima vez que o saldo cair abaixo do limite. Os clientes podem remover sua conta PayPal do mesmo cartão sempre que quiserem. Se você desconectar o PayPal posteriormente no Modo SaaS e ele for o que estava lidando com as recargas automáticas, elas retornarão para o Stripe, se você o tiver conectado, ou para seu próprio webhook, se você tiver configurado um. #### É bom saber sobre o PayPal - **Um plano sempre solicita ao cliente uma conta PayPal, mesmo em um teste gratuito.** Os testes ainda funcionam — nada é cobrado até que o teste termine — mas o PayPal exige que o comprador aprove com uma conta antecipadamente, portanto, a opção **Exigir cartão para iniciar teste** do plano não faz diferença em um checkout do PayPal. Se você depende de testes sem conta, venda esse plano através do Stripe. - **Os preços são cobrados exatamente como você os definiu.** O PayPal não adiciona uma linha de imposto separada no checkout, portanto, inclua qualquer imposto devido no preço dos seus planos e no seu preço por crédito. - **Trocar de plano significa cancelar e assinar novamente.** Um cliente em uma assinatura do PayPal não pode mudar para outro nível no lugar: ele cancela o atual e compra o novo plano através do seu próprio link. (Clientes que pagam com cartão ainda podem trocar no portal do cliente Stripe — veja [Clientes trocando de plano](#clients-switching-plans).) - **Um reembolso não retira os créditos.** Se você reembolsar um pagamento do PayPal a partir da sua conta PayPal, o reembolso é registrado aqui, mas os créditos já entregues permanecem no saldo do cliente — o mesmo que ocorre com o Stripe. --- ### Configuração de Preços - **Níveis de preços** — defina pacotes de créditos que seus clientes podem comprar (até 10, por exemplo, "Pacote Inicial: 100 créditos por $15"), configurados na aba **Planos** do Modo SaaS. Cada plano fatura **mensalmente, anualmente ou a cada N semanas** (um preço anual ainda concede seus créditos mês a mês; um plano do tipo semanal os concede a cada período de faturamento) e pode ter um **teste gratuito** de 1 a 90 dias com seu próprio valor de crédito de teste, com ou sem solicitar um cartão antecipadamente, e com ou sem **expiração rígida** (créditos de teste não utilizados retornam para seu pool, conta bloqueada, se o teste terminar sem uma atualização). Veja [Passo 3 — Configurar níveis de preços](#step-3--set-up-pricing-tiers). Cada plano recebe seu próprio link de pagamento na aba **Pagamentos** — um do Stripe, um do PayPal ou ambos, dependendo do que você conectou. Cada plano também pode limitar o que um cliente carrega entre renovações: o grupo **Créditos não utilizados** define **Manter no máximo** (meses de franquia mantidos) e **Expirar créditos não utilizados após** (dias), aplicado a cada cliente no plano — veja [Limitando o que é transferido](sub-accounts.md#capping-what-rolls-over). Você também pode gerenciar tudo isso a partir do código — veja [Gerenciar seus níveis de preços via API](api-for-agencies.md#manage-your-pricing-tiers-over-the-api). - **Preço por crédito** — defina um preço personalizado por crédito para recargas flexíveis. Compras de crédito personalizadas (ad-hoc) devem ser entre 10 e 10.000 créditos por transação. Assinaturas de nível cobrem valores fixos; o valor personalizado lida com qualquer coisa entre eles. Uma **nota** opcional (até 200 caracteres) é mostrada aos clientes diretamente abaixo do preço na página de Faturamento deles — útil quando você precifica em uma moeda, mas cobra em outra, por exemplo, *"USD 0,25 por crédito à nossa taxa de referência"*. O preço e a nota também podem ser lidos e alterados a partir do código — veja [Definir seu preço por crédito via API](api-for-agencies.md#set-your-per-credit-price-over-the-api). - **Preço mínimo de crédito** — a plataforma impõe um preço mínimo por crédito para manter a sustentabilidade da plataforma. Você pode definir seu preço igual ou acima desse mínimo. ### Painel de Créditos da Subconta Os **Detalhes de uso de crédito** de cada subconta (no menu **Mais** da linha na página de Subcontas) mostram: - Créditos comprados e gasto total - Créditos consumidos e saldo restante - Tendências de uso ao longo do tempo, detalhadas por motivo e pelas principais campanhas > **O que o painel mostra.** Quando uma subconta usa a chave de API da sua agência, o painel mostra o uso de créditos, mas oculta o custo em dólares subjacente. Os totais de uso contam apenas os créditos efetivamente consumidos — bônus promocionais, renovações mensais e ajustes de plano são excluídos para que o número de "créditos usados" reflita a atividade real. --- ## Copiando Campanhas para Subcontas Você pode copiar uma campanha comprovada da sua conta de agência (ou de qualquer subconta) para uma ou mais subcontas de uma só vez — a configuração do bot, a mensagem de abertura, as FAQs e a base de conhecimento, as funções personalizadas e a mídia são transferidas, para que você não precise reconstruí-las manualmente. A cópia chega como um Rascunho, e alguns itens específicos da conta (modelos de WhatsApp, canais e número de telefone, lista de contatos) são refeitos em cada subconta. Comece pela página de **Subcontas** — abra o menu **Mais** de uma linha e escolha **Copiar campanha para cá**. Para copiar um Agente de IA, use **Copiar agente para cá** no mesmo menu, ou o ícone **Copiar este agente para uma subconta** na linha do agente na página de **Agentes de IA**. Para entregar a um cliente uma configuração completa de uma só vez, em vez de um único Agente, use um **Snapshot** — veja [Snapshots](snapshots.md). Para o passo a passo completo, o que é copiado e o que precisa ser refeito, consulte [Copiar uma Campanha para uma Subconta](sub-accounts.md#copy-a-campaign-to-a-sub-account). --- ## Modo de Acesso (atuando como uma subconta) Você pode acessar o painel de uma subconta diretamente da sua conta de agência, como se você fosse o cliente. Este é o mesmo recurso que algumas plataformas chamam de "assistir" ou "personificar" — aqui, a ação é rotulada como **Entrar como usuário**. 1. Na barra lateral, clique em **Subcontas**. 2. Encontre a subconta na lista. Nessa linha, clique no menu **Mais** (ícone de três pontos na extremidade direita). 3. Clique em **Entrar como usuário**. 4. O painel é recarregado como essa subconta — acesso total às campanhas, contatos, chats e configurações dela. 5. Quando terminar, clique na pílula âmbar **Assistindo: ** no topo da barra lateral e escolha **Voltar para minha agência**. Isso é especialmente útil para fornecer suporte prático aos clientes sem pedir que eles compartilhem suas credenciais de login. --- ## Gerenciando Recursos de Subcontas Dependendo do seu nível de agência, você pode controlar a quais recursos cada subconta tem acesso. A alocação de recursos é gerenciada por subconta e através dos seus níveis de preços. No modal **Editar** de uma subconta, você pode ajustá-la individualmente: alternar quais recursos ela possui, ocultar páginas específicas do menu lateral e das configurações, escolher quem recebe seus e-mails de alerta (veja [Roteamento de Notificações](sub-accounts.md#notification-routing)), definir um limite mensal para o gasto da sua própria chave de API e ativar ou desativar seu nível de IA Máxima. O editor de recursos inclui um grupo de **Tipos de Canal** que decide quais canais de mensagens o cliente pode conectar — Chat Widget, WhatsApp Business API, WhatsApp Web, Instagram, Facebook Messenger, Telegram, LINE, Viber, E-mail, SMS e iMessage. Os tipos de canal são ativados por padrão, a menos que você desative alguns; um canal que você desativou aparece como bloqueado na página de Canais do cliente, com uma observação de que ele não está incluído no plano atual dele. > **Se o cliente estiver em um nível pago, coloque o recurso no nível também.** As alternâncias que você define aqui são substituídas pela própria lista de recursos do nível toda vez que a assinatura desse cliente é renovada. Use o modal **Editar** para ajustes pontuais e o nível de preços para qualquer coisa que o cliente deva manter. > **Nível Max de IA e sua própria chave de API.** Se sua agência opera com sua própria chave de API, habilitar o Max para um cliente altera o uso de IA desse cliente de "gratuito via sua chave" para 0,25 créditos por ação faturados no pool da sua agência. O mesmo se aplica ao nível **Mini**, que vem com o Max — ele também é executado em nossa infraestrutura, a 0,15 créditos por ação, nunca em sua chave. --- ## Precisa de ajuda? If you have questions about agency accounts or sub-account management, reach out via our [email support](mailto:hi@dmchamp.com).