Skip to main content
Pacotes de Créditos definem quantos créditos o cliente recebe e quando esses créditos são renovados. Cada plano é vinculado a um pacote de créditos — assim, você cria o pacote uma vez e reutiliza em múltiplos planos.

Como funciona

  1. Você cria um pacote de créditos definindo quantidade e intervalo de renovação
  2. Vincula o pacote a um ou mais planos
  3. Quando um cliente assina um plano, recebe automaticamente os créditos do pacote
  4. Os créditos renovam periodicamente conforme o intervalo configurado

Campos

CampoDescrição
NomeIdentificador do pacote (ex: “Mensal 1000 créditos”)
Quantidade de créditosQuantos créditos o cliente recebe a cada renovação
Intervalo de renovaçãoA cada quantos meses os créditos renovam (ou não renováveis)
Valor do crédito (centavos)Custo unitário de cada crédito — usado para calcular o preço dos créditos extras
Créditos extrasQuantidade bônus inclusa no pacote

Pacotes renováveis vs não renováveis

  • Renováveis — Os créditos são resetados e renovados a cada X meses. O cliente nunca acumula.
  • Não renováveis — Os créditos são dados uma vez e o cliente consome até acabar.

Como os créditos são consumidos

Cada vez que o cliente usa um agente, ele consome dois tipos de recursos do seu workspace:
  • Operações — Cada ação executada pelo agente (chamadas de tools, buscas em conhecimento, processamentos, etc.)
  • Tokens — Volume de texto processado pelos modelos de IA (input + output)
O custo total dessa interação (operações + tokens) é convertido em créditos usando o valor do crédito que você definiu no pacote. Esse valor é descontado automaticamente do saldo do cliente.

Exemplo

Você configura o pacote com **valor do crédito = R0,10.UmaconversadoclientecomoagenteconsumiuoequivalenteaR 0,10**. Uma conversa do cliente com o agente consumiu o equivalente a R 1,50 em operações e tokens → o cliente é descontado em 15 créditos.
O cliente não vê o valor monetário de um crédito. Para ele, créditos são apenas uma unidade de uso — essa abstração te dá liberdade para ajustar margens e estruturar preços sem expor o custo real.

Por que essa estrutura

  • Margem flexível — Você define o valor do crédito considerando sua margem sobre o custo real de operações e tokens
  • Simplicidade para o cliente — Ele vê “X créditos restantes”, sem precisar entender tokens ou operações
  • Controle de uso — Clientes com planos diferentes podem ter a mesma moeda (crédito) mas com valores diferentes por baixo

Usando em múltiplos planos

O mesmo pacote pode ser vinculado a vários planos diferentes. O contador na interface mostra quantos planos estão usando cada pacote.
Estruture os pacotes pensando em tiers: um pacote básico (ex: 500 créditos/mês), um intermediário (2.000/mês), um premium (10.000/mês). Isso facilita montar escalas de preço.