Contas de Agência #

O que são Contas de Agência? #

As contas de agência permitem-lhe gerir várias contas de cliente a partir de um único painel. Em vez de iniciar sessão em contas separadas para cada cliente, obtém uma vista centralizada onde pode criar subcontas, monitorizar os seus agentes de IA, alocar créditos e alternar entre clientes instantaneamente.

Isto foi concebido para agências de marketing, consultores e revendedores que gerem a aplicação em nome de várias empresas.

As duas páginas que tornam isto possível — Subcontas e Modo SaaS — têm cada uma o seu lugar na barra lateral, em vez de estarem escondidas dentro das Definições. Esta página é a visão geral; os mecanismos do dia a dia encontram-se na Gestão de Subcontas.

Sistema de Créditos Partilhados #

Uma das principais diferenças entre as contas de agência e as contas regulares é o funcionamento dos créditos:

• Os créditos são partilhados entre a sua conta de agência e todas as subcontas.
• Quando uma subconta utiliza créditos (para respostas de IA, transmissões, etc.), os créditos são deduzidos do saldo da sua agência.
• As subcontas não veem o saldo de créditos — apenas veem a sua utilização. Você, como agência, gere o conjunto total de créditos.

Exemplo: Tem 1.000 créditos na sua conta de agência. O agente de IA do Cliente A responde a 50 mensagens de uma transmissão (50 créditos). O bot de IA do Cliente B responde a 30 conversas (30 créditos). O seu saldo restante é de 920 créditos.

Criar Subcontas #

1. Clique em Subcontas na barra lateral principal — é uma página própria, logo acima de Definições.
2. Clique no botão verde Adicionar conta (canto superior direito).
3. Preencha os detalhes do seu cliente no modal de 3 passos: conta (nome, e-mail), empresa (nome da empresa, morada, descrição) e funcionalidades.

4. Clique em Criar conta.

Um ecrã de confirmação mostra a palavra-passe de início de sessão gerada — copie-a antes de fechar. Se o cliente também a recebe por e-mail, a escolha é sua: o interruptor Enviar informações da conta para a subconta no passo Funcionalidades (em E-mail de boas-vindas) está ativado por predefinição e envia a palavra-passe ao cliente por e-mail. Desative-o e apenas você receberá a palavra-passe, por e-mail e uma vez no ecrã, para que a possa entregar pessoalmente. Guia completo: Gestão de Subcontas — Criar uma Subconta.

Mostrar uma demonstração ao vivo a um potencial cliente #

Antes de um cliente se registar, pode dar-lhe uma pré-visualização ao vivo do assistente de chat a funcionar no seu próprio site — sem necessidade de instalação da parte dele. Utilize a Ligação de demonstração para cliente.

Como funciona: cola o endereço do website do cliente e a plataforma gera uma ligação partilhável. Quando o cliente abre essa ligação, vê o seu próprio website com o seu widget de chat flutuante por cima — totalmente ativo e pronto para conversar. Nada muda no website real deles e não precisam de tocar em qualquer código. A pré-visualização reside inteiramente na sua ligação.

Como chegar lá: abra Definições → Canais → Canais, clique em Gerir no cartão Widget de chat do website, desloque-se até Canais e Incorporação, escreva ou cole o endereço do website do cliente (por exemplo, theirbusiness.com) no campo Ligação de demonstração do cliente e clique em Criar ligação. A ligação é copiada para si e adicionada à lista abaixo do campo. Depois, envie essa ligação ao cliente da forma que preferir — e-mail, WhatsApp, uma mensagem, onde quiser.

Algumas coisas a saber:

• Alguns sites não permitem ser apresentados dentro de outra página (uma definição de segurança da parte deles). Quando isso acontece, a ligação de demonstração continua a funcionar — mostra uma moldura de pré-visualização limpa com o endereço do site, e o assistente de chat continua totalmente ativo para experimentação. A experiência de conversação é idêntica; apenas o pano de fundo do site difere.
• A demonstração utiliza a sua configuração real do widget, pelo que quaisquer mensagens que o cliente envie durante o teste chegam até si como qualquer outra conversação do widget de chat.
• Uma ligação de demonstração não memoriza um agente: a ligação pertence ao seu widget de chat e as conversas de demonstração vão sempre para o agente que for o predefinido do seu widget nesse momento. Pode ter várias ligações ativas ao mesmo tempo, mas todas mostram esse mesmo agente, pelo que alterar o predefinido altera todas as demonstrações abertas. Para duas demonstrações personalizadas ao mesmo tempo, crie a segunda numa subconta. Eliminar um agente de demonstração não desativa uma ligação.
• Assim que a demonstração terminar, clique em Desativar junto à ligação na lista. Qualquer pessoa que a abra depois disso verá uma página a indicar que a ligação foi desativada, e o seu widget continua a funcionar em todos os outros locais. As ligações copiadas antes de 25 de setembro de 2026 não constam da lista; Desativar essas ligações abaixo da lista desativa-as todas de uma só vez.

Credenciais de Acesso do Cliente #

Quando cria uma subconta:

• O cliente recebe um e-mail e uma palavra-passe que pode utilizar para iniciar sessão na sua própria conta, na sua página de início de sessão com marca branca.
• Dar acesso de início de sessão aos clientes é opcional — pode gerir tudo em nome deles, se preferir.
• Se o cliente iniciar sessão, verá o seu próprio painel com os seus agentes de IA, contactos e conversas. Não verá o seu painel de agência nem outras subcontas.
• O saldo de créditos está oculto das subcontas, uma vez que você gere o conjunto de créditos partilhado.

Alternar entre Subcontas #

Existem duas formas de mudar para a conta de um cliente:

O seletor de conta, a partir de qualquer lugar:

1. No topo da barra lateral, clique em Mudar de conta.

2. Pesquise a subconta por nome ou e-mail, ou percorra a lista.
3. Clique nela. O painel de controlo recarrega com 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 no extremo direito).
3. Clique em Iniciar sessão como utilizador.

De qualquer forma, enquanto estiver dentro de uma subconta, o seletor na barra lateral fica cor de âmbar e apresenta A assistir: . Clique nele e escolha Voltar para a minha agência para regressar ao seu próprio painel. A barra cor de âmbar A assistir no topo da página tem a mesma opção de saída; clique no × para ocultar a barra durante o resto da sua visita, caso precise de espaço.

Se o cliente tiver a autenticação de dois fatores ativada, não lhe será pedido o código: já iniciou sessão como si próprio e o código seria enviado para o cliente, não para si.

Monitorização da Utilização de Créditos #

Como agência, pode monitorizar como os créditos estão a ser consumidos em todas as subcontas:

• Blocos de estatísticas na página de Subcontas — quantos agentes de clientes estão ativos ou inativos e quantas subcontas têm problemas.
• Acompanhamento por subconta — quantos créditos cada subconta está a utilizar, a partir do menu Mais dessa linha.
• Detalhes de utilização de créditos — uma vista dedicada por subconta que mostra os créditos comprados, créditos consumidos, saldo restante, utilização por motivo, a lista de gastos dos Principais agentes e uma tabela de transações filtrável.

Esta visibilidade ajuda-o a compreender os seus custos, identificar clientes com elevada utilização e definir preços adequados para os seus serviços.

Revenda de Créditos (também conhecido como Modo SaaS) #

A revenda de créditos permite-lhe vender créditos às suas subcontas ao seu próprio preço, criando uma fonte de receita para a sua agência. Toda esta área reside na sua própria página na barra lateral chamada Modo SaaS — a mesma funcionalidade que poderá conhecer como “Revenda de Créditos”, sob o seu nome padrão da indústria. Está disponível no plano Agência e está bloqueada atrás da funcionalidade de white-labeling. Se o seu plano incluir white-labeling — o que todos os níveis de oferta vitalícia que o listam incluem — a revenda já é sua: não está limitado a gerir a aplicação para clientes, pode vender planos sob a sua própria marca, aos seus próprios preços, através do seu próprio Stripe ou PayPal. Nada extra para comprar.

Como Funciona #

1. Abrir o Modo SaaS — clique na sua entrada na barra lateral principal (fica ao lado de Subcontas, perto da parte inferior do menu), ou clique na pílula Modo SaaS no topo da página de Subcontas.
2. Ativar a revenda de créditos para uma subconta no seu modal Editar (página de Subcontas → menu Mais da linha → Editar → Gestão de Créditos) mudando o modo de Manual para Revenda. A revenda só é oferecida quando a sua agência tiver o white-labeling no seu plano.
3. Defina o seu preço — defina pacotes de créditos e preços por crédito que as suas subcontas veem quando compram créditos.
4. Aplicação de preço mínimo — a plataforma aplica um preço mínimo de crédito para garantir um preço sustentável em toda a plataforma.
5. As subcontas compram créditos através do seu checkout personalizado, alimentado por qualquer fornecedor de pagamento que ligue — Stripe, PayPal, ou ambos. Os pagamentos vão diretamente para a sua própria conta com esse fornecedor.
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 seu pool de agência — essa dedução é o seu custo da venda, enquanto o pagamento do cliente vai para a sua própria conta de pagamento.

Economia dos 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 seu pool de agência. O dinheiro do cliente vai para a sua conta Stripe; a dedução do pool é o seu custo de plataforma pela venda. O seu lucro é a diferença entre o preço que definiu e o custo desses créditos para si — que é também a razão pela qual existe o preço mínimo por crédito (não pode definir um preço para um pacote abaixo do custo de crédito da própria plataforma).

Mantenha o seu pool coberto: o checkout exige que o pool da sua agência contenha, pelo menos, tantos créditos quantos os do pacote que está a ser adquirido. O mesmo se aplica ao seu link público de inscrição: um plano que oferece ao comprador 1.000 créditos só é vendido enquanto o seu pool contiver pelo menos 1.000 (para um plano com período experimental gratuito, os créditos do período experimental). Quando não contém, o comprador vê “As inscrições estão temporariamente indisponíveis. Por favor, contacte (o nome da sua empresa) para concluir a sua compra.” e ninguém é cobrado; carregue os seus créditos em Definições → Faturação e o mesmo link voltará a funcionar. Sempre que um comprador ou um dos seus clientes for recusado desta forma, receberá um alerta por e-mail, na aplicação e como notificação push, indicando quantos créditos a compra exigia e qual era o seu saldo, no máximo uma vez a cada 6 horas, para que possa carregar ou ativar o carregamento automático antes que o próximo comprador chegue. Se, no momento do pagamento, o seu pool ainda não conseguir cobrir a compra, a plataforma cobra automaticamente o cartão da sua agência registado para o carregar — e se essa cobrança automática falhar, o pagamento do cliente é reembolsado e não são entregues créditos.

Exemplo: Vende 150 créditos por 25 $. Os 150 créditos são depositados no saldo do cliente, os 25 $ vão para a sua conta Stripe e 150 créditos são deduzidos do seu pool de agência. Se esses créditos do pool lhe custarem 15 $, a sua margem na venda é de 10 $.

Os créditos adquiridos cobrem tudo o que o cliente gasta — respostas de IA, ferramentas, seguimentos e também os custos de WhatsApp não relacionados com IA (aluguer de números e, a partir de 1 de outubro de 2026, as taxas de operador por mensagem). Tudo isto é deduzido primeiro ao saldo adquirido pelo cliente; o seu fundo de agência apenas cobre o que esse saldo não conseguir cobrir. Os custos de WhatsApp são faturados ao preço de custo, a menos que aplique uma margem por cliente: a linha Margem de lucro da taxa de WhatsApp na secção Editar → Preços de ação de uma subconta é um multiplicador sobre esses custos, e a diferença é creditada de volta no seu fundo (ver Aplicar margem de lucro aos custos de WhatsApp de um cliente). O campo Preço do cliente é separado e apenas altera o preço das ações de IA Max e Mini. O SMS não é uma delas: o SMS funciona sempre numa conta Twilio que liga pessoalmente, pelo que a Twilio lhe fatura diretamente e não estão envolvidos créditos.

O que acontece quando o saldo de um cliente chega a zero #

Os gastos de um cliente de revenda permanecem isolados dos créditos que comprou desde que a sua avença mensal seja zero. Sem avença, no momento em que o saldo adquirido atinge zero, o bot de IA deixa de responder para essa subconta — não recorre ao seu saldo de 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 a utilização de um cliente esgote o saldo da sua agência.

Se a subconta ainda tiver uma Avença mensal definida (consulte Modos de gestão de créditos), essa avença continua a ser atribuída todos os meses e é gasta a partir do seu saldo exatamente como no modo manual, pelo que o cliente continua a funcionar depois de os seus créditos adquiridos se esgotarem. Defina a avença como zero na janela Editar da subconta se pretender o comportamento de pagamento por utilização. (O SMS é-lhe faturado diretamente pela Twilio de qualquer forma, pelo que não existe qualquer cobrança de créditos envolvida.)

O Fluxo de Inscrição Self-Service #

O objetivo da revenda de créditos é que não tenha de gerir as inscrições manualmente. O fluxo funciona da seguinte forma:

1. Publica uma ligação de pagamento (num e-mail, no seu site, num anúncio).
2. Um novo cliente clica nela, paga e uma subconta é criada automaticamente. (Se o plano tiver um período experimental gratuito, o cliente inicia-o sem pagar nada — a cobrança ocorre automaticamente quando o período experimental termina.)
3. O cliente recebe um e-mail de início de sessão com uma palavra-passe temporária.
4. O cliente inicia sessão, conclui a integração e prossegue a partir daí.

Só intervém se o cliente precisar de ajuda — carregamentos de saldo, novas tentativas de pagamento, etc., tudo funciona em piloto automático.

Existem três formas de configurar isto: Stripe (recomendado, totalmente integrado), PayPal (também totalmente integrado, e a resposta habitual quando o Stripe não está disponível onde se encontra), ou um Fornecedor de Pagamento Personalizado (qualquer outro sistema que já utilize — requer um pouco de trabalho de integração).

Configurar a Revenda de Créditos #

1. Clique em Modo SaaS na barra lateral principal.
2. Se é a sua primeira vez aqui, chegará ao assistente de configuração. Escolha um dos três caminhos:
   • Tenho uma conta / Ligar Stripe — recomendado. Veja Opção 1: Ligar Stripe abaixo.
   • Usar um Fornecedor de Pagamento Personalizado — para qualquer outro fornecedor de pagamento que queira gerir você mesmo. Veja Opção 2: Fornecedor de Pagamento Personalizado abaixo.
   • Ligar PayPal em vez disso — integrado como o Stripe, com o dinheiro a cair na sua conta PayPal Business. Veja Opção 3: Ligar PayPal abaixo.

O Stripe é o caminho de menor resistência. Se o Stripe não estiver disponível no seu país, ou se os seus clientes simplesmente preferirem o PayPal, ligue o PayPal — é igualmente integrado e não necessita de trabalho de integração. Mantenha a rota de fornecedor de pagamento personalizado para um sistema de faturação que já tenha e queira manter (Mollie, Paddle, GoCardless, o seu próprio backend, etc.).

Pode ligar o Stripe e o PayPal ao mesmo tempo. Os seus clientes recebem então um botão para cada um e escolhem o que preferirem.

Opção 1: Ligar Stripe #

Este é o caminho recomendado. A plataforma trata do checkout, da criação da conta e da entrega dos créditos por si — basta fornecer as chaves ao Stripe.

Passo 1 — Criar uma chave API restrita do Stripe #

1. No assistente do Modo SaaS, ser-lhe-á pedida a sua Chave Secreta Stripe.
2. Abra o seu painel de controlo Stripe num novo separador → Developers → API keys → Create restricted key.
3. Dê um nome à chave (por exemplo, DM Champ Reselling) e conceda estas permissões:
   • Checkout Sessions → Write
   • Products → Write
   • Prices → Write
   • Subscriptions → Write (identifica a subscrição de cada cliente para que as renovações — e as avaliações gratuitas que convertem em pagas — creditem a conta correta, e permite que a plataforma verifique um nível para subscritores ativos antes de o eliminar)
   • Customers → Write, Setup Intents → Read e Customer portal → Write (utilizado quando um cliente guarda um cartão para recarregamento automático ou gere a sua subscrição)
   • Account → Read
   • Webhook Endpoints → Write (permite que a plataforma verifique se o seu webhook está registado com os eventos corretos e corrija-o por si, caso não esteja — consulte a verificação de integridade do Webhook abaixo)
4. Clique em Create key e, em seguida, copie a chave.

Já estabeleceu a ligação com menos permissões? Não precisa de uma nova chave. No Stripe, abra Developers → API keys, clique na sua chave restrita existente, selecione as permissões em falta e guarde — a plataforma detetá-las-á no pedido seguinte. O sintoma revelador de uma chave sem Subscriptions é o erro “Could not verify if this tier has active subscribers” quando tenta eliminar um nível de preços.

5. Cole-a no assistente e clique em Save & Continue.

Vai mudar para uma conta Stripe diferente mais tarde? Guarde a chave da nova conta da mesma forma (Modo SaaS → o assistente de reconfiguração), registe o webhook na nova conta e recrie os seus planos lá. Os clientes que compraram antes da mudança mantêm os seus créditos e o estado do plano aqui, mas o seu registo de faturação e qualquer cartão que tenham guardado para carregamento automático residiam na sua conta Stripe antiga, pelo que são esquecidos automaticamente: a sua próxima compra cria um novo cliente na nova conta e a um cliente com carregamento automático será pedido que guarde um cartão novamente. Os clientes que nunca compraram nada não são afetados.

Passo 2 — Registar o webhook do Stripe #

1. O assistente mostra-lhe um URL de webhook. Copie-o.
2. Em Stripe → Developers → Webhooks → Create an event destination (painéis de controlo mais antigos do Stripe chamam a isto Add endpoint). Quando o Stripe pedir o tipo de endpoint, escolha Your account (um endpoint de Account), não Connected accounts: ligou a sua própria conta Stripe, por isso não existe nenhuma aplicação Connect envolvida.
3. Cole o URL do webhook como o Endpoint URL.
4. Para os eventos, selecione checkout.session.completed (compras iniciais), invoice.paid (renovações e a primeira cobrança após o fim de um período experimental gratuito — sem isto, a renovação de um cliente é cobrada no Stripe, mas os seus créditos não são recarregados), customer.subscription.updated (alterações de plano feitas no portal de cliente do Stripe — sem isto, um cliente que faça um upgrade mantém a sua tolerância antiga até que a corrija manualmente) e customer.subscription.deleted (cancelamentos — sem isto, um cliente que cancele no Stripe continua a aparecer aqui como subscrito).
5. Para o Payload style (ou formato de payload), escolha Snapshot, não Thin. Um destino “thin” envia apenas uma referência para o evento, sem os detalhes da compra, e não é visível para a verificação de webhook da plataforma: o assistente avisa então que não foi encontrado nenhum endpoint de webhook e as compras dos clientes não são creditadas. Se já criou um “thin”, elimine-o e crie um novo destino com Snapshot.
6. O Stripe mostra um signing secret para o novo webhook. Copie-o e cole-o no assistente, depois clique em Save & Continue.

O modo de teste é ignorado #

O Stripe envia eventos de modo de teste para o mesmo endpoint, e a plataforma ignora todos eles: um checkout de teste não cria nenhuma conta de cliente, não atribui créditos e não lhe custa nada do seu saldo de créditos. Para experimentar o seu próprio fluxo de registo de ponta a ponta, execute-o em modo ativo com um cupão de 100% de desconto.

Verificação de integridade do Webhook #

Assim que guardar o segredo de assinatura, e uma vez por dia a partir daí, a plataforma utiliza a sua chave Stripe para verificar se o seu endpoint de webhook está ativado e subscrito a todos os quatro eventos. Se faltarem eventos e a sua chave tiver a permissão Webhook Endpoints → Write, estes são adicionados automaticamente por si. Se a plataforma não conseguir corrigir o problema (não foi encontrado nenhum endpoint, o endpoint está desativado, a chave não tem a permissão necessária ou a Stripe rejeita a chave porque expirou ou foi revogada), o painel de controlo do Modo SaaS apresenta um aviso “Webhook needs attention” que lhe indica exatamente o que fazer. Corrija-o rapidamente: enquanto o aviso estiver ativo, as renovações dos seus clientes continuam a ser cobradas na Stripe, mas os seus créditos não são recarregados.

Não precisa de abrir o painel para descobrir: os mesmos problemas, além de uma chave Stripe rejeitada em qualquer parte da plataforma e um webhook que deixou de responder (a Stripe enviou renovações ou pagamentos que nunca chegaram), também lhe enviam um alerta de Problemas de Ligação Stripe por e-mail e através do sino de notificações, no máximo uma vez por dia por problema. Consulte Notificações.

Passo 3 — Configurar escalões de preços #

1. Defina os pacotes de créditos que os seus clientes podem comprar (até 20 níveis — por exemplo, Starter — 1.000 créditos / $29, Pro — 5.000 créditos / $99) e, opcionalmente, as funcionalidades que cada nível desbloqueia. Os itens de programador que um nível exclui (Acesso à API, Servidores MCP, Webhooks e Integrações CRM & ERP) são ocultados das Definições do cliente, para que este veja apenas o que o seu plano inclui. Desmarque Integrações CRM & ERP e os clientes nesse plano deixarão de ver Definições → CRM & ERP, onde sistemas de negócio como o Odoo são ligados. Os planos que criou antes desta opção existir têm-na ativada, pelo que nada muda para os seus clientes atuais até que a desmarque.
   • Um plano pode ter 0 créditos se incluir a opção Traga a Sua Própria Chave de API. Marque Traga a Sua Própria Chave de API nas funcionalidades do plano e defina os créditos para 0: o cliente paga o preço do seu plano pela plataforma e a sua IA funciona com a sua própria chave de API, que adiciona nas suas próprias definições, pelo que o plano não retira nada do seu conjunto de créditos. As respostas da IA do cliente só começam depois de essa chave ser adicionada. Em qualquer plano sem a opção Traga a Sua Própria Chave de API, os créditos devem ser pelo menos 1, e guardar 0 apresenta um erro. O link de pagamento e a lista de planos de um plano de 0 créditos mostram apenas o preço, sem uma linha de créditos.
   • Precisa do mesmo plano em dois ciclos de faturação — digamos, mensal e anual? Configure-o uma vez e, em seguida, clique no ícone Duplicar (ao lado do ícone do lixo no nível) em vez de o criar novamente. A cópia transporta todas as definições do original — créditos, preço, funcionalidades, limites, período experimental — com (cópia) adicionado ao seu rótulo, e ainda não está publicada: altere a sua Faturação para Anual, ajuste o preço e o rótulo, depois guarde, e este obtém o seu próprio produto e preço no Stripe. A cópia é sempre adicionada ao fim da sua lista de Planos propositadamente: os seus links de pagamento e código de incorporação apontam para os planos pela sua posição na lista (ver Passo 4 — Partilhe os seus links de pagamento), pelo que nada do que já colocou no seu site se move.
2. Escolha como o plano fatura com o seletor Faturação: Mensal, Anual ou A cada N semanas. No Mensal, nada muda — o preço que introduz é cobrado todos os meses. No Anual, o preço que introduz é o preço para um ano inteiro, enquanto o campo Créditos por mês continua a significar exatamente isso — os créditos que o cliente recebe por mês. Portanto, 1.000 créditos / $290 / Anual é um cliente a pagar-lhe $290 uma vez por ano e a receber 1.000 créditos todos os meses. O seu subsídio é concedido mês a mês — o primeiro mês quando compram, depois automaticamente a cada mês seguinte, com a contagem a reiniciar em cada renovação anual — em vez de doze meses de créditos serem atribuídos no primeiro dia. Isso é importante para o seu conjunto: uma venda anual não retira um ano de créditos de uma só vez. Se o cliente cancelar, as concessões mensais param. A cada N semanas é para qualquer outro ciclo: escolha-o e introduza as Semanas entre pagamentos (1 a 52) — a cada 4 semanas, por exemplo, o que perfaz 13 pagamentos por ano em vez de 12. Num plano de estilo semanal, o preço e os créditos aplicam-se por período de faturação: 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 o ciclo de faturação de um plano guardado cria um novo preço no seu Stripe, pelo que os subscritores existentes permanecem no que subscreveram.
3. Dê ao plano um período experimental gratuito se desejar. Período experimental gratuito (dias) aceita qualquer valor de 1 a 90 — deixe em 0 para não haver período experimental — e Créditos de teste define com quantos créditos o cliente começa (o padrão são os créditos mensais do plano, e pode reduzi-lo — para um mínimo de 1, porque uma conta de teste sem créditos não conseguiria concluir a sua própria configuração). Com um período experimental definido, um novo cliente não é cobrado no registo: recebe os créditos de teste no primeiro dia e pode usar o plano imediatamente. Quando o período experimental termina, o Stripe cobra o preço do plano automaticamente e o cliente passa a ter o subsídio mensal completo a partir daí. Algumas coisas a ter em mente:
   • Os créditos de teste saem do seu conjunto de agência, exatamente como quaisquer outros créditos de plano: são deduzidos no momento em que o período experimental começa e entram no saldo do cliente, em vez de serem retirados do seu conjunto à medida que o cliente os gasta (o mesmo se aplica aos créditos de um plano pago em cada pagamento). Um período experimental generoso num plano que promove amplamente é um custo real, por isso defina o número deliberadamente em vez de o deixar no subsídio mensal completo.
   • Um período experimental é para novos registos. Um registo através do seu link de pagamento ou checkout incorporado obtém o período experimental exatamente como configurado no plano. Uma subconta que já existe — criada por si, subscrita anteriormente ou que já teve um período experimental — ao comprar a partir da sua própria página de Faturação é cobrada imediatamente, sem um segundo período experimental. Um cliente que cancela durante o período experimental nunca é cobrado e mantém os créditos de teste que restarem.
   • Os créditos de teste não utilizados permanecem quando o período experimental converte. A primeira cobrança após o período experimental adiciona os créditos mensais completos do plano aos créditos de teste que restarem ao cliente; o saldo não é reiniciado. A única exceção é um plano com um limite de Créditos não utilizados (item 9 abaixo), que reduz o saldo transportado nessa primeira cobrança exatamente como faz em cada renovação.
   • Cartão ou sem cartão — a escolha é sua. Por predefinição, o período experimental ainda pede ao cliente um cartão no registo, e o Stripe cobra-o quando o período experimental termina. Desative Requerer cartão para iniciar o período experimental e o checkout ignora o cartão completamente: o cliente começa apenas com um e-mail. Se não tiverem adicionado um cartão quando o período experimental terminar, o plano simplesmente termina — a sua subconta é marcada como cancelada, não são concedidos mais créditos e mantêm o que resta dos créditos de teste. Um período experimental sem cartão converte menos automaticamente do que um com cartão em ficheiro, por isso compensa lembrar o cliente de adicionar o seu cartão antes do fim.
   • Expiração rígida após o período experimental — recupere os créditos não utilizados. Ao lado do interruptor do cartão encontra-se a Expiração rígida após o período experimental: quando o período experimental termina sem uma atualização, os créditos de teste não utilizados voltam para o seu conjunto e a conta do cliente é bloqueada até que subscrevam. Deixe-o desativado (o padrão) e nada muda em relação ao parágrafo acima — o plano é cancelado, não são concedidos mais créditos e o cliente mantém os créditos de teste que restarem, pelo que a sua IA continua a responder até que estes se esgotem. Ative-o e, no momento em que um período experimental termina sem uma atualização, os créditos de teste não utilizados voltam para o seu conjunto de agência e a conta do cliente é bloqueada: o envio e as respostas da IA param e eles veem “O seu período experimental gratuito terminou. Contacte o seu fornecedor para continuar.” Apenas o que não gastaram volta — um período experimental que realmente usaram custa-lhe o que usaram. O bloqueio é levantado automaticamente assim que compram qualquer plano, e pode levantá-lo ou alterá-lo você mesmo a partir do modal Editar da subconta, usando os mesmos controlos de bloqueio que para um cliente que se atrasa nos pagamentos. (Um bloqueio que já tenha colocado manualmente nunca é tocado por nada disto — a sua razão para o mesmo prevalece sobre a nossa.) A expiração rígida funciona tanto em períodos experimentais com cartão obrigatório como sem cartão; num período experimental sem cartão, o checkout informa o comprador antecipadamente de que o seu plano e quaisquer créditos de teste restantes terminam automaticamente após o período experimental, a menos que adicionem um método de pagamento.
4. O grupo Canais transporta o Limite de canais do plano — um número, não um interruptor, funcionando exatamente como os lugares de equipa e o limite de Agentes de IA. Escolha Não definido (o padrão — o plano não gere o número, pelo que o que a conta já tem permanece como está), Ilimitado ou Personalizado com o número exato de canais de mensagens que os clientes neste plano podem ter ligados de uma só vez — incluindo 0, para planos onde você liga e gere os canais você mesmo. O limite é aplicado quando um cliente subscreve e atualizado em cada renovação, e um limite que definiu manualmente numa subconta específica (no seu modal Editar) nunca é substituído por uma renovação. Controla quantos canais, não quais — isso é o grupo seguinte. A contagem é por ligação, não por tipo de canal: cada número de WhatsApp ocupa um lugar próprio (tanto o WhatsApp Web como a API Business), enquanto o Instagram e o Messenger chegam através da mesma ligação de página Meta e ocupam juntos um único lugar. Um cliente no seu limite vê uma mensagem clara quando tenta ligar outro canal; religar um que já tenha nunca é bloqueado.
5. Dentro da lista de funcionalidades de cada nível, encontrará também um grupo Tipos de Canal que lista os tipos de canal que podem ser dados a um cliente — Widget de Chat, API WhatsApp Business, WhatsApp Web, Instagram, Facebook Messenger, Telegram, LINE, Viber, E-mail, SMS e iMessage. Os tipos de canal estão ativados por predefinição, a menos que desative alguns, para que possa reservar canais específicos para níveis superiores — digamos, um plano inicial apenas com widget e API WhatsApp Business a partir do seu nível Pro. Os clientes num nível que exclui um canal veem-no bloqueado na sua página de Canais com uma nota para atualizar.
6. A lista de funcionalidades também transporta um grupo Equipa, para que cada plano possa definir o seu próprio subsídio de lugares de equipa. Um seletor, Lugares de equipa, decide se os clientes no plano obtêm membros de equipa e quantos: escolha Não incluído (o padrão — os clientes neste plano não podem convidar colegas de equipa), uma das predefinições (3 / 5 / 10 / Ilimitado) ou Personalizado com qualquer número exato — Starter com 3 lugares, Professional com 10, Enterprise ilimitado, ou o que se adequar ao seu preço. O subsídio é aplicado automaticamente quando um cliente subscreve e atualizado em cada renovação, pelo que não há nada a definir manualmente por cliente. Duas coisas a saber: Não definido significa que os membros da equipa estão incluídos, mas o plano não gere o número — qualquer limite de lugares que a conta já tenha é deixado como está — e um limite de lugares que definiu manualmente numa subconta específica (no seu modal Editar ou via API) nunca é substituído por uma renovação, pelo que exceções pontuais sobrevivem aos ciclos de faturação. Existe também um grupo Produtividade (Tarefas, Resumos Diários, Biblioteca de Multimédia de IA) se quiser reservar esses para planos superiores. O mesmo grupo transporta os dois interruptores de assistente do cliente: Assistente do cliente mostra o seu assistente com a sua marca aos clientes no plano, e Assistente do cliente pode fazer alterações também permite que este altere a sua conta por eles após confirmarem. Ambos estão desativados por predefinição.
7. O grupo Contactos & Agentes de IA transporta o Limite de Agentes de IA do plano — um número, não um interruptor, funcionando exatamente como os lugares de equipa. Escolha Não definido (o padrão — o plano não gere o número, pelo que o que a conta já tem 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 gere os agentes você mesmo e os clientes não devem criar os seus próprios. O limite é aplicado quando um cliente subscreve e atualizado em cada renovação, e um limite que definiu manualmente numa subconta específica (no seu modal Editar) nunca é substituído 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 a partir do seu lado de agência nunca é bloqueado por isso.
8. Abaixo do limite de Agentes de IA, o mesmo grupo Contactos & Agentes de IA transporta uma linha de Modelos de IA que decide em que modelos de IA os clientes no plano podem executar os seus agentes: interruptores Pro, Max e Mini, os mesmos três que a linha Modelos de IA que este cliente pode usar no modal Editar de uma subconta. Deixe cada interruptor desativado (o padrão) e o plano não gere modelos: os clientes escolhem qualquer modelo que a sua conta permita. Ative um ou mais e cada cliente no plano fica bloqueado exatamente nesses modelos, aplicados quando subscrevem e atualizados em cada renovação, pelo que não há nada a definir manualmente por cliente. Os modelos que deixa desativados desaparecem dos cartões de Qualidade de IA do cliente, e o bloqueio é aplicado do nosso lado, não apenas ocultado. Um bloqueio que definiu manualmente numa subconta específica (no seu modal Editar ou via API) nunca é substituído pelo plano. A maioria das agências ativa apenas Max e Mini: o Pro custa 1 crédito por resposta contra 0,25 no Max sem responder melhor, e um cliente que lê a lista de preços como um ranking de qualidade irá escolhê-lo por reflexo. Ver Bloquear um cliente num modelo de IA.
9. O grupo Créditos não utilizados decide o que acontece aos créditos restantes de um cliente quando o plano renova. Manter no máximo é quantos meses de subsídio um cliente neste plano pode transportar: em cada renovação, o seu saldo não utilizado é reduzido para, no máximo, esse número de vezes o subsídio mensal, e depois os novos créditos são adicionados — 1 mantém o equivalente a um mês, 0.5 metade de um mês, 0 não transporta nada. Expirar créditos não utilizados após é um número de dias: os créditos que ficaram sem ser utilizados durante esse período são eliminados na primeira renovação após atingirem essa idade, e como o gasto retira sempre primeiro dos créditos mais antigos, um cliente que usa o seu subsídio todos os meses nunca perde nada. Deixe ambos vazios — o padrão, e o que todos os planos que já vende mantém — e nada é limitado ou expira. Vale a pena defini-los num plano barato ou com preço de período experimental, onde um cliente que mal usa o produto acumula um saldo pelo qual o seu conjunto é responsável. Um valor definido numa subconta específica supera o do plano, pelo que ainda pode fazer uma exceção para um único cliente. Ver Limitar o que é transportado.
10. Defina o preço por crédito — é isto que os clientes pagam por recargas ad-hoc.
11. Clique em Guardar & Continuar.

Os contactos são uma funcionalidade de sim/não, não um número. O mesmo grupo Contactos e Agentes de IA inclui Contactos ilimitados como um simples item de ligar/desligar, e não existe deliberadamente nenhum campo para introduzir um número de contactos. Desligá-lo não lhe dá um limite de contactos para definir — por isso, a menos que tenha uma razão específica, mantenha-o ligado. Os três limites que pode expressar como um número real são Limite de canais, Limite de agentes de IA e Lugares na equipa, cada um com as opções Não definido / Ilimitado / Personalizado.

Permita que os clientes utilizem o que constrói, sem terem de construir o seu próprio. O grupo Contactos e Agentes de IA também inclui três interruptores: Criar e Editar Automatizações, Enviar Transmissões e Criar Listas Inteligentes. Todos os três estão ativados por predefinição e foram atribuídos a todos os planos e clientes que já possui, pelo que nada muda até que desative um deles. Com um interruptor desativado, os clientes nesse plano ainda podem ver e utilizar tudo o que configurou para eles (a partir de um snapshot, um pacote guardado ou da API da agência), e o serviço continua a funcionar. Simplesmente não podem criar novos, editá-los ou eliminá-los. No caso das transmissões, isto também significa que não podem iniciar, pausar, retomar ou duplicar uma. Para as listas inteligentes, as listas simples continuam permitidas, assim como mudar o nome de uma lista inteligente; alterar as suas regras não é permitido. O cliente vê uma mensagem a indicar que o seu plano não inclui essa funcionalidade. Você nunca é restringido: ao trabalhar dentro da conta do cliente (assistir ou iniciar sessão como o cliente) ou através da sua chave de API de agência, pode continuar a criar e alterar os três. Isto é diferente do interruptor Automatizações, que oculta toda a secção de Automatizações ao cliente. Para definir isto para um cliente em vez de todo o plano, utilize os mesmos interruptores no modal Editar desse cliente, ou o endpoint de funcionalidades da API da agência.

Não existe um limite por plano para transmissões. Os agentes são o elemento a limitar se quiser manter um nível inicial pequeno — utilize o Limite de Agentes de IA acima.

Os níveis são subscrições, não compras únicas. Cada nível de preço é uma subscrição recorrente — cobrada todos os meses, uma vez por ano ou a cada N semanas, dependendo do seu seletor de Faturação — e funciona até que o cliente cancele. Os planos mensais e anuais concedem a dotação de créditos todos os meses; um plano de estilo semanal concede-a a cada período de faturação. Para recargas pontuais, utilize a opção de montante personalizado por crédito. Como os níveis são subscrições ativas, um nível que ainda tenha subscritores ativos não pode ser eliminado — cancele ou migre esses clientes primeiro.

⚠️ A lista de funcionalidades do escalão prevalece em cada renovação. Quando um cliente subscreve um escalão, e novamente cada vez que este é renovado, as suas funcionalidades são repostas exatamente para o que esse escalão inclui. Portanto, se ativar uma funcionalidade extra para um cliente a partir de Edit Sub Account, adicione-a também ao seu escalão — caso contrário, ela será removida na próxima renovação. (As compras de créditos únicas personalizadas não alteram as funcionalidades.)

Vender um plano num domínio white label específico #

Se gerir mais do que um domínio white label, cada nível terá um seletor Vendido em (que só aparece quando tiver dois ou mais domínios). Deixe-o em Domínio principal e nada muda. Escolha um dos seus outros domínios — por exemplo, o seu domínio Lead Finder — e:

• O checkout desse nível assume a marca do domínio e, após o pagamento, o comprador é redirecionado para esse domínio, e não para o seu principal.
• A subconta do comprador é atribuída automaticamente a esse domínio, para que os seus e-mails e a marca de início de sessão sigam esse domínio desde o primeiro dia (a mesma atribuição que pode definir manualmente no seletor White label da subconta).
• Os clientes com sessão iniciada nesse domínio veem um cartão de Planos na sua página de Créditos que lista apenas os planos vendidos nesse local, com um botão de atualização — assim, um cliente no seu domínio Lead Finder pode subscrever sem nunca ver a sua marca principal.

Os planos vendidos no seu domínio principal nunca aparecem nos seus outros domínios, e vice-versa.

Se mais tarde tornar outro domínio o seu principal, todos os planos que estavam no Domínio principal são fixados ao domínio onde estavam efetivamente a ser vendidos, pelo que nada muda para os clientes que compram nesse local.

Chegará a um ecrã Está tudo pronto! com uma lista de verificação (conta Stripe ligada, níveis de preços configurados, webhook registado) e uma dica para testar com o cartão de teste do Stripe 4242 4242 4242 4242. A partir daí, Ver Painel leva-o para o painel do Modo SaaS.

Clientes a mudar de plano #

Se permitir que os clientes gere a sua própria subscrição a partir do portal de cliente do Stripe, eles podem mudar de plano por si próprios. Eis o que isso faz aos seus créditos.

• O upgrade a meio do ciclo recarrega-os 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 renovação seguinte. O Stripe cobra a diferença de preço pelo resto do período; os créditos saem do seu conjunto, como sempre.
• O downgrade nunca retira créditos. O que já foi atribuído ao cliente permanece com ele, e nada regressa ao seu conjunto. A tolerância mais pequena aplica-se a partir da renovação seguinte.
• Mudar de plano repetidamente não permite ganhar a tolerância duas vezes. A plataforma memoriza a tolerância mais elevada com a qual o período atual do cliente já foi financiado, pelo que Starter → Professional → Starter → Professional dentro de um mês entrega a diferença de 900 créditos apenas uma vez, e não duas.
• As funcionalidades, lugares e limites do plano seguem o novo plano imediatamente, em ambas as direções.

Três aspetos a configurar corretamente nas definições do portal de cliente Stripe (Painel da Stripe → Definições → Faturação → Portal de cliente):

• Guarde as definições do portal com a opção “Cancelar subscrições” ativada. A Stripe só disponibiliza um portal de cliente depois de as definições terem sido guardadas no seu painel. Até lá, o botão Abrir portal de faturação na página de Faturação dos seus clientes falhará com a mensagem “Não foi possível abrir o portal de faturação”, e um portal guardado sem a opção de cancelamento deixa os clientes sem forma de terminar o seu plano — veja Como um cliente cancela o seu plano.
• Mantenha a opção “os clientes podem alterar a quantidade” desativada. A quantidade multiplica o valor cobrado ao cliente, mas nunca os créditos que este recebe — um cliente que defina a quantidade para 3 paga três vezes o preço e continua a receber a dotação de um único plano.
• Agendar reduções de plano para o final do período de faturação é a opção predefinida mais sensata em termos financeiros. Uma redução de plano que entra em vigor imediatamente coloca o cliente num plano mais pequeno durante um período pelo qual já pagou o preço mais elevado, e nenhum dos créditos já concedidos reverte a seu favor.

Passo 4 — Partilhe os seus links de pagamento #

O separador Pagamentos do painel de controlo lista os seus links de pagamento. Abertos a partir do endereço principal da aplicação, os links e o código de incorporação utilizam o seu próprio domínio white-label assim que este estiver ligado e acessível: um plano vendido num domínio específico obtém esse domínio, todos os outros planos obtêm o seu domínio principal. Abertos a partir de um dos seus próprios domínios, os links utilizam esse domínio. Se nenhum dos seus domínios estiver acessível, os links utilizam o endereço com o qual iniciou sessão. A página de checkout em si é sempre personalizada com o seu logótipo e marca.

Existe também Copiar Código de Incorporação no mesmo separador se quiser colocar os cartões de preços diretamente no seu próprio site.

Está a publicar anúncios no Meta? O código de integração também reencaminha o ID de clique de anúncio do Meta (fbclid) da sua página para os botões de checkout, e uma ligação de pagamento simples também o aceita (...&fbclid=...). Juntamente com um ID do Meta Pixel no seu domínio de marca branca, isso permite que o Meta atribua a inscrição ao anúncio. Consulte Acompanhar conversões de anúncios Meta.

Quer saber de que campanha veio um cliente? Adicione etiquetas UTM a uma hiperligação de pagamento, por exemplo ...&utm_source=facebook&utm_medium=paid&utm_campaign=spring_sale (também utm_content e utm_term). Quando alguém compra através dessa hiperligação, a nova conta de cliente mantém as etiquetas e a página de Subcontas mostra-as sob o cliente como Source: facebook / paid / spring_sale. As etiquetas também são incluídas nos metadados do checkout na sua própria conta Stripe. O código de integração faz isto por si: quando um visitante chega à sua página com etiquetas UTM no endereço, os botões de preços transportam-nas para o checkout, mesmo que o visitante navegue pelo seu site primeiro. Funciona tanto em hiperligações Stripe como PayPal. Apenas estas cinco etiquetas são mantidas, cada uma até 200 caracteres, e apenas numa conta de cliente nova; um cliente existente que volte a comprar mantém a origem de onde veio inicialmente.

Se tiver o PayPal ligado também, cada plano transporta um link PayPal ao lado do seu link Stripe, e o código de incorporação coloca um botão por método de pagamento ligado em cada cartão de preço.

Cada link de pagamento aponta para um plano de acordo com a sua posição na sua lista de Planos (o primeiro plano é tier=0, o segundo tier=1, e assim sucessivamente). Se eliminar um plano, os planos seguintes sobem uma posição — por isso, volte a copiar os seus links e o código de incorporação a partir do separador Pagamentos após eliminar um plano; caso contrário, um botão no seu site pode acabar por apontar para o plano errado ou para um que já não existe. Os planos são apresentados aos seus clientes pela ordem em que aparecem na sua lista de Planos.

O que os compradores podem introduzir no checkout. Para além do cartão, a página de checkout da Stripe solicita o e-mail, o número de telefone e a morada de faturação do comprador, e oferece um campo opcional de Nome da Empresa, bem como uma caixa de verificação “Estou a comprar como empresa” onde podem adicionar o seu NIF / número de identificação fiscal. O nome da empresa e o número de identificação fiscal são guardados no cliente na sua conta Stripe, para que os possa recolher para a sua própria faturação.

O número de telefone é solicitado por predefinição, mas pode desativá-lo. No separador Pagamentos, em Campos de Checkout, desative a opção Pedir um número de telefone no checkout e os compradores apenas introduzirão o seu e-mail, cartão e morada de faturação. Isto aplica-se imediatamente aos seus links de pagamento e ao seu checkout incorporado — não é necessário copiar nada novamente — e as contas que se registam com esta opção desativada simplesmente não têm nenhum número de telefone registado, o que não altera mais nada no seu funcionamento.

Finalização da compra no idioma do seu comprador. O campo Nome da Empresa e a linha acima do botão de pagamento (“Complete a sua compra de” e o nome da sua empresa) são apresentados no idioma do comprador, juntamente com o resto da página da Stripe. O idioma provém da ligação (adicione lang=fr, por exemplo), depois do idioma da própria conta do cliente, depois do navegador do comprador, depois do seu idioma predefinido e, por fim, inglês quando nenhum destes é conhecido.

A sua própria linha acima do botão de pagamento. No mesmo separador Pagamentos, em Campos de Finalização de Compra, preencha a Nota de finalização de compra e clique em Guardar nota para substituir “Complete a sua compra de…” pela sua própria frase, por exemplo, uma garantia de reembolso. É apresentada exatamente como a escreve e não é traduzida, por isso escreva-a no idioma que os seus compradores utilizam. Deixe-a vazia para voltar à linha predefinida. Se o plano tiver uma avaliação gratuita, a frase de avaliação é adicionada após a sua nota.

Cobrar IVA ou imposto sobre vendas. No mesmo separador Pagamentos, em Campos de Checkout, Calcular imposto automaticamente entrega a questão do imposto ao Stripe: calcula o IVA ou imposto sobre vendas correto para cada comprador a partir do país em que se encontram e do NIF que introduzem, adiciona-o ao checkout e aplica a autoliquidação para compradores empresariais da UE que forneçam um número de IVA válido, pelo que esses clientes pagam o preço do plano sem IVA adicional. Está desativado, a menos que o ative.

Duas coisas a acertar primeiro. O interruptor precisa do Stripe Tax ativo na sua própria conta Stripe, e recusa-se a ativar até que esse seja o caso, por isso configure o Stripe Tax no Stripe antes de voltar. E nas suas definições do Stripe Tax, defina Incluir imposto nos preços para Não se quiser que o imposto seja adicionado ao preço do seu plano. Essa definição é do Stripe, não nossa, e para preços em euros o Stripe trata o preço do seu plano como já contendo o imposto, o que reduz silenciosamente o que retém.

Ativá-lo altera apenas os novos checkouts. Os clientes que já estão subscritos continuam a pagar exatamente o que pagam agora.

Fazer com que os compradores aceitem os seus termos e condições. Alguns países (França, por exemplo) exigem que os compradores aceitem os seus termos antes de pagarem. No mesmo separador Pagamentos, em Aceitação de termos, ative a opção Exigir uma caixa de verificação de termos no checkout. A partir desse momento, todas as páginas de checkout da Stripe (links de pagamento, checkout incorporado e as compras de planos e carregamentos que um cliente inicia a partir da sua própria página de Faturação) apresentam uma caixa de verificação, e o botão de pagamento não funciona até que o comprador a selecione.

A caixa de verificação remete para o URL dos Termos de Serviço guardado na sua própria conta Stripe, por isso adicione-o primeiro: na Stripe, abra Definições, depois Empresa, de seguida Detalhes públicos e preencha Termos de serviço. O interruptor verifica isto e recusa-se a ser ativado até que o URL esteja lá.

Por predefinição, a caixa de verificação diz “Concordo com os Termos de Serviço” no idioma de checkout do comprador. Para utilizar a sua própria redação, escreva-a em Texto para todos os idiomas e clique em Guardar texto. Pode adicionar uma ligação no texto desta forma: [Terms and Conditions](https://yoursite.com/terms). Para mostrar um texto diferente por idioma, clique em Adicionar uma versão de idioma, escolha o idioma e escreva essa versão, por exemplo, francês: J'accepte les [Conditions Générales de Vente](https://yoursite.com/cgv) de Votre Agence. Um comprador cujo checkout esteja num idioma que adicionou verá essa versão; todos os outros verão o texto para todos os idiomas.

Os checkouts do PayPal não apresentam esta caixa de verificação.

Promoções e códigos de desconto. Todas as páginas de checkout (links de pagamento, checkout incorporado e as compras de planos e carregamentos que um cliente inicia a partir da sua própria página de Faturação) têm um campo Adicionar código de promoção. Os códigos são da sua responsabilidade: crie-os no seu dashboard Stripe em Catálogo de produtos → Cupões (defina o montante ou a percentagem de desconto e, em seguida, adicione um código de promoção que o cliente possa introduzir, com uma data de validade ou limite de utilização opcionais) e partilhe o código como desejar. O desconto altera o valor que o cliente lhe paga; os créditos que recebem permanecem exatamente o que o plano indica, pelo que um plano com desconto custa-lhe o mesmo do seu saldo que um plano a preço total. Um cupão num plano de subscrição segue a duração do cupão do Stripe (uma vez, um número de meses ou para sempre). Não há nada a configurar do lado da plataforma.

⚠️ Não elimine os produtos que a plataforma cria dentro da sua conta Stripe. Quando configura níveis de preços, a plataforma cria automaticamente produtos e preços correspondentes no Stripe. Eliminá-los no Stripe irá quebrar os seus links de pagamento. Gere os seus preços a partir do painel do Modo SaaS, não de dentro do Stripe.

Opção 2: Fornecedor de Pagamento Personalizado #

Escolha este caminho se o Stripe não for uma opção. A plataforma fornece-lhe um único campo de URL de webhook — o resto da implementação é da sua responsabilidade. Existem duas coisas que precisa de configurar por si próprio:

1. Registo inicial — quando um novo cliente paga através do seu link de pagamento, chama a API da plataforma para criar a subconta.
2. Carregamentos automáticos — quando os créditos de uma subconta estão baixos, a plataforma chama o seu webhook para que possa cobrar o cartão e conceder mais créditos.

O que tem de construir #

• Produtos / links de pagamento no seu próprio fornecedor de pagamento (Stripe fora do Stripe Connect, Mollie, Paddle, GoCardless, faturação manual, etc.).
• Um fluxo de trabalho que é executado após um pagamento bem-sucedido, que chama a API da plataforma para:
  • Criar a subconta (POST /v1/sub-accounts).
  • Opcionalmente, enviar por e-mail a palavra-passe temporária ao cliente.
• Um fluxo de trabalho que gere webhooks de recarregamento automático da plataforma: cobrar o cartão guardado, e depois chamar a API da plataforma para adicionar créditos.

Não precisa de programar isto de raiz — o Zapier, Make, n8n ou qualquer ferramenta low-code pode chamar a API REST da plataforma e a API do seu fornecedor de pagamento em sequência.

Passo 1 — Encontrar a referência da API #

A documentação completa da API encontra-se em help.dmchamp.com → API Reference → Sub Accounts.

Abra o help.dmchamp.com diretamente, não o URL da sua documentação white-label. A referência da API é filtrada da documentação white-label para que os seus clientes não a vejam.

A secção Sub Accounts mostra o endpoint de criação de subcontas, a estrutura da resposta (incluindo a palavra-passe temporária que pode utilizar no seu e-mail de boas-vindas) e as flags de funcionalidades disponíveis que pode passar ao criar uma conta.

Passo 2 — Configurar o webhook de recarregamento automático #

1. No assistente do Modo SaaS, escolha Usar um fornecedor de pagamentos personalizado.
2. Introduza o seu URL de webhook — o endpoint no seu servidor (ou Zapier / Make / n8n) que irá processar eventos de saldo baixo.
3. Clique em Enviar Evento de Teste para verificar se o endpoint é alcançável. O painel de resultados mostra o estado HTTP que o seu servidor devolveu, a latência de ida e volta, o corpo da resposta e o payload JSON exato enviado — para que possa construir e depurar o seu processador de ponta a ponta sem esperar que um cliente real fique com saldo baixo. Os eventos de teste têm test: true no payload para que o seu servidor possa terminar antes de cobrar a alguém.
4. Clique em Guardar URL de Webhook.

Uma vez configurado, sempre que o saldo de créditos de uma subconta descer abaixo do seu limite de recarregamento automático:

• A plataforma envia uma notificação para o seu URL de webhook com os detalhes da subconta e quantos créditos são necessários.
• O seu servidor processa o pagamento da forma 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, o seu servidor chama a API para atribuir os créditos à subconta.

Para obter detalhes técnicos sobre o payload do webhook e a chamada da API, consulte Sub-Account Auto-Recharge (Custom Payment Provider).

Opção 3: Ligar PayPal #

Escolha este caminho se o Stripe não estiver disponível no seu país, ou se os seus clientes preferirem pagar com PayPal. É integrado exatamente como o Stripe — a plataforma executa o checkout, cria a subconta e entrega os créditos — e o dinheiro vai diretamente para a sua própria conta PayPal Business. Precisa de uma conta PayPal Business com uma aplicação REST criada nela; não há nada para construir.

Ligar o PayPal não substitui o Stripe. Se tiver ambos, os seus clientes obtêm ambos os botões, na sua página de Faturação e nos seus cartões de preço.

Passo 1 — Ligue a sua aplicação PayPal #

1. No assistente do Modo SaaS, escolha Ligar PayPal em vez disso.
2. Num novo separador, abra o seu painel de programador PayPal e crie uma aplicação REST na sua conta Business.
3. Copie o ID do Cliente e o Segredo da aplicação e cole-os no assistente.
4. Escolha o ambiente: Live para pagamentos reais, ou Sandbox se quiser testar todo o fluxo primeiro com os compradores de teste do PayPal. O ID do Cliente e o Segredo devem vir do mesmo ambiente que escolher, e os pagamentos Sandbox não são dinheiro real — mude a ligação para Live antes de partilhar os seus links.
5. Clique em Guardar & Continuar. A plataforma verifica as credenciais com o PayPal imediatamente; se o PayPal as rejeitar, nada é guardado e pode colá-las novamente.

Passo 2 — Registe o webhook do PayPal #

O webhook é a forma como a sua conta PayPal diz à plataforma que um pagamento foi efetuado, uma subscrição renovada, ou um pagamento reembolsado. Sem ele, os seus clientes pagam mas os seus créditos não são entregues.

1. O assistente mostra-lhe um URL de webhook. Copie-o.
2. Na mesma aplicação REST do PayPal, adicione um webhook com esse URL e subscreva-o a estes 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 atribui ao novo webhook um ID. Copie-o, cole-o no assistente e clique em Guardar.

Os seus planos são os mesmos em qualquer dos casos — configure-os uma vez como em Passo 3 — Configurar escalões de preços e serão vendidos através de quaisquer métodos de pagamento que tenha ligado.

O que os seus clientes veem #

• Carregamentos — um botão Pagar com PayPal na sua página de Faturação, junto à opção de cartão, ao mesmo preço por crédito que definiu.
• Planos — cada escalão obtém uma ligação de checkout do PayPal ao lado da do Stripe no separador Pagamentos, e Copiar Código de Incorporação emite um botão por método de pagamento ligado, para que um cartão de preços no seu site possa oferecer cartão e PayPal lado a lado.
• Carregamentos automáticos — veja abaixo.

Carregamentos automáticos no PayPal #

Uma definição, Cobrança de carregamentos automáticos, decide qual dos seus métodos ligados trata dos carregamentos automáticos: Stripe, PayPal ou o seu próprio webhook. Apenas um deles pode fazê-lo de cada vez, mesmo quando tem o Stripe e o PayPal ambos ligados — tudo o resto (carregamentos manuais, checkout de planos) continua a oferecer ambos.

Defina-o como PayPal e cada cliente liga a sua própria conta PayPal uma vez, a partir do cartão Recarga automática na sua página de Faturação. A partir daí, sempre que o seu saldo cair abaixo do seu limite, a plataforma cobra a essa conta PayPal guardada o carregamento ao seu preço por crédito e entrega os créditos automaticamente, exatamente como o fluxo de cartão Stripe faz. Um cliente que ainda não tenha ligado o PayPal simplesmente não é cobrado — o seu saldo diminui até que liguem uma conta ou comprem créditos manualmente — e se o PayPal recusar uma cobrança, não são entregues créditos e a plataforma tenta novamente da próxima vez que o saldo baixar abaixo do limite. Os clientes podem remover a sua conta PayPal do mesmo cartão sempre que quiserem.

Se desligar mais tarde o PayPal no Modo SaaS e este for o que tratava dos carregamentos automáticos, estes revertem para o Stripe se o tiver ligado, ou para o seu próprio webhook se tiver configurado um.

É bom saber sobre o PayPal #

• Um plano pede sempre ao cliente uma conta PayPal, mesmo num período experimental gratuito. Os períodos experimentais continuam a funcionar — nada é cobrado até que o período termine — mas o PayPal exige que o comprador aprove com uma conta antecipadamente, por isso o interruptor Exigir cartão para iniciar período experimental do plano não faz diferença num checkout do PayPal. Se depende de períodos experimentais sem conta, venda esse plano através do Stripe.
• Os preços são cobrados exatamente como os definiu. O PayPal não adiciona nenhuma linha de imposto separada no checkout, por isso inclua qualquer imposto que deva no preço dos seus planos e no seu preço por crédito.
• Mudar de plano significa cancelar e subscrever novamente. Um cliente numa subscrição PayPal não pode mudar para outro escalão no local: cancelam a atual e compram o novo plano através da sua própria ligação. (Os clientes que pagam por cartão ainda podem mudar no portal de cliente Stripe — veja Clientes a mudar de planos.)
• Um reembolso não retira os créditos. Se reembolsar um pagamento PayPal a partir da sua conta PayPal, o reembolso é registado aqui, mas os créditos já entregues permanecem no saldo do cliente — o mesmo que com o Stripe.

Configuração de Preços #

• Níveis de preços — defina pacotes de créditos que os seus clientes podem comprar (até 20, por exemplo, “Pacote Inicial: 100 créditos por 15 $”), configurados no separador Planos do Modo SaaS. Cada plano é faturado mensalmente, anualmente ou a cada N semanas (um preço anual ainda concede os seus créditos mês a mês; um plano de tipo semanal concede-os a cada período de faturação) e pode incluir um período experimental gratuito de 1 a 90 dias com o seu próprio montante de créditos experimentais, com ou sem pedido de cartão antecipado, e com ou sem expiração rígida (créditos experimentais não utilizados voltam para o seu pool, conta bloqueada, se o período experimental terminar sem uma atualização). Consulte Passo 3 — Configurar níveis de preços. Cada plano obtém o seu próprio link de pagamento no separador Pagamentos — um da Stripe, um do PayPal, ou ambos, dependendo do que tiver ligado. Cada plano também pode limitar o que um cliente transporta entre renovações: o grupo Créditos não utilizados define Manter no máximo (meses de subsídio mantidos) e Expirar créditos não utilizados após (dias), aplicado a cada cliente no plano — consulte Limitar o que transita. Também pode gerir tudo isto a partir de código — consulte Gerir os seus níveis de preços através da API.
• Preço por crédito — defina um preço personalizado por crédito para carregamentos flexíveis. As compras de créditos personalizadas (ad-hoc) devem ser entre 10 e 10.000 créditos por transação. As subscrições de níveis cobrem montantes fixos; o montante personalizado trata de qualquer valor intermédio. Uma nota opcional (até 200 caracteres) é mostrada aos clientes diretamente abaixo do preço na sua página de Faturação — útil quando define preços numa moeda, mas cobra noutra, por exemplo “0,25 USD por crédito à nossa taxa de referência”. O preço e a nota também podem ser lidos e alterados a partir de código — consulte Definir o seu preço por crédito através da API.
• Moedas — os planos e o preço por crédito podem ser definidos em USD, EUR, GBP, CAD, AUD, CHF, SEK, NOK, DKK, SGD, HKD, MXN, BRL, COP, GTQ, VND, ILS, OMR, THB, MYR, NZD, PLN, PHP, ZAR, AED, KWD ou QAR. Os planos também aceitam JPY. O dinar do Kuwait (KWD) e o rial de Omã (OMR) utilizam 3 casas decimais, e os seus preços são arredondados para o 0,010 mais próximo, porque os pagamentos com cartão nessas moedas apenas aceitam montantes em passos de 10 fils ou baisa. Esta lista é separada da moeda de visualização em Definições → Perfil → Preferências, que oferece mais opções.
• Preço mínimo por crédito — a plataforma impõe um preço mínimo por crédito para manter a sustentabilidade da plataforma. Pode definir o seu preço igual ou acima deste mínimo.

Painel de Créditos da Subconta #

Os detalhes de utilização de créditos de cada subconta (a partir do menu Mais da sua linha na página de Subcontas) mostram:

• Créditos comprados e gasto total
• Créditos consumidos e saldo restante
• Tendências de utilização ao longo do tempo, discriminadas por motivo e pela lista de Principais agentes

O que o painel mostra. Quando uma subconta utiliza a chave de API da sua agência, o painel mostra a sua utilização de créditos, mas oculta o custo subjacente em dólares. Os totais de utilização contam apenas os créditos efetivamente consumidos — bónus promocionais, renovações mensais e ajustes de plano são excluídos para que o valor de “créditos utilizados” reflita a atividade real.

Copiar Agentes para Subcontas #

Pode copiar um Agente de IA comprovado da sua conta de agência para uma ou mais subcontas de uma só vez. As suas instruções, FAQs e base de conhecimento, funções personalizadas e ferramentas ligadas, multimédia, horas de atividade, regras de etiquetas e definições de seguimento são todas transferidas, para que não tenha de o reconstruir manualmente. A cópia chega desativada e algumas definições específicas da conta (canais do cliente e modelos de WhatsApp) são configuradas em cada subconta.

Comece a partir da página Subcontas: abra o menu Mais de uma linha e escolha Copiar agente para aqui, ou utilize o ícone Copiar este agente para uma subconta na linha do agente na página Agentes de IA. Para entregar a um cliente uma configuração completa de uma só vez em vez de um único Agente, utilize um Instantâneo (Snapshot). Consulte Instantâneos.

Para o passo a passo completo, o que é copiado e o que precisa de ser refeito, consulte Copiar um Agente de IA para uma Subconta.

Modo de Início de Sessão (atuar como subconta) #

Pode aceder ao painel de controlo de uma subconta diretamente a partir da sua conta de agência, como se fosse o cliente. Esta é a mesma funcionalidade que algumas plataformas chamam de “assistir” ou “impersonar” — aqui, a ação é designada por Iniciar sessão como utilizador.

1. Na barra lateral, clique em Subcontas.
2. Encontre a subconta na lista. Nessa linha, clique no menu Mais (ícone de três pontos no extremo direito).
3. Clique em Iniciar sessão como utilizador.
4. O painel é recarregado como essa subconta — acesso total aos seus agentes de IA, contactos, conversas e definições.
5. Quando terminar, clique na pílula âmbar A assistir: no topo da barra lateral e escolha Voltar para a minha agência.

Isto é especialmente útil para prestar apoio prático aos clientes sem lhes pedir que partilhem as suas credenciais de início de sessão.

Gerir funcionalidades das subcontas #

Dependendo do seu nível de agência, pode controlar a que funcionalidades cada subconta tem acesso. A atribuição de funcionalidades é gerida por subconta e através dos seus níveis de preços.

A partir da janela modal Editar de uma subconta, pode ajustá-la individualmente: alternar as funcionalidades a que tem acesso, ocultar páginas específicas do seu menu lateral e definições, escolher quem recebe os seus e-mails de alerta (consulte Encaminhamento de Notificações), definir um limite mensal para os gastos com a sua própria chave de API e ativar ou desativar o seu nível Max AI.

O editor de funcionalidades inclui um grupo de Tipos de Canal que decide quais os canais de mensagens que o cliente pode ligar — Chat Widget, WhatsApp Business API, WhatsApp Web, Instagram, Facebook Messenger, Telegram, LINE, Viber, Email, SMS e iMessage. Os tipos de canal estão ativados por predefinição, a menos que desative alguns; um canal que tenha desativado aparece como bloqueado na página de Canais do cliente, com uma nota de que não está incluído no seu plano atual.

Dois interruptores no grupo Produtividade controlam o seu assistente de cliente para este cliente:

• Assistente de cliente mostra o seu assistente com a sua marca dentro da conta deste cliente, assim que o tiver ativado em White Labeling.
• Assistente de cliente pode fazer alterações permite que o assistente altere a conta do cliente por eles (agentes, conhecimento, contactos, definições) após confirmarem. Sem isto, o assistente responde e mostra onde clicar.

Se o cliente estiver num nível pago, coloque a funcionalidade nesse nível também. Os interruptores que define aqui são substituídos pela própria lista de funcionalidades do nível sempre que a subscrição desse cliente é renovada. Utilize o modal Editar para ajustes pontuais e o nível de preços para tudo o que o cliente deve manter.

Nível Max de IA e a sua própria chave de API. Se a sua agência utiliza a sua própria chave de API, ativar o Max para um cliente altera a utilização de IA desse cliente de “gratuita através da sua chave” para 0,25 créditos por ação faturados ao saldo da sua agência. O mesmo se aplica ao nível Mini, que acompanha o Max: 0,15 créditos por ação, nunca através da sua chave. Se a sua agência possui uma adesão ao Champions Circle, o seu saldo paga a Tarifa Insider em vez disso: 0,20 por ação Max e 0,12 por ação Mini.

Precisa de ajuda? #

Se tiver dúvidas sobre contas de agência ou gestão de subcontas, contacte-nos através do nosso apoio por e-mail.