# Importação e exportação

> Exporte um workflow em um único arquivo JSON, com ou sem personagens, objetos e locais, e importe em outra conta, projeto ou instalação self-hosted.

Source: https://nodaro.ai/pt-BR/docs/guides/import-export

Um workflow viaja como um único **arquivo JSON**. Você o exporta do editor e o importa em qualquer lugar: em outra conta, em outro projeto ou em uma instalação self-hosted. O arquivo pode levar os personagens, objetos e locais que o workflow usa. A importação copia as mídias que consegue acessar, para que a cópia funcione de forma independente.

## Exportar um workflow
### Salve o workflow
A exportação lê a versão salva do workflow, não o que está no canvas. Salve primeiro.

### Escolha Exportar
Na barra de ferramentas do editor, abra **Exportar** e escolha o que o arquivo deve conter.

| Opção | O que vai no arquivo |
| --- | --- |
| **Com mídias** | O workflow, mais os personagens, objetos e locais que ele usa |
| **Somente template** | Só o workflow, sem resultados e sem outros conteúdos de execução |

### Compartilhe o arquivo
Envie o arquivo ou guarde-o como backup. Se o workflow usa mídias que só a sua instalação consegue servir, como arquivos em um servidor privado, a exportação avisa. Envie essas mídias para um lugar público antes de compartilhar o arquivo, ou conte com a necessidade de novas entradas nesses nós.

## Importar um workflow
**Na página inicial.** Clique em **Importar JSON**, ao lado de “Continue de onde parou”, e escolha um arquivo. O Nodaro cria o workflow e o abre. Ele vai para o seu projeto padrão, **Meus workflows recentes**, que é criado na primeira vez em que algo precisa dele.

**No editor.** Abra **Importar** na barra de ferramentas. Escolha **De um arquivo** ou **Da área de transferência** e depois uma de duas opções:

| Opção | O que acontece |
| --- | --- |
| **Importar como novo** | Um novo workflow, como o botão da página inicial |
| **Adicionar ao atual** | Os nós importados são adicionados ao canvas aberto, à direita do que já está lá |

Todo workflow importado recebe o nome do arquivo com **(Imported)** no fim, para que uma cópia nunca pareça o original. Os dois caminhos aceitam uma exportação normal e o formato de tutorial.

## O que é transferido
| Parte do workflow | O que acontece na importação |
| --- | --- |
| **Personagens, objetos e locais** | Em um arquivo **Com mídias**, eles são criados de novo na sua conta, e os nós apontam para as suas novas cópias. |
| **Mídias que a nova instalação consegue acessar** | As imagens, os vídeos e os áudios são copiados para o armazenamento da nova instalação, então o workflow deixa de depender do original. A mensagem de sucesso diz quantos arquivos foram copiados. |
| **Mídias que a nova instalação não consegue acessar** | Continuam apontando para onde estavam. A importação avisa e indica os nós, que não serão executados até você enviar os arquivos de novo. |
| **Entidades que não cabem no seu armazenamento** | O workflow é importado mesmo assim, e a importação indica as entidades que não conseguiu criar. Os nós que as usam as mostram como ausentes. |
| **Credenciais salvas** | Nunca são exportadas. Um nó [**Saída de webhook** (Webhook Output)](https://nodaro.ai/docs/nodes/publish/webhook-output) chega sem a credencial dele, e você escolhe a sua. |
| **Agendamentos** | Um nó [**Gatilho agendado** (Schedule Trigger)](https://nodaro.ai/docs/nodes/automate/schedule-trigger) importado sempre começa pausado. Ative-o quando estiver pronto. |
| **Trechos e configurações de seletores** | São transferidos como estão. Um [trecho](https://nodaro.ai/docs/guides/prompt-snippets) é texto simples no prompt, e um seletor mantém o modo Completo ou Compacto. |

**Workflows compartilhados são exportados sem as entidades.** Você pode exportar um workflow que alguém compartilhou com você. Nesse caso, o arquivo vem sem os personagens e os locais por trás dele. Ter permissão para ler um workflow não dá a você as entidades dele.

## Mover um workflow entre o Nodaro Cloud e uma instalação self-hosted
O mesmo arquivo funciona nas duas direções:

1. Exporte o workflow com a opção **Com mídias** na instalação antiga.
2. Importe-o na nova instalação com **Importar JSON**.
3. Leia a mensagem da importação. Envie de novo as mídias que ela não conseguiu acessar.
4. Em uma instalação self-hosted, confira se os modelos que o workflow usa estão disponíveis pelas suas chaves de provedor ou por uma [conexão com o Nodaro Cloud](https://nodaro.ai/docs/concepts/editions).
5. Escolha de novo as credenciais nos nós Saída de webhook e ative os agendamentos que devem ser executados.

## Importar e exportar por código
A API REST importa os mesmos arquivos com `POST /v1/workflows/import`, enviando o conteúdo do arquivo como `workflow_json`. A resposta inclui o novo workflow e um relatório da importação: quantos arquivos de mídia foram copiados, quais estavam inacessíveis e quais foram ignorados. O SDK chama o mesmo endpoint com `client.workflows.import(...)`, e os assistentes conectados por [MCP](https://nodaro.ai/docs/mcp) também podem exportar e importar workflows. Veja a [API de workflows](https://nodaro.ai/docs/developers/api/workflows).

## Frequently asked questions

### Como copio um workflow para outra conta do Nodaro?

No editor, abra “Exportar” e escolha “Com mídias”. Na outra conta, clique em “Importar JSON” na página inicial e escolha o arquivo. O workflow abre como uma nova cópia, com os personagens, objetos e locais dele criados nessa conta.

### Qual é a diferença entre “Com mídias” e “Somente template”?

“Com mídias” inclui os personagens, objetos e locais que o workflow usa. “Somente template” inclui só o workflow, sem resultados e sem outros conteúdos de execução.

### Por que um nó importado diz que a mídia dele está faltando?

O arquivo aponta para mídias que só a instalação original conseguia servir, como um servidor self-hosted privado. A importação indica esses nós. Envie as mídias de novo na nova instalação antes de executá-los.

### Um agendamento importado começa a ser executado na hora?

Não. Um nó Gatilho agendado importado sempre começa pausado. Ative-o com a chave dele quando estiver pronto.

### As minhas chaves de webhook vão junto em uma exportação?

Não. Uma exportação nunca leva credenciais salvas. Depois de uma importação, escolha a sua própria credencial em cada nó Saída de webhook que precisar de uma.