---
title: Fluxo de trabalho
description: Crie, teste, implante e revise fluxos de trabalho de projeto reutilizáveis quando o construtor estiver disponível.
---

Fluxo de trabalho transforma um processo repetível em etapas conectadas que o Runner pode executar com as mesmas entradas e regras novamente.

> **Condicional:** A interface de Fluxo de trabalho existe, mas a navegação padrão do projeto atual não expõe uma entrada de Fluxo de trabalho. Use-a apenas quando o Runner exibir uma entrada de Fluxo de trabalho aprovada para seu espaço de trabalho ou o suporte do Runner fornecer um caminho aprovado. Não adivinhe ou edite uma URL para acessá-la. Se seu plano permitir apenas uma visualização, o Runner pode mostrar a página mantendo seus controles bloqueados.

## Caminho de entrada

Abra a entrada **Fluxo de trabalho** apenas quando o Runner a apresentar em seu espaço de trabalho. A página lista fluxos de trabalho para o projeto atual. Se nenhuma entrada estiver presente, use [Disponibilidade de recursos](./feature-availability) ou entre em contato com o suporte em vez de tentar uma URL direta.

## Antes de começar

- O acesso ao Fluxo de trabalho depende do lançamento de recursos atual e do plano.
- Confirme o projeto e os serviços conectados antes de testar ou implantar um fluxo de trabalho.
- Uma visualização ou rascunho salvo não está ativo; implantação e ativação são ações consequentes separadas.

## Lista de fluxos de trabalho

Quando não há fluxos de trabalho, selecione **Criar Fluxo de trabalho**. Quando a lista já tem itens, use **Novo Fluxo de trabalho**.

| Controle | O que acontece depois que você o seleciona |
| --- | --- |
| **Criar Fluxo de trabalho** ou **Novo Fluxo de trabalho** | Abre **Criar um Fluxo de trabalho**. |
| **Em branco** | Cria um **Fluxo de trabalho sem título** e abre seu construtor. |
| Cartão de modelo | Cria um fluxo de trabalho a partir desse modelo e abre seu construtor. Se os modelos falharem ao carregar, **Tentar novamente** os solicita novamente. |
| Nome do fluxo de trabalho | Abre esse fluxo de trabalho no construtor. |
| **Renomear** | Torna o nome editável. Pressionar Enter ou clicar em outro lugar salva; Escape cancela a edição. |
| **Fixar no topo** / **Desafixar** | Move o fluxo de trabalho para dentro ou para fora do grupo fixado. Não executa o fluxo de trabalho. |
| **Duplicar** | Cria uma cópia e abre a cópia no construtor. |
| **Exportar** | Baixa o fluxo de trabalho como um arquivo JSON. Não implanta ou executa nada. |
| **Excluir** | Abre uma confirmação. Confirmar remove permanentemente esse fluxo de trabalho e não pode ser desfeito. |

Use o menu Mais de cada linha para encontrar **Renomear**, **Fixar no topo** ou **Desafixar**, **Duplicar**, **Exportar** e **Excluir**.

Os rótulos de linha também podem mostrar se uma versão é **Ativa**, tem um **Rascunho à frente**, expõe um Endpoint ou está vinculada a um Agendamento ou Evento. Um rótulo pausado ou bloqueado por plano significa que o acionamento automático não está ativo no momento.

### Trabalhar com vários fluxos de trabalho

Selecione a caixa de seleção ao lado de uma ou mais linhas. A barra de seleção mostra quantos estão selecionados e oferece:

- **Exportar** para baixar os fluxos de trabalho selecionados.
- **Excluir** para abrir uma confirmação em massa. Confirmar remove permanentemente cada fluxo de trabalho selecionado.
- **Limpar** para remover a seleção sem alterar nenhum fluxo de trabalho.

**Selecionar tudo** seleciona os fluxos de trabalho mostrados na lista atual. Sempre reconfira a contagem antes da exclusão em massa.

## Construir e salvar

A tela do construtor é onde você adiciona etapas, as conecta e configura o que cada etapa recebe e faz. **Adicionar componente** abre a biblioteca de componentes pesquisável. Os controles da tela ampliam, reduzem, ajustam o fluxo de trabalho à tela e organizam automaticamente as etapas conectadas.

As alterações são salvas automaticamente; não há um botão Salvar separado. A seta Voltar conclui um salvamento pendente antes de retornar à lista de fluxos de trabalho.

| Estado de salvamento | O que fazer |
| --- | --- |
| **Salvando…** | Aguarde antes de fechar a página ou implantar. |
| **Salvo** | A alteração mais recente da tela está armazenada. |
| **Falha ao salvar** | Selecione **Tentar novamente** após verificar a conexão. |
| **Conflito — suas alterações não foram salvas** | Uma versão salva é mais recente. **Recarregar** descarta as edições locais conflitantes e carrega a versão salva. |

O painel inferior contém **Playground** e **Histórico**. No Playground, complete as entradas de texto, produto ou mídia necessárias antes de executar. O controle de execução permanece indisponível enquanto as entradas necessárias estão faltando. Os resultados aparecem na área de saída.

O menu Mais do construtor também fornece **Exportar JSON** e **Importar JSON…**. Exportar baixa a tela atual. Importar substitui imediatamente a tela atual e dispara salvamento automático sem confirmação, portanto exporte um backup e verifique o arquivo selecionado antes de importar.

## Escolha o teste certo

Os testes podem ter consequências muito diferentes.

| Controle | O que acontece depois que você o seleciona |
| --- | --- |
| **Simular sem chamar APIs** | Abre um diálogo de simulação. Use dados de amostra gerados ou cole JSON, depois selecione **Executar Simulação**. Ações do lado de escrita, como e-mails, postagens do Slack e alterações de loja, são simuladas. |
| **Teste ao vivo — efeitos colaterais reais, marcado como isTest** | Abre um diálogo de teste ao vivo. Use dados gerados, JSON colado ou um evento recente quando disponível. **Executar Teste ao vivo** faz chamadas reais de API e pode enviar mensagens ou alterar serviços conectados. A execução é marcada como um teste no histórico. |
| **Pular esperas** | Durante um teste ao vivo, pula períodos de espera configurados para que o teste possa continuar mais cedo. Não remove outros efeitos reais. |
| **Executar fluxo de trabalho** | Inicia o fluxo de trabalho configurado imediatamente e abre Histórico. Suas etapas podem ter efeitos reais; revise cada etapa e entrada primeiro. |
| **Parar execução** | Solicita que a execução atual seja interrompida. O trabalho já concluído não é revertido. |
| **Cache** | Em uma reexecução, pula nós elegíveis cujas entradas não foram alteradas para que você possa se concentrar no trabalho alterado a jusante. |

Use Simulação para verificar ramificação e fluxo de dados. Use Teste ao vivo apenas quando efeitos colaterais reais são aceitáveis nas contas conectadas.

## Revisar histórico de execução

Abra **Histórico** no painel inferior para ver execuções anteriores. Filtre a lista com **Ao vivo**, **Teste** ou **Tudo**, depois selecione uma execução para inspecionar seus resultados de nó, saída, tempo e erros. Os status incluem Concluído, Falhou, Em execução e Cancelado.

Se a lista disser **Nenhuma execução ainda**, o fluxo de trabalho atual não tem execução registrada. Iniciar outra execução não é uma correção para uma falha; abra a execução com falha primeiro e leia seu erro.

Alguns nós com falha elegíveis oferecem **Tentar novamente a partir de "nó"**. Isso inicia uma nova tentativa imediatamente, sem outra confirmação. As ações a jusante podem ser executadas novamente, portanto verifique as mensagens ou alterações de loja já produzidas pela execução com falha primeiro.

## Implantar e ativar

Selecione **Implantar** para abrir **Implantar Fluxo de trabalho**. Revise o resumo de alterações, compatibilidade de contrato de API, resultados de validação e changelog opcional antes de continuar.

Você pode opcionalmente vincular o fluxo de trabalho implantado a um agendamento ou um evento. Apenas um desses tipos de acionador pode ser selecionado por vez.

- **Implantar** publica uma versão com as configurações selecionadas.
- **Ativar e Implantar** aparece quando uma nova vinculação de agendamento ou evento tornaria a automação ativa. Confirmar publica a versão e permite que acionadores futuros sejam executados automaticamente com efeitos reais.

Um erro de salvamento, conflito não resolvido ou problema de validação pode bloquear a implantação. Resolva-o em vez de selecionar Implantar repetidamente.

Após a implantação, o status de produção pode mostrar **Não implantado**, **Rascunho à frente** ou **Ativo**, mais **Sem acionador**, **Ativo** ou **Pausado** para a vinculação. Abrir uma vinculação existente oferece controles consequentes:

- **Pausar** interrompe acionadores automáticos mas mantém o fluxo de trabalho e a vinculação.
- **Retomar** permite que a vinculação retida seja acionada novamente.
- **Remover** exclui permanentemente a vinculação mas não exclui o fluxo de trabalho.

Cada ação abre uma confirmação e pode incluir um motivo. Remover a marca de uma vinculação existente durante a implantação pausa essa vinculação em vez de removê-la permanentemente.

## Histórico de versão e reversão

Selecione **Histórico de versão** para abrir o painel **Histórico de versão**.

| Ação | Resultado |
| --- | --- |
| **Reverter** | Abre **Reverter para esta versão?**. **Confirmar** faz a versão implantada selecionada substituir a versão implantada atual. Isso pode alterar o que as execuções futuras fazem, mas não substitui a tela de rascunho atual. |
| **Restaurar** no Histórico de Rascunho | Substitui a tela atual pelo rascunho salvo selecionado após confirmação. Alterações de tela não salvas ou mais recentes podem ser perdidas. |

Adicione um motivo de reversão opcional para que outros membros do espaço de trabalho entendam a alteração. Revise a tela restaurada e o estado de implantação antes de iniciar outra execução.

## Lista de verificação de operação segura

1. Confirme que você está no projeto e fluxo de trabalho corretos.
2. Aguarde **Salvo** antes de testar ou implantar.
3. Complete e revise cada entrada necessária.
4. Comece com **Executar Simulação** quando possível.
5. Use Teste ao vivo ou Executar fluxo de trabalho apenas quando seus efeitos de serviço conectado são aceitáveis.
6. Inspecione **Histórico** e saídas antes de implantar.
7. Trate **Ativar e Implantar**, reversão, restauração e exclusão como ações consequentes que exigem uma revisão final.

## Solução de problemas

| Problema | Próxima etapa |
| --- | --- |
| Nenhuma entrada **Fluxo de trabalho** é visível | Isso é esperado na navegação padrão. Não adivinhe uma URL; veja [Disponibilidade de recursos](./feature-availability) ou pergunte ao suporte do Runner se seu espaço de trabalho tem uma entrada aprovada. |
| Os controles são bloqueados por uma visualização de plano | Siga a mensagem do plano na tela ou pergunte a um proprietário do espaço de trabalho sobre o acesso. |
| A lista de modelos falha | Selecione **Tentar novamente** ou crie um fluxo de trabalho **Em branco**. |
| O botão Executar está indisponível | Complete cada entrada necessária e corrija qualquer valor inválido. |
| O conflito de salvamento aparece | Decida se a versão salva deve vencer antes de selecionar **Recarregar**, porque as edições locais conflitantes são descartadas. |
| A execução falha | Abra-a em **Histórico**, mantenha o erro e as entradas visíveis e evite iniciar execuções idênticas repetidamente. |
| A implantação está bloqueada | Resolva as mensagens de salvamento, conflito, contrato ou validação mostradas no diálogo de implantação. |

## Guias relacionadas

- [Automações](../automate-test-and-create/automations)
- [Estados e detalhes de tarefas](../work-with-runner/task-states-and-details)
- [Solucionar problemas de tarefas do Runner](../help-and-reference/troubleshoot-runner-tasks)
- [Disponibilidade de recursos](./feature-availability)