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

# Clonar workflows existentes

> Copie um ou vários workflows para outro projeto da sua empresa sem reconstruí-los.

Quando você já tem um workflow que funciona, não precisa refazê-lo em outro projeto. Você pode selecionar os workflows que quiser e copiá-los para outro projeto da sua empresa: a Jelou leva o canvas completo, os inputs, as perguntas de treinamento e a rota de AI Routing.

É a forma habitual de passar um fluxo de um ambiente de testes para produção, de replicar uma implementação para outra marca ou de reaproveitar um fluxo que você já resolveu.

<Note>
  Aqui você copia **workflows individuais** entre projetos que já existem. Se o que você quer é criar um projeto novo a partir de outro, com toda a sua configuração, use **Clonar existente** ao [criar um projeto](/pt/guias/primeiros-passos/criar-projeto).
</Note>

## Antes de começar

* Você precisa de permissão para **criar workflows** no projeto. Sem ela, o ícone não aparece.
* A opção não está disponível no modo somente leitura nem enquanto você revisa uma versão publicada.
* O projeto de destino deve ser **outro** projeto da sua empresa. O projeto que você tem aberto não aparece na lista.

## Clone os workflows

<Steps>
  <Step title="Ative o modo de clonagem">
    Na barra lateral, na seção **Workflows**, clique no ícone de clonar workflows que fica ao lado do **+**.

    A lista entra em modo de seleção: cada workflow mostra uma caixa de seleção e os menus de ações de cada linha ficam ocultos.
  </Step>

  <Step title="Selecione os workflows">
    Marque a caixa de cada workflow que quiser copiar. Você pode escolher um ou vários.
  </Step>

  <Step title="Abra o modal de clonagem">
    O botão no pé da barra lateral muda para **Clonar Workflow** ou **Clonar Workflows** conforme quantos você marcou. Ele fica desabilitado até você selecionar pelo menos um.
  </Step>

  <Step title="Escolha o projeto de destino">
    Em **Clonar em**, selecione o projeto para o qual quer copiar os workflows. O campo tem busca, útil quando a sua empresa tem muitos projetos.
  </Step>

  <Step title="Revise a validação">
    Ao escolher o destino, a Jelou revisa a seleção e diz o que vai acontecer antes de tocar em nada:

    * Se houver algo que impeça a cópia, aparece em vermelho e o botão de confirmar fica desabilitado.
    * Se houver apenas avisos, eles aparecem em âmbar e você pode continuar.
    * Se não houver nada a reportar, nenhuma mensagem aparece.
  </Step>

  <Step title="Decida se quer ir ao projeto de destino">
    Quando nada bloqueia a cópia, aparece a caixa **Ir para o projeto de destino quando a clonagem terminar**, marcada por padrão. Desmarque se preferir permanecer onde está.
  </Step>

  <Step title="Confirme">
    Clique em **Clonar** com o número de workflows selecionados. Enquanto executa, o botão mostra **Clonando...** e o projeto de destino e a caixa ficam fixos, para que a operação não mude no meio do caminho.
  </Step>

  <Step title="Pronto">
    Ao terminar, você verá uma notificação de confirmação. Se deixou a caixa marcada, a Jelou leva você para a lista de workflows do projeto de destino.
  </Step>
</Steps>

## Como o destino de cada workflow é decidido

A Jelou emparelha cada workflow pelo seu **nome**, como ele se chama hoje em cada projeto. É isso que determina o que acontece com ele:

| Situação no projeto de destino     | O que a Jelou faz                                                    |
| ---------------------------------- | -------------------------------------------------------------------- |
| Nenhum workflow tem esse nome      | **Cria** o workflow, mantendo o nome do original                     |
| Existe exatamente um com esse nome | **Substitui**: o conteúdo do destino é sobrescrito pelo da origem    |
| Existe mais de um com esse nome    | **Bloqueia a cópia**, porque não consegue escolher para qual apontar |

Nenhum workflow é renomeado no processo. Na substituição, o workflow do destino mantém o próprio nome — justamente o nome que emparelhou os dois.

<Warning>
  Substituir sobrescreve o conteúdo do workflow que já estava no projeto de destino. Antes de confirmar, leia o aviso do modal: ele diz exatamente qual workflow será sobrescrito.
</Warning>

## O que é copiado

| Elemento                          | Como chega ao projeto de destino                                                                                 |
| --------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| Canvas de cada canal              | Os nós, suas conexões e sua configuração são copiados                                                            |
| Inputs                            | Copiados como estão                                                                                              |
| Perguntas de treinamento          | Copiadas como estão                                                                                              |
| Rota de AI Routing                | Criada ou atualizada apontando para o workflow copiado                                                           |
| Canais                            | Emparelhados por tipo. Se o workflow de origem tem um canal de um tipo que não existe no destino, a Jelou o cria |
| Transferências para agente humano | Mantêm sua configuração de atribuição                                                                            |
| Nós de banco de dados             | Continuam apontando para os mesmos bancos de dados da sua empresa                                                |

O projeto de origem nunca é modificado: a clonagem apenas o lê.

## O que você precisa configurar de novo

Alguns nós viajam com sua estrutura e suas conexões intactas, mas perdem a referência que estava vinculada ao projeto de origem. O nó continua no canvas, no lugar e conectado, mas você precisa escolher o recurso novamente:

| Nó                                                        | O que é mantido                     | O que você precisa fazer                                                                                                                                      |
| --------------------------------------------------------- | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Modelo HSM                                                | Suas saídas e suas conexões         | Escolher o modelo novamente                                                                                                                                   |
| Mensagem com WhatsApp Flow                                | O nó e suas conexões                | Escolher o flow novamente, além da tela e dos dados se você os usava                                                                                          |
| AI Agent                                                  | Seu prompt, seu modelo e suas tools | Carregar o conhecimento novamente: as fontes chegam vazias e a leitura de arquivos fica desativada                                                            |
| Mensagens que redirecionam para outro workflow ao expirar | A mensagem e seus botões            | Se o workflow para o qual ela redirecionava não viajou na seleção nem existe no destino, o redirecionamento ao expirar fica desativado. Configure-o novamente |

<Warning>
  Revise esses nós **antes de publicar** no projeto de destino. Um nó de modelo HSM ou de WhatsApp Flow sem recurso selecionado falha em execução, e um AI Agent sem o seu conhecimento vai responder sem a informação que você esperava.
</Warning>

## Variáveis e segredos

Variáveis e segredos **não são copiados**. Os nós que os usam continuam buscando-os por nome no projeto de destino, então eles precisam existir lá antes de você clonar.

<Warning>
  Se um workflow usa uma variável ou um segredo que não existe no projeto de destino, a cópia é bloqueada e o modal informa qual nome está faltando. Crie-o primeiro no projeto de destino e tente novamente.
</Warning>

## O que pode impedir a clonagem

Estes são os casos que bloqueiam a cópia. Em todos eles, a mensagem do modal nomeia o workflow ou o recurso envolvido para você saber o que corrigir:

| Motivo                                 | O que significa                                                                                           |
| -------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| Variável ou segredo inexistente        | O workflow usa uma variável ou um segredo que não está no projeto de destino                              |
| Nome ambíguo no destino                | O projeto de destino tem vários workflows com o mesmo nome e não é possível escolher para qual apontar    |
| Nomes repetidos na sua seleção         | Você selecionou vários workflows com o mesmo nome, então não podem ser todos emparelhados                 |
| Referência a um workflow que não viaja | Um nó chama outro workflow que não está na sua seleção nem existe no projeto de destino                   |
| Referência ambígua                     | Um nó chama outro workflow por nome e o destino tem vários com esse nome                                  |
| Referência a um workflow excluído      | Um nó chama um workflow que já não existe                                                                 |
| Canais duplicados do mesmo tipo        | O workflow de origem ou o de destino tem mais de um canal do mesmo tipo, então o pareamento seria ambíguo |
| Workflow fora do projeto de origem     | O workflow selecionado não pertence ao projeto do qual você está clonando                                 |

<Tip>
  Se um workflow chama outro, inclua ambos na mesma seleção. Assim a referência é resolvida entre os workflows que viajam juntos, sem depender do que já existe no destino.
</Tip>

## Depois de clonar

<Steps>
  <Step title="Configure novamente os nós pendentes">
    Abra os nós de modelo HSM e de WhatsApp Flow e escolha o recurso correspondente no projeto de destino. Se o workflow tem um AI Agent, carregue o conhecimento dele novamente.
  </Step>

  <Step title="Revise os canais">
    Se a Jelou criou um canal que não existia no destino, revise a configuração dele antes de ir para produção.
  </Step>

  <Step title="Teste o fluxo">
    Use o [tester](/pt/guias/primeiros-passos/tester) no projeto de destino para verificar se o workflow responde como você espera.
  </Step>

  <Step title="Publique no projeto de destino">
    A cópia chega ao canvas do projeto de destino, mas não é publicada sozinha. Publique uma versão lá para que comece a atender. Consulte [publicar versões](/pt/guias/primeiros-passos/publicar-versoes).
  </Step>
</Steps>

## Perguntas frequentes

<AccordionGroup>
  <Accordion title="O projeto de origem é modificado?">
    Não. A clonagem apenas lê o projeto de origem. Seus workflows, seus canais e sua configuração permanecem intactos.
  </Accordion>

  <Accordion title="Posso clonar para um projeto de outra empresa?">
    Não. A lista **Clonar em** mostra apenas projetos da sua própria empresa.
  </Accordion>

  <Accordion title="Posso clonar para o mesmo projeto em que estou?">
    Não. O projeto que você tem aberto não aparece na lista de destinos.
  </Accordion>

  <Accordion title="O que acontece se a clonagem falhar no meio do caminho?">
    A Jelou reverte tudo o que havia escrito até aquele momento, incluindo os workflows e canais que tivesse criado. O projeto de destino fica como estava e você pode tentar novamente.
  </Accordion>

  <Accordion title="É possível recuperar o workflow que foi sobrescrito?">
    Substituir sobrescreve o workflow no canvas do projeto de destino, então o conteúdo anterior do canvas não pode ser recuperado de lá. O que não muda por si só é a produção: a substituição não publica nada, então a versão já publicada no destino continua atendendo até você publicar a substituição. Isso lhe dá margem para revisar o resultado antes — e, na dúvida, renomeie o workflow de origem para que um novo seja criado em vez de sobrescrever.
  </Accordion>

  <Accordion title="Por que meu nó de modelo HSM ou de WhatsApp Flow ficou sem seleção?">
    Porque o modelo e o flow estão vinculados ao projeto de origem, então a referência não é transferida. O nó mantém seu lugar e suas conexões, então basta escolher o recurso novamente no projeto de destino.
  </Accordion>

  <Accordion title="O conhecimento do AI Agent é copiado?">
    Não. O nó chega com seu prompt, seu modelo e suas tools, mas as fontes de conhecimento chegam vazias e a leitura de arquivos fica desativada. Carregue-as novamente no projeto de destino.
  </Accordion>

  <Accordion title="Posso clonar tools ou apps do marketplace?">
    Não. O modo de clonagem aparece apenas na seção **Workflows** da barra lateral.
  </Accordion>

  <Accordion title="Por que o botão de confirmar está desabilitado?">
    Ou você não escolheu um projeto de destino, ou a validação encontrou algo que impede a cópia. Revise as mensagens em vermelho do modal.
  </Accordion>
</AccordionGroup>

## Próximos passos

<CardGroup cols={2}>
  <Card title="Crie um projeto" icon="folder-plus" href="/pt/guias/primeiros-passos/criar-projeto">
    Crie um projeto do zero ou clone um completo com toda a sua configuração.
  </Card>

  <Card title="Publicar versões" icon="rocket" href="/pt/guias/primeiros-passos/publicar-versoes">
    Publique o workflow copiado no projeto de destino.
  </Card>

  <Card title="AI Routing" icon="route" href="/pt/guias/primeiros-passos/ai-routing">
    Entenda como a Jelou decide qual workflow atende cada mensagem.
  </Card>

  <Card title="Teste seus workflows" icon="flask" href="/pt/guias/primeiros-passos/tester">
    Verifique o fluxo copiado antes de publicá-lo.
  </Card>
</CardGroup>