Agente de Fluxo (bot de passos)

São dois tipos de agente, escolhidos na criação:

Tipo	Como se comporta
💬 Agente de Conversa	A IA conduz seguindo o roteiro que você escreve. Flexível e natural. É o recomendado
🪜 Agente de Fluxo	Segue passos fixos: mensagem, pergunta, ramificação. Zero improviso

A escolha é definitiva: cada tipo tem suas próprias abas, e eles não se misturam. Pra trocar, crie outro agente.

Use o Fluxo quando a ordem não pode variar: triagem por menu, coleta de dados numa sequência obrigatória, qualificação com perguntas fixas.

Onde se monta

Em <agente> › Tools › Fluxo. No agente do tipo Conversa essa sub-aba nem aparece.

A tela é uma lista de passos, não um quadro de arrastar. Cada passo tem uma chave técnica em minúsculas, com números e underscore, do tipo boas_vindas ou perguntar_plano. É por ela que um passo aponta pro outro, num seletor de Próximo passo.

O primeiro passo criado vira o Inicial. Você pode marcar outro a qualquer momento, e o anterior perde a marca.

Os cinco tipos de passo

Passo	O que configura
📢 Mensagem	O texto (aceita Liquid) e o próximo passo. Envia e segue direto
❓ Pergunta	O texto, o nome da variável que guarda a resposta e o próximo passo
🔀 Ramificação	As saídas: rótulo, palavras-chave e o passo de destino de cada uma. Uma pode ser marcada como Fallback
🔧 Tool	Escolhe uma ferramenta já criada na sub-aba Ferramentas, e o próximo passo
🏁 Fim	Transferir pra humano ou Marcar como resolvido

Não existe passo de espera, de anexo, de condição por campo do CRM nem de sub-fluxo. Tudo que sai disso se faz com um passo Tool.

Como o caminho é escolhido

Na ramificação, o app tenta três coisas, nesta ordem:

1. Número digitado. Se o cliente responde “2”, vai pra segunda saída. Sem IA no meio.
2. Palavra-chave. As palavras que você listou na saída. Só vale quando uma única saída bate.
3. A IA classifica. Se o cliente escreveu livre, um classificador escolhe a saída mais provável.

Não casou nada, vai pro Fallback. Sem fallback, o bot devolve um pedido de escolha com as opções numeradas e espera de novo.

Duas consequências práticas:

• Sempre marque um fallback numa das saídas. Sem ele, o cliente teimoso fica preso repetindo o mesmo pedido, porque não existe limite de tentativas nem tempo de desistência.
• As opções são texto numerado, não botão do WhatsApp.

Perguntas e dados

A resposta de um passo de Pergunta vira uma variável, usada nos passos seguintes como {{ state.nome_da_variavel }}.

Dois pontos importantes:

• Não existe validação. O que o cliente escrever é guardado como veio, inclusive “não sei” no lugar do e-mail.
• A variável não vai pra ficha do contato sozinha. Pra gravar, coloque um passo Tool com a ferramenta de atualizar campo do contato.

Ferramentas

O catálogo é o mesmo do agente de conversa, as 19 ferramentas nas cinco categorias. Veja Ferramentas do agente.

A diferença é quem decide: no fluxo, a ferramenta roda porque o passo mandou, sempre na mesma hora. No agente de conversa, quem decide é a IA.

Testar e subir

Aqui mora a pegadinha maior: o playground não executa o fluxo. A aba Teste conversa pelo caminho da IA, que nesse tipo de agente nem é usado em produção. O aviso em Cérebro › Roteiro (“Esse agente está em modo Sequencial”) diz que o roteiro não vale aqui.

Então o teste de verdade é o status Em teste, em Operação, com a sua conversa na lista. Veja Operação.

O que ele não faz

• Não volta atrás. Não existe passo de voltar nem comando do cliente pra isso.
• Passo sem próximo é silêncio. O fluxo simplesmente para, sem cair na IA. Antes de ativar, confira se nenhum passo está marcado como (não ligado).
• Agente de Fluxo sem nenhum passo criado responde como agente de conversa, usando o roteiro. Ou você monta os passos, ou o tipo não faz diferença.
• Fim com transferência desliga o bot naquela conversa em definitivo. Ela não volta pro bot sozinha.
• Ele encadeia no máximo 6 passos automáticos por vez. Pergunta e ramificação sempre param pra esperar o cliente.

Uma triagem curta que funciona

Chave	Tipo	Conteúdo
boas_vindas	Mensagem	”Oi! Sou o atendimento da Loja X.”
menu	Ramificação	1 Comprar · 2 Suporte · 3 Outro assunto, com “outro” como fallback
perguntar_pedido	Pergunta	”Qual o número do pedido?” guardando em pedido
consultar	Tool	Requisição na sua API com {{ state.pedido }}
fim_humano	Fim	Transferir pra humano

Cinco passos, uma variável, um fallback. Comece por algo desse tamanho e cresça depois.