Nós

Entenda e escolha os nós do seu Spaceflow

Os nós são os blocos de construção de um Spaceflow. Cada nó representa uma etapa do fluxo — uma ação, uma decisão, uma integração ou um controle de lógica. Para montar um fluxo, você arrasta nós para o canvas e os conecta em sequência, definindo o caminho que o processo deve seguir.

Nós marcados como Em breve estão no roadmap e aparecem bloqueados no editor — não podem ser adicionados ao fluxo por enquanto.

Para ver os nós disponíveis, abra um Spaceflow no editor e clique em Adicionar Nó ou arraste a partir do semicírculo amarelo de qualquer nó existente.

Quando usar os nós do Spaceflow

Utilize os nós do Spaceflow quando precisar construir fluxos de automação no canvas.

Eles são ideais para:

• Coletar dados de usuários via formulários
• Solicitar aprovações ou ações manuais
• Enviar e-mails e notificações automáticas
• Criar, consultar ou editar itens em categorias
• Direcionar o fluxo por caminhos condicionais
• Integrar com sistemas externos via API
• Executar operações de inteligência artificial
• Pausar ou aguardar períodos entre etapas
• Encerrar processos de forma controlada

Tipos disponíveis e quando utilizar

Comparação entre os grupos de nós

Ações como Formulário, Aprovação e Tarefa geram tarefa; E-mail, CRUD e Notificação de Comparação são automáticas.

Como os nós funcionam

Cada nó possui entradas (dados recebidos do passo anterior) e saídas (dados gerados e disponibilizados para os próximos nós). Essa cadeia permite que informações fluam ao longo de todo o processo, sendo reutilizadas e transformadas a cada etapa.

Alguns nós exigem ação humana e geram uma tarefa na tela de Tarefas Rápidas — o fluxo só avança quando a tarefa é concluída. Outros são totalmente automáticos. Na descrição de cada nó abaixo, essa distinção está indicada.

Exemplo prático: fluxo completo

Para ilustrar como os nós trabalham juntos, veja um fluxo de solicitação e aprovação de compras que utiliza todos os grupos de nós:

Neste exemplo:

1. O fluxo é disparado manualmente (Início).
2. O solicitante preenche os dados da compra (Formulário — gera tarefa).
3. A I.A. gera um resumo automático da solicitação (IA Geradora — automático).
4. O nó de Rotas avalia o valor: compras até R$ 5.000 vão para o gestor; acima disso, para a diretoria.
5. O aprovador analisa e decide (Aprovação — gera tarefa).
6. Os caminhos se reencontram no Mesclar.
7. O item é criado automaticamente na categoria "Compras" (Operações de Dados — automático).
8. O solicitante recebe uma confirmação por E-mail (automático).
9. O pedido é enviado ao ERP externo via Requisição HTTP (automático).
10. O fluxo aguarda 2 dias (Atraso — automático).
11. Um responsável confere a entrega (Tarefa — gera tarefa).
12. O fluxo encerra (Fim).

Triggers

Nós que iniciam o fluxo. Todo Spaceflow começa obrigatoriamente com um trigger.

Nó de Início

O primeiro nó de Início é criado automaticamente ao montar um novo Spaceflow. Ele define o evento que dispara o fluxo. Os tipos de gatilho disponíveis são:

• Manual — o fluxo é iniciado por um membro do workspace, sob demanda.
• Ações em itens — o fluxo dispara automaticamente quando um item de uma categoria é criado, atualizado ou excluído.
• Timer — o fluxo é executado automaticamente em intervalos programados (ex: todo dia às 8h, toda segunda-feira).
• Webhook — o fluxo é disparado por uma chamada externa. Um webhook é um endereço URL gerado pelo ENSPACE que fica "esperando" receber uma requisição de outro sistema. Quando essa requisição chega, o fluxo inicia automaticamente. Isso permite que sistemas externos — como um ERP, um site ou até outro Spaceflow — iniciem processos no ENSPACE sem intervenção manual.

Nó de Início como Subfluxo

Ao adicionar qualquer nó de Início além do primeiro, ele se comporta como um nó de subfluxo. Em vez de definir um gatilho, ele aponta para outro Spaceflow existente no workspace e o inicia durante a execução do fluxo atual.

O subfluxo pode ser disparado de duas formas:

• Automático — o fluxo pai inicia o subfluxo diretamente ao chegar nesse nó.
• Manual — o fluxo pai gera uma tarefa para que um membro do workspace escolha qual subfluxo iniciar. Gera tarefa.

Ações

Nós que executam tarefas no fluxo de trabalho. Alguns geram tarefas para ação humana, outros executam operações automáticas.

I.A.

Nós que utilizam inteligência artificial para ampliar as capacidades do fluxo. São configurados por meio de um campo de prompt — uma instrução em texto que você escreve para dizer à I.A. o que deve fazer. Pense no prompt como uma ordem ou pergunta que você faria a um assistente. Exemplo: "Resuma o conteúdo do campo Descrição em no máximo 3 frases." É possível combinar instruções fixas com variáveis de nós anteriores, fazendo a I.A. produzir conteúdo personalizado para cada execução.

Todos os nós de I.A. são automáticos — não geram tarefa.

Lógica e Controle

Nós que controlam o caminho, a lógica e o encerramento do fluxo. Todos são automáticos — executam sem intervenção humana e sem gerar tarefa.

Documentação

Nós para criação e gestão de documentos a partir dos dados do fluxo.

Integrações

Nós que conectam o fluxo com sistemas e serviços externos.

Comportamento dos dados

As execuções do Spaceflow seguem regras específicas de fluxo de dados entre os nós:

• Entradas e saídas — cada nó recebe os dados do nó anterior e pode transformá-los ou repassá-los adiante. Variáveis preenchidas em um formulário, por exemplo, ficam disponíveis para todos os nós subsequentes.
• Nós de tarefa — quando o fluxo atinge um nó que gera tarefa (Formulário, Aprovação, Tarefa ou Subfluxo Manual), a execução é pausada até que um usuário complete a ação. O estado do fluxo é preservado durante a pausa.
• Nós automáticos — executam imediatamente sem intervenção humana. Se um nó automático falhar (ex: API externa indisponível), o erro é registrado nos Logs e o fluxo pode ser interrompido.
• Nós de I.A. — consomem en-credits durante a execução. O consumo ocorre no momento em que o nó é processado, conforme o volume de tokens utilizados.
• Subfluxos — um nó de Início adicional inicia outro Spaceflow, mas não transfere dados automaticamente para ele. Os fluxos executam de forma independente.
• Edições em fluxos ativos — alterações na estrutura do fluxo (adição, remoção ou reconfiguração de nós) aplicam-se apenas a novas execuções. Fluxos em andamento continuam na versão anterior.

Casos de uso

• Solicitação e aprovação: fluxo de compras que coleta dados, rotea por valor, solicita aprovação hierárquica e cria o item automaticamente na categoria destino.
• Integração com ERP: recebimento de pedidos via webhook, criação de itens no ENSPACE, envio de confirmação por e-mail e requisição HTTP para atualizar status no sistema legado.
• Classificação com I.A.: formulário de suporte técnico com IA Roteadora que direciona chamados para filas diferentes com base no conteúdo descritivo.
• Automação temporal: fluxo com trigger Timer que executa rotinas diárias de verificação, consulta itens pendentes e envia lembretes automáticos.
• Orquestração entre workspaces: Spaceflow no workspace A envia requisição HTTP para webhook do workspace B, sincronizando dados entre ambientes distintos.
• Documentação automática: fluxo que coleta dados de um formulário e gera contratos ou relatórios em PDF (quando o nó de Documentação estiver disponível).

Boas práticas

• Utilize nós de Fim explicitamente em todos os caminhos do fluxo para garantir encerramento controlado e evitar execuções pendentes.
• Nomeie as arestas entre nós condicionais com títulos descritivos — isso facilita a leitura e manutenção do fluxo.
• Combine IA Geradora com variáveis de nós anteriores para produzir conteúdo personalizado (ex: e-mails com nome do cliente e dados da solicitação).
• Utilize Mesclar após bifurcações condicionais para reunir caminhos e evitar duplicação de nós subsequentes.
• Configure credenciais em Configurações > Credenciais antes de usar nós de Requisição HTTP — isso evita expor tokens e senhas no corpo do fluxo.
• Monitore os Logs regularmente para identificar falhas em nós automáticos que passaram pela validação estrutural do editor.
• Lembre-se de que alterações em fluxos ativos não afetam execuções em andamento — planeje versionamento em momentos de baixa atividade.
• Evite criar loops infinitos: ao usar nós de Loop ou Iterador (quando disponíveis), defina condições de saída claras para não consumir en-credits desnecessariamente.