Plano e Créditos

Tudo relacionado a cobrança e consumo da organização vive na aba Assinatura da página Configurações (/admin/settings?tab=subscription).

O que aparece na aba

• Saldo de Créditos (card destacado em roxo): saldo atual atualizado em tempo real, com a anotação Plano inclui N créditos/mês logo abaixo.
• Plano Atual: nome do plano (ex.: Free, Pro), badge verde Ativo e o botão Mudar Plano (abre a página de pricing em /admin/pricing).
• Contadores do plano: Agentes, Usuários e Conversas atuais da organização.

Use essa aba para conferir saldo antes de campanhas de uso intenso ou antes de aprovar um agente novo que vai puxar muito tráfego.

Como os créditos são gastos

Cada mensagem que um agente responde consome créditos. O quanto cada mensagem custa depende de vários fatores:

• Modelo escolhido pelo agente (modelos avançados custam mais por token);
• Tamanho do prompt do sistema (envia em todas as chamadas);
• Tamanho do histórico que vai junto na chamada (controlado pelo limite de histórico em Configurações Avançadas do agente);
• Uso de bases de conhecimento (cada chunk recuperado entra no contexto);
• Ferramentas chamadas (cada chamada gera uma rodada extra de LLM);
• Geração de imagens (cobrado à parte, por imagem);
• Tamanho da resposta (controlado pelo limite máximo de resposta).

Para investigar consumo, vá em Analytics → aba Créditos — lá você filtra por agente, canal e período para ver onde está vindo o gasto.

Mudar de plano

O botão Mudar Plano leva à página de pricing dentro do próprio painel. Antes de mudar, avalie:

• volume de conversas dos últimos 30 dias;
• número de usuários ativos;
• canais necessários (WhatsApp, Telegram, API);
• requisitos de suporte (planos superiores tem SLA mais agressivo).

Conectando sua própria chave da OpenRouter

Existe ainda um caminho alternativo de cobrança: em Configurações → aba Modelos IA, você pode conectar uma chave própria da OpenRouter. Quando configurada, a cobrança dos tokens dos LLMs passa direto pra sua conta na OpenRouter, e o SquadOS passa a cobrar apenas 1 crédito por mensagem como taxa de orquestração. Veja Configurações da Organização para detalhes.

Boas práticas

• Monitore o consumo após publicar agentes novos — picos de uso aparecem nas primeiras 24h.
• Teste modelos mais baratos em tarefas simples (validação de input, classificação, etc.) e reserve os caros para raciocínio complexo.
• Evite histórico excessivo quando o agente não precisa dele — cada turno extra é tokens a mais em toda chamada.
• Investigue picos de uso em Analytics → Créditos, especialmente quando uma ferramenta começa a falhar e o agente entra em loop.
• Revise o saldo de créditos junto com mudanças grandes (novo canal, nova base, alteração de modelo padrão).