Chatbot - Configurações
O que é
A página de Configuração do Chatbot WhatsApp centraliza os ajustes que controlam como o assistente virtual responde aos clientes da sua empresa. É aqui que se liga ou desliga o bot, define a personalidade (nome e instruções para a IA), redige as mensagens automáticas usadas em boas-vindas, fora do horário e transferência para atendente, além de configurar a agenda de atendimento dia a dia.
O usuário chega nesta página depois de ativar o módulo Chatbot WhatsApp e conectar a instância. É o primeiro lugar a visitar antes de começar a operar o bot, e o local de retorno sempre que precisar ajustar o tom de voz, horários ou textos padrão. As alterações são persistidas no modelo ChatbotConfig, único por empresa.
Como usar
- Vá em Chatbot WhatsApp > Configuração no menu lateral.
- No primeiro card, use o toggle verde (canto superior direito do bloco "Chatbot WhatsApp") para ativar ou desativar o bot. A mudança é salva automaticamente ao clicar no toggle.
- No card Personalidade, preencha:
- Nome do assistente - como o bot deve se apresentar (ex: "Assistente da Rota Azul"). Se ficar em branco, o sistema usa o nome da sua empresa.
- Instruções personalizadas - texto livre que orienta a IA sobre tom, foco do negócio e regras de conduta. Limite de 5.000 caracteres.
- No card Mensagens, escreva os textos automáticos:
- Mensagem de boas-vindas - enviada ao primeiro contato.
- Mensagem fora do horário - usada quando a conversa cai fora do expediente e a opção "Responder fora do horário" está marcada.
- Mensagem de transferência para atendente - exibida ao escalar para humano.
- No card Horário de Atendimento do Bot, para cada dia da semana:
- Marque o checkbox ao lado do nome do dia para ativá-lo.
- Ajuste os campos de hora início e fim do turno.
- Use + Adicionar turno para criar um segundo intervalo (ex: 08:00 - 12:00 e 14:00 - 18:00).
- Clique no X vermelho ao lado de um turno para removê-lo (visível apenas quando há mais de um turno no dia).
- Marque Responder fora do horário (envia mensagem informativa e encerra) se quiser que o bot envie a mensagem fora do expediente e encerre a conversa.
- No card Sessão, defina o Timeout de inatividade (minutos). Use
0para sessão infinita, ou um valor entre 1 e 1440 para encerrar conversas paradas automaticamente. - Clique em Salvar Configuração (botão indigo no rodapé) para gravar todas as alterações.
Casos especiais
Sessão sem expiração
Ao informar 0 no campo Timeout de inatividade, a conversa nunca expira por inatividade. O subtítulo do campo confirma esse comportamento exibindo "A conversa nunca expira por inatividade (sessão infinita)".
Múltiplos turnos no mesmo dia
Cada dia da semana aceita vários turnos. Use o link + Adicionar turno para configurar pausas (ex: intervalo de almoço). Os turnos seguem o formato HH:mm; o sistema normaliza automaticamente se o browser enviar HH:mm:ss.
Migração de horário legado
Se a configuração ainda usa o formato antigo (campos únicos horario_inicio/horario_fim + dias_semana), a tela detecta e converte automaticamente para o novo modelo horarios_por_dia ao carregar. O usuário pode então ajustar livremente cada dia.
Atendimento exclusivamente humano fora do expediente
Deixe Responder fora do horário desmarcado para que o bot simplesmente ignore mensagens recebidas fora dos turnos configurados. Nenhuma resposta automática é enviada nesse caso.
Erros comuns e como resolver
- "Erro ao carregar configuração" - Causa: falha na chamada GET
/admin/chatbot-whatsapp/api/config, geralmente perda de sessão ou módulochatbot-whatsappdesativado. Solução: recarregue a página e, se persistir, confirme em Configurações > Módulos que o módulo Chatbot WhatsApp continua ativo. - "Erro ao salvar" - Causa: validação rejeitou algum campo (instruções com mais de 5.000 caracteres, timeout fora do intervalo 0 - 1440, horário em formato inválido, mensagens acima de 1.000 caracteres). Solução: revise os limites de cada campo descritos na seção "Como usar" e tente novamente.
- Toggle do bot volta sozinho para desligado - Causa: a chamada de salvamento disparada pelo toggle falhou (token expirado ou backend indisponível). Solução: recarregue a página, faça login novamente se necessário e acione o toggle de novo.
Onde encontrar
- URL:
/admin/chatbot-whatsapp/config - Caminho no menu: Chatbot WhatsApp > Configuração
- Permissão necessária: ver o Inbox
- Módulo necessário:
chatbot-whatsapp
Veja também
Dashboard Chatbot- Métricas e sessões em tempo real para acompanhar o bot depois de configurado.