Inbox WhatsApp Básico 5 min de leitura

Chatbot - Configurações

Página onde você define o comportamento do chatbot de WhatsApp: liga/desliga o bot, ajusta personalidade (nome do assistente e instruções da IA), customiza mensagens automáticas e configura os horários em que o robô atende cada dia da semana, com suporte a múltiplos turnos.

Atualizado em 12/08/2026

Configuração do Inbox WhatsApp

Tutorial em vídeo · 3:51 · gravado em 21/09/2026

Abrir na biblioteca de vídeos

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

  1. Vá em Chatbot WhatsApp > Configuração no menu lateral.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. No card Sessão, defina o Timeout de inatividade (minutos). Use 0 para sessão infinita, ou um valor entre 1 e 1440 para encerrar conversas paradas automaticamente.
  7. 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ódulo chatbot-whatsapp desativado. 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.

Este artigo foi útil?

Obrigado pelo seu feedback!

Neste artigo

Comece a usar agora

Crie sua conta e teste grátis por 7 dias, com acesso a todas as funcionalidades.

Testar Grátis