Problemas comuns

Os problemas mais frequentes e como resolver — a maioria em menos de um minuto.

O bot não responde

• Painel → Visão geral: o agente está online? Se não, clique em Reiniciar.
• Está “digitando...” há muito tempo? Tarefas longas levam minutos. Pra abortar: /stop.
• Conversa muito longa pode deixar o agente confuso — /new começa do zero (a memória de longo prazo permanece).
• Nada disso resolveu? Rode o Diagnóstico no painel e veja os Logs.

“API key rejeitada” ou erros de crédito

• Verifique se a key tem crédito no provedor (console da Anthropic ou da OpenAI). Key sem crédito = agente mudo.
• Key revogada ou trocada? Atualize no painel → Modelo & recursos e reinicie.

“Nenhuma mensagem encontrada” ao vincular o Telegram

• Você precisa mandar /start pro seu bot (o que você acabou de criar) — não pro BotFather.
• Mande a mensagem e clique em “Detectar meu Telegram” logo em seguida.

Outra pessoa tentou falar com o bot e nada aconteceu

Comportamento correto: o agente só responde ao Telegram vinculado na criação. Todo o resto é ignorado, de propósito.

Mensagens de voz não são entendidas

• O serviço de transcrição (Passo 5) está configurado? Sem ele, áudio recebido não vira texto.
• A key do Groq tem camada grátis, mas pode expirar ou atingir limite — confira em console.groq.com.

Uma tarefa agendada parou de rodar

Tarefa que falha 10 vezes seguidas é desativada automaticamente. Veja o motivo com /cron status(ou na aba Atividade) e peça por conversa: “reativa a tarefa X”.

Excluí o agente sem querer — dá pra recuperar?

Não. A exclusão é irreversível e destrói servidor, disco e memória. Por isso ela exige confirmação dupla — e por isso o export de memória existe.