👤 Para pipe admins e grupos de admin.
🔐 Disponível para planos pagos. Histórico de versões em Multi-Tenant (MT) e Single-Tenant (ST). Restore apenas em MT. Ambos atualmente em Beta.
🎯 Para quem quer manter um registro de como um pipe está configurado em um dado momento, acompanhar como ele mudou e voltar a uma configuração anterior quando precisar.
⏩ Resumo do conteúdo: Aprenda a salvar e baixar versões do seu pipe, como restaurar uma versão anterior e como rastreá-las em Atividades.
O que é uma versão
Uma versão é um snapshot descritivo de toda a configuração do seu pipe, salvo como um arquivo JSON.
Ela cobre 19 tipos de elemento, incluindo fases, campos, condições de campo, automações, expressões condicionais, conexões de pipe e de campo e mais. Ela não cobre Integrações, APPs e AI Agents por enquanto.
O que a torna útil é que ela registra o que cada peça é e faz, em termos claros, não apenas IDs internos. Isso significa que o arquivo é legível por si só, tanto por uma pessoa quanto por uma ferramenta. Uma versão salva a configuração do pipe, não os cards dentro dele.
Por que isso importa
Até agora, não havia como ver como um processo estava configurado em um momento específico. Em um pipe complexo, reconstruir isso apenas a partir de logs não é viável.
"Me mostra como estava o processo de aprovação de crédito no dia 15 de março."
Se uma versão foi salva nessa data ou próxima dela, baixe o arquivo. O JSON é a configuração completa como ela estava.
"O que mudou neste pipe no último trimestre?"
Baixe a versão do início do trimestre e a do fim, e compare as duas em uma ferramenta de comparação.
"Vamos reestruturar este pipe. E se der errado?"
Salve uma versão antes de começar. Você fica com o registro da configuração que funcionava, para comparar.
"A auditoria quer a documentação da configuração do nosso processo."
Cada versão salva é um registro datado e legível de como o processo estava configurado.
"Quem salvou esta versão, e quando?"
Como acessar o Histórico de versões
Abra o pipe
Clique em Gerenciar (canto superior direito)
Selecione Histórico de versões
Como criar uma versão
Clique em Criar versão. A versão será gerada, com um número sequencial, timestamp e quem a criou. A geração roda em segundo plano, então você pode fechar o painel e continuar trabalhando. Pipes maiores podem demorar mais.
Atualize a página para ver a versão criada. Ela não atualiza ao vivo por enquanto; depois de recarregar, você encontrará a notificação no sino confirmando que a versão foi gerada, e a própria versão na lista.
Se a geração falhar, você verá um alerta no painel e nenhuma versão é adicionada à lista
Como nomear uma versão
As versões são criadas numeradas e sem nome para que nada atrase a geração. Você pode nomear depois, para que ela faça sentido mais adiante.
Encontre a versão na lista
Abra o menu de três pontos daquela linha
Selecione Renomear versão
Digite o nome e confirme
O nome é atualizado na própria linha. Você pode renomear uma versão quantas vezes precisar.
Dica de nomeação
Um bom nome de versão responde duas perguntas de uma vez: posso voltar para esta com segurança? e o que mudou depois dela?
Combine o estado com o que veio na sequência:
✅ "Estável - antes da reformulação da escalação"
✅ "Antes do rollout de SLA - config funcionando"
✅ "Homologada pela auditoria de TI - ago 2026"
❌ "Versão 4", "Backup", "Teste"
Daqui a seis meses, o número e a data não vão dizer qual versão baixar. O nome vai.
Como baixar uma versão
Abra o menu de três pontos da linha da versão
Selecione Baixar JSON
Você recebe um arquivo JSON estruturado para ser lido em qualquer ferramenta de comparação, ou para entregar a um AI Agent.
Como comparar duas versões
Por enquanto, a comparação acontece fora da Pipefy.
Baixe as duas versões que você quer comparar
Abra os dois arquivos em uma ferramenta externa que compare JSON
A ferramenta mostra exatamente o que mudou entre os dois momentos
Como restaurar uma versão
Restaurar substitui a configuração atual do seu pipe pela configuração salva em uma versão. Fases, campos, automações e condicionais voltam a como estavam quando aquela versão foi criada.
📌 Por enquanto, só é possível restaurar a versão mais recente. Nas versões anteriores a ação aparece desabilitada, com um tooltip explicando o motivo. Restaurar para qualquer ponto do histórico está a caminho.
Abra seu pipe e vá em Gerenciar → Histórico de versões.
Encontre na lista a versão que você quer restaurar. Confira a data e quem criou.
Clique em Restaurar versão.
Leia o diálogo de confirmação e digite restore para confirmar. A fricção é proposital: a ação substitui sua configuração atual e não pode ser desfeita pela interface.
Aguarde a confirmação. O restore leva alguns segundos na maioria dos pipes, e mais tempo em pipes grandes.
O que o restore afeta
A configuração do seu pipe é substituída pela que estava salva na versão — fases, campos, automações, condicionais.
Os cards não são alterados, mas há alguns cenários a considerar:
se o restore apagar uma fase, os cards também são apagados e não vão para a Lixeira. Essa é uma limitação da própria Lixeira. Para recuperar os cards, você precisará abrir um ticket com o time de suporte da Pipefy.
Se você restaurar uma fase que tinha sido apagada, os cards vão para a Lixeira. Recupere os cards de lá antes de criar outra versão ou rodar outro restore.
AI Agents e integrações não são restaurados. Eles mantêm a configuração atual, que pode não corresponder mais à estrutura restaurada — revise-os depois de restaurar.
Depois do restore
Um alerta de sucesso ou de falha aparece na tela. Se o restore falhar, sua configuração atual é mantida intacta.
Todos os pipe admins recebem uma notificação no sino (atualize a página para vê-la) e um e-mail com a configuração que você tinha antes do restore anexada em JSON. Esse anexo é o seu caminho de volta se você restaurou a versão errada.
Rastreando uma versão nas Atividades
Cada versão exibe um ID da versão na lista. Criar, renomear e restaurar uma versão ficam registrados nas Atividades do pipe, então você pode cruzar os dois.
Vá em Gerenciar → Atividades → Alterações de configuração para ver quem criou, renomeou ou restaurou uma versão, e quando.
O que você pode fazer via API
Criar, renomear, baixar e restaurar uma versão
Todos esses recursos via API estão disponíveis tanto para ambientes ST quanto MT.
📌 Documentação da API: