Pular para o conteúdo principal

Criar um Fluxo

Neste guia, você vai criar um fluxo completo do zero. Vamos montar um exemplo prático: um fluxo de boas-vindas com triagem por intenção — quando o cliente manda a primeira mensagem, o bot pergunta o motivo do contato e roteia para a fila correta.

Acessar o editor

  1. Clique em Automações na barra lateral.
  2. Clique em Novo Fluxo no canto superior direito.
  3. Dê um nome ao fluxo (ex: "Boas-vindas com triagem").
  4. (Opcional) Adicione uma descrição explicando o que o fluxo faz.
  5. Clique em Criar — o editor visual abre.

Conhecendo o editor

A tela do editor tem 3 áreas principais:

  • Esquerda — Paleta de nodes: lista as 5 categorias (Ativadores, Fluxo, Mensagens, Ações, IA). Você arrasta um node daqui pra dentro do canvas.
  • Centro — Canvas: onde você desenha o fluxo. Pode dar zoom (Ctrl+rolagem do mouse), arrastar pra navegar, e selecionar nodes pra editar.
  • Direita — Painel de propriedades: aparece quando você clica em um node. É onde você configura o que aquele node específico faz.

No topo do canvas tem 3 botões importantes: Salvar, Publicar e Testar.

Passo 1 — Adicionar o ativador

Todo fluxo começa com um ativador. Para o nosso exemplo:

  1. Na paleta esquerda, expanda Ativadores.
  2. Arraste Conversa Iniciada para o canvas.
  3. Clique no node que apareceu — o painel direito mostra as configurações.
  4. Configure:
    • Canais: selecione em quais canais esse fluxo dispara (WhatsApp, Instagram, etc.). Deixe em branco para todos.
    • Filas: filtra por filas específicas (opcional).

Passo 2 — Enviar a saudação

  1. Arraste Enviar Mensagem (categoria Mensagens) pra dentro do canvas.
  2. Conecte o ativador a esse node: passe o mouse sobre o ponto inferior do ativador, segure e arraste até o ponto superior do node "Enviar Mensagem".
  3. Clique no node "Enviar Mensagem" e configure no painel direito:
    • Texto: digite a mensagem. Use variáveis: Olá {{contact.name}}! 👋 Seja bem-vindo ao [Sua Empresa]. Para te direcionar melhor, escolha uma opção:
    • Quando você digita {{, o autocomplete mostra todas as variáveis disponíveis. Selecione contact.name da lista.

Salvar com frequência Aperte Ctrl+S (ou Cmd+S no Mac) ou clique em Salvar no topo. O sistema também salva automaticamente, mas costume sempre é bom.

Passo 3 — Enviar menu de opções

Em vez de pedir resposta livre, vamos enviar uma lista interativa do WhatsApp:

  1. Arraste Enviar Menu (Lista) pra dentro do canvas e conecte ao "Enviar Mensagem".
  2. Configure:
    • Cabeçalho: "Como podemos ajudar?"
    • Corpo: "Toque em uma opção pra continuar"
    • Texto do botão: "Ver opções"
    • Seções: clique em Adicionar Seção.
      • Título da seção: "Atendimento"
      • Opções:
        • Título: "Vendas" / Descrição: "Falar com um vendedor"
        • Título: "Suporte" / Descrição: "Ajuda com o produto"
        • Título: "Financeiro" / Descrição: "Boletos e pagamento"

Cada opção que o cliente escolhe vira o valor da próxima resposta dele.

Passo 4 — Esperar a escolha

  1. Arraste Aguardar Resposta (categoria Fluxo) e conecte ao "Enviar Menu (Lista)".
  2. Configure:
    • Salvar resposta em variável: digite escolha. A próxima mensagem do cliente vai virar {{vars.escolha}}.
    • Timeout: 5 minutos. Se o cliente não responder em 5 min, o fluxo segue pelo caminho "Sem resposta".

O node "Aguardar Resposta" tem duas saídas: uma quando o cliente responde, outra quando dá timeout.

Passo 5 — Rotear pela escolha (Switch)

  1. Arraste Switch (Roteador) e conecte à saída "Respondeu" do "Aguardar Resposta".
  2. Configure:
    • Variável a avaliar: {{vars.escolha}}
    • Casos:
      • "Vendas" → cria uma saída chamada "vendas"
      • "Suporte" → cria uma saída chamada "suporte"
      • "Financeiro" → cria uma saída chamada "financeiro"
    • Padrão (else): uma saída pra qualquer outra resposta.

Passo 6 — Transferir pra fila certa

Para cada saída do Switch:

  1. Arraste Transferir Fila (categoria Ações) e conecte à saída "vendas".
  2. No painel: Fila: escolha "Vendas".
  3. Repita para "suporte" → fila "Suporte", "financeiro" → fila "Financeiro".
  4. Para a saída "padrão", você pode adicionar outro Enviar Mensagem pedindo o cliente reformular.

Passo 7 — Tratar timeout

Conecte a saída "Sem resposta" (timeout) do "Aguardar Resposta" a:

  • Um Enviar Mensagem com algo como: "Como você não respondeu, vou encaminhar para o atendimento geral. Pode descrever o que precisa?"
  • Seguido de um Transferir Fila para a fila padrão.

Passo 8 — Finalizar com Fim

(Opcional) No final de cada caminho, você pode adicionar um node Fim para deixar explícito que o fluxo terminou. Sem ele, o fluxo simplesmente para depois do último node.

Validar e publicar

  1. Clique em Salvar.
  2. O sistema valida o fluxo automaticamente. Se houver erro:
    • Node sem conexão de entrada: algum node ficou solto. Conecte com uma seta.
    • Campo obrigatório vazio: clique no node em vermelho e preencha o que falta.
    • Variável inexistente: você usou {{vars.algo}} mas não criou essa variável antes.
  3. Quando estiver tudo OK, clique em Publicar. A partir desse momento o fluxo está rodando em produção.

Rascunho vs. Publicado Enquanto está em rascunho, o fluxo não dispara — só fica salvo. Só Publicado ativa o ativador. Se você editar um fluxo publicado, as mudanças só valem depois que você clicar em Publicar de novo.

Testar o fluxo

Antes de publicar, dá pra simular execução:

  1. Clique em Testar no topo do editor.
  2. Escolha uma conversa real recente como contexto (ou crie uma de teste).
  3. O sistema executa o fluxo passo a passo, mostrando qual node disparou e o valor das variáveis em cada momento.
  4. Use isso pra debugar antes de colocar em produção.

Editar um fluxo publicado

Sempre que abrir um fluxo já publicado:

  1. Faça as alterações.
  2. Clique em Salvar — fica como rascunho de uma nova versão.
  3. Clique em Publicar quando quiser ativar — substitui a versão antiga.

O Adonix mantém histórico de versões, então dá pra reverter pra uma versão anterior se algo quebrar.

Próximos passos

  • Veja os templates prontos para começar mais rápido.
  • Para roteamento mais inteligente, troque o Switch por Classificar Intenção (IA) — em vez de comparar valores literais, a IA entende variações ("queria comprar" → vendas, "boleto não chegou" → financeiro).