Iniciar Fluxo

Dispare outro Spaceflow a partir do seu fluxo

O nó Iniciar Fluxo permite que um Spaceflow dispare outro Spaceflow durante sua execução. Ele funciona como um gatilho remoto — ao chegar nesse nó, o fluxo pai envia um sinal para iniciar outro fluxo e imediatamente avança para o próximo nó, sem esperar que o fluxo disparado termine.

O fluxo disparado é um Spaceflow completamente independente. Ele possui seu próprio canvas, seus próprios nós e aparece normalmente na listagem de Spaceflows do workspace. O fluxo pai não recebe retorno, não sabe se o fluxo disparado concluiu e não é afetado por erros que ocorram nele.

Quando usar este nó

Utilize o nó Iniciar Fluxo quando precisar acionar outro Spaceflow a partir de um fluxo em execução.

Ele é ideal para:

• Disparar fluxos auxiliares sem precisar de integrações complexas
• Permitir que um membro escolha manualmente qual processo iniciar durante um fluxo
• Orquestrar múltiplos processos independentes a partir de um fluxo principal
• Dividir lógicas complexas em Spaceflows menores e reutilizáveis

Comparação entre modos de disparo

Como o nó funciona

O nó Iniciar Fluxo funciona como um disparador externo. Ele recebe a execução do fluxo pai, identifica o Spaceflow destino e envia um comando de início.

• Entradas — recebe os dados do nó anterior no fluxo pai, mas não repassa esses dados ao fluxo disparado.
• Saídas — não gera dados ou variáveis para os nós seguintes. O fluxo pai continua com as variáveis que já possuia antes deste nó.
• Execução — o fluxo disparado inicia uma nova execução independente, com seu próprio contexto e sem vínculo com a execução do pai.

Como adicionar o nó

O nó Iniciar Fluxo não aparece como um tipo separado no painel de nós. Para criá-lo, adicione um nó de Início ao canvas além do primeiro que já existe. Qualquer nó de Início adicionado após o primeiro se comporta automaticamente como um nó de Iniciar Fluxo.

Pré-requisitos

Para que um Spaceflow possa ser disparado por este nó, ele precisa atender a duas condições:

• Nó de Início configurado como Manual — o fluxo destino precisa ter seu nó de Início configurado com tipo de disparo Manual. Fluxos com disparo por Eventos, Webhook ou Timer não podem ser disparados por este nó.
• Status Ativo — o fluxo destino precisa estar com status Ativo. Por padrão, todo Spaceflow é criado com status Inativo. Para ativá-lo, abra o fluxo no editor, clique no ícone de engrenagem ao lado do título e altere o status para Ativo.

Modo de disparo

O nó pode ser configurado em dois modos:

Automático

O fluxo pai dispara automaticamente o fluxo destino ao chegar nesse nó, sem intervenção humana. O fluxo destino é fixo — definido na configuração do nó. Não gera tarefa.

As configurações disponíveis são:

• Nome do nó — identificação no canvas.
• Tipo — selecione Automático.

Exemplo de fluxo — Automático

Um fluxo de onboarding de novo cliente dispara automaticamente dois fluxos auxiliares: verificação documental e configuração de acessos. Ambos são independentes e o fluxo principal continua sem aguardar.

Neste exemplo:

1. O fluxo principal é iniciado manualmente com um formulário de dados do cliente.
2. Após o preenchimento, o nó Iniciar Fluxo dispara automaticamente o fluxo "Verificação Documental" (equipe de compliance).
3. Outro nó Iniciar Fluxo dispara automaticamente o fluxo "Configuração de Acessos" (equipe de TI).
4. Ambos os fluxos são independentes — o fluxo principal não aguarda conclusão de nenhum deles.
5. O fluxo principal segue direto para o envio de e-mail de boas-vindas.

Manual

O fluxo pai gera uma tarefa para que um membro do workspace selecione qual fluxo iniciar entre os disponíveis. Isso é útil quando a decisão de qual processo disparar depende de análise humana — por exemplo, escolher entre diferentes fluxos de tratamento conforme o tipo de ocorrência. Gera tarefa.

As configurações disponíveis são:

• Nome do nó — identificação no canvas.
• Tipo — selecione Manual.
• Workflows que podem ser iniciados — selecione quais Spaceflows ficarão disponíveis para o membro escolher. Apenas fluxos com início Manual e status Ativo aparecem na lista.

Como o modo Manual gera uma tarefa, as configurações de tarefa padrão ficam disponíveis:

• Definição da Tarefa — nome da tarefa e conteúdo descritivo (aceita variáveis com {{).
• Tempo de conclusão da tarefa — tipo de prazo, cálculo do tempo, valor e se conta apenas dias úteis.
• Classificação da Tarefa — pontos e prioridade (Baixa, Normal, Alta, Urgente).
• Permissões e Responsabilidade — limitar acesso, vincular item, criador, colaboradores e atribuição de responsável.

É por isso que a coluna "Gera tarefa?" deste nó aparece como Configurável na tabela de referência — depende do modo escolhido.

Exemplo de fluxo — Manual

Um fluxo de triagem de chamados recebe uma solicitação e o analista de N1 deve escolher qual fluxo de tratamento iniciar: técnico, comercial ou jurídico.

Neste exemplo:

1. Um sistema externo dispara o fluxo principal via webhook (ex: formulário de contato no site).
2. O fluxo cria automaticamente um item na categoria "Chamados".
3. O nó Iniciar Fluxo em modo Manual gera uma tarefa para o analista de N1.
4. O analista escolhe entre os fluxos disponíveis: "Tratamento Técnico", "Tratamento Comercial" ou "Tratamento Jurídico".
5. O fluxo escolhido inicia independentemente; o fluxo principal encerra.

Este nó vs. Requisição HTTP

Ambos podem disparar outro Spaceflow, mas servem para cenários diferentes:

A regra prática: se precisa apenas disparar outro fluxo sem enviar dados, use Iniciar Fluxo. Se precisa passar dados ou disparar em outro workspace, use Requisição HTTP apontando para o webhook do fluxo destino.

Limitações conhecidas

• O nó funciona apenas dentro do mesmo workspace. Não é possível disparar fluxos de outros workspaces.
• Se o Spaceflow configurado como destino for excluído ou tiver seu status alterado para Inativo, a execução do nó resultará em erro.
• O fluxo pai não aguarda a conclusão do fluxo disparado e não recebe retorno sobre seu resultado. Se o fluxo disparado falhar, o fluxo pai não é afetado.
• Não é possível usar variáveis para escolher dinamicamente qual fluxo disparar no modo Automático — o destino é sempre fixo.
• Não há limite de quantidade de nós Iniciar Fluxo em um mesmo Spaceflow. Cada um pode apontar para um fluxo diferente.

Comportamento dos dados

O nó Iniciar Fluxo não altera o estado dos dados do fluxo pai, mas é importante entender como ele se comporta no pipeline:

• Não gera saídas — após este nó, os nós seguintes do fluxo pai não têm acesso a nenhuma variável nova proveniente do fluxo disparado.
• Não consome dados de entrada — embora receba a execução do nó anterior, ele não processa ou transforma esses dados. O fluxo continua com as mesmas variáveis disponíveis antes do nó.
• Execuções independentes — o fluxo disparado inicia do zero, com seu próprio nó de Início. Se o fluxo destino tiver um formulário de início configurado, ele será exibido normalmente na execução independente.
• Erros no fluxo destino — não afetam a execução do fluxo pai. O erro será registrado apenas nos logs do fluxo disparado.
• Tarefas pendentes — no modo Manual, a tarefa gerada precisa ser concluída para que o fluxo pai avance. Até lá, a execução permanece pausada neste nó.

Casos de uso

• Orquestração de processos paralelos: um fluxo de onboarding de cliente dispara automaticamente um fluxo de verificação documental e um fluxo de configuração de acessos, ambos independentes.
• Escalonamento por tipo de ocorrência: no modo Manual, um analista recebe uma tarefa para escolher qual fluxo de tratamento iniciar (ex: "Incidente Técnico", "Reclamação" ou "Solicitação Comercial").
• Fluxos reutilizáveis: um fluxo de "Gerar Relatório Mensal" é disparado automaticamente por vários fluxos diferentes (Financeiro, RH, Jurídico) sem duplicar a lógica.
• Divisão de responsabilidades: um fluxo principal de vendas dispara um fluxo de pós-venda independente, mantendo os times separados e sem compartilhar dados sensíveis.
• Rotinas de limpeza: após um fluxo de importação de dados, dispara um fluxo de validação e correção automática em segundo plano.

Exemplo de fluxo — Reutilização

O fluxo "Gerar Relatório Mensal" é reutilizado por três departamentos diferentes, cada um com seu próprio fluxo principal.

Neste exemplo:

1. Três fluxos principais independentes (Financeiro, RH, Jurídico) possuem cada um um nó Iniciar Fluxo.
2. Todos apontam para o mesmo fluxo destino: "Gerar Relatório Mensal".
3. Cada disparo é independente — o fluxo de relatório executa três vezes, uma para cada departamento.
4. A lógica do relatório é centralizada em um único Spaceflow, evitando duplicação.

Exemplo de fluxo — Divisão de responsabilidades

Um fluxo de vendas dispara um fluxo de pós-venda para o time de customer success, mantendo os dados separados.

Neste exemplo:

1. O vendedor inicia o fluxo manualmente e preenche o formulário de dados da venda.
2. O sistema cria automaticamente o contrato na categoria "Contratos".
3. O nó Iniciar Fluxo dispara o fluxo "Pós-venda CS" para o time de customer success.
4. O fluxo de pós-venda é independente — o time de CS recebe uma nova execução com seu próprio formulário de início.
5. O fluxo principal segue para notificar o vendedor, sem aguardar o pós-venda.

Boas práticas

• Utilize o modo Automático quando o fluxo destino for sempre o mesmo e não depender de decisão humana.
• Utilize o modo Manual apenas quando um membro precisar analisar o contexto antes de escolher qual processo iniciar.
• Verifique se o fluxo destino está com status Ativo e tipo de início Manual antes de publicar o fluxo pai.
• Lembre-se de que este nó não transfere dados — se o fluxo destino precisar de informações do fluxo pai, use Requisição HTTP ou reconstrua a consulta no fluxo destino.
• Não dependa do resultado do fluxo disparado para tomar decisões no fluxo pai, pois não há retorno de status. Se precisar de feedback, use integração via webhook bidirecional.
• Nomeie o nó de forma descritiva no canvas (ex: "Iniciar — Validação Documental") para facilitar a leitura do fluxo.
• Evite criar ciclos de disparo onde o fluxo A inicia o fluxo B e o fluxo B inicia o fluxo A — isso pode causar execuções infinitas.
• Monitore os logs dos fluxos disparados separadamente, pois erros neles não aparecem na execução do fluxo pai.