Nó de Rotas

O Nó de Rotas é um dos componentes principais de um fluxo de trabalho no SpaceFlow. Ele permite direcionar a execução do fluxo por diferentes caminhos com base nas condições que você definir.

O que é o Nó de Rotas?

Em vez de seguir um único caminho linear, o Nó de Rotas permite construir fluxos dinâmicos onde cada execução pode tomar uma direção diferente dependendo dos dados. Use-o para:

• Avaliar condições em um ponto específico do fluxo
• Decidir qual caminho o fluxo deve seguir
• Lidar com múltiplos resultados possíveis a partir de um único nó

Como funciona?

Quando você adiciona um Nó de Rotas ao seu fluxo:

1. Você define uma ou mais rotas (por exemplo, Rota 1, Rota 2, Rota 3).
2. Para cada rota, você configura uma ou mais condições.
3. Durante a execução, o sistema avalia todas as condições e direciona o fluxo para todas as rotas válidas ao mesmo tempo — e, junto com elas, para a rota de fallback.

O nó não escolhe um caminho: ele abre todos os que couberem.

Estrutura do nó

Dentro do painel de configuração, você encontrará as seguintes seções:

Nome do Nó

Um campo de texto para identificar o nó dentro do seu fluxo. Use um nome claro e descritivo para que seja fácil de localizar.

Condições das Rotas

Aqui é onde você cria e gerencia suas rotas:

• Cada rota (Rota 1, Rota 2, Rota 3…) representa um caminho possível.
• Clique em + Adicionar Rota para criar uma nova rota.
• Você também pode remover rotas existentes que não são mais necessárias.

Rota de Fallback

A rota de fallback existe para o fluxo nunca parar com erro. Sem ela, quando nenhuma condição é atendida, a execução para com a mensagem "Nenhuma condição satisfeita e fallback não definido".

Um exemplo do que dá errado: em um fluxo de pagamento, a rota "Bizagi" e o fallback apontavam para a mesma tarefa. Para cada pagamento aprovado o sistema abria duas tarefas idênticas — uma pela rota que casou, outra pelo fallback.

Como tratar "nenhum dos casos previstos"

Como o fallback não serve para decidir, crie uma rota explícita para o caso do campo em branco, comparando com valor vazio:

A comparação com valor vazio casa com campo não preenchido. Assim o caso "faltou configurar" tem tratamento próprio, e o fallback continua sendo só a rede de segurança.

Exemplo prático

Imagine um fluxo de aprovação baseado no valor da solicitação:

Neste cenário, o Nó de Rotas abre o caminho correspondente ao valor. O Fim do fallback também é alcançado, mas como ele não faz nada, não interfere.

Quando usar

Use o Nó de Rotas sempre que precisar:

• Criar pontos de decisão no seu fluxo
• Separar diferentes cenários em caminhos distintos
• Automatizar regras de negócio
• Evitar duplicar fluxos inteiros para cada variação

Boas práticas

• O fallback aponta para um nó Fim. Nunca para uma tarefa, um nó de escrita ou um e-mail — e nunca para um nó que já é destino de outra rota.
• Uma rota, um destino. Se duas rotas levam ao mesmo lugar e as duas podem casar, o destino roda duas vezes.
• Nomeie suas rotas claramente. Use rótulos descritivos como "Valor baixo" ou "Alta prioridade" para que qualquer pessoa lendo o fluxo entenda cada caminho de imediato.
• Sempre teste todos os caminhos. Percorra o fluxo pela interface, não só pelos dados: erros de roteamento aparecem como tarefa duplicada ou tarefa que nunca abre, e nenhum dos dois gera mensagem de erro.
• Confira no log de execução. O resultado do nó traz matchedRoutes e nextNodes — é ali que se vê exatamente quais caminhos abriram.