Chatbot - Editor de Fluxos

O que é

O Editor de Fluxos é a tela visual onde o atendimento automático do chatbot e desenhado. Em um canvas com grid você arrasta blocos do painel lateral (Mensagem, Menu / Opções, Aguardar Resposta, Condicao, Consultar Sistema, Resposta IA, Salvar Dado, Encaminhar Atendente, Encerrar Conversa) e conecta a saida de cada bloco a entrada do próximo, formando a arvore de decisão que o motor do chatbot executa no WhatsApp.

Todo fluxo comeca com um no fixo Início (em verde, não pode ser apagado) e deve ter um gatilho configurado para que o motor saiba quando dispara-lo (primeira mensagem do cliente, palavra-chave, IA conversacional, fora do horario, menu, fallback ou evento do sistema). Você chega aqui ao clicar em Novo Fluxo na listagem de fluxos ou ao clicar para editar um fluxo existente.

Como usar

1. Va em Chatbot WhatsApp > Fluxos no sidebar e clique em Novo Fluxo (ou clique em um fluxo existente para abrir o editor).
2. No cabecalho, clique em Gatilho para abrir o modal Configurações do Fluxo e preencha:
   • Nome do fluxo - titulo interno do fluxo.
   • Descrição - texto curto de referência.
   • Tipo de gatilho - quando o fluxo dispara. Opções: Primeira mensagem (boas-vindas), Palavra-chave, IA Conversacional (Gemini), Fora do horario, Menu, Fallback (nenhum outro match) ou Evento do sistema.
   • Palavras-chave - aparece somente para gatilho Palavra-chave; lista separada por virgula (ex: reserva, pedido, minha reserva).
   • Prioridade - número de 0 a 100. Quanto maior, antes o fluxo e avaliado.
3. Feche o modal e arraste blocos do painel Blocos (lado esquerdo) para o canvas. Os blocos disponíveis são:
   • Mensagem - envia texto livre. Use {variavel} para interpolar dados da sessão.
   • Menu / Opções - apresenta opções numeradas. Cada opção gera uma saida extra no bloco para ramificar a conversa.
   • Aguardar Resposta - pausa o fluxo aguardando o cliente digitar. Aceita timeout em minutos (1 a 60).
   • Condicao - testa uma variavel da sessão com operadores Igual a, Contem, Diferente de, Maior que, Menor que ou Existe (não vazio). A saida 1 e Verdadeiro e a saida 2 e Falso.
   • Consultar Sistema - busca dados do Viagilize. Ações disponíveis: Buscar excursões, Buscar reserva (por código), Listar reservas do cliente, Status pagamento, Listar embarques, Consultar precos, Verificar vagas, Consultar fidelidade, Gerar link pagamento.
   • Resposta IA - entrega a resposta ao Gemini com um contexto adicional e uma mensagem de fallback caso a IA falhe.
   • Salvar Dado - grava um valor (fixo ou {variavel}) em uma variavel da sessão para uso em blocos seguintes.
   • Encaminhar Atendente - transfere a conversa para um humano com uma mensagem opcional de transicao. E um bloco terminal (sem saida).
   • Encerrar Conversa - finaliza a sessão com uma mensagem de despedida opcional. Também e terminal.
4. Conecte os blocos: clique no circulo de saida (lado direito de um bloco) e arraste ate o circulo de entrada (lado esquerdo) do bloco seguinte. As conexoes aparecem em azul.
5. De duplo clique em um bloco para abrir o modal de edição e preencher o conteudo especifico do bloco (texto, opções, variaveis, etc.). Confirme em Salvar dentro do modal.
6. Use os botoes do canto inferior direito do canvas para zoom: +, - e 1:1 (resetar).
7. No cabecalho, clique em Organizar para que o editor recalcule automaticamente a posicao dos blocos seguindo o caminho principal.
8. Clique em Salvar Fluxo (botao indigo no cabecalho). Após o primeiro salvamento, o botao verde Testar aparece e leva ao simulador do fluxo.

Casos especiais

Configurando o bloco Menu / Opções

No modal de edição do bloco, alem da mensagem e da variavel de destino, ha um botao Adicionar opção que cria itens numerados (1, 2, 3...). Cada opção adicionada gera automaticamente uma saida nova no bloco, e você precisa conectar cada saida ao próximo bloco daquele caminho.

Gatilho IA Conversacional (Gemini)

Ao escolher IA Conversacional (Gemini) como tipo de gatilho, um aviso roxo aparece no modal Configurações do Fluxo indicando que a IA do Gemini conversa livremente com o cliente e consulta o sistema automaticamente. Esse modo não exige montagem de blocos passo a passo - a IA decide.

Presets do bloco Condicao

O modal do bloco Condicao oferece presets prontos (Cliente cadastrado?, Tem e-mail?, Reserva encontrada?, Pagamento pendente?, Muitas tentativas?) que preenchem variavel, operador e valor de uma vez. E possível ajustar os campos manualmente abaixo dos presets.

No Início não pode ser apagado

O bloco verde Início e o ponto de entrada obrigatório do fluxo. Tentar exclui-lo não tem efeito - o editor bloqueia a remocao. Ele também não abre modal de edição em duplo clique.

Reaproveitar fluxo existente

Para criar um fluxo parecido com outro, abra a listagem em Chatbot WhatsApp > Fluxos e use a ação Clonar ali. O editor não tem clonagem propria - ele edita um fluxo de cada vez.

Erros comuns e como resolver

• "Erro ao salvar fluxo" (toast vermelho) - Causa: falha de validação no backend (ex: tipo de gatilho invalido, prioridade fora de 0-100, nome com mais de 100 caracteres). Solucao: abrir o console do navegador para ver a mensagem detalhada e ajustar o campo correspondente no modal Gatilho.
• Bloco sem conexao na saida - Causa: a saida do bloco anterior ficou solta no ar. Solucao: o motor encerra o fluxo nesse ponto sem aviso ao cliente. Sempre conecte cada saida a um próximo bloco ou a um bloco Encerrar Conversa.
• Drawflow ou container não encontrado (console) - Causa: a biblioteca Drawflow não carregou (CDN bloqueado ou rede offline). Solucao: recarregar a página; se persistir, verificar conexao com cdn.jsdelivr.net.
• Opções do menu não geram saidas - Causa: opções adicionadas mas o fluxo foi salvo sem fechar o modal de edição do bloco. Solucao: clicar em Salvar dentro do modal antes de Salvar Fluxo no cabecalho.

Onde encontrar

• URL: /admin/chatbot-whatsapp/editor/{fluxo}
• Variante para novo fluxo: /admin/chatbot-whatsapp/editor/novo
• Caminho no menu: Chatbot WhatsApp > Fluxos > (abrir um fluxo) ou Chatbot WhatsApp > Fluxos > Novo Fluxo
• Permissão necessária: ver o Inbox
• Módulo necessário: chatbot-whatsapp

Veja também

• Fluxos do Chatbot - listagem onde se ativa, clona e exclui os fluxos criados aqui.
• Configurações do Chatbot - horario de atendimento, mensagens padrão e limites de conversa que se aplicam a todos os fluxos.
• Dashboard do Chatbot - metricas de sessões e conversas geradas pelos fluxos.