Perguntas Frequentes (FAQ)

Respostas diretas pras dúvidas mais comuns sobre como os bots funcionam.

💬 Interação Básica

O bot lê meus áudios?

Sim. O bot recebe o áudio, transcreve pra texto, e processa. Mas a transcrição pode ter erros — principalmente com nomes próprios, números e sotaques fortes. Se o bot entendeu errado, corrija com texto.

Preciso falar de um jeito especial?

Não. Fale natural, como falaria com um colega de trabalho. Só seja claro sobre o que quer — inclua contexto, escopo e prazo quando possível.

O bot responde em grupo?

Sim, mas depende da configuração:

Em alguns grupos ele responde só quando mencionado (@nomedele)
Em outros ele responde a qualquer mensagem
Pergunte ao administrador como está configurado no seu grupo

O bot pode me responder por áudio?

Sim, se o dono configurou essa função. Peça: "me manda um áudio explicando isso". Se não estiver ativado, ele vai responder por texto.

🧠 Memória

O bot lembra de tudo que eu falo?

Sim e não. Todas as mensagens ficam armazenadas — o bot pode buscar qualquer conversa passada se você pedir. Mas no dia a dia, ele não relê tudo automaticamente — ele usa os "fatos" (resumos extraídos) como atalho.

A memória funciona em camadas:

Arquivo completo — todas as mensagens, sempre disponíveis. Peça: "busca o que eu falei sobre X"
Fatos — resumos extraídos automaticamente ou por pedido seu. São consultados antes de cada resposta
Sessão atual — o que está sendo dito agora

Por que o bot "esqueceu" algo que eu falei?

Na maioria das vezes, ele não esqueceu — só não consultou automaticamente. Possibilidades:

Não gerou um fato — a informação está no arquivo completo, mas não foi extraída como fato. Peça: "busca o que eu falei sobre isso"
Fato desatualizado — o fato foi salvo com uma informação antiga. Peça pro bot verificar de novo
Não foi relevante naquele momento — o bot prioriza os fatos mais relevantes pra cada conversa. Se tinha muita coisa mais importante, aquele fato pode não ter sido injetado

Como faço o bot lembrar de algo?

Diga explicitamente:

"Guarda que eu prefiro relatórios em texto, não em tabela"
"Lembra que o prazo do projeto X é dia 15"
"Salva isso: meu telefone novo é 99999-1234"

Os fatos salvos podem estar errados?

Sim. Fatos são extraídos automaticamente e podem conter dados desatualizados — preços antigos, status que mudou, números que foram corrigidos depois. Se o bot apresentar um dado que parece errado, peça: "verifica isso de novo na fonte".

⚡ Tarefas e Automações

Qual a diferença entre pedir algo agora e algo recorrente?

Agora: "me manda o preço da soja" → o bot faz uma vez e pronto
Recorrente: "todo dia às 8h me manda o preço da soja" → o bot configura um alarme interno e faz automaticamente

Se você quer algo recorrente, diga explicitamente que é recorrente. Um pedido casual não vira automático sozinho.

O que é um "comando rápido"?

É uma palavra ou frase que aciona um processo específico, sempre da mesma forma. Tipo um botão.

Exemplo: /novaop no MiguelAntônio cria uma Ordem de Pagamento. Você não precisa explicar nada — o bot já sabe o fluxo e vai pedindo as informações na ordem certa.

Cada bot tem seus próprios comandos. Pergunte ao seu bot: "quais comandos você tem?"

Posso pedir pro bot fazer algo todo dia sem saber termos técnicos?

Sim! Você não precisa saber o que é um "cron" ou "agendamento". Diga naturalmente:

"Todo dia às 7h me manda um resumo"
"Toda segunda me lembra de fazer X"
"Me avisa quando o dólar passar de 5.50"

O bot entende e configura por baixo dos panos.

🔧 Problemas Comuns

O bot não respondeu. O que aconteceu?

Possíveis causas:

Sobrecarga temporária — o servidor de IA que o bot usa pode estar lento. Espere 1-2 minutos e tente de novo
Não foi mencionado — em grupos configurados pra responder só com menção, o bot não responde sem @
Mensagem não chegou — raramente, mensagens podem se perder no caminho. Mande de novo

O bot fez algo diferente do que eu pedi

Provavelmente a instrução estava ambígua. Corrija dizendo:

O que era pra ser (não só "errado")
O contexto que faltou ("era da fazenda X, não da Y")

O bot pode perguntar: "da próxima vez, faço assim?" — confirme e ele aprende.

O bot respondeu com uma informação antiga

Fatos na memória do bot podem ficar desatualizados. Diga: "verifica isso de novo" ou "esse dado tá atualizado?". O bot vai buscar na fonte ao invés de confiar na memória.

Posso usar o bot no grupo e no privado?

Depende da configuração. Geralmente:

Grupo: o bot participa e responde conforme configurado
Privado (DM): só funciona se você foi autorizado pelo administrador

📖 Glossário Simples

Se o administrador ou alguém técnico usar esses termos, aqui está o que significam na prática:

Termo técnico	O que significa pra você
Skill	Uma coisa que o bot aprendeu a fazer — tipo um treinamento ou especialização. Cada skill dá ao bot uma nova capacidade (buscar preços, fazer análise de dados, criar carrosséis, etc.)
Protocolo	Uma regra da casa que o bot sempre segue — sem precisar que você lembre ou peça. Exemplo: "sempre reagir antes de responder", "nunca revelar senhas"
Cron	Um despertador programado — algo que o bot faz sozinho no horário certo, todo dia ou toda semana, sem você precisar pedir
Monitor / Dumb Monitor	Um vigia automático e silencioso — fica verificando algo em segundo plano (se um servidor tá no ar, se o backup rodou) e só aparece quando dá problema
Memória / Fato	O bot tem duas camadas: fatos resumidos (acesso rápido no dia a dia) e histórico completo de todas as mensagens. Fatos são usados automaticamente; o histórico pode ser buscado quando necessário
Comando	Um atalho fixo — você digita e o bot executa sempre da mesma forma, sem precisar de contexto extra
Onboarding	A primeira conversa — o bot te conhece e aprende como você funciona
Heartbeat	O "está vivo" do bot — uma verificação automática periódica que mantém o sistema ativo

🆘 Ainda tem dúvida?

Pergunte diretamente pro bot: "como você funciona?" ou "o que você sabe fazer?". Ele vai te explicar no contexto dele.

Se o problema for técnico (bot fora do ar, erro repetido), fale com o administrador.