Cliente pediu "quero marcar", bot respondeu "vou checar com a Bella e te aviso". Você queria ele agendar sozinho. Algo está faltando.
5 pré-requisitos pro bot agendar
O bot só cria agendamento via tool criarAgendamento se TODOS esses estão satisfeitos:
Pelo menos 1 agenda criada (em Configurações → Agendas)
Agenda tem modo de atendimento configurado (por horário, período, ou dia inteiro)
Agenda tem horário de funcionamento (pelo menos 1 dia da semana)
Pelo menos 1 serviço associado à agenda (com nome e duração)
Persona do bot ativa (em Configurações → IA)
Se UMA dessas falta, bot não tenta agendar — escala pra você.
Diagnóstico — 4 verificações rápidas
1. Agenda existe e tá ativa?
Em Configurações → Agendas:
- Tem pelo menos 1 agenda na lista? Se não → cria.
- Agenda existe mas suspensa? Reativa.
2. Serviços vinculados?
Click na agenda → seção "Serviços". Deve ter ≥ 1.
Sem serviço, bot não sabe o que oferecer ("agendar o quê?").
3. Horário de funcionamento abrange o que cliente pediu?
Se cliente pede "domingo às 22h" e sua agenda só funciona segunda a sábado 9-19h, bot vai oferecer outro horário (não vai criar pra fora do funcionamento).
Confere Configurações → Agendas → [agenda] → Horário.
4. Conversa não está pausada?
Em /conversas/[id], header mostra status:
- 🟢 Bot ativo → pode agendar
- 🟡 Pausa automática até meia-noite → bot não responde até reset (cron 00:05 BRT) ou você reativar manualmente
- 🔴 Pausa manual → você assumiu a conversa, bot não opera mais
Se pausada, reativa clicando no botão Play no header.
Cenário: bot diz "vou anotar e te aviso" toda hora
Esse texto padrão é o fallback do bot quando ele:
- Não tem ferramentas disponíveis (agenda não configurada)
- Tools disponíveis mas falharam
- Cliente pediu coisa fora do escopo
Confira logs em /admin/conversas/[id]/debug (se admin) — mostra:
- Quais tools estavam disponíveis
- Qual tool foi chamada
- Resposta da tool
Se aparece "agendaTools: []" → significa agenda não está como ativa em Configurações → Negócio → Agenda inteligente.
Cenário: bot agenda no horário errado
Cliente pediu "sexta de manhã", bot agendou pra terça de tarde. Causas:
- Slot oferecido por engano: bot pode ter alucinado horário (raríssimo)
- Cliente confirmou outro horário (releu mensagem do bot e clicou no horário errado)
- Persona instruiu bot a "sempre oferecer manhã": revisa persona em
/configuracoes/ia → Persona
Fix imediato: você reagenda manualmente pelo card do agendamento (clica → Remarcar → escolhe horário certo). Bot avisa cliente automaticamente.
Cenário: cliente perguntou "qual horário tem amanhã" e bot não respondeu
Bot deveria chamar tool verificarDisponibilidade. Se não chamou:
- Agenda inteligente desativada: verifica em Configurações → Negócio
- OpenRouter caiu (raro): tente de novo em 1min
- Pergunta foi muito ambígua: ex "tem horário?" sem contexto. Bot pode pedir esclarecimento
Se persiste, manda printscreen da conversa pro suporte.
Bot agendou conflito de horário
2 clientes no mesmo slot. Erro grave. Causas:
- Race condition entre 2 mensagens simultâneas (extremamente raro mas existe)
- Bot chamou tool sem checar disponibilidade primeiro (bug conhecido — reportar)
Fix imediato: reagende um dos 2 manualmente, comunica cliente.
⚠️ Reporta pro suporte com prints — TMB precisa investigar a race condition.