Sub-workflows no n8n: quebrando o monolito em partes reutilizáveis
Como converter parte de um fluxo em sub-workflow reutilizável no n8n, com o recurso automático disponível desde a versão 1.97.0.
Resumo por IA
Resumo gerado por IA, revisado pela redação.
Sub-workflows dividem um fluxo grande e complexo em partes menores e reutilizáveis, cada uma funcionando como um fluxo independente que pode ser chamado por outros. É a mesma lógica de dividir um programa grande em funções menores — mais fácil de entender, testar e reaproveitar.
Adicione ao Google NotíciasPor que quebrar um fluxo grande
Legibilidade — um fluxo de oitenta nodes é difícil de entender de relance; cinco sub-fluxos de dezesseis nodes cada, com nomes claros, contam a história por si só.
Reuso — uma lógica usada em três fluxos diferentes, como "validar e formatar telefone", vira um sub-workflow chamado pelos três, em vez de copiada três vezes.
Manutenção — corrigir a lógica num lugar só, em vez de em cada cópia espalhada.
Teste isolado — testar uma parte específica sem precisar rodar o fluxo inteiro do início.
Como converter, desde a versão 1.97.0
O n8n tem um recurso que converte automaticamente um trecho selecionado de um fluxo existente em sub-workflow, atualizando sozinho as referências entre os nodes.
Selecione um grupo contínuo de nodes no fluxo original.
A seleção precisa ter no máximo um ponto de entrada vindo de fora do grupo, e no máximo um ponto de saída indo para fora dele.
A seleção não pode incluir nodes de gatilho.
Use a opção de converter em sub-workflow.
O n8n cria um novo fluxo com esses nodes, adiciona um Execute Workflow Trigger automaticamente, e atualiza as expressões que referenciavam outros nodes para funcionarem como parâmetros de entrada.
A seleção não pode ter mais de um node com conexão de entrada vinda de fora, nem mais de um com conexão de saída para fora. Um Merge node, por exemplo, não pode ser o ponto de entrada, porque ele recebe de mais de um ramo por natureza.
Chamando o sub-workflow
No fluxo principal, o node Execute Workflow chama o sub-workflow pelo nome ou ID, passando os parâmetros necessários. O sub-workflow roda, devolve o resultado, e o fluxo principal continua a partir dali — como uma chamada de função.
Nomeie os sub-workflows de forma descritiva, pelo que eles fazem — "Validar e formatar telefone", não "Fluxo 3". Isso facilita encontrar e reaproveitar quando surgir a mesma necessidade em outro fluxo, meses depois.
Sub-workflows quebram fluxos grandes em partes reutilizáveis, testáveis e mais fáceis de entender. A conversão automática, desde a versão 1.97.0, faz o trabalho pesado de atualizar as referências sozinha.
Perguntas frequentes
O que são sub-workflows no n8n?
São fluxos menores e independentes, chamados por outros fluxos como se fossem funções — dividindo um fluxo grande e complexo em partes menores, reutilizáveis e mais fáceis de manter.
Como converter parte de um fluxo em sub-workflow?
Selecionando um grupo contínuo de nodes, com no máximo um ponto de entrada e um de saída externos, sem incluir nodes de gatilho, e usando a opção de conversão automática disponível desde a versão 1.97.0 do n8n.
Por que dividir um fluxo grande em sub-workflows?
Melhora legibilidade, permite reaproveitar a mesma lógica em vários fluxos sem duplicar, facilita manutenção centralizada e permite testar partes isoladamente, sem rodar o fluxo inteiro.
Este tutorial faz parte do guia Curso de n8n do zero ao avançado: o guia completo em português. Veja também: Node, trigger e workflow: o vocabulário do n8n em 10 minutos · A estrutura de dados do n8n: por que tudo é um array com json · Item linking no n8n: como ele decide qual item vai pra saída · Execuções passo a passo: como achar onde o fluxo do n8n quebrou · A Canvas UI do n8n 2.0: o que mudou e como se orientar · n8n Cloud ou self-hosted: a decisão que define seu custo e sua liberdade
