> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gennia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Pacotes de Créditos

> Configure pacotes reutilizáveis de créditos vinculados a planos

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

| Campo                           | Descrição                                                                        |
| ------------------------------- | -------------------------------------------------------------------------------- |
| **Nome**                        | Identificador do pacote (ex: "Mensal 1000 créditos")                             |
| **Quantidade de créditos**      | Quantos créditos o cliente recebe a cada renovação                               |
| **Intervalo de renovação**      | A 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 extras**             | Quantidade 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 = R$ 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**.

<Note>
  **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.
</Note>

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

<Tip>
  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.
</Tip>