Créditos de IA
A tela Créditos de IA (acessível pelo menu lateral) mostra o saldo disponível de créditos para uso do agente de IA (Dani), o detalhamento por lote e o extrato de consumo da sua empresa.
Disponibilidade
Esta tela só aparece em planos que incluem o recurso de IA (useOpenAi). Se você não vê o menu, seu plano atual não inclui o agente de IA.
O que são créditos de IA
Créditos são a "moeda" consumida pelo agente de IA a cada interação com os clientes. Cada mensagem processada pelo agente desconta créditos do saldo disponível.
Se o saldo chegar a zero, o agente de IA é pausado automaticamente até que novos créditos sejam adicionados.
Card de Saldo
O card principal (fundo azul gradiente) exibe:
- Saldo disponível — total de créditos somados de todos os lotes ativos.
- Quantidade de lotes ativos — quantos lotes estão com créditos restantes.
- Botão "Recarregar créditos" — redireciona para o checkout externo (CF Growth) para comprar mais créditos.
Banner de saldo baixo / zerado
| Situação | Banner exibido |
|---|---|
Saldo zerado (empty: true) | Banner vermelho: "Sem créditos — o agente de IA está pausado. Recarregue para reativar." |
Saldo baixo (lowBalance: true) | Banner laranja: "Seu saldo de créditos está acabando. Considere recarregar." |
Breakdown por origem
Abaixo do card de saldo, três cartões menores mostram os créditos separados por origem:
| Cartão | O que representa |
|---|---|
| Plano (mensal) | Créditos incluídos no plano atual. Renovam a cada ciclo. Exibem data de renovação. |
| Recarga (cumulativo) | Créditos comprados avulsos. Acumulam e não expiram automaticamente. |
| Trial | Créditos do período de teste (só aparece se houver saldo de trial restante) |
Lotes de créditos
Cada lote tem uma origem, uma quantidade total e uma quantidade restante. A tela exibe um card por lote com:
- Ícone e rótulo de origem (Trial ou Compra)
- Número grande: créditos restantes
- Linha "de X créditos": total original do lote
- Barra de progresso: percentual consumido
- Data de expiração (quando aplicável)
A ordem de consumo dos lotes é: Trial → Plano → Recarga (os que expiram antes são consumidos primeiro).
Resumo do período
Quando há dados no extrato, a seção "Resumo do período" exibe:
| Card | O que mostra |
|---|---|
| Total consumido | Soma de créditos debitados no período |
| Conversas | Número de conversas que geraram débito (quando disponível) |
| Registros | Total de entradas no extrato |
Extrato de consumo
Tabela paginada (20 registros por página) com cada movimento de créditos.
Colunas
| Coluna | O que mostra |
|---|---|
| Data | Data e hora do movimento (DD/MM/AAAA HH:MM) |
| Tipo | Chip colorido: Debito (vermelho), Credito / Compra / Trial (verde), Expiracao (laranja) |
| Descrição | Texto descritivo do movimento (ex.: nome do ticket, modelo de IA) |
| Modelo | Modelo de IA utilizado (ex.: gpt-4o, claude-3-haiku) |
| Valor | Quantidade de créditos (negativo = débito em vermelho, positivo = crédito em verde) |
| Saldo após | Saldo total imediatamente após o movimento |
Recarregar créditos
- Clique em Recarregar créditos no card de saldo.
- O sistema consulta
/credits/recharge-infopara obter a URL do checkout externo. - Uma nova aba abre com o checkout do CF Growth (sistema de cobrança).
- Conclua a compra no checkout externo.
- Os novos créditos aparecem no extrato e no saldo após processamento.
WARNING
A recarga é processada pelo CF Growth (sistema externo). Qualquer problema com o pagamento deve ser tratado pelo suporte, que verificará o processamento da recarga.
Problemas comuns
"O menu 'Créditos de IA' não aparece." Seu plano não inclui o recurso de IA (useOpenAi = false). Faça upgrade para um plano que inclua IA — veja Grade de planos.
"O saldo está zerado mas eu recarreguei." Aguarde alguns minutos para o webhook de confirmação processar. Se o saldo não atualizar, acione o suporte com o comprovante de compra.
"O agente de IA parou de responder." Verifique o saldo na tela Créditos de IA. Se aparecer o banner vermelho de "sem créditos", recarregue para reativar o agente.
"Vejo lotes expirados. Eles voltam?" Não. Créditos expirados são perdidos. Lotes de "Plano" expiram no fim do ciclo mensal; lotes de "Trial" expiram com o trial. Lotes de "Recarga" não têm expiração automática.