Como usar - Conta Certa

Módulo 1 • Comandos de Entrada

Comandos de Inicialização, Convites e Aceite LGPD

Como iniciar o bot do zero, entrar em uma família existente e validar sua licença.

Todos os Comandos de Inicialização

1

Criar Nova Conta Familiar (/start):
Ao enviar /start pela primeira vez (sem link de convite), o bot apresenta os links dos Termos de Uso (v1.0) e da Política de Privacidade (v1.0). Ao clicar em "✅ Li e aceito os Termos e a Política (v1.0)", o sistema cria automaticamente a sua família (Família de [Seu Nome]), define você como 👑 Administrador e libera o Teclado Principal.
2

Entrar via Link de Convite (/start convite_TOKEN):
Quando o Administrador gera um link em 👥 Membros → ➕ Gerar Link de Convite, o convidado clica no link (válido por 24 horas e de uso único). O bot envia uma notificação em tempo real para o Administrador com os botões "Aprovar ✅" e "Recusar ❌", e apresenta o termo LGPD para o convidado aceitar.
3

Renovação de Termos e Verificação de Licença:
Antes de processar qualquer mensagem, áudio ou clique de botão, o ContaCerta verifica automaticamente se a licença da família está ativa e se você já aceitou a versão vigente da Política de Privacidade.

Conta Certa | Gestão Financeira Inteligente

bot • online

/start 08:45 ✓✓

👋 Olá, Willian!

Para utilizarmos o Conta Certa com total transparência e segurança em conformidade com a LGPD, precisamos que você revise e confirme nossos documentos:

📄 Termos de Uso (v1.0)
🔒 Política de Privacidade (v1.0)

• Seus áudios são usados apenas para transcrição e apagados imediatamente.
• Nunca pedimos senhas bancárias.
• Você pode exportar seus dados ou excluir sua conta a qualquer momento no menu ⚙️ Minha Conta. 08:45

✅ Li e aceito os Termos e a Política (v1.0)

👥 Membros

💸 Registar Transação

🏦 Contas

🔁 Transferir entre contas

📊 Ver Resumo

🗑️ Apagar Lançamento

💳 Cartões

🔮 Previsão

🎯 Orçamento

⚙️ Minha Conta

Módulo 2 • Navegação Completa

O que faz cada um dos 10 Botões do Teclado (e seus Sub-botões)

Referência completa de todas as telas e botões internos que aparecem quando você toca no menu inferior do Telegram.

👥 Membros Admin + Membros

Lista todas as pessoas da conta familiar indicando o cargo (👑 Admin ou Membro) e o status (✅ Ativo ou ⏳ Pendente). Respeita o limite padrão de até 6 membros ativos por família.

Sub-botões internos (Visão do 👑 Admin):

➕ Gerar Link de Convite: Cria um link único válido por 24h.
👑 Transferir Admin para [Nome] → ✅ Transferir / ❌ Cancelar: Passa a liderança para outro membro ativo (você vira membro comum).
🗑️ Remover [Nome]: Exclui imediatamente o membro da família.
🚪 Sair / Renunciar Administração: Permite escolher um sucessor e sair da família.

Sub-botões internos (Visão do 👤 Membro):

🚪 Sair da Família → ✅ Sair da família: Sai da conta mantendo os lançamentos antigos registrados na família.

💸 Registar Transação Uso Diário

Exibe a instrução rápida lembrando que você pode enviar qualquer receita ou despesa livremente por texto ou áudio a qualquer momento no chat.

Sub-botões gerados durante um lançamento:

Confirmação de IA / Hábito: ✅ Sim, é isso | ✅ Sim, manter | ❌ Não, escolher (abre a lista de Categorias Principais e Subcategorias).
Formas de Pagamento (Despesas): Pix, Dinheiro, Débito, Crédito, Boleto, Transferência, Outros.
Seleção de Destino: Botões com o nome das suas Contas ativas (ou dos seus Cartões ativos, se escolheu Crédito).
Tela Final de Confirmação: ✅ Confirmar (salva no banco), ✏️ Editar (permite reenviar a frase corrigida) e ❌ Cancelar.

🏦 Contas Saldos em Tempo Real

Exibe todas as contas bancárias ou carteiras ativas da família, o saldo individual atualizado de cada uma (Saldo Inicial + Receitas − Despesas exceto crédito ± Transferências) e o 💰 Saldo total das contas.

Sub-botões de Cadastro de Conta:

➕ Cadastrar conta: Pede o nome da conta (até 60 caracteres).
Escolha do Tipo de Conta: Conta corrente, Conta conjunta, Poupança, Dinheiro, Carteira, Conta digital, Outra.
Regra de Saldo Negativo: ✅ Sim, tem cheque especial (permite ficar negativa) ou ❌ Não tem (bloqueia despesas maiores que o saldo disponível).

🔁 Transferir entre contas Movimentação Interna

Transfere valores entre duas contas ativas da família (ex: da Conta Corrente para a Poupança ou Carteira) sem contabilizar como nova receita ou despesa no resumo do mês. Exige no mínimo 2 contas cadastradas.

Passo a passo nos sub-botões:

Passo 1: Clique no botão da Conta de Origem.
Passo 2: Clique no botão da Conta de Destino (o bot oculta a conta de origem para evitar erro).
Passo 3: Digite o valor no chat (ex: 150 ou 150,50).
Passo 4: Clique em ✅ Confirmar ou ❌ Cancelar.

📊 Ver Resumo Relatórios e PDF

Mostra o balanço dos últimos 30 dias (Total de Receitas, Despesas e Saldo), lista todos os lançamentos à vista com data, hora e nome do autor, e agrupa separadamente os lançamentos de cada Cartão de Crédito.

Sub-botões de Análise Avançada:

📈 Resumo comparativo: Compara o mês atual (do dia 1 até hoje) com o exato mesmo intervalo do mês passado, mostrando o percentual (%) de aumento ou redução de receitas e despesas.
📄 Baixar Relatório em PDF dos últimos 30 dias: Gera e envia no chat o arquivo relatorio_financeiro.pdf consolidado.
👥 Filtrar por Membro: Escolha um familiar → escolha 🔴 Despesas ou 🟢 Receitas para ver o total gasto por aquela pessoa e o ranking por categoria.
🔍 Filtrar por Categoria: Escolha 🔴 Filtrar Despesas ou 🟢 Filtrar Receitas → escolha a Categoria Principal para ver os lançamentos do mês atual.

🗑️ Apagar Lançamento Auditoria e Limpeza

Lista em botões todos os lançamentos normais (🟢/🔴) e compras de cartão de crédito (💳) dos últimos 30 dias, do mais recente para o mais antigo.

Regras e Sub-botões:

Ao clicar no item desejado, abre a trava de segurança: ✅ Sim, apagar ou ❌ Cancelar.
Permissão: Membros comuns apagam apenas os próprios registros; o Administrador pode apagar qualquer registro da família.

💳 Cartões Crédito e Faturas

Lista todos os cartões de crédito ativos da família com seus respectivos limites.

Sub-botões de Gestão do Cartão:

➕ Cadastrar cartão: Solicita Nome → Limite → Dia de fechamento (1 a 31) → Dia de vencimento (1 a 31) → ✅ Salvar / ❌ Cancelar.
💳 Ver [Nome do Cartão]: Abre o painel exclusivo daquele cartão com 4 opções:
- 🧾 Pagar fatura: Lista as faturas abertas por vencimento → permite escolher de qual conta bancária sairá o dinheiro → valida o saldo e quita as parcelas.
- ✏️ Editar dias: Altera o dia de fechamento e de vencimento para as próximas compras.
- 🚫 Desativar cartão → ✅ Sim, desativar: Oculta o cartão mantendo todo o histórico passado.
- 🔙 Voltar aos cartões.

🔮 Previsão Projeção Estatística

Calcula automaticamente a estimativa de despesas para o próximo mês com base na média aritmética dos 3 meses completos anteriores (incluindo meses sem gastos naquela categoria como zero na média). Lista o total previsto e o detalhamento por subcategoria, do maior para o menor.

🎯 Orçamento Teto de Gastos Mensal

Exibe o painel de metas mensais das 17 Categorias Principais de despesa (dividido em 3 páginas de 6 itens). Combina os gastos à vista do mês + parcelas de cartão que vencem no mês (Regime de Competência). Mostra a porcentagem consumida ou o alerta 🚨 (excedido).

Sub-botões de Paginação e Meta:

Definir [Categoria]: Solicita no chat o valor mensal máximo (ex: 2000) e salva imediatamente.
◀️ Back e Next ▶️: Navega entre as páginas 1/3, 2/3 e 3/3.

⚙️ Minha Conta Privacidade e LGPD

Painel de transparência e Direitos do Titular (também acessível escrevendo 🔒 Privacidade). Exibe seu Nome, Username, Perfil na família e versão dos Termos aceita.

Sub-botões de Direitos do Titular (LGPD):

✏️ Corrigir meus dados cadastrais: Atualiza seu nome de exibição e sincroniza seu @username.
📦 Exportar meus dados (ZIP/CSV): Gera na hora um arquivo contacerta_export_AAAA-MM-DD.zip contendo usuario.json + 8 planilhas CSV (lancamentos.csv, contas.csv, cartoes.csv, compras_cartao.csv, parcelas.csv, transferencias.csv, orcamentos.csv, recorrencias.csv).
🗑️ Excluir minha conta e meus dados → 🗑️ Sim, excluir minha conta: Apaga seus dados pessoais (anonimizando lançamentos em famílias ativas como "Usuário removido" ou apagando a família inteira se você for o único membro).

Módulo 3 • Como escrever ou falar

Dicionário Completo de Verbos, Formatos de Valor, Datas e Áudio

Veja exatamente quais palavras acionam uma Receita, uma Despesa ou uma Exclusão no interpretador do ContaCerta.

1. Palavras que identificam RECEITA (🟢)

Basta incluir qualquer uma destas expressões na sua frase ou áudio:

2. Palavras que identificam DESPESA (🔴)

Qualquer uma das palavras abaixo classifica o lançamento como gasto:

3. Formatos de Valores, Multiplicadores, Datas e Descrição

$

Valores e Multiplicadores aceitos: Você pode digitar 50, 50,90, R$ 1.500,50, formato americano 1,500.50 ou usar multiplicadores por extenso: 2 mil (vira R$ 2.000,00) ou 1 milhão. Números precedidos por "dia" (ex: dia 15) ou seguidos de "x/parcelas" (ex: 10x) são inteligentemente ignorados como valor para não confundir o cálculo!
📅

Datas aceitas na frase: hoje, ontem, anteontem, ou datas com barra ou traço: 14/10, 14-10, 14/10/26 ou 14/10/2026.
📝

Como gravar uma Descrição Específica: O bot só grava o campo de descrição quando você escreve a palavra descrição: (com ou sem acento).
Exemplo: Gastei 180 na consulta médica ontem descrição: Pediatra da Sofia.

Conta Certa | Gestão Financeira Inteligente

bot • online

🎙️ Mensagem de voz (0:05) 14:10 ✓✓

✅ Áudio processado. Confira os dados antes de confirmar. 14:10

🏦 Escolha a conta onde esta receita será depositada: 14:10

Conta Principal Itaú

🔍 Confirme os dados (Áudio):

• Tipo: 🟢 Receita
• Valor: R$ 3500.00
• Subcategoria: Salário
• Conta: Conta Principal Itaú
• Forma de pagamento: Não informada 14:10

Apague o gasto de 84,90 14:15 ✓✓

🗑️ Encontrei este registro recente. Deseja apagá-lo?

🔴 25/10 12:31 | Delivery — R$ 84.90 14:15

✅ Sim, apagar

❌ Cancelar

Módulo 4 • Estrutura Oficial de Classificação

Todas as Categorias e Subcategorias do Sistema

O ContaCerta organiza suas finanças em 17 Categorias de Despesa e 8 Categorias de Receita. Se você citar qualquer subcategoria abaixo na sua frase, o bot classifica automaticamente!

1. 🏠 Moradia 22 subcategorias

2. 🍽️ Alimentação 14 subcategorias

3. 🚗 Transporte 16 subcategorias

4. 🏥 Saúde 16 subcategorias

5. 🎓 Educação 13 subcategorias

6. 🧸 Filhos 14 subcategorias

7. 👕 Vestuário 9 subcategorias

8. 💈 Higiene e Cuidados Pessoais 10 subcategorias

9. 🎬 Lazer e Entretenimento 13 subcategorias

10. 💻 Assinaturas e Serviços Digitais 10 subcategorias

11. ✈️ Viagens 11 subcategorias

12. 🐾 Animais de Estimação 11 subcategorias

13. 🛍️ Compras 12 subcategorias

14. 🤝 Doações e Contribuições 7 subcategorias

15. 💼 Trabalho 11 subcategorias

16. 🛡️ Seguros 8 subcategorias

17. 📦 Outros 3 subcategorias

1. 💵 Trabalho e Renda 11 subcategorias

2. 🧑‍💻 Trabalho Autônomo 8 subcategorias

3. 🏢 Negócios 6 subcategorias

4. 📈 Investimentos 7 subcategorias

5. 🏡 Patrimônio 6 subcategorias

6. 🎫 Benefícios 6 subcategorias

7. 🔄 Reembolsos 5 subcategorias

8. 🎁 Outras Receitas 7 subcategorias

Módulo 5 • Inteligência Artificial e Hábitos

Marcas Reconhecidas Automaticamente e Aprendizado da Família

Veja quais marcas o ContaCerta já conhece de fábrica e como ele aprende o hábito dos seus fornecedores locais.

Termos / Marcas digitadas ou faladas por você	Subcategoria Sugerida Automaticamente	Categoria Principal
`netflix`, `prime video`, `amazon prime video`, `disney+`, `disney plus`, `max`, `hbo max`, `hbo`, `paramount+`, `globoplay`, `apple tv+`, `crunchyroll`, `youtube premium`, `mubi`, `telecine`, `starz`, `claro tv+`, `sky+`, `pluto tv`, `discovery+`, `dazn`, `premiere`, `ufc fight pass`	Streaming de vídeo	Assinaturas e Serviços Digitais
`spotify`, `youtube music`, `apple music`, `amazon music`, `deezer`, `tidal`, `soundcloud`, `qobuz`, `napster`	Streaming de música	Assinaturas e Serviços Digitais
`audible`, `storytel`, `ubook`	Aplicativos	Assinaturas e Serviços Digitais
`uber`, `99`, `99app`	Uber	Transporte
`sem parar`, `conectcar`	Pedágio	Transporte
`ifood`	Delivery	Alimentação
`mercado`, `mercadinho`, `supermercado`	Supermercado	Alimentação
`drogasil`, `pague menos`, `drogaraia`, `drogarias pacheco`, `ultrafarma`, `farmacia`	Farmácia	Saúde
`enel`, `light`, `cemig`, `copel`	Energia elétrica	Moradia
`sabesp`	Água	Moradia
`comgás`	Gás	Moradia
`obra` → Pequenas reformas (Moradia) \| `pedreiro` → Serviços profissionais (Trabalho) \| `tv` / `televisão` → Eletrônicos (Compras)	Mapeamento Direto	Moradia / Trabalho / Compras

Desambiguação Inteligente ("Manutenção")

A palavra "manutenção / conserto / reparo" existe tanto em Moradia quanto em Transporte. O bot analisa o contexto da frase:
• Se tiver carro, veículo, moto, pneu, revisão, oficina → classifica em Transporte → Manutenção.
• Se tiver casa, apto, apartamento, telhado, pintor, encanador → classifica em Moradia → Manutenção.

Aprendizado de Hábito do Fornecedor

Quando você registra um estabelecimento novo (ex: "Padaria Estrela"), o bot cadastra o fornecedor automaticamente. A partir do momento em que sua família tiver pelo menos 2 lançamentos nesse fornecedor (com 60% ou mais na mesma subcategoria nos últimos 20 registros), o bot passa a sugerir:
"Você costuma registrar 'Padaria Estrela' como Alimentação → Padaria. Deseja manter?"

Módulo 6 • Automação Mensal

Compras Parceladas e as 25 Subcategorias Recorrentes

Como o bot calcula o vencimento exato de cada parcela no cartão e quais categorias ativam o convite de recorrência mensal.

Dois jeitos de lançar Compra Parcelada no Cartão (2x a 60x)

A

Frase completa (com valor e parcelas): Use R$ antes do valor ou a palavra por.
Exemplos: Comprei celular por 2400 em 12x ou Comprei sofá R$ 3000 em 10 parcelas. O bot já divide as parcelas (ajustando os centavos na primeira parcela se a divisão não for exata) e pede apenas para escolher o cartão.
B

Frase em duas etapas (sem informar o valor de início):
Exemplo: Comprei geladeira em 10x. O bot responde: "💳 Entendi: geladeira em 10 parcelas. Qual é o valor total da compra?". Você digita 3200 e escolhe o cartão!

As 25 Subcategorias que oferecem Recorrência Mensal Automática

Sempre que você confirma um lançamento em conta bancária pertencente a uma das 25 subcategorias abaixo, o recibo exibe os botões "🔄 Sim, todo mês" e "❌ Apenas este mês":

📌 5 Subcategorias Recorrentes VARIÁVEIS (pedem confirmação do valor no mês seguinte):

📌 20 Subcategorias Recorrentes FIXAS (lançamento automático no mesmo dia de cada mês):

Módulo 7 • Inteligência de Dados

Guia Completo de Perguntas em Linguagem Natural

Você pode perguntar seus gastos, receitas ou saldo combinando qualquer categoria, fornecedor ou período de tempo.

O que você quer consultar	Palavras-chave que o Bot reconhece	Exemplos Práticos para copiar e usar
1. Tipo de Métrica (Gastos, Receitas ou Saldo)	• Saldo: `sobrou`, `sobra`, `saldo`, `economizamos`, `poupamos`, `guardamos` • Receitas: `recebemos`, `recebi`, `receita(s)`, `ganhamos`, `renda`, `entrou`, `faturamos` • Despesas: `gastamos`, `gastei`, `gasto(s)`, `despesa(s)`, `pagamos`, `custou`, `saiu`	Quanto sobrou este mês? Qual o total de receitas este ano? Quanto gastamos no mês passado?
2. Apelidos de Categorias (Atalhos rápidos)	• `comida / alimentos` → Alimentação • `casa` → Moradia • `carro` → Transporte • `filho / filha / criança` → Filhos • `assinatura(s)` → Assinaturas e Serviços Digitais • `pet / pets / animais` → Animais de Estimação • `lazer / diversão` → Lazer e Entretenimento • `beleza / higiene` → Higiene e Cuidados Pessoais • `viagem` → Viagens	Quanto gastamos com comida este mês? Quanto gastei com o carro este ano? Qual o gasto com pets nos últimos 3 meses?
3. Períodos de Tempo (Numéricos ou por extenso de "um" a "doze")	• `hoje`, `ontem`, `esta semana`, `semana passada` • `este mês / mês atual`, `mês passado / mês anterior` • `este ano`, `ano passado`, `último ano` (12 meses) • `últimos X dias / semanas / meses / anos` (ex: últimos 3 meses ou últimos três meses) • Nome do mês ou ano específico: `janeiro`, `março de 2026`, `2025`	Quanto gastamos em setembro? Quanto gastamos nos últimos 15 dias? Quanto gastei com Uber nas últimas duas semanas?
4. Busca por Fornecedor ou Termo Livre	Qualquer nome de loja, marca ou palavra gravada na descrição (com 3 letras ou mais) que não seja uma categoria oficial.	Quanto gastamos com Netflix este ano? Quanto gastei na Drogasil este mês?

Módulo 8 • Limites Operacionais

O que NÃO é possível fazer no ContaCerta

Conheça todas as travas de segurança e o que o bot não processa para evitar dúvidas no uso diário.

1. Não movimenta dinheiro nem pede senhas

O ContaCerta não tem acesso à sua conta bancária real (Open Finance), não paga boletos reais no banco e jamais solicita senhas ou tokens bancários.

2. Não lê fotos, comprovantes ou PDFs

O bot aceita exclusivamente texto e áudio/voz. Enviar imagens de notas fiscais, prints de Pix ou arquivos PDF não criará lançamentos.

3. Não registra 2 valores na mesma mensagem

Mensagens com mais de um valor monetário (ex: "Gastei 30 na padaria e 90 no açougue") são recusadas por ambiguidade. Envie um lançamento por vez.

4. Não aceita valores negativos ou zero

Enviar frases como "Gastei -50 no mercado" retorna erro. Informe sempre valores positivos maiores que zero.

5. Não aceita verbo de receita e despesa juntos

Se a mesma frase tiver um indicador de receita e outro de despesa (ex: "Recebi 100 e gastei no mercado"), o bot não consegue classificar o tipo.

6. Não aceita compra parcelada com data futura

Compras no cartão só podem ter a data de hoje ou datas passadas, e o número de parcelas deve estar estritamente entre 2x e 60x.

7. Não permite lançar Receita em Cartão de Crédito

Cartões de crédito são exclusivos para despesas. Toda receita é obrigatoriamente depositada em uma Conta Bancária/Carteira.

8. Não apaga pagamento de fatura individualmente

O lançamento gerado na conta quando você paga uma fatura de cartão possui trava contábil e não pode ser apagado pelo menu Apagar Lançamento.

9. Não apaga pelo bot registros com mais de 30 dias

O menu 🗑️ Apagar Lançamento e o comando de apagar por texto buscam apenas lançamentos dos últimos 30 dias.

10. Não permite estar em 2 famílias nem exceder 6 membros

Cada usuário do Telegram só pode pertencer a uma família ativa por vez, respeitando o teto padrão de 6 integrantes por família.