Documentação

1. Começando

Crie sua conta informando seu número de WhatsApp — esse número também é o seu login. Você recebe um código de verificação por WhatsApp; depois de confirmar, defina sua senha e pronto, sua conta está pronta pra uso.

A partir daí você pode usar o sistema de duas formas, que se complementam:

• Pelo site: dashboard completo, cadastro de categorias/contas/veículos, relatórios e o Lançamento Fácil.
• Pelo WhatsApp: mande mensagens pro número do sistema a qualquer hora — texto, áudio ou foto — e ele processa sozinho (ver comandos).

2. Lançando gastos e receitas

Três jeitos de registrar um gasto ou recebimento:

Pelo site

Em Transações → Nova transação, preencha tipo, valor, categoria, carteira, descrição e data. Dá pra editar ou excluir qualquer lançamento depois.

Por texto no WhatsApp

Escreva naturalmente, sem comando nenhum — o sistema entende linguagem livre:

Também dá pra perguntar sobre suas finanças em linguagem livre — o sistema sempre calcula a resposta a partir dos seus lançamentos reais, nunca inventa números:

Por áudio ou foto no WhatsApp

Grave um áudio contando o gasto — ele é transcrito e tratado exatamente como se você tivesse digitado. Ou manda uma foto de nota de compra (mercado, farmácia etc.) — o sistema lê o valor total e o nome do estabelecimento e já registra.

A categoria é escolhida automaticamente com base em palavras-chave (ver Categorias) — se nenhuma bater, fica "sem categoria" e você pode corrigir depois.

3. Categorias e orçamentos

Categorias organizam seus gastos e receitas. Cada categoria tem uma lista de palavras-chave — quando a descrição de um lançamento contém uma delas, a categoria é aplicada automaticamente (web, WhatsApp, foto ou áudio). Algumas categorias padrão (Mercado, Transporte, Lazer, Contas, Saúde, Salário...) já vêm cadastradas quando você cria a conta.

Em Orçamentos, defina um limite mensal por categoria pra acompanhar se está gastando dentro do esperado.

Subcategorias

Dá pra criar uma categoria "dentro" de outra — ao cadastrar, só escolher a categoria-mãe. Além de organizar manualmente, o sistema também cria subcategorias sozinho: se uma categoria responder por mais de 20% dos seus gastos no mês, no relatório mensal (ver seção 8) ela é dividida automaticamente, com base nos lançamentos reais daquele mês — por exemplo, "Mercado" virando "Mercado › Compras da semana" e "Mercado › Farmácia".

Quando nenhuma categoria bate

Se a descrição não casar com nenhuma palavra-chave, o sistema pede uma ajuda à IA. Se ela tiver certeza de qual categoria existente serve, aplica sozinha — sem te perguntar nada. Se não tiver certeza, ela pergunta pra você: sugere um nome pra uma categoria nova e lista as categorias existentes que poderiam se encaixar. É só responder com o nome de uma delas, confirmar a sugestão, digitar outro nome, ou "não" pra deixar sem categoria.

Corrigindo a categoria de um gasto

Errou a categoria ou mudou de ideia? Pelo WhatsApp, /recategorizar nome_da_categoria corrige o último lançamento; ou descreva em linguagem livre, tipo "muda a categoria do mercado pra lazer", que o sistema acha o lançamento certo sozinho. Se a categoria não existir ainda, ela é criada na hora.

4. Carteiras

Carteiras representam onde o dinheiro está — dinheiro em espécie, conta corrente, cartão etc. Todo lançamento pertence a uma carteira, e o saldo de cada uma aparece no dashboard. Uma carteira "padrão" é usada automaticamente quando você não especifica (por exemplo, ao lançar pelo WhatsApp).

5. Contas mensais

Para despesas recorrentes (aluguel, internet, assinaturas), cadastre uma conta mensal em Contas Mensais com nome, dia de vencimento e, se o valor for sempre o mesmo, o valor padrão.

Toda segunda-feira de manhã, o sistema manda um lembrete por WhatsApp de cada conta que está vencida ou perto de vencer, e continua lembrando até você confirmar o pagamento. Você pode confirmar de duas formas:

• Pelo site, clicando em Marcar como paga;
• Pelo WhatsApp, respondendo /pagar nome da conta valor (o valor é opcional se a conta já tem um valor padrão).

Ao confirmar, o sistema já cria a transação de despesa correspondente automaticamente.

6. Manutenção de veículos e casa

Em Manutenção, cadastre carros, motos ou a casa. Pra veículos, dá pra registrar a quilometragem atual — o sistema usa seu histórico de KM pra estimar a data provável de cada manutenção vencer, combinando prazo por tempo e por quilometragem (o que vencer primeiro).

Cadastro automático pela foto do documento

Manda uma foto do documento do veículo (CRLV) pelo WhatsApp — o sistema lê marca, modelo, ano e placa, cadastra o veículo sozinho e já sugere (via IA, baseado no modelo) as manutenções mais comuns com os intervalos certos.

Atualizando quilometragem e marcando manutenção feita

Ação	Pelo site	Pelo WhatsApp
Atualizar KM	Na página do veículo	/km nome_do_veículo quilometragem
Marcar manutenção feita	Botão "Marcar como feita"	/feito nome_da_manutenção valor
Ver pendências	Página Manutenção	/veiculos

Manda também uma foto de nota de manutenção (troca de óleo, pastilha de freio etc.) — o sistema registra o gasto com a lista de peças/serviços na descrição e guarda uma cópia da imagem junto do lançamento.

Um veículo ou a casa pode ser marcado como inativo quando você se desfizer dele — ele some das pendências e lembretes, mas o histórico continua acessível.

7. Extratos bancários e faturas de cartão

Cadastre suas contas bancárias e cartões de crédito em Extratos. Todo início de mês (e diariamente, até você enviar) o sistema pede pelo WhatsApp o extrato ou fatura do mês anterior de cada conta ativa.

Basta mandar uma foto ou PDF do extrato/fatura. O sistema lê todos os lançamentos e concilia automaticamente:

• Lançamentos que você já tinha registrado manualmente são reconhecidos e não duplicados — se a descrição ou data do extrato for mais precisa, o lançamento é atualizado (o dado original fica guardado nas observações da transação).
• Lançamentos que você ainda não tinha registrado são criados automaticamente.

Se a conta/cartão ainda não estiver cadastrado, mandar o extrato já cadastra ele automaticamente. Use /extratos pra ver o que ainda está pendente de envio.

8. Relatório mensal automático

Assim que todos os extratos/faturas do mês anterior de todas as suas contas forem recebidos, você recebe automaticamente pelo WhatsApp um relatório com:

• Total gasto, recebido e saldo do mês;
• Gastos por categoria, com um gráfico;
• As maiores despesas individuais do mês;
• Alertas de gasto fora do padrão — categorias que ficaram bem acima da sua média dos últimos meses;
• Se alguma categoria passou de 20% dos gastos, ela já aparece dividida em subcategorias — ver seção 3.

Não precisa pedir nada — é automático, uma vez por mês, assim que os dados estiverem completos.

9. Lançamento Fácil

No dashboard, o botão Lançamento Fácil abre uma página onde você digita, grava um áudio ou manda uma foto — processado pela mesma inteligência do bot do WhatsApp, mas direto do navegador, sem precisar ter o telefone por perto nem número vinculado. Útil quando está no computador ou prefere não usar o WhatsApp pra isso.

10. Comandos do WhatsApp

A qualquer momento, mande /ajuda pra ver esse resumo direto no WhatsApp. Referência completa:

Comando	O que faz
/ajuda	Mostra a lista de comandos
/saldo	Saldo da carteira padrão
/categorias	Lista suas categorias cadastradas
/contas	Contas mensais pendentes
/pagar <conta> [valor]	Marca uma conta mensal como paga
/veiculos	Manutenções pendentes de carro/moto/casa
/km <veículo> <km>	Atualiza a quilometragem de um veículo
/feito <manutenção> [valor]	Marca uma manutenção como feita
/extratos	Extratos/faturas pendentes de envio
/recategorizar <categoria>	Recategoriza o último lançamento
qualquer frase	Lança um gasto/receita ou responde uma pergunta sobre suas finanças (ver seção 2)
foto	Identifica sozinho: documento de veículo, nota de compra, nota de manutenção, extrato ou fatura
áudio	Transcrito e tratado como texto normal

11. Segurança

Cada foto, extrato e lançamento só é acessível por quem é dono dele — mesmo que alguém descubra o link de uma imagem, sem estar logado na conta certa não dá pra ver. A comunicação com o WhatsApp é validada pra garantir que as mensagens vêm mesmo do Twilio, e o número de verificação por código tem limite de tentativas pra evitar força bruta.

12. Dúvidas frequentes

Preciso usar o site e o WhatsApp?

Não — use o que for mais prático em cada momento. Tudo que é lançado por um lado aparece no outro, é a mesma conta.

O sistema erra a categoria às vezes?

Pode acontecer, principalmente se a descrição não bater com nenhuma palavra-chave cadastrada. É só editar a transação pelo site e, se quiser, adicionar a palavra-chave na categoria pra acertar da próxima vez.

Posso usar mais de um veículo, conta bancária ou cartão?

Sim, não tem limite — cada um é controlado separadamente, com suas próprias manutenções, extratos e lembretes.

E se eu mandar uma foto ou áudio que o sistema não entende?

Ele avisa que não conseguiu identificar e pede pra tentar de novo com uma imagem mais nítida, ou sugere registrar manualmente pelo site.