De modelo de Flow a Flow: criar, configurar, ativar

Como as três peças se encaixam — Connection, modelo de Flow e Flow — e os passos para transformar um modelo em um flow em execução: vincular conexões, teste a seco, publicar e gerenciar.

O artigo “Modelos de Flow” desta seção cobre os modelos em si: criar, editar, clonar, importar/exportar. Este artigo cobre o passo que aquele deixa de fora: como um modelo vira um Flow real e em execução, e como os três conceitos se relacionam.

Os três conceitos#

Criar um Flow de um modelo#

1. Abra Integration → Flows → Novo flow e escolha um modelo da biblioteca (ou comece em branco; poderá salvá-lo como modelo depois).
2. O canvas abre com os nós do modelo como espaços reservados. Clique em cada nó que fala com um sistema externo e vincule a Connection que ele deve usar: o nó “trazer pedidos” recebe sua conexão Shopify, o de “comprar etiqueta” a sua conexão UPS.
3. Um flow não pode ser publicado enquanto um nó for espaço reservado: o designer marca claramente os nós sem vínculo; trabalhe neles até não restar nenhum.
4. Complete os detalhes que o modelo deixou abertos: o mapping desta conexão, filtros (ex. só pedidos com uma etiqueta) e o gatilho: por horário, por evento (novo pedido, envio criado) ou só manual.
5. Faça um teste a seco (dry run): executa contra as conexões reais em modo de teste e mostra a entrada e saída de cada nó sem confirmar alterações. Corrija o que ele expuser.
6. Publique. Publicar congela esta configuração como a versão ativa; o flow começa a executar conforme seu gatilho.

Configurar e gerenciar um Flow ativo#

• Ativar / desativar: desativar pausa todas as execuções na hora sem apagar nada; use quando um canal estiver em manutenção ou uma credencial for rotacionada. Reative quando estiver pronto.
• Editar com segurança: abrir o designer de um flow publicado edita um rascunho; as execuções ativas continuam na versão publicada até você publicar de novo. Se uma versão nova falhar, volte à anterior na página do flow.
• Teste por passo: o designer pode testar um único passo contra sua conexão vinculada, útil quando um nó falha e você quer verificar a correção sem executar o flow inteiro.
• Salvar como modelo: quando um flow funciona bem, salve-o como modelo; a cópia devolve as conexões a espaços reservados, pronta para a próxima loja ou cliente.
• Flows de simulação: um flow cujos nós usam conexões sem chaves roda de ponta a ponta com dados de exemplo, marcado como simulado em Runs; é a forma mais rápida de validar um modelo antes de ter credenciais reais.