> ## Documentation Index
> Fetch the complete documentation index at: https://docs.liderhub.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Entenda Créditos
> Entenda o modelo de cobrança por créditos na LíderHub. As métricas abaixo se baseiam numa amostragem de 350 MIL chats de diversos clientes.
## O que são Créditos?
Cada ação de Inteligência Artificial traz custos para a LíderHub, e traduzimos isso em forma de créditos.
Toda assinatura LíderHub já tem créditos incluídos. Planos mais caros têm mais créditos.
Você também pode contratar mais créditos sob demanda, ou ser cobrado pela diferença que usar. Mais detalhes em [Pacotes adicionais (Add-on)](/planos/pacotes-adicionais-addon).
**Estas são as quatro operações que mais impactam o consumo de créditos**:
|
Ação |
Créditos |
| 1 |
Processamento da IA |
\~9 |
| 2 |
Áudio gerado |
120/minuto |
| 3 |
Áudio transcrito |
6/minuto |
| 4 |
Imagem transcrita |
\~4 |
Você também pode ver o custo da lista de chats utilizando o parâmetro{" "}
cost=true na página /conversations e ver o custo de
cada chat.{" "}
Clique para ver mais
.
### 1. Processamento de IA
Sempre que há uma IA marcada como responsável e o cliente enviar uma mensagem, a IA responde ao cliente.
Cada processamento da IA custa créditos. Em cada processamento, a IA precisa
produzir uma resposta no chat. Em média, isso custa cerca de{" "}
9 créditos, principalmente pelo{" "}
tipo de saída gerada e pelo{" "}
tamanho do prompt.
Um processamento pode ser só texto ou{" "}
texto com menções (ações no mesmo envio, por exemplo status
ou calendário). O custo em créditos depende da menção. Na tabela, média por
tipo; descrição e documentação em{" "}
Menções (@)
.
| Menção |
O que faz |
Créditos
|
|
@status
|
Altera em qual etapa do funil a conversa está.{" "}
Ver mais
|
8.9 |
|
@template
|
Envia template (mensagem rápida) com texto, mídia ou arquivo.{" "}
Ver mais
|
9.1 |
|
@responsavel
|
Transfere a conversa para um humano ou outro agente.{" "}
Ver mais
|
9.4 |
|
@tag
|
Adiciona etiquetas ao contato para organização e filtros.{" "}
Ver mais
|
9.5 |
|
@biblioteca
|
Consulta artigos da base de conhecimento da empresa.{" "}
Ver mais
|
11.9
|
|
@departamento
|
Move a conversa para outro departamento.{" "}
Ver mais
|
8.5 |
|
@salvarnome
|
Atualiza o nome do contato na ficha.{" "}
Ver mais
|
8.9 |
|
@dataehora
|
Fornece data e hora atuais para o modelo usar no raciocínio.{" "}
Ver mais
|
10.6 |
|
@calculadora
|
Executa cálculos matemáticos no fluxo da conversa.{" "}
Ver mais
|
12.5
|
|
@think
|
Ativa raciocínio em etapas antes da resposta final.{" "}
Ver mais
|
4.4 |
|
@gerarcontrato
|
Gera contrato via ZapSign e envia o link para assinatura.{" "}
Ver mais
|
13.1
|
|
@resumo
|
Gera um resumo do histórico da conversa.{" "}
Ver mais
|
12.6 |
|
@ativaraudio
|
Faz o agente responder em áudio em vez de texto.{" "}
Ver mais
|
12.5 |
|
@notificar
|
Notifica um membro da equipe sem transferir a conversa.{" "}
Ver mais
|
11.8 |
|
@variável
|
Grava valores em variáveis do lead para uso no fluxo.{" "}
Ver mais
|
7.3 |
|
@calendario
|
Consulta disponibilidade e eventos no Google Calendar.{" "}
Ver mais
|
15.5
|
|
@desativaraudio
|
Desliga o modo áudio; o agente volta a responder em texto.{" "}
Ver mais
|
10.1 |
|
@advbox
|
Consulta informações de processos no AdvBox.{" "}
Ver mais
|
7.0 |
|
@desativarIA
|
Desliga a IA na conversa; só humanos seguem atendendo.{" "}
Ver mais
|
9.3 |
|
@calendario
|
Cria, edita ou remove eventos no Google Calendar.{" "}
Ver mais
|
14.3 |
Menções leves (status, responsável, nome, tag, …) custam{" "}
quase o mesmo que uma resposta só em texto: poucos tokens,
fluxo direto.
Raciocínio ou saída grande (base de conhecimento, contrato,
resumo longo, …) fica em média \~35% mais cara. Quanto maior
o output ou o esforço do modelo, maior o custo.
Exemplos de menções mais pesadas:{" "}
@calculadora
{", "}
@gerarcontrato
{" "}
(ZapSign),{" "}
@calendario
,{" "}
@resumo
{" e "}
@biblioteca
.
Quanto maior o prompt (contexto enviado para o modelo),{" "}
maior tende a ser o custo. Se o conjunto do prompt ficar na
faixa da média de cerca de 10 mil caracteres, o custo tende a
ficar próximo da média informada (\~9 créditos).
O contador na interface do agente passou a incluir os snippets JSON das
menções (@), então o número exibido pode ser maior que o texto visível. Isso
não altera o custo - é apenas uma contagem mais transparente.
| Caracteres do prompt |
Créditos
|
%
|
| 0-750 |
5.9 |
7.8% |
|
750-4.000
|
7.7 |
29.2% |
|
4.000-7.400
|
9.1 |
25.7% |
| 7.400-10.700 |
10.8 |
17.7% |
| 10.700-17.300 |
12.9 |
16.0% |
| 17.300-23.900 |
17.6 |
2.6% |
Em{" "}
Configurações do Agente
, o contador de caracteres mostra o tamanho total do prompt
(texto + snippets JSON das menções). O limite de referência varia por modelo -
por exemplo, 10.000 caracteres para GPT-5.2 e{" "}
7.000 para GPT-5 Mini.
Na prática, 99% das mensagens variam de 6-18{" "}
créditos por processamento, sendo \~95% entre 8-13.
Estes dados são válidos para a{" "}
frequência de mensagens enviadas conforme o{" "}
tamanho do prompt entre usuários LíderHub. Nossos templates
já seguem regras para manter o prompt enxuto e para dividir o fluxo com{" "}
sobreposição de prompt
{" "}
quando fizer sentido.
Os valores por processamento costumam variar entre cerca de 9{" "}
e 15 créditos conforme as menções (tipo de saída) e o{" "}
tamanho do prompt, mas o que mais causa impacto no custo de
um chat é o volume de mensagens trocadas, e não só o custo de
cada envio.
Para a maioria dos clientes LíderHub, o processamento da IA{" "}
representa mais de 90% do custo total em créditos. O
principal fator de consumo elevado são conversas longas{" "}
(muitas mensagens e, portanto, muitos processamentos).
### 2. Gerar áudio de resposta
Sempre que o [modo áudio (@ativaraudio)](/agentes/mencoes#15-ativaraudio-modo-audio) estiver ativado e gerarmos um áudio para responder o cliente com áudio.
**SEMPRE** que há custo de geração de áudio, há também o custo **(1)** de **Processamento da IA**, porque o sistema primeiro processa e gera a resposta e depois gera o áudio.
Isso também acontece com áudios recebidos: há custo de créditos da transcrição do áudio recebido e, depois, da geração da resposta.
### 3 e 4. Transcrever áudio e imagens recebidas
Sempre que a IA estiver associada a algum chat e receber uma imagem ou um áudio, há transcrição automática do conteúdo.
Áudios e imagens enviados por dispositivos externos (como o WhatsApp no celular) são transcritos automaticamente para preservar o contexto da conversa e permitir que a IA compreenda o conteúdo em atendimentos futuros.
**Recomendação:** sempre que possível, envie as mídias pela plataforma.
***
## Quanto custa um chat completo?
Com base na análise de chats reais na plataforma:
Conversa típica com algumas mensagens de texto.
De 2 a 3× mais caro que o chat médio.
Os **97%** dos chats qualificados mais baratos custaram em média **140 créditos**.
Lead fora do perfil. Desative a IA cedo e economize.
**97% dos chats custam menos de 500 créditos.** Se um chat ultrapassar esse valor, cabe uma checagem humana:
* É um chat de alguém qualificado, no fluxo de fechamento?
* É um chat de alguém desqualificado, apenas conversando com a IA?
* É um loop com algum outro sistema?
Você humano decide se quer deixar a IA ativa, ou quer desativá-la.
Por segurança, nas configurações você pode definir uma trava de limite para ser notificado, e outra para desativar a IA. É semelhante a @desativarIA.
### Onde vão os créditos?
Na prática, a maior parte do gasto está no processamento típico da conversa (quando ignoramos outliers, como os poucos chats muito caros). Em termos de **para onde vão os créditos**, a distribuição média aproxima-se de:
Quase todo o consumo em{" "}
respostas de texto, raciocínio e menções do agente em cada
processamento.
Transcrição automática de mensagens de áudio ou imagem
recebidas do cliente.
Créditos gastos na geração de áudio quando o modo áudio
está ativo.
Na plataforma, acesse{" "}
chat.liderhub.ai/settings/usage
{" "}
e consulte o consumo de créditos da sua conta,{" "}
filtrando por período e vendo em quais{" "}
tipos de custo você mais gasta. Você também pode revisar cada
uso em Histórico detalhado.
• Clique em (1) Configurações e (2) Uso para ver mais detalhes de consumo.
• Em (3) você pode visualizar seu limite de créditos; em (4), o valor em
excedentes.
• Em (5), o gráfico dos seus custos de créditos ao longo do tempo.
}
>
Certamente esta interface estará um pouco mais otimizada quando você acessar.
Se tiver dúvidas, contate o suporte em{" "}
chat.liderhub.ai/suporte
{" "}
ou pelo{" "}
WhatsApp
.
***
A equivalência entre o modelo antigo (conversas com IA) e os créditos do plano, incluindo a tabela Basic, Pro e Scale, está em [Veja mais sobre créditos para clientes antigos](/planos/creditos-clientes-antigos).
## E se eu usar mais do que o plano?
Você tem **duas alternativas**:
| Add-on |
Preço |
Benefício |
Modelo |
|
Pacote de Créditos
|
{"R$"} 50
|
+1.000 créditos |
On-demand |
|
Pacote de Créditos
|
{"R$"} 2.800
|
+100.000 créditos |
On-demand |
|
Pacote de Créditos
|
{"R$"} 4.200
|
+200.000 créditos |
On-demand |
Estes são preços de pacotes já negociados com clientes
LíderHub. Se você quiser condições semelhantes, em geral é{" "}
viável alinhar algo nessa linha com o time comercial.
Exemplo (200 mil créditos): com chat médio de{" "}
70 créditos, 200 mil créditos equivalem a{" "}
\~2.857 conversas (200.000 ÷ 70). O pacote de{" "}
{"R$"} 4.200 representa cerca de{" "}
{"R$"} 1,47 por lead (4.200 ÷ 2.857 ≈ 1,47).
Atenção: se você não contratar um pacote
de add-on de créditos, o consumo excedente é cobrado em{" "}
{"R$"} 0,04 por crédito. Contate nosso suporte via{" "}
WhatsApp
{" "}
para saber mais.
Quando o consumo ultrapassa o que o plano inclui no mês, os créditos extras são cobrados **por crédito utilizado**, na **data de renovação** da assinatura (o mesmo dia do mês em que o plano foi iniciado). Assim você segue com o mesmo nível de desempenho da IA e paga só o que usar além do pacote.
**Exemplo:** Se você assinou no dia **10 de abril**, o consumo extra de abril será cobrado no dia **10 de maio**, junto com a renovação do plano.
Você receberá alertas progressivos ao atingir **80%** e **100%** do saldo.
Nunca haverá cobrança surpresa.
**Reduzimos o custo** por mensagem ao passar para um **modelo de IA mais econômico** (menos eficaz que o principal). Esse modo costuma ir bem em **casos simples**: **prompt enxuto**, **poucas condicionais**, fluxo **unidirecional** e instruções **extremamente claras**.
**Ao atingir o limite do plano**, essa mudança para o modelo mais barato **é automática** quando você **não tem cobrança de excedentes ativada** (defina em **Configurações > Planos e Uso**). **Cada plano** traz um **limite diferente** de quanto você pode usar nesse regime **antes** de passar a pagar excedente ou de precisar ajustar o uso, conforme as regras do seu contrato.
Em Configurações > Planos e Uso você ativa ou desativa a
cobrança por excedente e acompanha limites e consumo.
O modelo de créditos contabilizará a partir de **maio de 2026**. Clientes que contrataram antes disso receberão créditos equivalentes ao acordo anterior.
[Veja mais sobre créditos para clientes antigos](/planos/creditos-clientes-antigos)
***
## Proteção automática contra desperdício
Um dos principais benefícios do novo modelo é a **proteção automática**: se um chat ultrapassar 500 créditos, a LíderHub notifica o responsável humano.
Isso resolve o problema dos "chats caros demais" — loops, áudios infinitos ou conversas estagnadas — que representavam 36% do custo total no período analisado.
***
## Boas práticas para economizar créditos
A análise identificou os principais causadores de custo desnecessário. Seguindo estas práticas, você pode reduzir o consumo em até **50%**.
Isso significa que, se você já é cliente, basta aplicar boas práticas para ter o dobro de **Conversas IA**, de acordo com o que apresentamos aqui. Veja mais em Créditos para clientes antigos.
@desativarIA para leads desqualificados}>
Leads desqualificados ou desinteressados geraram **36% de todo o custo** no período analisado.
Quando um lead claramente não tem perfil, use @Desativar IA no prompt para encerrar o processamento. Nossos prompts padrão já vêm configurados com essa lógica, e pode ser automático.
**Economia potencial: até 50% dos créditos**
Os 3% de chats mais caros — que consumiram 36% do custo — são majoritariamente loops, "sequestros de bot" ou conversas de "amizade" onde o lead fica respondendo indefinidamente sem avançar na jornada.
Configure limites de turno no prompt e use @Desativar IA após algumas tentativas sem resposta relevante.
Fique tranquilo, a LíderHub já tem mecanismos de segurança para remover a IA e preservar seus créditos. Acesse Configurações > Uso para ver mais.
Utilize @ativaraudio com moderação}>
Por minuto, o áudio pesa muito mais no custo do que uma resposta só em texto.
**5% dos chats mais caros** tiveram **33% dos custos** associados à geração de áudio, **mas não tiveram conversões muito maiores** que o restante da base.
Use áudio para etapas onde ele agrega valor real, não como resposta padrão para todas as mensagens.
Otimizar o prompt é escrever boas instruções, diretas e sem ambiguidade, com regras claras de quando encerrar, mudar de assunto ou evitar que o lead fique em loop de perguntas fora da pauta ("sequestro" da conversa). Isso tudo você define em Prompt e instruções.
Também é importante **quebrar o prompt** em **vários agentes** e instruções menores para reduzir custo por mensagem. Veja Sobreposição de prompt.
Há informações que **não devem ficar inteiras no prompt** (por exemplo textos extensos ou bases de FAQ): o lugar certo é a base de conhecimento, para a IA buscar só quando precisar. Cada consulta à base tem custo próprio (\~12 créditos em média); manter o prompt enxuto e a base focada evita prompt caro e contexto desperdiçado a cada mensagem.
Regra prática: prompts com histórico muito acima da faixa recomendada (veja a tabela em 1.2 nesta página) já custam bem mais por mensagem; combine prompt curto, base útil e multi-agente quando fizer sentido.
***
## Deixe uma sugestão
Agradecemos muito pelo seu tempo! Se você precisa de suporte, acesse [Obtenha suporte](/suporte/obtenha-suporte).
## Dúvidas Frequentes
Não. Os planos foram calibrados para que os créditos incluídos equivalham — ou superem — o que você usava antes. Um chat médio custa 70 créditos, e o plano Basic (antes 125 conversas) passa a ter 8.750 créditos, o suficiente para \~125 chats médios.
Quem usa bem a IA — desativando para leads desqualificados e evitando loops — vai usar ainda menos créditos do que as conversas antigas.
Acesse **Configurações > Plano** para ver o saldo de créditos, consumo do mês atual e histórico. Em breve, também será possível ver o custo por chat individualmente.
Você recebe alertas progressivos conforme o saldo cai (80%, 100%).
Ao zerar, sua IA não deixa de funcionar, mas um modelo mais barato (menos inteligente) fica associado ao seu agente, o que pode aumentar alucinações.
Se o uso excedente continuar sem pagamento extra, podemos cessar o serviço de IA, conforme nossos termos de uso. A plataforma segue funcionando para atendimento humano quando você tem assinatura ativa, mas sem créditos de IA naquele período.
Fique tranquilo: no próximo período os créditos de IA em geral são renovados e a IA volta a funcionar com capacidade máxima.
Os principais fatores são: quantidade de mensagens no histórico (mais longo = mais caro por mensagem), uso de áudio (120 créditos/min), ferramentas complexas (Google Calendar custa mais que SetStatus) e loops de conversa. Os 3% de chats mais caros concentram a maior parte do custo exatamente por essas razões.
Só se a IA continuar respondendo. Com a prática de desativar a IA assim que o lead é identificado como fora do perfil, o custo cai para menos de 30 créditos por conversa. Nossos prompts padrão já vêm com essa lógica configurada.
Os créditos extras são cobrados por crédito consumido, no dia de renovação da sua assinatura. Se você assinou no dia 10, o consumo extra do mês é cobrado no dia 10 do mês seguinte — junto com a renovação normal do plano. A maioria dos clientes não precisará de créditos extras se seguir as boas práticas de desativar a IA para leads fora do perfil.
Add-ons são cobrados mensalmente, também na data de renovação da sua assinatura. Cada seat adicional custa **R\$ 100/mês** e cada conexão adicional custa **R\$ 100/mês**. Você pode adicionar ou remover add-ons a qualquer momento em **Configurações > Plano**.
