Builder · Atualizado em 06/10/2026

Como consultar versões de um fluxo

Veja o histórico de versões publicadas, dê nome a elas, baixe uma cópia e restaure uma versão anterior como rascunho.

Cada vez que você publica, o Pipe guarda uma versão numerada do fluxo. O painel de versões mostra esse histórico e permite voltar a uma versão anterior.

Quando usar

Consulte as versões quando uma mudança publicada causou problema e você quer voltar atrás, quando precisa saber quem publicou e quando, ou quando quer guardar uma cópia de uma versão importante antes de uma reformulação.

Pré-requisitos

  • Permissão para editar o fluxo no Builder.
  • Ao menos uma publicação feita. Sem versão publicada, a lista aparece vazia e a restauração mostra o aviso "Não foi encontrada nenhuma versão publicada".

Como as versões funcionam

  • O rascunho é o desenho que você edita. O Builder salva sozinho, sem criar uma versão a cada alteração.
  • Ao clicar em Publicar fluxo, o rascunho vira a versão publicada, com o próximo número. A versão publicada anterior vai para o histórico.
  • Uma versão publicada não muda. Se você editar o fluxo depois, o Pipe começa um novo rascunho.
  • No rodapé do Builder, passe o mouse sobre o estado de salvamento para ver a origem do desenho (Rascunho, Publicada ou Fluxo padrão), o número da versão, qual versão está no ar e quantos blocos existem.

Passo a passo

  1. Abra o fluxo na aba Builder.
  2. Clique em Configuração na barra de ferramentas.
  3. Abra a aba Versões.
  4. Clique em VERSÕES PUBLICADAS para expandir a lista. Cada cartão mostra o título e a descrição, se houver, a data e a hora da publicação no formato dd/MM/aaaa - HH:mm:ss, e quem publicou.
  5. Para dar nome a uma versão, clique no ícone de lápis (Nomear versão). Na janela Edite o título e descrição da versão, preencha Título e Descrição e clique em Salvar.
  6. Para baixar uma cópia, clique no ícone Baixar fluxo do cartão. O arquivo é salvo como nome-do-fluxo-v3-2026-10-06.json, com o número da versão e a data.
  7. Para voltar a uma versão, clique no ícone Restaurar versão do cartão e leia o aviso.
  8. Confirme em Restaurar. O Pipe fecha o painel e mostra "Versão N restaurada como rascunho".
  9. Revise o rascunho, teste e clique em Publicar fluxo se quiser que a versão restaurada volte ao ar.

Para restaurar a última versão publicada de uma vez, use o item Restaurar versão no alto da aba, sem abrir a lista.

Aba Versões da Configuração do Builder, com Restaurar versão e Versões publicadas

Campos e limites

Campo ou controleDetalhe
TítuloAté 50 caracteres.
DescriçãoAté 200 caracteres.
VERSÕES PUBLICADASMostra as 10 mais recentes.
Nomear versãoEdita título e descrição. Deixar vazio limpa o campo.
Restaurar versãoCopia a versão para o rascunho, depois de confirmação.
Baixar fluxoBaixa o desenho, as ações globais e os subfluxos daquela versão.

Exemplo na Loja Girassol

A Loja Girassol publicou uma mudança no bloco Pedidos que passou a enviar todos os contatos para o atendimento humano.

  1. Em Configuração, aba Versões, a equipe abre VERSÕES PUBLICADAS.
  2. Identifica a versão anterior à mudança pela data e pelo título "Antes do ajuste de pedidos", que foi dado por Nomear versão.
  3. Clica em Restaurar versão nela e confirma em Restaurar.
  4. Testa o rascunho e publica de novo. O fluxo volta a rotear pedidos corretamente, e a versão problemática continua no histórico para consulta.

Resultado esperado

Depois de restaurar, o Builder mostra o desenho da versão escolhida como rascunho. A versão que está no ar não muda até a próxima publicação.

Boas práticas

  • Baixe uma cópia antes de reformular o fluxo.
  • Teste o rascunho restaurado antes de publicar.
  • Use a descrição para registrar o que mudou e por quê.

Limitações

  • O painel lista apenas as 10 versões publicadas mais recentes.
  • Restaurar descarta as alterações do fluxo principal que estavam no rascunho. Os subfluxos mantêm as alterações.
  • O painel não compara duas versões lado a lado.

Problemas comuns

  • "Não foi encontrada nenhuma versão publicada": o fluxo ainda não foi publicado. Publique ao menos uma vez.
  • "Não foi possível restaurar a versão publicada": tente de novo. Se persistir, feche e abra o Builder e repita.
  • O botão Publicar fluxo está desabilitado: se o desenho aberto é a versão publicada e não há alterações, não há o que publicar. Faça uma alteração, ou restaure uma versão anterior para criar um rascunho diferente.
  • A lista mostra "Nenhuma versão publicada ainda": nenhuma publicação foi feita neste fluxo.
  • O título não salva: confira o limite de 50 caracteres no título e de 200 na descrição.

Próximos passos

Perguntas frequentes

Qual a diferença entre rascunho e versão publicada?

O rascunho é o que você edita e é salvo sozinho. A versão publicada é a que atende os contatos. Publicar transforma o rascunho em uma nova versão numerada.

Restaurar uma versão apaga a que está no ar?

Não. Restaurar copia a versão escolhida para o rascunho. A versão no ar continua a mesma até você publicar de novo.

Quantas versões o painel mostra?

As 10 versões publicadas mais recentes, da mais nova para a mais antiga.

O que se perde ao restaurar?

As alterações do fluxo principal que estavam no rascunho. As alterações dos subfluxos são mantidas. O Pipe pede confirmação antes.

Posso dar nome a uma versão?

Sim. Use o ícone Nomear versão e informe título de até 50 caracteres e descrição de até 200.