> ## Documentation Index
> Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ferramenta de Migração de Workflows V1

> Migre seus Workflows V1 existentes para os Workflows V2 usando a ferramenta de migração integrada à plataforma.

<Info>
  A ferramenta de migração está disponível desde **1º de junho de 2026 (v2.1.0)**. Os Workflows V1 serão removidos em **7 de setembro de 2026** — veja os passos abaixo para migrar.
</Info>

Os Workflows V1 estão sendo descontinuados em favor dos [Workflows V2](/tools/workflows-v2), que apresentam um canvas visual redesenhado, mais tipos de triggers, melhor depuração e histórico de versões. Em vez de reconstruir seus workflows do zero, a ferramenta de migração integrada à plataforma permite que você migre workflows V1 existentes para V2 diretamente no local.

Para informações sobre o cronograma de descontinuação e o que está mudando, consulte a página [Descontinuação dos Workflows V1](/changelogs/feature-deprecations/workflows-v1-deprecation).

## Antes de Começar

<CardGroup cols={2}>
  <Card title="Ferramenta de migração disponível" icon="circle-check">
    A Ferramenta Migrate Flow está disponível desde 1º de junho de 2026. Você pode migrar qualquer workflow V1 hoje — os workflows V1 continuam funcionando normalmente até 7 de setembro de 2026.
  </Card>

  <Card title="Planeje atualizações downstream" icon="triangle-exclamation">
    Após a migração, todos os agents ou integrações que chamam o workflow V1 precisarão ser atualizados para apontar para o novo workflow V2 antes de **7 de setembro de 2026**, quando o V1 for removido.
  </Card>
</CardGroup>

## Como Migrar um Workflow

<Warning>
  Após a migração, você deve **executar e verificar cada etapa individual** do workflow no V2 — não apenas uma execução ponta a ponta. A verificação etapa por etapa é a única maneira confiável de detectar diferenças sutis de comportamento entre V1 e V2 (referências de variáveis, formato do payload do trigger, ramificações, tentativas de repetição, etc.).
</Warning>

<Steps>
  <Step title="Faça um inventário dos seus workflows V1">
    Vá até **Workflows** e liste todos os workflows V1 ainda em uso. Anote:

    * Quais workflows são acionados por **agents, APIs ou integrações externas** — estes precisarão de atualizações downstream após a migração.
    * O **proprietário** de cada workflow, para que a pessoa certa valide após a migração.
    * Uma **saída de referência** de uma execução V1 bem-sucedida recente para cada workflow — você comparará a saída V2 com ela posteriormente.
  </Step>

  <Step title="Abra um workflow no construtor V1">
    Navegue até **Workflows** e abra o workflow que deseja migrar. Certifique-se de que está em um estado estável e funcional — migre primeiro os fluxos publicados e testados.
  </Step>

  <Step title="Clique em 'Migrate Flow'">
    No **canto superior direito** do construtor V1, clique em **Migrate Flow**. Isso inicia a validação automática contra o catálogo V2.
  </Step>

  <Step title="Revise o resumo da migração">
    O modal de migração exibe um status **Pass** (Aprovado) ou **Fail** (Reprovado) junto com quaisquer erros ou avisos.

    | Resultado         | O que significa                                       | O que fazer                                             |
    | :---------------- | :---------------------------------------------------- | :------------------------------------------------------ |
    | **Pass**          | Todas as ações e configurações são compatíveis com V2 | Clique em **Continue & Import** para prosseguir         |
    | **Fail (avisos)** | Algumas ações podem se comportar diferentemente no V2 | Não é possível auto-migrar — envie um ticket de suporte |
    | **Fail (erros)**  | Ações incompatíveis detectadas                        | Não é possível auto-migrar — envie um ticket de suporte |

    <Warning>
      Workflows que falham na validação não podem ser migrados automaticamente. Entre em contato com seu gerente de conta da Automation Anywhere ou abra um ticket através do [portal de suporte](https://apeople.automationanywhere.com/) para migração assistida.
    </Warning>
  </Step>

  <Step title="Clique em 'Continue & Import'">
    Isso cria a versão V2 do seu workflow com todas as ações, triggers e configurações transferidas. O workflow V1 original **não** é excluído ou desativado.
  </Step>

  <Step title="Execute e verifique cada etapa no workflow V2">
    **Não** confie em uma única execução ponta a ponta. Percorra o workflow etapa por etapa:

    1. **Abra o construtor V2** e revise o canvas — confirme que cada ação, trigger, ramificação, loop e conexão do V1 está presente.
    2. **Verifique a configuração em cada etapa** — credenciais, campos de entrada, variáveis mapeadas, seleções de menu suspensão e referências de expressão devem corresponder ao V1.
    3. **Execute o workflow em modo de teste/depuração** com um payload de entrada realista.
    4. **Para cada etapa, abra os detalhes da execução** e verifique:
       * A etapa foi **executada com sucesso** (sem erro, sem estado pulado)
       * A **entrada** da etapa corresponde ao que o V1 teria enviado
       * A **saída** da etapa corresponde à saída de referência do V1 (formato e valores)
       * As **referências de variáveis** downstream são resolvidas corretamente (sem `undefined`, sem `{{...}}` não processados)
       * A **lógica de ramificação / loop** avalia para o mesmo caminho que o V1
       * **Tentativas de repetição, timeouts e etapas de tratamento de erros** funcionam conforme esperado
    5. **Execute novamente com entradas de caso extremo** (campos vazios, payloads grandes, caminhos de falha) e repita a verificação etapa por etapa.
    6. **Registre quaisquer inconsistências** em relação à saída de referência do V1 e corrija-as no construtor V2 antes de publicar.

    <Tip>
      Use o **log de Execuções** do V2 para detalhar o JSON de entrada/saída de cada etapa. Esta é a maneira mais rápida de identificar diferenças de mapeamento de variáveis ou esquema entre V1 e V2.
    </Tip>
  </Step>

  <Step title="Publique o workflow V2">
    Publique somente depois que cada etapa tiver sido verificada. Clique em **Publish** para tornar o workflow migrado ativo. O V2 mantém um **histórico de versões** completo, permitindo reverter para uma versão anterior, se necessário.

    <Note>
      O workflow V1 original permanece acessível e pode continuar executando até **7 de setembro de 2026**, quando o V1 for removido. Pode ser necessário atualizar quaisquer agents ou integrações que estavam chamando o workflow V1 para apontar para o novo workflow V2 antes dessa data.
    </Note>
  </Step>

  <Step title="Atualize os chamadores downstream">
    Antes de **7 de setembro de 2026**, atualize tudo que chama o workflow V1 para apontar para o novo workflow V2:

    * Agents que invocam este workflow
    * Integrações externas usando o endpoint ou ID do V1
    * Automações e trabalhos agendados
  </Step>

  <Step title="Monitore o workflow V2 em produção">
    Para as primeiras execuções em produção:

    * Acompanhe o **log de Execuções** e faça verificações pontuais da saída de cada etapa em relação à referência V1.
    * Mantenha o workflow V1 ativo (permanece acessível até **7 de setembro de 2026**) para que possa redirecionar o tráfego se uma regressão aparecer.
    * Reverta usando o **histórico de versões** do V2, se necessário.
  </Step>

  <Step title="Repita para cada workflow V1 restante">
    A migração é **por workflow** — não existe ação em lote. Percorra seu inventário do Passo 1 até que todos os workflows V1 sejam migrados, verificados etapa por etapa e publicados.
  </Step>
</Steps>

## Validação: Aprovado vs. Reprovado

A ferramenta de migração valida seu workflow V1 antes de migrá-lo. Compreender o resultado da validação ajuda a decidir os próximos passos.

| Resultado         | O que significa                                       | O que fazer                                        |
| :---------------- | :---------------------------------------------------- | :------------------------------------------------- |
| **Pass**          | Todas as ações e configurações são compatíveis com V2 | Clique em **Continue & Import** para prosseguir    |
| **Fail (avisos)** | Algumas ações podem se comportar diferentemente no V2 | Não é possível migrar — envie um ticket de suporte |
| **Fail (erros)**  | Ações incompatíveis detectadas                        | Não é possível migrar — envie um ticket de suporte |

<Warning>
  Workflows que falham na validação não podem ser migrados automaticamente. Entre em contato com seu gerente de conta da Automation Anywhere ou abra um ticket de suporte através do [portal de suporte da Automation Anywhere](https://apeople.automationanywhere.com/) para migração assistida.
</Warning>

## Após a Migração

Quando um workflow é publicado no V2:

* O **workflow V1 original permanece acessível e continuará executando** até **7 de setembro de 2026**, quando o V1 for removido. A migração não desativa ou exclui o workflow V1.
* Qualquer **agent, integração ou automação** que chamava o endpoint do workflow V1 precisará ser reconfigurado para chamar o novo workflow V2 antes de 7 de setembro de 2026.
* Use o **log de Execuções** no V2 para monitorar execuções e verificar se o workflow migrado se comporta conforme esperado.
* O **histórico de versões** do V2 salva cada estado publicado, permitindo reverter para uma versão anterior, se necessário.

## Perguntas Frequentes

<AccordionGroup>
  <Accordion title="Posso migrar todos os workflows de uma vez?">
    Não. A migração é acionada por workflow usando o botão **Migrate Flow** na interface V1. Cada workflow deve ser validado e migrado individualmente.
  </Accordion>

  <Accordion title="O que acontece com o workflow V1 após eu migrar?">
    O workflow V1 original permanece acessível e continuará executando até **7 de setembro de 2026**. Ele não é desativado ou excluído após a migração. Em 7 de setembro de 2026, todos os workflows V1 serão removidos e aqueles que não foram migrados pararão de funcionar.
  </Accordion>

  <Accordion title="Preciso atualizar as integrações após migrar?">
    Sim. Agents, integrações externas ou processos de automação que chamam o workflow V1 por endpoint ou ID precisarão ser atualizados para apontar para o novo workflow V2 após a migração.
  </Accordion>

  <Accordion title="E se meu workflow falhar na validação?">
    Workflows com erros ou avisos não podem ser migrados automaticamente usando a ferramenta. Envie um ticket de suporte através do [portal de suporte da Automation Anywhere](https://apeople.automationanywhere.com/) para migração assistida.
  </Accordion>

  <Accordion title="Minha configuração de workflow será preservada?">
    A ferramenta de migração foi projetada para transferir sua configuração de workflow existente para o V2. Após a migração, revise todas as etapas, triggers e configurações no construtor V2 e teste antes de publicar.
  </Accordion>

  <Accordion title="Qual é o prazo para migrar?">
    Os Workflows V1 serão removidos em **7 de setembro de 2026**. A ferramenta de migração está disponível desde 1º de junho de 2026, dando aproximadamente três meses para migrar. Os workflows V1 continuarão executando durante este período, mas recomendamos migrar o mais cedo possível para ter tempo de atualizar as integrações downstream e verificar o comportamento no V2. Consulte a página [Descontinuação dos Workflows V1](/changelogs/feature-deprecations/workflows-v1-deprecation) para o cronograma completo.
  </Accordion>
</AccordionGroup>

## Suporte

Para assistência na migração ou dúvidas sobre workflows incompatíveis, entre em contato com seu gerente de conta da Automation Anywhere ou abra um ticket de suporte através do [portal de suporte da Automation Anywhere](https://apeople.automationanywhere.com/).

<CardGroup cols={2}>
  <Card title="Descontinuação dos Workflows V1" icon="triangle-exclamation" href="/changelogs/feature-deprecations/workflows-v1-deprecation">
    Cronograma completo de descontinuação, detalhes de impacto e o que está mudando.
  </Card>

  <Card title="Workflow Builder V2" icon="arrow-right" href="https://ai-kb.automationanywhere.com/tools/workflows-v2">
    Saiba o que há de novo nos Workflows V2 e como construir com o canvas atualizado.
  </Card>
</CardGroup>