[BETA] Pipe Snapshots e Restore via API: salve a estrutura do seu processo e volte para a última versão estável

Visão geral

Alterar a estrutura de um processo em produção gera apreensão pelo risco de quebrar regras ativas e paralisar a operação. O Pipe Snapshots leva para a API o mesmo conceito do histórico de versões da UI: cada snapshot é uma versão salva da configuração do pipe, e o fluxo pode ser restaurado para o último snapshot quando uma mudança não sai como esperado.

O que há de novo?

As capacidades de snapshot e restore estão disponíveis via chamadas de API GraphQL no portal de desenvolvedores Pipefy:

• Snapshot completo do pipe (Create Pipe Snapshot): gera um arquivo JSON estruturado contendo os diversos elementos da configuração, como fases, campos, automações, condicionais e outros.
• Restauração para a última versão estável (Restore Pipe to Last Snapshot): reverte a estrutura do pipe para o último snapshot salvo. A ação não pode ser desfeita.
• Consulta e gestão de histórico (Query & Rename Pipe Snapshots): possibilita listar os snapshots salvos de um processo e renomeá-los para manter o controle de versões.

Como isso ajuda?

• Maior segurança para alterar processos em produção: reestruture fases, campos e automações sabendo que, se algo der errado, o pipe volta para o último snapshot salvo -  sem chamado de suporte nem correção manual.
• Visibilidade do que mudou: compare dois snapshots salvos em datas diferentes e identifique exatamente quais campos e automações entraram, saíram ou foram alterados.
• A estrutura do pipe como documentação: use o JSON exportado para entender a configuração de um pipe complexo sem percorrer fase por fase, ou para gerar documentação automática do processo com um agente de IA.

Casos de uso

1. Ana, Pipe Admin em Operações de Compras: antes de reestruturar as fases e as regras do fluxo de requisições, Ana cria um snapshot. Uma das condicionais entra em conflito com o formulário inicial e trava a entrada de novos pedidos. Ana aciona a restauração, o pipe volta à estrutura anterior e a operação segue - sem fila de chamados no suporte.
2. Bruno, Especialista em Governança de TI: o time quer saber quais campos e automações entraram no pipe de Onboarding no último trimestre. Bruno compara dois snapshots salvos em datas diferentes em uma ferramenta de diff ou com uso de Agente de IA e obtém a lista exata do que mudou, sem reconstruir o histórico manualmente.
3. Dani, Gestor de TI: um pipe de atendimento passou por meses de alterações de vários administradores e ninguém sabe como ele está hoje. Como tudo acontece por API, Dani monta uma rotina: o snapshot roda periodicamente, o JSON segue para um agente de IA da própria empresa e o documento do processo é gravado no repositório da equipe. Documentar deixa de ser tarefa e vira consequência de versionar o pipe.

Mais relevante para

• Pipe Admins
• Arquitetos de Processo
• Times de TI e Governança

Documentação

Consulte o portal de desenvolvedores para comportamento e limitações antes de usar:

1. Gerar uma versão do Pipe em JSON
2. Listar e consultar as versões existentes
3. Renomear uma versão
4. Restaurar o Pipe para a última versão salva

Planos e disponibilidade

O recurso está em fase Beta, disponível para todos os planos nesta fase e é exclusivo para Pipe Admins. As chamadas Create, Rename e Query estão liberadas para 100% das contas Multi-Tenant (MT) e Single-Tenant (ST); a chamada Restore, para 100% das contas MT. O snapshot cobre a estrutura de configuração do pipe (fases, campos, automações, condicionais e outros) - não inclui os cards nem, no momento, Integrações, APPs e Agentes de IA, que podem precisar de reconfiguração após um restore.