Tipos de blocos do Flow Builder: qual escolher e quando
Dezesseis blocos, cinco famílias e um mapa de decisão para quem está com o canvas aberto e precisa saber qual peça arrastar agora.
Passei três dias caçando um defeito que não existia. O fluxo estava certo, a validação passava limpa, e mesmo assim metade dos contatos caía na rota de erro. O problema eram os tipos de blocos: eu tinha usado Captura onde cabia Menu. As pessoas escreviam "boleto", "2ª via", "quero o boleto" e a Condição seguinte só sabia comparar com o número da opção.
Erro de bloco quase nunca acende luz vermelha no editor. Ele aparece semanas depois, com alguém do time dizendo que o bot está burro. Este guia é o mapa de decisão que eu montei depois daquele episódio, bloco a bloco, com o critério que uso na hora de arrastar a peça. Para o panorama do editor, veja o que é o Flow Builder.
Blocos de conversa
São os que o cliente vê. Definem o ritmo da jornada e concentram quase todo o trabalho de escrita. Erro aqui aparece rápido, porque a pessoa reage na hora. Isso é bom: você descobre no mesmo dia.
| Bloco | Função | Use quando |
|---|---|---|
| Mensagem | Envia texto ao contato | Informar, confirmar ou encerrar sem esperar resposta estruturada |
| Menu | Apresenta opções e roteia conforme a resposta | As respostas possíveis são conhecidas e contáveis |
| Captura | Coleta a resposta do contato | A resposta é aberta mesmo, como número de pedido ou descrição |
| Mídia | Envia imagem, áudio, vídeo ou documento | O conteúdo é visual: catálogo, comprovante, instrução |
A confusão que eu vivi é a mais comum de todas. Se você já sabe quais são as respostas possíveis, Menu. Ele elimina erro de digitação e deixa a Condição seguinte simples. Guarde a Captura para o que é texto livre de verdade.
Blocos de decisão e de tempo
A Condição pega o que foi coletado e escolhe a rota. Toda saída precisa terminar em destino real, sem exceção. Condição com saída vazia é o começo silencioso do contato preso, e você só descobre quando alguém reclama.
O Delay segura a jornada por um tempo. Ele resolve duas coisas diferentes: dar respiro humano à conversa e escalonar acompanhamento. Detalhe que já me pegou: o processamento dos delays roda por comando dedicado. Se a rotina não estiver ativa no servidor, o fluxo simplesmente não avança e ninguém entende por quê.
Blocos de integração
Aqui a conversa vira conversa entre sistemas. É onde mora o maior valor e também a maior chance de quebrar, porque você depende de coisas fora do seu alcance.
- HTTP: faz requisição para consultar ou enviar dado a um serviço externo
- Webhook: dispara evento para fora, avisando outro sistema
- Email: envia ou prepara email dentro da jornada
- Arquivo: manipula arquivo dentro da automação
- HotFolder: processa arquivo de uma pasta monitorada
A dúvida entre HTTP e Webhook aparece toda semana. O critério é curto: se você precisa da resposta para decidir o próximo passo, HTTP. Se basta avisar e seguir, Webhook. O HotFolder aceita origem local, FTP, Google Drive, OneDrive e S3, sempre dependendo de credencial e extensão do ambiente.
Blocos de dados e ação
O bloco Dados lê e grava variável de contexto e tem conector para MySQL/MariaDB, PostgreSQL, SQL Server e SQLite conforme a configuração. É ele que deixa a conversa parar de perguntar o que a empresa já sabe. Nada irrita mais um cliente antigo do que ter que digitar o CNPJ de novo.
O bloco Ação dispara rotina interna do CRM, tipo registrar informação no atendimento. É a costura entre a automação e o resto da casa, incluindo o funil de atendimento.
Blocos de inteligência e reuso
O bloco Agente chama um agente de IA configurado na Central de Inteligência Artificial. Ele traz linguagem natural para dentro de um fluxo que, fora dali, é todo determinístico. Antes de sair usando, entenda a estrutura da Central de IA.
O bloco Flow encapsula um subfluxo. Ele nasce com o rótulo "Defina um fluxo", deixa você escolher um fluxo existente e carrega o preview dos nós do escolhido. Esse preview já me salvou de publicar chamando o subfluxo errado. Assunto completo em subfluxos reutilizáveis.
Tipos de blocos parecidos: como escolher
| Dúvida | Como eu decido |
|---|---|
| Menu ou Captura | Respostas conhecidas e contáveis pedem Menu; texto livre pede Captura |
| HTTP ou Webhook | Preciso da resposta para decidir? HTTP. Só avisar? Webhook |
| Condição ou Agente | Regra objetiva e auditável pede Condição; interpretar linguagem pede Agente |
| Mensagem ou Mídia | Texto puro pede Mensagem; imagem ou documento pede Mídia |
| Duplicar trecho ou Flow | Trecho repetido em dois ou mais fluxos pede bloco Flow |
Escolhas erradas que custam caro
Cinco padrões respondem por quase todos os casos que eu já tive que desatar. Se algum deles soar familiar, abra o fluxo agora.
- Captura no lugar de Menu, gerando resposta livre que a Condição não consegue tratar
- HTTP no lugar de Webhook, com a jornada esperando por uma resposta que ninguém usa
- Condição no lugar de Agente, com dezenas de regras tentando cobrir jeitos de falar
- Delay usado para disfarçar lentidão de integração, quando o problema está no serviço externo
- Três Mensagens em sequência onde cabia uma, entupindo a conversa do cliente
O terceiro merece parágrafo próprio. Quando uma Condição começa a acumular variação textual, o problema mudou de natureza: virou interpretação de linguagem. Insistir na regra determinística ali gera manutenção sem fim e cobertura que nunca fica completa. Já mantive uma Condição com trinta e duas variações de "cancelar". Perdi.
O que fazer agora
Abra seus fluxos existentes procurando duas coisas: trecho duplicado e condição com saída vazia. Esses dois respondem pela maior parte das falhas silenciosas que ninguém reporta. Depois siga para as validações do editor e para o guia de subfluxos.