Top Gestão + Super Assistente de IA no WhatsApp
Um assistente pessoal e empresarial que vive no WhatsApp, movido por um SuperMemory na plataforma Max. Ele lê, entende, lembra e age — organizando finanças, compromissos, saúde e lazer, e economizando tokens ao pensar em cima de memória estruturada, não de contexto bruto.
01 Visão geral
Top Gestão é uma plataforma de gestão de vida (pessoal + negócios) e, ao mesmo tempo, um agente de IA no WhatsApp que atua como copiloto do dia a dia. A tese central: a maior parte da nossa vida operacional passa por conversas — combinados com a esposa, cobranças de clientes, prazos, pagamentos, ideias soltas. Hoje isso se perde. O agente captura essas conversas, transforma em memória estruturada e age proativamente em cima delas.
O sistema se divide em duas frentes que compartilham o mesmo cérebro:
Top Gestão (app na plataforma Max)
Finanças pessoais, finanças dos negócios, gestão de compromissos, gestão de saúde e gestão de lazer — dashboards bonitos e interativos, tudo alimentável tanto pela tela quanto pela conversa no WhatsApp.
Agente WhatsApp (Baileys + SuperMemory)
Lê texto/áudio/imagem, transcreve, entende intenção, registra na memória, cria tarefas/lembretes, dispara crons e responde consultas — inclusive conversando com o agente Max que tem acesso a tudo.
Diferencial
Não é um chatbot que responde perguntas. É um assistente com memória de longo prazo que entende compromissos assumidos em conversas e faz o follow-up sozinho — ex.: sua esposa pediu algo, você confirmou, e mais tarde ele te pergunta se você fez.
02 Princípios de projeto
Memória > Contexto
Nada de reprocessar históricos gigantes a cada mensagem. Pensamos em cima de fatos destilados no SuperMemory. Tokens são gastos em decisão, não em releitura.
Proatividade
O agente age antes de ser chamado: lembra prazos, cobra follow-ups, avisa respostas que já sabe, alerta gastos fora da meta.
Círculo de confiança
Uso restrito a pessoas autorizadas. Consentimento explícito por contato sobre o que é mapeado. Dados sensíveis tratados com cuidado.
Controle do usuário
Você decide, por contato, o que mapear (passado e futuro), o que ignorar e a política de novos contatos. Nada é opaco.
Custo previsível
Antes de importar, mostramos estimativa de custo (transcrição de áudio, leitura de imagem, contexto). Você aprova antes de gastar.
Um cérebro, várias bocas
WhatsApp é a interface principal, mas o mesmo cérebro serve o app Top Gestão e o agente Max. Fonte única de verdade.
03 Arquitetura geral
Fluxo de ponta a ponta, do WhatsApp até a ação:
Componentes principais
Gateway WhatsApp (Baileys)
Serviço Node dedicado com sessão persistente, reconexão automática, envio/recebimento, download de mídia e webhooks internos para a plataforma Max.
Pipeline de ingestão
Fila (Redis) desacopla recebimento de processamento. Cada mensagem vira um "evento" idempotente com metadados (autor, chat, tipo, timestamp).
Serviços de mídia
Whisper via Groq para transcrição de áudio; modelo de visão para descrever imagens (com controle de custo e opção de pular).
SuperMemory
Postgres (fatos + relacional) + pgvector (busca semântica) + grafo de entidades. É o cérebro consultado por todos.
Agente / Orquestrador
Recebe consultas, decide ferramentas, lê o SuperMemory, escreve novas memórias, dispara ações. Integra com o agente Max da Claude.
Top Gestão (app Max)
Front bonito e interativo dos módulos financeiro/compromissos/saúde/lazer, lendo e escrevendo no mesmo banco.
04 O Cérebro — SuperMemory
O SuperMemory é o coração do projeto. Em vez de guardar (e reprocessar) conversas cruas, ele destila cada interação em fatos estruturados organizados em camadas, para que o agente responda e aja com pouco token e alta precisão.
As camadas da memória
Raw / Bruta
Mensagem original + mídia + transcrição literal. Guardada comprimida, consultada raramente (auditoria/reprocessamento). Nunca vai inteira ao LLM.
Episódica
Resumo do que aconteceu em cada conversa/período: "Dia 12, Fábio cobrou o relatório X; combinamos entregar sexta." Datada e atribuída.
Semântica / Fatos
Fatos atemporais e entidades: pessoas, preferências, valores recorrentes, contas, contatos, relacionamentos ("aniversário da esposa em X", "cliente Y paga dia 5").
Compromissos & Ações
Promessas, pedidos, prazos e tarefas com estado (aberto/feito/atrasado) e origem rastreável até a mensagem. É o que gera follow-up proativo.
Perfil / Identidade
Perfil consolidado por usuário e por contato: rotina, tom, metas, o que importa. É o "system prompt vivo" do agente para cada pessoa.
Como uma mensagem vira memória
- Normaliza — texto limpo (ou transcrição do áudio / descrição da imagem).
- Extrai — um passo de LLM tira fatos, entidades, intenções, datas e valores em JSON estruturado.
- Resolve entidades — liga "minha esposa", "Fábio", "cliente do mercado" às entidades já conhecidas (grafo).
- Deduplica & atualiza — funde com o que já existe; corrige fatos que mudaram (ex.: valor de uma dívida caiu).
- Indexa — embedding para busca semântica + tags para busca estruturada.
- Dispara gatilhos — se virou compromisso/prazo, cria tarefa/lembrete no motor de ações.
Como o agente consulta (barato)
Ao chegar uma mensagem nova, o agente não relê a conversa toda. Ele faz uma recuperação dirigida: busca no SuperMemory apenas os fatos, compromissos e perfil relevantes àquele contato e assunto (top-K por relevância), monta um contexto enxuto e responde. O histórico bruto só entra se explicitamente necessário.
Resultado prático
Responder "o que o Fábio me pediu essa semana?" custa uma busca vetorial + poucos fatos no prompt — não a releitura de centenas de mensagens.
05 Que dados úteis o agente coleta
A partir do que já foi conversado, o agente destila sinais de alto valor. Exemplos concretos por categoria:
| Categoria | O que é extraído | Para que serve |
|---|---|---|
| Compromissos pessoais | "buscar remédio", "pagar o boleto", pedidos da esposa/família | Follow-up: "você fez o que a Ana pediu?" · lembrete no horário certo |
| Compromissos de trabalho | Entregas prometidas a clientes/sócios, reuniões, cobranças | Cobrança automática de prazos · agenda · status por cliente |
| Financeiro | Valores combinados, pagamentos a receber/pagar, dívidas, vencimentos | Lança em Finanças · alerta de vencimento · fecha o caixa mental |
| Datas & eventos | Aniversários, viagens, consultas, prazos, "semana que vem" | Cria eventos na agenda · lembra com antecedência |
| Perguntas pendentes | Alguém te perguntou algo e você não respondeu | "Fulano te perguntou X — quer que eu responda? Já sei a resposta." |
| Preferências & pessoas | Gostos, restrições, relacionamento, tom de cada contato | Respostas mais humanas · sugestões (presente, restaurante) |
| Negócios | Serviços vendidos, valores, status de entrega, leads | Alimenta o módulo Meus Negócios · mede lucro e pendências |
| Saúde | Consultas, exames, sintomas mencionados, remédios | Estrutura exames/consultas · lembra de tomar/agendar |
Cenário-âncora (o pedido da esposa)
Mensagem da esposa: "amor, passa na farmácia e pega o remédio da vó?" → você responde "deixa comigo". O agente extrai um compromisso (autor: esposa; responsável: você; ação: comprar remédio; estado: assumido). À noite ele te cutuca: "Você chegou a pegar o remédio da vó que a Ana pediu?" — e, se você disser que não, vira lembrete para amanhã.
06 Estratégia de economia de tokens
Custo é requisito de projeto. Táticas aplicadas em todo o pipeline:
1. Memória destilada, não contexto bruto
O agente lê fatos (L1–L4), não conversas inteiras. O prompt de resposta é pequeno e dirigido.
2. Recuperação top-K
Busca vetorial + filtros por contato/assunto trazem só o essencial. Limite rígido de tokens de contexto por resposta.
3. Modelos por tarefa (roteamento)
Extração e classificação em modelo barato/rápido; raciocínio complexo só quando precisa. Whisper via Groq é barato e veloz.
4. Batelada & agendamento
Extração roda em lote e em horários definidos, não a cada palavra. Mensagens triviais ("ok", "kkk") são filtradas antes do LLM.
5. Cache & deduplicação
Fatos repetidos não são reprocessados. Prompts de sistema reaproveitados via cache do provedor.
6. Gatilhos, não polling
O agente só "pensa" quando há evento relevante ou cron; não fica relendo tudo em loop.
Regra de ouro
Toda mensagem que chega tem duas perguntas baratas antes de gastar raciocínio caro: (a) isso é relevante? (b) já sei a resposta pela memória? Só o que sobra vai para o modelo grande.
07 Camada WhatsApp (Baileys)
Gateway em Node.js usando Baileys (WhatsApp multi-device, sem API oficial), com sessão persistente e reconexão automática. Ele é os olhos e a boca do agente.
Captura
Texto, áudio (voz), imagens, contatos e metadados de grupo. Vídeo é ignorado nesta versão. Cada evento é enfileirado com autor, chat, tipo e timestamp.
Transcrição de áudio
Áudios enviados e recebidos vão para Whisper via Groq — rápido e barato. A transcrição vira texto de primeira classe na memória.
Leitura de imagem
Imagens passam por modelo de visão que descreve/extrai texto (comprovantes, prints). Opcional e sob controle de custo.
Envio & interação
O agente responde no WhatsApp, faz perguntas de follow-up, envia lembretes e confirma ações. Tom natural, humano.
Tipos de mensagem e tratamento
| Tipo | Tratamento | Custo |
|---|---|---|
| Texto | Direto para extração (após filtro de trivialidade) | Baixo |
| Áudio / voz | Whisper (Groq) → texto → extração | Médio |
| Imagem | Visão → descrição/OCR → extração (opcional) | Médio |
| Contato | Adiciona/atualiza entidade "pessoa" no grafo | Baixo |
| Grupo | Contabilizado; mapeamento opcional (ruído alto) | Config |
| Vídeo | Ignorado nesta versão | — |
08 Importador inicial & estimativa de custos
Ao conectar o WhatsApp, o agente faz um onboarding da memória: varre as conversas recentes para dar um "passado" ao assistente — mas sempre com você no controle e vendo o custo antes.
Escopo padrão do import
Tela do importador
Uma interface de revisão mostra, por conversa, uma prévia quantificada antes de gastar qualquer token:
| Conversa | Texto | Áudio | Imagem | Grupo? | Custo estimado | Ações |
|---|---|---|---|---|---|---|
| Ana (esposa) | 34 | 6 | 3 | — | R$ 0,12 | Mapear passado+ futuro |
| Fábio Mariano | 40 | 12 | 2 | — | R$ 0,21 | Mapear passado+ futuro |
| Cliente X | 28 | 1 | 5 | — | R$ 0,09 | Mapear passado |
| Grupo Família | 40 | 3 | 9 | Sim | R$ 0,15 | Ignorar |
Valores ilustrativos. O custo real é calculado com base em: segundos de áudio (Whisper/Groq), nº de imagens (visão) e tokens de contexto (extração).
Controles por contato (decisão individual)
Mapear mensagens passadas
Marca/desmarca importar o histórico recente daquele contato para a memória.
Mapear mensagens futuras
Decide se conversas novas com esse contato continuam sendo mapeadas dali em diante.
Ignorar contato
Desmarca conversas que você não quer na memória (privadas, irrelevantes).
Política de novos contatos
Um interruptor global: novos contatos que te chamarem entram automaticamente no mapeamento — ou ficam de fora até você aprovar.
Aprovação antes do gasto
Nenhuma transcrição ou leitura de imagem acontece antes de você revisar a estimativa e confirmar. Você aprova em bloco ou conversa a conversa.
Como o custo é estimado
🎙️ Áudio
Σ segundos de áudio × preço/minuto do Whisper (Groq). Contabilizado por conversa.
🖼️ Imagem
nº de imagens × custo médio de leitura por imagem no modelo de visão.
💬 Contexto
tokens estimados das mensagens de texto × preço do modelo de extração.
09 Motor de ações — tarefas, lembretes & crons
Memória sem ação é só arquivo. O motor de ações transforma fatos em iniciativa. Tudo que tem data, prazo ou aviso pode ser registrado e cobrado pelo agente.
Tarefas
Geradas de compromissos detectados ou criadas por comando. Têm responsável, prazo e estado; entram no módulo de Compromissos.
Lembretes
"Me lembra de X às 18h" ou automáticos por prazo. Disparam no WhatsApp na hora certa.
Crons diários
Rotinas agendadas: resumo do dia de manhã, checagem de pendências à noite, alerta de vencimentos, relatório semanal.
Follow-ups
Cobra compromissos assumidos ("você fez o que pediram?") e fecha o loop atualizando o estado.
Respostas antecipadas
Se alguém te pergunta algo que o agente já sabe pela memória, ele te avisa a resposta — ou se oferece para responder.
Alertas
Estouro de limite de categoria, meta de gasto em risco, dívida vencendo, exame atrasado.
Exemplos de crons diários
| Horário | Cron | O que faz |
|---|---|---|
| 07:30 | Bom dia executivo | Agenda do dia, tarefas por prioridade (urgente/médio/tranquilo), contas a pagar |
| 13:00 | Check financeiro | Gastos do dia vs. limites de categoria; alerta se algo estourou |
| 21:00 | Fechamento do dia | Cobra follow-ups pendentes, pergunta o que foi feito, reprograma o que ficou |
| Seg 08:00 | Resumo semanal | Faturamento dos negócios, metas, dívidas quitadas, saúde da semana |
10 Top Gestão — Finanças pessoais
Dashboard bonito e interativo na tela inicial, com botão + para lançar receita/despesa em segundos (pela tela ou por mensagem no WhatsApp).
O dashboard também mostra metas de ganho e metas de gasto com progresso visual.
Categorias personalizadas
Categorias de receita e de gasto criadas pelo usuário. Na criação de uma categoria de receita, há a opção "Reserva": ao marcar, uma % da entrada é automaticamente aportada na reserva de emergência.
Metas
Criar meta com nome, valor total e prazo. Ao definir o valor total, o sistema divide em parcelas (quantas couberem no prazo) e mostra um progresso visual até a conclusão.
Dívidas
Visão geral: total de todas as dívidas, soma das parcelas mensais e quantas já foram quitadas.
Criar dívida: nome, valor total, tipo (CartãoEmpréstimoFinanciamentoParcelamentoOutros), descrição, valor da parcela, nº de parcelas e data de início.
Progresso de quitação por dívida, com status de cada parcela: Paga ou Pendente.
Investimentos
Total investido, valor inicial, rendimento e rentabilidade (%), com infográficos interativos.
Criar investimento e registrar aportes: valor, data e a qual investimento pertence.
Limites por categoria
Cada categoria tem um limite editável. Ex.: Mercado — define quanto pode gastar e o sistema mostra quanto já foi gasto, com alerta ao se aproximar/estourar.
Reserva de emergência
Total aplicado, saques e saldo. Meta da reserva (valor) com barra de progresso.
Aportes vêm das categorias de receita marcadas como "Reserva" (aporta % da entrada) e também podem ser manuais. Saques registrados e refletidos no saldo.
Cartão de crédito & formas de pagamento
Cadastro de cartões: nome, limite e data da fatura.
Ao criar uma despesa, escolhe-se a forma de pagamento: PixDébitoCartão de créditoDinheiro. Selecionando cartão, escolhe-se qual, respeita-se o limite e a transação é anotada na fatura.
Plano financeiro
Valor total e valor inicial, data inicial e final, com progressão do plano exibida de forma bonita e interativa.
11 Top Gestão — Meus negócios
Gestão financeira dos negócios, com dashboard próprio.
Criar negócio
Nome do negócio, tipo de serviço e meta mensal.
Serviços dentro do negócio
Cada serviço tem: nome, valor final, valor de custo (o sistema calcula o lucro), descrição e status.
Status de recebimento: Recebido / Não recebido. Status de entrega: EntreguePendenteCancelado.
Dashboard & filtros
Seleção de todos os negócios ou por tipo de negócio, com filtro de datas e gráficos interativos bonitos.
12 Gestão de compromissos
Agenda semanal com configuração de horário de trabalho e um dashboard com as tarefas do dia por prioridade.
🔴 Urgente
Prioridade máxima do dia.
🟡 Médio
Importante, sem estourar hoje.
🟢 Tranquilo
Pode aguardar/encaixar.
Criar evento
Nome, data, horas, avisos e descrição. Integrado ao motor de lembretes (dispara no WhatsApp).
Inteligência de tempo
Controle de tempo, ganhos estimados por hora, ranking de serviços mais rentáveis e cálculo de custo de oportunidade — para decidir onde vale investir seu tempo.
13 Gestão de saúde
Água & alimentação
Registro de ingestão de água e refeições, com metas diárias e acompanhamento.
Academia & movimento
Consistência de exercícios, caminhadas, alongamentos e momentos de pausa — com streaks e lembretes.
Exames & consultas (estrutura)
Estrutura para acompanhar: SangueOftalmoNutricionistaVitaminasDentista. Cada item guarda última data, próxima data recomendada, resultados/anotações e lembrete de renovação.
Sugestão de estrutura
Cada categoria de saúde vira um "trilho" com meta, histórico e próxima ação. O agente cobra: "faz 6 meses do exame de sangue — quer que eu agende um lembrete?".
14 Gestão de lazer
Módulo para direcionar momentos recreativos com a família, com foco em custo-benefício e roteiro pronto.
Busca por cidade
Procura lugares por cidade e dá dicas de pontos bons para ir com a família.
Custo-benefício
Avalia opções por preço vs. qualidade e sugere o melhor para o momento.
Roteiro
Monta um roteiro do passeio (ordem, horários, orçamento estimado).
Integração inteligente
Como o agente conhece sua agenda e seu orçamento, ele sugere lazer que cabe no seu tempo e no seu bolso — e pode já bloquear o horário na agenda de compromissos.
15 Integração com a plataforma Max
O agente do WhatsApp e o app Top Gestão vivem dentro da plataforma Max (VPS cérebro). O agente Max da Claude tem acesso ao mesmo SuperMemory, então uma consulta feita ao Max pode responder com base em tudo que o assistente já sabe — e vice-versa.
Fonte única de verdade
WhatsApp, app e agente Max leem/escrevem o mesmo banco e a mesma memória. Sem silos.
Consulta cruzada
Pergunta ao Max: "quanto gastei em mercado esse mês e o que o Fábio me pediu?" — resposta combinando finanças + memória de conversas.
Ferramentas do Max
O agente pode usar as capacidades da plataforma (crons, navegador, publicação, VPS) quando fizer sentido para executar uma tarefa.
Multiusuário
Memória e permissões isoladas por usuário (você e o Fábio), cada um com seu perfil, contatos e dados — no mesmo cérebro.
16 Segurança, privacidade & consentimento
Círculo fechado
Acesso restrito a pessoas de confiança. Sem exposição pública do agente.
Consentimento granular
Por contato: mapear passado, mapear futuro, ignorar. Política clara para novos contatos.
Dados sensíveis
Conversas e mídia guardadas com controle de acesso; camada bruta separada e de acesso restrito.
Direito ao esquecimento
Possibilidade de apagar a memória de um contato ou período a qualquer momento.
Rastreabilidade
Todo fato aponta para a mensagem de origem — dá para auditar de onde o agente tirou algo.
Ética de proatividade
O agente cutuca você, nunca terceiros sem sua ordem. Ele sugere respostas, você decide enviar.
Nota importante
Baileys é uma integração não-oficial. O uso é pessoal e restrito ao círculo de confiança, respeitando os termos e a privacidade dos contatos, com consentimento como padrão.
17 Stack técnico (proposto)
| Camada | Tecnologia | Papel |
|---|---|---|
| Canal | Baileys (Node.js) | Gateway WhatsApp multi-device |
| Fila / eventos | Redis | Desacoplar ingestão de processamento |
| Transcrição | Whisper via Groq | Áudio → texto (rápido e barato) |
| Visão | Modelo de visão | Imagens → descrição/OCR (opt-in) |
| Extração / raciocínio | LLM roteado (Claude via Max) | Fatos, intenções, respostas, ações |
| Memória relacional | PostgreSQL | Fatos, tarefas, finanças, entidades |
| Busca semântica | pgvector | Recuperação top-K de memórias |
| Agendamento | Crons da plataforma Max | Rotinas diárias/semanais, lembretes |
| App / UI | Top Gestão (na plataforma Max) | Dashboards e módulos de gestão |
| Hospedagem | VPS cérebro (Max) | Orquestração central |
18 Roadmap por fases
Fundação & canal
Gateway Baileys estável, ingestão em fila, Whisper/Groq, esqueleto do SuperMemory. Conectar e receber/enviar.
Importador & consentimento
Tela de import com contagem por tipo, estimativa de custo e controles por contato (passado/futuro/ignorar/novos).
Extração & memória viva
Pipeline de extração de fatos/compromissos, grafo de entidades, recuperação top-K barata, perfis por usuário/contato.
Motor de ações
Tarefas, lembretes, crons diários, follow-ups proativos (cenário da esposa), respostas antecipadas.
Top Gestão — Finanças
Módulos pessoal e negócios completos: dashboards, categorias, metas, dívidas, investimentos, limites, reserva, cartões, plano.
Compromissos, Saúde & Lazer
Agenda semanal, inteligência de tempo, trilhos de saúde/exames e roteiros de lazer com custo-benefício.
Integração total com o Max
Consulta cruzada finanças + memória, ferramentas do Max, multiusuário e refino de custo/UX.
Top Gestão + Super Assistente Max AI — Documento de produto e arquitetura · v1.0 · uso interno.
Cérebro na plataforma Max · Canal WhatsApp (Baileys) · Transcrição Whisper/Groq · Memória em Postgres + pgvector.