Tudo que você precisa para controlar suas finanças

Despesas e Receitas

Registre gastos e ganhos em segundos com comandos rápidos como /despesa 50 mercado. Wizard conversacional guia passo a passo quando faltam dados. Transações futuras viram agendadas automaticamente

Extrato e Resumo

Extrato interativo com filtros por categoria, grupo, tags, tipo, período e status. Resumo por categoria com totais de receitas, despesas e saldo do período

Saldo e Agendadas

Consulte saldo do mês, mês passado ou janeiro — o bot entende períodos naturais. Transações futuras aparecem com ⏳ e são listadas em /agendadas

Recorrências

Crie recorrências com wizard completo. Geração automática diária via cron — adiante, pule, arquive ou edite cada ocorrência. Transforme qualquer transação em recorrência

Busca e Detalhes

Busque transações por descrição, valor ou tag com /buscar mercado. Veja detalhes completos, edite valor/categoria/data/grupo/tags ou exclua com confirmação

Linguagem Natural IA

"Gastei 50 no almoço", "quanto gastei esse mês?", "recebi 3000 de salário" — o bot entende frases comuns sem precisar de comandos, graças à IA do DeepSeek

Grupos e Categorias

Organize por conta bancária, cartão de crédito ou tipo de gasto. Categorias pré-definidas por tipo (despesa/receita) + crie as suas. Consulte saldo e resumo filtrando por grupo

Web Dashboard

Acesse seus dados pelo navegador com código temporário de 6 dígitos gerado pelo /login. Limpeza automática de categorias e grupos sem uso com /limpar

Comece a usar em 3 passos

Abra o Telegram

Busque por @patofinancebot e inicie a conversa

Envie seu primeiro comando

Digite /despesa 50 almoço, /saldo mes passado, /resumo ultimo mes ou /buscar mercado

Deixe o resto com o bot

Extratos, resumos, categorias — tudo por comando ou clique

Comandos disponíveis

/despesa 50 almoço

Registra uma despesa

/receita 3000 salário

Registra uma receita

/saldo

Saldo do período — use /saldo mes passado, /saldo janeiro

/extrato

Extrato com filtros — use /extrato janeiro 2025, /extrato --grupo Pessoal

/resumo

Resumo por categoria — use /resumo ultimo mes, /resumo --grupo Trabalho

/detalhes 42

Detalhes completos da transação com botões para editar ou excluir

/agendadas

Lista transações futuras agendadas — use /futuras como atalho

/recorrencia

Cria e gerencia recorrências com geração automática — adiante, pule ou arquive ocorrências

/buscar mercado

Busca transações por descrição, valor ou tag — use /buscar 150, /buscar #ifood

/grupo

Gerencia grupos (contas bancárias, carteiras)

/categoria

Gerencia categorias (despesa e receita)

/tag

Lista tags com quantidade de transações

/ajuda

Lista todos os comandos. Use /ajuda extrato para detalhes de um comando

/limpar

Remove categorias/grupos sem transações

/resetar

Reseta sua conta (apaga todas as transações, categorias, grupos e tags)

/cancelar

Cancelar operação em andamento

Linguagem natural

"Gastei 50 no almoço" · "Recebi 3000 de salário" · "Quanto gastei este mês?"

Dúvidas frequentes

Precisa cadastrar cartão ou dados bancários?

Não. O Pato Finance é apenas um assistente de registro. Você insere seus gastos e receitas manualmente ou por comando.

É realmente grátis?

Sim. O bot é 100% gratuito e open source. Veja o código no GitHub.

Meus dados ficam seguros?

Sim. Tudo fica no Supabase PostgreSQL com criptografia. Seus dados são seus — não compartilhamos com terceiros.

Funciona sem internet?

Precisa de internet para o Telegram, mas o bot é leve e funciona até em 3G.

O que fazer depois de iniciar o bot?

Envie seu primeiro comando: /despesa 50 almoço para registrar um gasto, /receita 3000 salário para uma receita, ou /saldo para ver seu saldo. O bot já vem com categorias pré-definidas — não precisa configurar nada.

Preciso criar categorias antes de registrar?

Não. O bot tem categorias pré-definidas (Alimentação, Transporte, Salário, etc.) e cria novas automaticamente se você digitar um nome que não existe. Use /categoria para gerenciar.

Como registro uma despesa com categoria, tags e grupo específicos?

Use os flags opcionais: /despesa 50 --descricao "almoço no shopping" --grupo "Cartão Nubank" --tags #comida #lazer. Para receita: /receita 3000 --descricao "salário" --grupo "Conta Corrente". Se omitir algo, o wizard conversacional guia passo a passo.

Posso editar ou excluir uma transação depois de registrada?

Sim. Use /detalhes ID (o ID aparece no extrato) para ver a transação completa. Lá você encontra botões para editar valor, categoria, data, grupo, tags, descrição ou excluir a transação.

Como funciona o sistema de tags?

Tags são marcadores livres como #ifood, #viagem ou #trabalho. Você adiciona ao registrar com o flag --tags #minhaTag. Depois, use /tag para ver todas com contagem de uso, e clique em qualquer uma para filtrar as transações daquela tag.

Como funcionam as recorrências?

Recorrências criam transações automaticamente todo mês, semana ou período configurado. Use /recorrencia para criar pelo wizard ou transforme uma transação existente em recorrência. O bot roda um cron diário às 06:00 que gera as ocorrências pendentes. Você pode adiantar, pular, arquivar ou editar cada recorrência pelos botões inline.

Como acesso meus dados pelo navegador?

Envie /login no bot para gerar um código de 6 dígitos. Acesse o site do Pato Finance, vá em "Entrar" e digite o código. Pronto — seus dados aparecem no navegador com a mesma conta do Telegram.

Consigo usar no computador?

Sim. O Telegram tem versão Desktop e Web (web.telegram.org). Todos os comandos funcionam igual — você pode registrar, consultar e gerenciar tudo do PC.

O bot não respondeu, o que fazer?

Pode ser instante de lentidão — aguarde alguns segundos. Se não responder, envie /cancelar para limpar qualquer estado pendente e tente novamente. Se o problema persistir, o bot pode estar em manutenção — verifique o status no GitHub.

O que acontece se eu resetar minha conta?

O comando /resetar apaga todas as suas transações, categorias, grupos, tags e recorrências. É uma operação destrutiva — o bot exibe um aviso e você precisa digitar RESETAR para confirmar. Use com cuidado.

Como reportar um bug ou sugerir melhoria?

Abra uma issue no GitHub. O projeto é open source e toda contribuição é bem-vinda. Descreva o problema ou sugestão que a gente analisa.

Pronto para organizar suas finanças?

Em menos de 1 minuto você já está controlando seu dinheiro

Falar com Pato Finance

Grátis · Open Source · Seus dados seguros