Skip to content

Construtor de Fluxos (V3)

O Construtor de Fluxos é o editor visual onde você desenha como o bot conversa. Cada fluxo é um diagrama de blocos conectados; um bot pode ter quantos fluxos quiser.

Abrir o construtor

  1. Configurações → Bots → clique no bot.
  2. Aba Flows.
  3. Clique em + New Flow para criar, ou em um fluxo existente para editar.

A tela do construtor tem três áreas:

  • Sidebar esquerda — biblioteca de blocos para arrastar.
  • Canvas central — onde o fluxo vive.
  • Painel direito — abre quando você clica num bloco; mostra as configurações dele.

Conceitos básicos

Grupos

Um grupo é um cartão com vários blocos dentro. Tudo num grupo executa em sequência. Use grupos para juntar blocos relacionados (ex.: "Coletar dados do cliente").

Para criar: arraste um bloco do sidebar para o canvas — um grupo novo é criado automaticamente.

Blocos

Cada bloco é uma ação: enviar texto, perguntar algo, condicionar, chamar API, etc. Veja Blocos disponíveis.

Conexões (edges)

Setas que ligam o final de um grupo ao início de outro. Para conectar:

  1. Passe o mouse sobre a borda inferior do grupo de origem.
  2. Clique e arraste até o grupo de destino.

Eventos

Pontos de entrada do fluxo (ex.: "ao receber primeira mensagem", "ao clicar botão X"). Sem evento, o fluxo nunca dispara.

Variáveis

Valores que persistem durante a conversa (nome do cliente, escolha em menu, etc.). Veja Variáveis e contexto.

Anatomia de um fluxo simples

Um fluxo de boas-vindas mínimo:

[Evento: Início] → [Texto: "Olá! Como posso ajudar?"]
                 → [Botões: "Vendas" | "Suporte"]
                     "Vendas" → [Atribuir time: Vendas]
                     "Suporte" → [Atribuir time: Suporte]

Salvar vs publicar

  • Salvar (Ctrl/Cmd + S) — guarda o trabalho como rascunho. Só você (e outros admins) vê.
  • Publicar — promove o rascunho para versão ativa. Apenas a versão publicada responde clientes reais.

Veja Publicar e versionar para detalhes sobre histórico de versões e rollback.

Testar antes de publicar

No canto inferior direito da tela de Flows tem um botão flutuante 💬 Testar fluxo. Ele abre um chat de simulação que executa o rascunho atual — útil para validar mudanças antes de publicar.

Operações comuns

Cosmobots — plataforma de atendimento conversacional