Builder · Atualizado em 06/10/2026
Como criar e usar subfluxos no Builder
Separe uma parte do fluxo em um subfluxo, chame-a por um bloco, baixe ou carregue o arquivo e saiba o que acontece ao deletar.
Subfluxo é uma parte do fluxo guardada à parte, com blocos próprios, que o fluxo principal chama por um único bloco. Quando a conversa termina o subfluxo, ela volta para o bloco que o chamou.
Quando usar
- Uma sequência se repete em vários pontos, como pedir o número do pedido e validá-lo.
- O desenho do fluxo principal ficou grande e você quer separar um assunto, como a troca de produtos.
- Duas pessoas editam partes diferentes e você quer facilitar a leitura.
- Você quer reaproveitar uma parte em outro fluxo, levando-a por arquivo.
Pré-requisitos
- Acesso ao Builder do fluxo, com permissão para editar o rascunho.
- Um fluxo aberto no Builder. Veja como criar um fluxo no Builder.
Como o subfluxo funciona
O subfluxo nasce com dois blocos: Início, que começa já passando para o próximo passo, e Fim, que devolve a conversa ao fluxo principal. Entre os dois, você monta os blocos como em qualquer fluxo.
No fluxo principal, o subfluxo é representado por um bloco de chamada. Esse bloco não tem conteúdo próprio: a aba Subfluxo dele mostra qual subfluxo é chamado. Quando o contato chega ao bloco, entra no subfluxo. Ao alcançar o Fim, volta para o bloco de chamada, e as Condições de saída dele decidem o próximo bloco.
Passo a passo: criar um subfluxo
- No Builder, clique em Adicionar bloco.
- No menu NOVO BLOCO, clique em Subfluxo.
- Clique em + Criar novo subfluxo.
- Na janela Criar novo subfluxo, digite o Nome do subfluxo. O nome já vem como "Novo subfluxo", aceita até 50 caracteres e é obrigatório.
- Clique em Criar subfluxo.
- O bloco de chamada aparece no fluxo principal, com o nome que você deu.
- Abra o bloco e, na aba Condições de saída, escolha o bloco para o qual o contato segue quando o subfluxo terminar.
Passo a passo: editar o subfluxo
- Clique no bloco de chamada para abrir o painel.
- Na aba Subfluxo, confira a quantidade de blocos e clique em Abrir subfluxo.
- Uma barra aparece no topo do desenho, com o caminho Fluxo principal / nome do subfluxo e a etiqueta Subfluxo.
- Edite os blocos entre Início e Fim como faria no fluxo principal.
- Para voltar, clique em Fluxo principal na barra.
Também é possível abrir um subfluxo pelo menu NOVO BLOCO: clique em Subfluxo e escolha o nome na lista.
Passo a passo: baixar e carregar um subfluxo
- Com o subfluxo aberto, clique no ícone Baixar subfluxo da barra. O navegador baixa um arquivo
.jsoncom o nome curto do subfluxo. - Em outro fluxo, abra um subfluxo e clique no ícone Carregar subfluxo.
- Escolha o arquivo
.json. O desenho do subfluxo aberto é substituído pelo do arquivo.
Se o arquivo não for de um subfluxo válido, o Builder mostra o aviso "O arquivo especificado não contém um subfluxo válido para importação".
Passo a passo: deletar um subfluxo
- Clique no bloco de chamada para selecioná-lo.
- Pressione Delete ou Backspace, ou clique com o botão direito no bloco e escolha Excluir.
- Na janela Deletar subfluxo, leia o aviso e confirme em Deletar subfluxo.
O bloco de chamada e o subfluxo são removidos juntos, com todas as configurações. Se você duplicou o bloco de chamada, os dois compartilham o mesmo subfluxo: ele só é apagado quando o último bloco que o chama for removido. Dá para desfazer com Ctrl+Z.
Exemplo na Loja Girassol
A Loja Girassol pede o número do pedido em dois lugares: em "Acompanhar pedido" e em "Trocas e suporte". Marcela cria o subfluxo "Número do pedido", com um bloco de entrada validando o número entre o Início e o Fim. No fluxo principal, os dois assuntos chamam o mesmo subfluxo. Em cada chamada, a condição de saída leva para o bloco certo: um segue para a consulta e o outro para a troca.
Resultado esperado
O fluxo principal fica mais curto, com um bloco que representa a sequência. Ao testar, o contato entra no subfluxo, percorre os blocos e retorna ao bloco de chamada. Veja como testar um fluxo.
Limitações
- As ações Redirecionar para serviço e Consultar Assistente de conteúdo não podem ser usadas dentro de um subfluxo.
- O bloco Fim não se conecta a um próximo bloco.
- Erros dentro de um subfluxo aparecem marcados no bloco que o chama, com o prefixo "Subfluxo".
- Um bloco de chamada importado de arquivo pode ficar sem o desenho do subfluxo. Nesse caso a aba Subfluxo mostra "Este subfluxo ainda não tem desenho neste fluxo", com os botões Carregar subfluxo e Criar subfluxo vazio.
Problemas comuns
- "Este subfluxo ainda não tem desenho neste fluxo": o fluxo foi importado sem o arquivo do subfluxo. Use Carregar subfluxo ou Criar subfluxo vazio.
- O contato não sai do subfluxo: confira se o caminho chega ao bloco Fim e se há uma condição de saída no bloco de chamada.
- Uma ação não aparece dentro do subfluxo: Redirecionar para serviço e Consultar Assistente de conteúdo são ocultadas ali.
- Um bloco de chamada marcado com erro: abra o subfluxo e procure o bloco apontado na mensagem.
Próximos passos
Perguntas frequentes
Qual a diferença entre um subfluxo e um bloco comum?
Um subfluxo é um mini fluxo com blocos próprios, começando em Início e terminando em Fim. O fluxo principal só enxerga um bloco que o chama.
O que decide o próximo passo depois que o subfluxo termina?
As condições de saída do bloco que o chama, no fluxo principal. É nelas que você define para onde o contato segue.
Posso apagar o subfluxo e manter o bloco que o chama?
Não. O bloco e o subfluxo são deletados juntos, a menos que outro bloco do mesmo fluxo ainda chame o mesmo subfluxo.
Dá para desfazer a exclusão?
Sim, enquanto a tela do Builder estiver aberta. Use Ctrl+Z.
O arquivo baixado de um subfluxo serve para outro fluxo?
Sim. Abra o subfluxo no outro fluxo e use Carregar subfluxo com o arquivo .json.
Esse artigo foi útil?
Obrigado pelo retorno!