# Roteador

> Envie um workflow por uma ou mais rotas nomeadas. Escolha a rota você mesmo, ative várias de uma vez ou deixe que condições nos dados recebidos decidam.

Source: https://nodaro.ai/pt-BR/docs/nodes/automate/router

O nó **Roteador** (Router) envia um workflow por uma ou mais rotas nomeadas. A entrada dele passa sem alterações para todas as rotas ativas, e os nós das rotas inativas são ignorados. Você mesmo escolhe a rota ativa no modo **Escolha única**, ativa várias rotas de uma vez no modo **Múltipla escolha** ou deixa que condições nos dados recebidos decidam no modo **Condicional**. O nó é gratuito.

- Found in: Automate › Logic & Data
- Output: data
- API type: `router`

## Quando usar
- Alternar entre duas sequências de nós, como um reel 9:16 e um post 1:1 feitos com o [**Redimensionar vídeo** (Resize Video)](https://nodaro.ai/docs/nodes/video/resize-video), sem desconectar nada.
- Fazer um vídeo e uma miniatura a partir da mesma imagem em uma execução, com duas rotas ativas.
- Executar uma etapa só quando os dados precisarem dela, por exemplo pular o ramo de dublagem quando `language` for `en`.
- Testar variações A/B ativando várias rotas de uma vez.

## Início rápido
### Adicionar o nó
Pressione Tab no canvas e escolha **Automatizar › Lógica e dados › Roteador**.

### Conectar a entrada
Conecte à entrada **Entrada** o valor que você quer repassar, por exemplo o resultado do [**Gerar vídeo** (Generate Video)](https://nodaro.ai/docs/nodes/video/generate-video). Ela aceita texto, JSON, imagens, vídeos e áudio.

### Configurar as rotas
Abra o painel de configurações e escolha um **Modo**. Renomeie as rotas e clique em **Adicionar rota** para criar mais. Cada rota tem a própria saída, à direita do nó.

### Conectar os ramos
Conecte a saída de cada rota ao primeiro nó do ramo dela.

### Escolher as rotas ativas e executar
Nos modos **Escolha única** e **Múltipla escolha**, clique em uma rota no nó, ou no painel de configurações, para ativá-la ou desativá-la. Clique em **Executar**. Só os ramos das rotas ativas são executados.

Workflow: Um Roteador no modo Escolha única envia o vídeo para o ramo do reel; o ramo do post é ignorado até você trocar a rota.

- Gerar vídeo → Roteador (entrada)
- Roteador → Redimensionar vídeo (Reel)
- Roteador → Redimensionar vídeo (Post)

## Entradas e saídas
| Entrada ou saída | Aceita ou envia | O que faz |
| --- | --- | --- |
| **Entrada** | Texto, JSON, imagens, vídeos ou áudio | O valor a rotear. |
| Uma saída por rota | O mesmo valor | Cada rota ativa repassa a entrada sem alterações. Uma rota inativa não envia nada. |

## Configurações
| Configuração | O que faz |
| --- | --- |
| **Modo** | **Seleção única (uma ativa)**, o padrão, mantém exatamente uma rota ativa. **Seleção múltipla (qualquer combinação)** permite que qualquer número de rotas fique ativo. **Condicional (por regras)** decide na hora da execução, a partir dos dados recebidos. |
| **Rotas** | As rotas nomeadas. Um Roteador novo tem **Route A** e **Route B**. Renomeie uma rota para dar um rótulo à saída dela no canvas; o nome é só um rótulo. **Adicionar rota** adiciona mais rotas, até 10. Os modos Escolha única e Múltipla escolha precisam de pelo menos 2 rotas; o modo Condicional funciona com 1. |

Quando você muda de **Múltipla escolha** para **Escolha única** com várias rotas ativas, só a primeira rota ativa continua ativa. Quando nenhuma rota está ativa, o nó mostra o selo **NENHUMA**.

## Modo condicional
No modo **Condicional (por regras)**, os dados decidem. O painel mostra o primeiro item recebido em **Amostra do nó anterior (primeiro item)**, para você ver os campos dele.

1. Em **Grupos de condições**, cada grupo tem uma ou mais condições: um campo, um operador e um valor. Clique em **Adicionar condição** para criar mais e escolha **AND** ou **OR** para combiná-las.
2. Em **Rotas ativadas**, marque as rotas que o grupo ativa quando as condições dele passam.
3. Clique em **Adicionar grupo** para outra regra. Quando você muda para o modo Condicional pela primeira vez, o painel começa com um grupo que ativa a primeira rota.

As condições funcionam como as do [**Filtrar lista** (Filter List)](https://nodaro.ai/docs/nodes/automate/filter-list), com os mesmos operadores e os mesmos atalhos de data, como **Desde a última execução**.

Como os grupos se combinam:

- Uma rota é executada quando pelo menos um grupo que corresponde a ativa. As rotas ativadas por vários grupos são executadas uma vez.
- Quando nenhum grupo corresponde, todas as rotas ficam inativas e os nós depois do Roteador são ignorados.
- Um Roteador sem grupos não ativa nenhuma rota.

A entrada precisa ser JSON, ou um texto que possa ser lido como JSON. Para rotear por um campo de dados extraídos, conecte o [**Extrair da web** (Web Scrape)](https://nodaro.ai/docs/nodes/automate/web-scrape) diretamente. Para rotear por uma parte dos dados, passe-os pelo [**Extrair campo** (Extract Field)](https://nodaro.ai/docs/nodes/automate/extract-field) com o **Tipo de saída** definido como **JSON**.

## Créditos
O Roteador é gratuito. Os ramos ignorados não custam nada, porque os nós deles não são executados.

## Dicas
- **Alterne sem refazer as conexões.** Mantenha os dois ramos conectados e troque a rota no modo Escolha única. O workflow fica pronto para as duas versões.
- **Dê nomes às rotas.** Uma rota chamada “Reel” ou “Dublagem” é mais fácil de acompanhar no canvas do que “Route A”.
- **Use uma rota vazia como interruptor.** Uma rota sem nós depois dela não faz nada, então, no modo Escolha única, uma rota chamada “Desligado” pausa o ramo inteiro.

## Frequently asked questions

### Como alterno entre duas versões de um workflow sem refazer as conexões?

Adicione um “Roteador” no modo “Escolha única”, com uma rota por versão, e conecte cada rota ao ramo dela. Escolha a rota antes de executar. Só esse ramo é executado, e os nós das outras rotas são ignorados.

### Um “Roteador” pode executar vários ramos de uma vez?

Sim. No modo “Múltipla escolha”, qualquer combinação de rotas pode ficar ativa, e todas as rotas ativas são executadas na mesma execução.

### Como o modo “Condicional” decide qual rota é executada?

Os grupos de condições testam campos do JSON recebido. Quando as condições de um grupo passam, ele ativa as rotas marcadas em “Rotas ativadas”. Os resultados de todos os grupos que correspondem são combinados e, quando nenhum grupo corresponde, nenhuma rota é executada.

### O que acontece com os nós de uma rota inativa?

Eles são ignorados, assim como os nós que vêm depois deles. Uma rota sem nós depois dela simplesmente não faz nada.

### O nó “Roteador” custa créditos?

Não. O “Roteador” é gratuito. Ele só decide quais ramos são executados.