EntrarTeste grátis

Builder · Atualizado em 06/10/2026

Como importar e exportar um fluxo

Baixe uma cópia do fluxo em arquivo JSON e carregue um arquivo para substituir o desenho atual, com subfluxos e ações globais.

Neste artigo
  1. Quando usar
  2. Pré-requisitos
  3. Passo a passo para exportar
  4. Passo a passo para importar
  5. O que entra e o que não entra no arquivo
  6. Exemplo na Loja Girassol
  7. Resultado esperado
  8. Boas práticas
  9. Limitações
  10. Problemas comuns
  11. Próximos passos
  12. Perguntas frequentes

Exportar gera um arquivo com o seu fluxo. Importar carrega um arquivo desses no Builder. Juntos, servem para guardar cópias, reaproveitar um desenho em outro projeto e restaurar um fluxo.

Quando usar

Exporte antes de uma mudança grande, para ter um ponto de retorno. Importe para copiar um fluxo que funciona de um projeto para outro, ou para recuperar um arquivo guardado. Para voltar a uma versão que já foi publicada neste fluxo, use a restauração de versões, que é mais simples.

Pré-requisitos

  • Permissão para editar o fluxo no Builder.
  • Para importar, um arquivo .json baixado de um fluxo pelo Builder.

Passo a passo para exportar

  1. Abra o fluxo na aba Builder.
  2. Clique em Configuração e abra a aba Versões.
  3. Clique em Baixar fluxo. O painel avisa que o download inclui o fluxo e as configurações de ações globais.
  4. O navegador salva um arquivo com o nome do fluxo em letras minúsculas, por exemplo loja-girassol.json.

Para baixar uma versão publicada específica, abra VERSÕES PUBLICADAS na mesma aba e use o ícone Baixar fluxo do cartão. O arquivo leva o número da versão e a data no nome.

Passo a passo para importar

  1. Abra o fluxo de destino na aba Builder.
  2. Clique em Configuração e abra a aba Versões.
  3. Clique em Carregar fluxo e escolha o arquivo .json.
  4. Leia a janela Carregar fluxo: "Ao importar o fluxo, a sua versão atual será substituída." Clique em Sim para continuar ou em Não para cancelar.
  5. Aguarde o aviso Fluxo importado. O painel fecha e o canvas mostra o desenho do arquivo.
  6. Se o aviso pedir para carregar o arquivo de algum subfluxo, abra o bloco que chama esse subfluxo e use Carregar subfluxo.
  7. Revise os blocos, teste e clique em Publicar fluxo.
Aba Versões com os botões Carregar fluxo e Baixar fluxo

O que entra e o que não entra no arquivo

ItemVai no arquivo?
Blocos, conteúdos, condições de saída e ações de blocoSim
Ações globaisSim
SubfluxosSim, junto com o fluxo principal
Variáveis sensíveisNão. Cadastre-as de novo no fluxo de destino.
Variáveis de configuração do fluxo principalNão. Confira e preencha no destino.
Histórico de versõesNão

Exemplo na Loja Girassol

A Loja Girassol quer reaproveitar o fluxo de atendimento da loja matriz na filial.

  1. No fluxo da matriz, em Configuração, aba Versões, clique em Baixar fluxo.
  2. No fluxo da filial, na mesma aba, clique em Carregar fluxo e escolha o arquivo.
  3. Confirme em Sim.
  4. Em Configuração, aba Variáveis, cadastre de novo a chave do sistema de pedidos na seção VARIÁVEIS SENSÍVEIS.
  5. Teste e publique.

Resultado esperado

Ao importar, o canvas mostra o desenho do arquivo, o rodapé indica que há alterações a salvar e depois Salvo. Ao exportar, o navegador baixa um arquivo .json que o Pipe consegue carregar de volta.

Boas práticas

  • Guarde os arquivos em uma pasta com data no nome. O Pipe não guarda os arquivos para você.
  • Não edite o .json à mão. Pequenos erros de formato tornam o arquivo inválido.
  • Depois de importar em outro projeto, revise textos, destinos e chaves.

Limitações

  • O arquivo precisa ser um fluxo exportado pelo Builder. Outros formatos de JSON são recusados.
  • O arquivo precisa ter um bloco inicial. Sem ele, a importação é recusada.
  • O arquivo não leva as variáveis sensíveis.
  • Se um subfluxo chamado não estiver no arquivo, ele precisa ser carregado à parte pelo bloco que o chama.

Problemas comuns

  • "O arquivo especificado não contém um fluxo válido para importação": o arquivo está corrompido, foi editado ou não é de um fluxo. Baixe de novo da origem.
  • Aviso para carregar os subfluxos: o arquivo cita subfluxos que não vieram nele. Abra cada bloco que chama o subfluxo e use Carregar subfluxo.
  • Importei o arquivo errado: use Desfazer (Ctrl+z) no rodapé para voltar, ou restaure uma versão em Versões.
  • A requisição HTTP falha no fluxo importado: a variável sensível não foi cadastrada no destino.

Próximos passos

Perguntas frequentes

O que o arquivo exportado contém?

O desenho dos blocos, as ações globais e os subfluxos do fluxo. As variáveis sensíveis não vão no arquivo.

Importar substitui o que eu tenho?

Sim, o desenho atual é substituído. O Pipe pede confirmação antes. A importação entra como uma alteração do rascunho, e você pode desfazer.

Preciso publicar depois de importar?

Sim. A importação altera o rascunho. Teste e publique para colocar no ar.

O que fazer se o Pipe disser que o arquivo não é um fluxo válido?

Verifique se o arquivo é um .json exportado de um fluxo e se não foi editado à mão ou cortado. Baixe de novo da origem.

Como levo um fluxo para outro projeto?

Baixe o fluxo no projeto de origem, abra o outro projeto e use Carregar fluxo. Depois cadastre de novo as variáveis sensíveis.