Comprar pacotes extras de tokens de IA

Cada plano do Syncro tem uma quota mensal de tokens de IA — a unidade de consumo dos agentes inteligentes (cada mensagem que a IA processa gasta tokens conforme tamanho do contexto e da resposta). Quando você atinge o limite do mês, os agentes pausam automaticamente até o próximo ciclo.

Pra não ficar parado esperando, você pode comprar pacotes extras de tokens via PIX a qualquer momento. O pagamento é confirmado em segundos e os tokens entram na sua conta na hora.

Quando você precisa comprar

A IA pausa quando:

• Soma dos tokens usados no mês = limite do plano
• A coluna tenant.ai_tokens_exhausted é marcada como true
• Status do agente IA passa pra "Quota esgotada"

Aviso visual aparece em /ia/agentes com:

• Quota esgotada este mês ⚠️
• "Seu agente foi pausado automaticamente. Adicione mais tokens para reativá-lo."
• Botão Comprar tokens

Pré-requisitos

• Permissão de admin do tenant.
• CPF ou CNPJ válido (necessário pra geração de PIX ).
• Email de cobrança válido.

Pacotes disponíveis

A lista de pacotes é configurada pelo time Syncro. Pacotes típicos:

💡 Dica: pacotes maiores têm melhor custo por token. Se você consome com frequência, vale comprar o maior — economia de até 30% por token vs pacotes pequenos.

Passo a passo

Pelo modal automático (quando esgota)

1. Quando a quota esgota, o modal abre automaticamente em /ia/agentes.
2. Veja o gráfico Uso dos últimos 7 dias pra entender consumo.
3. Selecione um pacote clicando no card desejado.
4. Se for sua primeira compra, preencha:

• CPF ou CNPJ (sem pontos / traços, só números)
• Email de cobrança (já vem pré-preenchido)

5. Clique em Gerar PIX.
6. Aparece o feedback Cobrança gerada! Efetue o pagamento via PIX..
7. O modal mostra:

• QR Code pra você escanear no app do banco
• Chave Copia-e-Cola pra copiar e colar
• Valor total
• Validade do PIX (geralmente 24h)

Pelo menu de Cobrança

1. Configurações → Cobrança.
2. Role até a seção Tokens de IA (ou similar).
3. Clique em Comprar tokens ou Adicionar tokens.
4. Mesmo modal abre.

Como pagar o PIX

1. Abra o app do seu banco (Itaú, Nubank, Bradesco, etc).
2. Vá em PIX → Pagar com QR Code (ou Copia-e-Cola).
3. Escaneie o QR ou cole a chave.
4. Confirme o valor.
5. Autorize o pagamento.
6. Pronto. Em até 1 minuto, os tokens são creditados na sua conta.

O que acontece após o pagamento

1. O sistema detecta o pagamento e envia webhook pro Syncro.
2. O Syncro:

• Atualiza TenantTokenIncrement.status = 'paid'
• Adiciona os tokens no saldo do mês
• Marca tenant.ai_tokens_exhausted = false

3. Os agentes IA voltam a funcionar imediatamente — sem precisar reativar manualmente.
4. Você recebe email de confirmação do pagamento.

Tokens compram acumulam até o fim do mês

Tokens extras comprados são somados aos do plano dentro do mês corrente. Exemplo:

• Plano Starter: 500k tokens/mês (já esgotou)
• Você comprou pacote de 100k
• Total disponível agora: 100k tokens
• No 1º dia do próximo mês: nova quota de 500k é liberada (tokens comprados não acumulam pro próximo mês)

⚠️ Atenção: tokens comprados não rolam pra o mês seguinte. Se você comprou 500k e usou só 200k, os 300k restantes expiram no fim do mês. Compre conforme demanda real.

Histórico de compras

Você vê todas as compras de tokens no histórico de cobrança:

1. Configurações → Cobrança → Histórico.
2. Filtre por tipo token_increment.
3. Cada linha mostra:

• Data
• Pacote comprado
• Valor pago
• Status (Confirmado, Pendente, Falhado)

Compras pendentes (PIX não pago)

Se você gerou o PIX mas não pagou dentro do prazo de validade:

• O TenantTokenIncrement fica com status pending.
• Após 24h sem confirmação, é considerado abandonado.
• Os tokens nunca são creditados.
• Você não é cobrado por nada.

Pra refazer, basta abrir o modal e gerar novo PIX.

Cancelar uma compra

Não é possível cancelar uma compra de tokens já paga via interface. Pra refund, contate suporte com:

• ID do pagamento (visível no app do banco)
• Email da conta
• Motivo do refund

Dados fiscais

Pra empresas (CNPJ) que precisam de nota fiscal:

• Cadastre o CNPJ corretamente no momento da primeira compra (campo CPF/CNPJ).
• Ao final do mês, contate suporte com a relação de compras pra emissão da nota.

A emissão não é automática hoje — é feita manualmente pelo time financeiro.

Erros comuns

"Erro ao gerar cobrança"

• Verifique se o CPF/CNPJ está no formato correto (só números, sem pontos / traços).
• Confirme email válido.
• Tente recarregar a página e gerar PIX novamente.
• Se persistir, contate suporte.

"PIX expirou"

PIX vale 24h. Se você não pagou nesse prazo, gere PIX novo no modal — basta clicar em Gerar PIX de novo.

"Paguei mas tokens não chegaram"

Casos raros de webhook falhar:

1. Confirme no app do banco que o pagamento foi confirmado.
2. Aguarde até 30 minutos (webhooks podem ter atraso).
3. Se passar disso, contate suporte com:

• Comprovante PIX
• Email da conta
• Pacote comprado

Suporte conferre e credita manualmente.

Alternativas pra reduzir consumo de tokens

Antes de comprar tokens extras, considere otimizar o uso:

• Limitar agentes IA — desabilitar agentes que não trazem retorno
• Reduzir base de conhecimento — RAG com muitos documentos consome mais tokens
• Encurtar instruções dos agentes IA
• Usar chatbot tradicional pra fluxos simples (não consome tokens IA)

Artigos relacionados

• Entender os planos disponíveis
• Histórico de faturas e pagamentos
• Formas de pagamento aceitas
• Quota de tokens (Agentes IA)