Como Funciona a Memória

O bot não é uma caixa de perguntas e respostas que esquece tudo quando você fecha o chat. Ele tem uma memória real — mas funciona diferente do que você pode imaginar.

A Analogia Certa

Pensa no bot como um funcionário que tem três coisas:

Um caderno de anotações — onde ele anota o que é importante (os "fatos")
Um histórico completo — onde todas as mensagens que você já mandou ficam guardadas num banco de dados, buscáveis por texto ou data
A conversa atual — o que está sendo dito agora

No dia a dia, ele consulta o caderno (fatos) antes de responder. Mas se precisar, ele pode buscar qualquer mensagem passada no histórico completo — basta pedir: "o que eu falei ontem sobre X?"

O que é um "Fato"?

Fato é a unidade básica da memória do bot. É uma informação curta e objetiva que foi extraída de uma conversa e guardada no banco de dados.

Exemplos de fatos:

"Diego prefere relatórios às 8h da manhã"
"O número da Alfa Tech é (94) 9182-9757"
"Projeto Papo Alfa é um podcast com entrevistas de empreendedores"
"Lael deve reagir a toda mensagem antes de responder"

Cada fato tem um nível de importância (1 a 10) e uma data de quando foi registrado.

Como os Fatos são Criados?

🤖 Automaticamente

A cada 5 minutos, um processo roda em segundo plano e analisa as conversas recentes. Se identificar algo importante — uma preferência, um dado de contato, uma decisão — ele extrai e salva como fato.

Você não precisa fazer nada. O bot faz isso sozinho.

📝 Por pedido seu

Você pode pedir explicitamente:

"Guarda que eu prefiro receber relatórios em texto, não em tabela"

"Lembra que o meu telefone novo é 99999-1234"

"Salva que a reunião de segunda sempre é às 14h"

Quando você diz isso, o bot registra como fato com prioridade maior.

Como o Bot Usa a Memória?

Antes de cada resposta, o bot busca no banco os fatos mais relevantes para aquela mensagem. Ele usa texto da mensagem, contexto da conversa e histórico para escolher quais fatos injetar.

É como se, antes de te responder, ele abrisse o caderno e lesse as anotações mais úteis pra aquele momento.

O Histórico Completo (Banco de Mensagens)

Todas as mensagens que você troca com o bot ficam armazenadas permanentemente num banco de dados. Nada se perde. O bot pode buscar qualquer conversa passada — por texto, por data, por pessoa.

Como usar:

"O que eu falei ontem sobre a reunião?"

"Busca a mensagem do Fernando sobre o preço da soja"

"O que aconteceu no grupo de manhã?"

O bot vai direto no histórico e encontra.

Importante: o bot não consulta o histórico inteiro antes de cada resposta (seria lento demais). Ele consulta os fatos resumidos. Mas se você pedir pra buscar algo específico, ele vai no histórico completo.

Por que o Bot Pode "Esquecer"?

Mesmo com tudo armazenado, às vezes parece que o bot "esqueceu" algo. Isso acontece porque:

1. O fato nunca foi criado

A informação foi dita em conversa, mas não gerou um fato automático. O histórico tem a mensagem, mas o bot não consultou automaticamente — precisaria que você pedisse.

Solução: peça explicitamente pro bot guardar, ou peça pra ele buscar: "busca o que eu falei sobre X".

2. O fato está desatualizado

Um fato foi criado com uma informação, mas ela mudou depois e ninguém atualizou. O bot pode usar o dado antigo.

Exemplo: você tinha um número de telefone que mudou, mas o fato do número velho ainda existe no banco.

Solução: diga "esse dado tá atualizado?" ou "atualiza meu telefone pra [novo número]".

3. O fato existe mas não foi relevante naquele momento

O sistema busca os fatos mais relevantes. Se havia muitas outras informações mais importantes, o fato que você esperava pode não ter sido injetado.

Fatos Têm Prazo de Validade?

Sim. Com o tempo, fatos pouco usados "decaem" — a importância diminui e eventualmente são arquivados. Isso evita que o banco fique cheio de informações velhas e irrelevantes.

Fatos importantes (importância alta, usados com frequência) ficam por muito mais tempo.

Por Que Parece Que Ele "Esqueceu"?

Pense em alguém que tem acesso a um banco de dados enorme com todas as conversas, mas que acorda todo dia sem lembrar do que aconteceu ontem. Ele pode consultar o histórico e se atualizar — mas precisa saber o que buscar.

Quando você diz "lembra de X?", você tá dando a pista pro bot saber onde procurar.

Cada conversa nova começa "limpa". O bot carrega automaticamente os fatos mais relevantes pra aquele momento, mas não carrega tudo — seria impossível. Então:

✅ Ele provavelmente vai lembrar: quem você é, suas preferências, projetos principais, decisões recentes
⚠️ Ele pode precisar de ajuda pra lembrar: detalhes de uma conversa específica, números exatos, algo que foi dito uma vez só
💡 Como ajudar: dê contexto — "lembra que semana passada a gente falou sobre o projeto X?" funciona muito melhor que "lembra daquilo?"

Isso é normal e faz parte de como a tecnologia funciona hoje. Quanto mais contexto você der, mais rápido o bot encontra o que precisa.

Boas Práticas

✅ Diga explicitamente quando algo é importante pra guardar

"Guarda que a nossa reunião semanal é sempre na terça"

✅ Corrija dados errados logo quando perceber

"Esse número tá desatualizado, meu contato novo é X"

✅ Se o bot trouxer dado errado, questione

"Isso tá certo? Verifica de novo"

✅ Se o bot não lembrar, peça pra buscar

"Busca o que eu falei semana passada sobre o projeto X" O histórico completo tem tudo — o bot só precisa que você peça pra consultar.

Diferença: Memória de Sessão vs Memória de Longo Prazo

Tipo	O que é	Duração
Sessão atual	O contexto da conversa em andamento — o que foi dito nesta conversa	Só enquanto conversa
Fatos (longo prazo)	O que foi extraído e guardado no banco de dados	Permanente (sujeito a decaimento)
Histórico de mensagens	Todas as mensagens passadas (Evolution API + Baileys), buscáveis por texto, data ou remetente	Permanente

O bot usa os três ao mesmo tempo. A sessão atual tem prioridade, depois os fatos injetados, e o histórico pode ser buscado quando necessário.