Chatbot WhatsApp - Fluxos de Conversa

O que é

A página Fluxos de Conversa centraliza todos os roteiros automatizados que o chatbot do WhatsApp executa quando um cliente envia mensagem. Cada fluxo combina um gatilho (o que dispara o atendimento) com uma sequência de etapas (mensagens, perguntas, consultas ao sistema, encaminhamento humano e respostas com IA).

O usuário chega aqui depois de ativar o módulo chatbot-whatsapp e configurar a conexao com o número. E nesta tela que você ativa ou desativa cada fluxo, ajusta a prioridade (fluxos com número maior são avaliados antes), clona fluxos para criar variacoes e importa templates prontos (por exemplo, "Atendimento Principal") como ponto de partida.

Como usar

1. Va em Modulos > Chatbot WhatsApp > Fluxos de Conversa no sidebar (URL: /admin/chatbot-whatsapp/fluxos).
2. Para criar do zero, clique em Novo Fluxo (botao indigo no canto superior direito) - você e levado direto ao Editor Visual.
3. Para importar um modelo pronto, clique em Templates (ao lado de Novo Fluxo), escolha um item da lista e clique em Importar. O fluxo aparece imediatamente na listagem.
4. Cada linha mostra:
   • Nome do fluxo com o tipo de gatilho, contagem de etapas e prioridade.
   • Selo Ativo/Inativo - clique para alternar sem abrir o fluxo.
   • Icone play - abre o simulador para testar a conversa.
   • Icone quadrados - abre o Editor Visual (Drawflow) para mexer nas etapas.
   • Icone lapis - abre o modal para alterar nome, descrição, gatilho e prioridade.
   • Icone duas páginas - clona o fluxo, criando uma copia inativa com sufixo "(copia)".
   • Icone lixeira - exclui o fluxo após confirmação.
5. Clique na linha (fora dos icones) para expandir o painel de etapas. La você pode reordenar etapas com as setas, abrir o modal de edição de cada etapa ou clicar em Adicionar Etapa.

Tipos de gatilho disponíveis

No modal de edição do fluxo, o campo Gatilho aceita:

• Primeira mensagem - dispara na abertura da conversa.
• Palavra-chave - exige lista de termos separados por virgula (campo aparece logo abaixo).
• IA Conversacional (Gemini) - usa a IA para conversar livremente; abre o bloco roxo com personalidade, system prompt extra, máximo de turnos e ferramentas habilitadas.
• Fora do horario - dispara quando o atendimento esta fora da janela configurada.
• Menu (0 ou "menu") - disparado quando o cliente digita 0 ou a palavra menu.
• Fallback (nenhum outro casou) - rede de seguranca quando nenhum outro fluxo respondeu.

Casos especiais

Fluxo com IA conversacional

Ao escolher gatilho IA Conversacional, o card expandido mostra um aviso roxo informando que o fluxo não usa etapas manuais - a IA decide o que responder e quando consultar o sistema. Você ainda pode limitar quais Ferramentas habilitadas a IA pode usar (buscar excursões, verificar vagas, listar embarques, consultar precos, buscar reserva, listar reservas do cliente, status de pagamento, gerar link de pagamento, consultar pontos de fidelidade, cadastrar cliente, transferir atendente).

Clonar para criar variacoes

Use Clonar fluxo quando quiser testar mudancas sem mexer no fluxo em producao. O clone nasce sempre Inativo e com o sufixo "(copia)" no nome. Ajuste o que precisar e troque o selo para Ativo quando estiver pronto.

Prioridade entre fluxos

Varios fluxos podem estar ativos ao mesmo tempo. O sistema avalia os gatilhos pela prioridade (maior número = avaliado primeiro). Mantenha valores acima de 80 para fluxos criticos (Atendimento Principal) e baixe os mais genericos (Fallback costuma ficar em 10-20) para evitar que um fluxo amplo intercepte mensagens que pertencem a outro mais especifico.

Erros comuns e como resolver

• "Erro ao salvar" ao editar um fluxo - Causa: campo Nome vazio (o botao Salvar fica desabilitado, mas a API também rejeita) ou gatilho invalido. Solucao: preencha o nome e escolha um dos gatilhos da lista.
• "Erro ao alterar status" ao clicar no selo Ativo/Inativo - Causa: o número do WhatsApp foi desconectado e o sistema bloqueia o toggle, ou você não tem a permissão de ver o Inbox no papel atual. Solucao: reconecte em Conexao ou peca ao Proprietario para ajustar suas permissões.
• Página não abre / aparece "Módulo não disponível" - Causa: o módulo não está contratado nesta empresa. Solucao: ative o módulo Chatbot WhatsApp em Billing / Módulos antes de tentar de novo.
• Clone não aparece na lista - Causa: a listagem foi cacheada no navegador. Solucao: o sistema recarrega automaticamente após Fluxo clonado; se não aparecer, recarregue a página (F5).

Onde encontrar

• URL: /admin/chatbot-whatsapp/fluxos
• Caminho no menu: Modulos > Chatbot WhatsApp > Fluxos
• Permissão necessária: ver o Inbox
• Módulo necessário: chatbot-whatsapp

Veja também

• Editor de Fluxos - desenhar visualmente as etapas e conexoes de cada fluxo no Drawflow.
• Configurações Chatbot - conectar o WhatsApp, definir horario de atendimento e mensagens padrão antes de ativar fluxos.