Flow Builder: como eu aprendi a desenhar automação que não trava

Um cliente escreveu "quero cancelar" perto da meia-noite e recebeu o menu de boas-vindas. Ele repetiu a frase. O bot mandou o menu de novo. Nove vezes seguidas, até ele desistir e sumir. Na manhã seguinte eu abri o Flow Builder, segui a linha do desenho com o dedo na tela e o erro estava ali, à vista de qualquer um: uma seta voltando para o mesmo nó.

Fiquei um bom tempo encarando aquilo com raiva de mim mesmo. A ferramenta não falhou. Fui eu que liguei duas caixas sem pensar em quem responderia fora do menu. E foi ali que caiu a ficha: a maior vantagem de desenhar automação em tela não é o canvas bonito. É conseguir mostrar o erro para outra pessoa em dez segundos.

Vou te contar como o editor funciona, o que cada peça faz e por que o sistema te barra em algumas construções. Se você já está com pressa de montar alguma coisa, pule para montar o primeiro fluxo do zero e volte aqui depois.

Por que o Flow Builder existe

Atendimento automatizado nunca nasce grande. Começa com uma saudação. Depois alguém pede um menu. Depois vem a regra de horário, a consulta de pedido, a exceção do cliente que compra muito. No começo a gente guarda tudo isso na cabeça e numa planilha compartilhada. Seis meses depois ninguém lembra por que aquela mensagem existe nem quem pediu.

O editor junta essa bagunça num artefato único, que dá para abrir, ler e discutir com quem entende do negócio sem precisar de um desenvolvedor traduzindo. E tem o custo do erro, que é o segundo motivo. Automação errada não devolve só uma resposta ruim. Ela prende gente. Cliente preso não reclama. Ele some.

O que tem dentro do canvas

O desenho roda sobre o Drawflow e os nós e as arestas ficam gravados no banco. O que você vê é o que o motor executa, sem tradução no meio do caminho. Confesso que demorei para confiar nisso e passei semanas conferindo duas vezes cada alteração antes de salvar.

• Canvas com nós e conexões persistidos, refletindo a execução real
• Barra única de ações: salvar, validar, importar, exportar, modelos e navegação
• Painel lateral de blocos, que dá para recolher quando o desenho cresce
• Modal de dados do fluxo, com conexão, gatilho e modo real aparecendo no bloco Início
• Upload de arquivo para usar direto dentro dos blocos
• Localização visual dos erros que a validação encontra

O bloco Início não é enfeite. Ele mostra os metadados de verdade: qual conexão está vinculada, qual gatilho dispara a jornada e em que modo o fluxo roda. Já editei o fluxo certo com o gatilho errado por não olhar essa caixa. Duas vezes. Agora leio antes de mexer em qualquer coisa.

As famílias de blocos

São dezesseis tipos de bloco. Decorar a lista não ajuda muito. O que ajuda é saber a que família cada um pertence, porque a escolha quase sempre nasce de uma pergunta simples: neste ponto eu quero falar, decidir, buscar dado fora, mexer no CRM ou reaproveitar algo pronto?

O bloco Dados fala com MySQL/MariaDB, PostgreSQL, SQL Server e SQLite conforme a configuração. O HotFolder monitora origem local, FTP, Google Drive, OneDrive e S3. Aqui vai um aviso que aprendi do jeito difícil: o bloco aparece no editor mesmo quando a credencial ou a extensão não está instalada no servidor. Prometi um HotFolder num S3 numa reunião e passei o resto da semana explicando o atraso. O detalhe de cada peça está em guia dos tipos de blocos.

Um fluxo salvo ainda não atende ninguém

Salvar só guarda o desenho. Para o fluxo trabalhar, ele precisa estar ativo e precisa de uma porta de entrada. Esse controle explícito é o que me deixa manter rascunho no ambiente sem medo de alguém receber mensagem de teste às sete da manhã.

• Gatilho de automação amarrado a um evento do CRM
• Entrada por webhook em automacao/webhook/{chave}, para sistemas de fora
• Acionamento por regra de auto atendimento e menus
• Chamada como subfluxo por outro fluxo, pelo bloco Flow

O webhook resolve bem quando o disparo nasce fora daqui, tipo um evento do e-commerce ou um sistema antigo que ninguém quer tocar. Os gatilhos internos cobrem os eventos do dia a dia do atendimento no WhatsApp e do funil.

Modelos prontos e o arquivo .flux

A galeria tem 416 modelos divididos em 26 categorias, com 16 casos em cada, mais busca e miniatura. A aplicação no canvas é sanitizada, ou seja, o conteúdo passa por tratamento antes de virar nó no seu fluxo. Uso muito como ponto de partida quando estou sem ideia de estrutura. Nunca uso como resposta pronta, porque o texto e a regra são sempre da sua casa.

Para levar fluxo de um ambiente para outro existe o formato portável `.flux`, com importação e exportação na própria barra de ferramentas. É assim que eu levo para produção o que já foi aprovado em homologação, em vez de redesenhar tudo e esquecer metade das arestas.

O que o editor não deixa você fazer

Algumas construções travam automação e por isso são barradas antes da publicação: bloco Flow sem destino, bloco Flow apontando para o próprio fluxo, destino inexistente, inativo ou de outra empresa, referência circular entre fluxos e loop local sem nenhum bloco que aguarde resposta, menu, captura, delay ou mensagem segura.

Leia essa lista como um resumo das armadilhas que já morderam alguém. Cada item virou bloqueio porque representa um cenário que queima recurso e prende cliente. Fui salvo por três delas em fluxos que eu jurava estarem certos. O tema tem texto próprio em validações de segurança do Flow Builder.

Por onde começar

Escolha um caso pequeno e chato. Sério. Primeiro contato fora do horário, confirmação de recebimento, coleta de número de pedido. Desenhe, valide, teste conversando de verdade e só então ative. Depois que o ciclo inteiro entrar na sua cabeça, o tamanho do fluxo deixa de assustar.