Flows
Um flow é um fluxo desenhado em um canvas visual, onde cada nó é uma ação ou uma decisão. Ele descreve, passo a passo, um comportamento mais rígido — um menu de opções, uma sequência de perguntas, um roteiro de diagnóstico.
Recurso avançado — não é como a IA responde hoje. Em produção, o atendimento é conduzido pela persona + base de conhecimento + ferramentas do agente, não por flows. O editor de flows existe e é completo, mas os fluxos não estão no caminho da conversa real no momento. Trate esta seção como um recurso avançado/preview: útil de conhecer, opcional de usar.
A tela /flows
A lista mostra cada flow com nome, tipo e última edição, mais indicadores de total, publicados e rascunhos. Os estados de um flow são:
| Estado | Significa |
|---|---|
| rascunho | Em edição — é onde você trabalha |
| publicado | Versão promovida para produção |
| arquivado | Versões anteriores, preservadas |
Criar um flow — 2 passos
Em /flows/new:
Identidade. Nome, slug, tipo (Main — invocável pelo agente / Sub-flow — chamado por outros flows) e uma descrição que a IA lê para decidir quando usar o flow.
Contrato. Os parâmetros de entrada e o retorno do flow (pode ficar vazio e ser definido depois no editor).
Ao criar, você vai para o editor de canvas.
O editor de canvas
Em /flows/[id]/edit, o editor tem três colunas:
- Paleta (esquerda) — os tipos de nó que você arrasta para o canvas, agrupados por categoria (Fluxo, Conversa, Voz, Inteligência, Cliente, Ações, Dados). Alguns nós são marcados Só voz e outros ficam em modo avançado.
- Canvas (centro) — onde você conecta os nós. Salva sozinho a cada poucos segundos.
- Inspetor (direita) — a configuração do nó selecionado. Pode alternar para o painel de teste.
No topo há Testar, Exportar/Importar (JSON), Histórico, Salvar e Publicar, além de badges que mostram a versão em rascunho e a versão publicada.
Testar o flow
O Modo Teste simula uma conversa (WhatsApp ou Voz), realça os nós executados no canvas e mostra um trace técnico com a ordem dos nós e as variáveis finais. Use mocks de cliente para experimentar sem tocar em dados reais.
Versões — publicar, comparar, reverter
Você edita sempre num rascunho — a versão publicada nunca é alterada direto.
- Publicar promove o rascunho para produção e arquiva a versão publicada anterior. Você pode escrever notas da versão. (Requer a permissão de publicar flows.)
- Histórico (
/flows/[id]/history) lista todas as versões, com quem publicou e quando. - Comparar (
/flows/[id]/compare) mostra o diff entre duas versões — nós e conexões adicionados, removidos ou modificados. - Reverter (rollback) volta uma versão anterior para produção.
Comece pela base de conhecimento. Antes de desenhar um flow, veja se o problema não se resolve com uma boa entrada na base de conhecimento — quase sempre resolve, e dá muito menos manutenção.
Próximo passo
→ Ferramentas (Tools) → Boas práticas