Meu bot de finanças no Telegram: eu digito o gasto, ele divide nas caixinhas e cobra as contas.
gastei 42 no posto
Anotado: R$ 42,00 em combustível. A caixinha da moto ainda tem R$ 318 este mês.
recebi 3500 do projeto
Entrou R$ 3.500,00. Separei primeiro as contas fixas do mês e dividi o resto entre as caixinhas.
Lembrete · parcela vence amanhã
Bot de Telegram que registra receitas e gastos ditos em linguagem natural, divide cada entrada em cinco caixinhas pela necessidade real do mês e cobra contas, parcelas e manutenções. Usa Gemini 2.5 Flash só para classificar a intenção; contas, saldos e prioridades são calculados em TypeScript e PostgreSQL. Confere o saldo declarado com o banco via Open Finance.
o problema
A renda do freelancer é irregular e planilhas não mostram quanto do dinheiro que entrou já está comprometido com contas, parcelas e metas; gastos pequenos passam batido e projetos são precificados no chute.
a solução
Bot Telegram em Next.js 15 + Supabase em que o Gemini devolve uma de 40 ações num enum fechado e o código executa. Livros-razão com triggers, aritmética em centavos, relatório de sexta via pg_cron, precificação em três patamares e conciliação com o extrato real via Pluggy, tudo em plano gratuito.
Como o atendimento roda
O cliente conversa como conversaria com uma pessoa. Por trás, o sistema identifica a intenção, consulta os dados certos e registra cada passo. As mensagens ao lado mostram o fluxo; os textos são ilustrativos.
Funcionalidades
- 01Registro de receitas e gastos por linguagem natural no Telegram
- 02Divisão automática de cada entrada em 5 caixinhas (Contas, Meta, Rolê, Previstos, Dia a dia)
- 03Resposta a 'posso gastar X?' com base no retrato financeiro real
- 04Contas fixas, dívidas parceladas, devedores, patrimônio e manutenções
- 05Ordem de pagamento calculada por gravidade e fluxo de caixa
- 06Projetos com marcos de pagamento e taxa da plataforma descontada
- 07Precificação de projetos em três patamares: sobreviver, viver e crescer
- 08Relatório automático toda sexta: 'dá pra sair no fim de semana?'
- 09Toques proativos com comemoração, cobrança e controle de frequência
- 10Conferência do saldo declarado contra o banco via Open Finance (Pluggy)
- 11Importação do extrato com conciliação, detecção de transferência interna e classificação por IA em lote
- 12Regras de classificação ensinadas pelo usuário
- 13/desfazer que reverte o último lançamento e seus efeitos
- 1416 comandos diretos que funcionam mesmo se a IA estiver fora
- 15Caderneta web com 9 seções, acesso por link assinado HMAC
Decisões técnicas
- >LLM restrito a classificar: 40 ações em enum fechado, validadas por responseSchema + Zod, e switch exaustivo que quebra o build se faltar tratamento
- >A IA recomenda por etiquetas de itens reais, sem poder inventar conta ou saldo
- >24 tabelas com RLS deny-all; contadores derivados por trigger a partir de livros-razão com UNIQUE
- >259 checagens automatizadas (187 de lógica pura + 72 de banco)
- >Toda aritmética em centavos inteiros; 9 módulos de regra de negócio puros e testáveis sem I/O
- >Webhook responde 200 na hora e processa em after() do Next 15, com idempotência por update_id
- >Custo de infraestrutura zero: Vercel, Supabase, Gemini e Pluggy em planos gratuitos
Tem um projeto parecido? Me conta o que precisa funcionar.
Pedir orçamento