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
- Abra o fluxo na aba Builder.
- Clique em Configuração na barra de ferramentas.
- Abra a aba Versões.
- 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.
- 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.
- 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.
- Para voltar a uma versão, clique no ícone Restaurar versão do cartão e leia o aviso.
- Confirme em Restaurar. O Pipe fecha o painel e mostra "Versão N restaurada como rascunho".
- 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.
Campos e limites
| Campo ou controle | Detalhe |
|---|---|
| Título | Até 50 caracteres. |
| Descrição | Até 200 caracteres. |
| VERSÕES PUBLICADAS | Mostra as 10 mais recentes. |
| Nomear versão | Edita título e descrição. Deixar vazio limpa o campo. |
| Restaurar versão | Copia a versão para o rascunho, depois de confirmação. |
| Baixar fluxo | Baixa 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.
- Em Configuração, aba Versões, a equipe abre VERSÕES PUBLICADAS.
- 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.
- Clica em Restaurar versão nela e confirma em Restaurar.
- 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.
Esse artigo foi útil?
Obrigado pelo retorno!