👤 Para pipe admins y grupos de admin.
🔐 Disponible para planes de pago. Historial de versiones en Multi-Tenant (MT) y Single-Tenant (ST). Restore solo en MT. Ambos actualmente en Beta.
🎯 Para quienes quieren mantener un registro de cómo está configurado un pipe en un momento dado, seguir cómo cambió con el tiempo y volver a una configuración anterior cuando lo necesiten.
⏩ Resumen del contenido: Aprende a guardar y descargar versiones de la configuración de tu pipe, cómo restaurar una versión anterior y cómo rastrearlas en Actividades.
Qué es una versión
Una versión es un snapshot descriptivo de toda la configuración de tu pipe, guardado como un archivo JSON.
Cubre 19 tipos de elemento, incluyendo fases, campos, condiciones de campo, automatizaciones, expresiones condicionales, conexiones de pipe y de campo y más. No cubre Integraciones, APPs ni AI Agents por ahora.
Lo que la hace útil es que registra qué es y qué hace cada pieza, en términos claros, no solo IDs internos. Eso significa que el archivo se puede leer por sí solo, tanto por una persona como por una herramienta. Una versión guarda la configuración del pipe, no los cards dentro de él.
Por qué esto importa
Hasta ahora, no había forma de ver cómo estaba configurado un proceso en un momento específico. En un pipe complejo, reconstruir eso solo a partir de los logs no es práctico.
"Muéstrame cómo estaba configurado el proceso de aprobación de crédito el 15 de marzo."
Si se guardó una versión en esa fecha o cerca de ella, descárgala. El JSON es la configuración completa tal como estaba.
"¿Qué cambió en este pipe el trimestre pasado?"
Descarga la versión del inicio del trimestre y la del final, y compáralas en una herramienta de diff.
"Vamos a reestructurar este pipe. ¿Y si sale mal?"
Guarda una versión antes de empezar. Tendrás un registro de la configuración que funcionaba para comparar y para restaurar.
"Los auditores quieren documentación de la configuración de nuestro proceso."
Cada versión guardada es un registro fechado y legible de cómo estaba configurado el proceso.
"¿Quién guardó esta versión, y cuándo?"
Cómo acceder al Historial de versiones
Abre el pipe
Haz clic en Gestionar (arriba a la derecha)
Selecciona Historial de versiones
Cómo crear una versión
Haz clic en Crear versión. La versión se generará, con un número secuencial, timestamp y quién la creó. La generación corre en segundo plano, así que puedes cerrar el panel y seguir trabajando. Los pipes más grandes pueden tardar más.
Actualiza la página para ver la versión creada. No se actualiza en vivo por ahora; una vez que recargues, encontrarás la notificación en la campana confirmando que la versión fue generada, y la versión misma en la lista.
Si la generación falla, verás una alerta en el panel y no se agrega ninguna versión a la lista.
Cómo nombrar una versión
Las versiones se crean numeradas y sin nombre para que nada retrase la generación. Puedes nombrar una después, para que tenga sentido más adelante.
Busca la versión en la lista
Abre el menú de tres puntos en esa fila
Selecciona Renombrar versión
Escribe el nombre y confirma
El nombre se actualiza al instante. Puedes renombrar una versión tantas veces como necesites.
Consejo para nombrar
Un buen nombre de versión responde dos preguntas a la vez: ¿puedo volver con seguridad a esta? y ¿qué cambió después de ella?
Combina el estado con lo que vino después:
✅ "Estable - antes de la reestructuración de escalation"
✅ "Pre-rollout de SLA - configuración funcionando"
✅ "Aprobado por la auditoría de TI - ago 2026"
❌ "Versión 4", "Backup", "Prueba"
Dentro de seis meses, el número y la fecha no te dirán qué versión descargar. El nombre sí.
Cómo descargar una versión
Abre el menú de tres puntos en la fila de la versión
Selecciona Descargar JSON
Recibirás un archivo JSON estructurado para leerse en cualquier herramienta de diff o entregarse a un AI Agent.
Cómo comparar dos versiones
La comparación ocurre fuera de Pipefy por ahora.
Descarga las dos versiones que quieres comparar
Abre ambos archivos en una herramienta que compare JSON
La herramienta muestra exactamente qué cambió entre los dos momentos
Cómo restaurar una versión
Restaurar reemplaza la configuración actual de tu pipe por la configuración guardada en una versión. Fases, campos, automatizaciones y condicionales vuelven a como estaban cuando se creó esa versión.
📌 Por ahora solo se puede restaurar la versión más reciente. En las versiones anteriores la acción aparece deshabilitada, con un tooltip que explica el motivo. Restaurar a cualquier punto del historial está en camino.
Abre tu pipe y ve a Gestionar → Historial de versiones.
Busca en la lista la versión que quieres restaurar. Revisa la fecha y quién la creó.
Haz clic en Restaurar versión.
Lee el diálogo de confirmación y escribe restore para confirmar. La fricción es intencional: la acción reemplaza tu configuración actual y no se puede deshacer desde la interfaz.
Espera la confirmación. El restore toma unos segundos en la mayoría de los pipes, y más tiempo en pipes grandes.
A qué afecta el restore
La configuración de tu pipe se reemplaza por la guardada en la versión — fases, campos, automatizaciones, condicionales.
Los cards no se modifican, pero hay algunos escenarios a considerar:
Si el restore elimina una fase, los cards también se eliminan y no van a la Papelera. Esta es una limitación de la propia Papelera. Para recuperar los cards tendrás que abrir un ticket con el equipo de soporte de Pipefy.
Si restauras una fase que había sido eliminada, los cards van a la Papelera. Recupera los cards de ahí antes de crear otra versión o ejecutar otro restore.
Los AI Agents y las integraciones no se restauran. Mantienen su configuración actual, que puede ya no corresponder a la estructura restaurada — revísalos después de restaurar.
Después del restore
Aparece una alerta de éxito o de error en pantalla. Si el restore falla, tu configuración actual se mantiene intacta.
Todos los pipe admins reciben una notificación en la campana (actualiza la página para verla) y un correo, Restore complete: {pipeName}, con la configuración que tenías antes del restore adjunta en JSON. Ese adjunto es tu camino de vuelta si restauraste la versión equivocada.
Rastrear una versión en Actividades
Cada versión muestra un ID de versión en la lista. Crear, renombrar y restaurar una versión quedan registrados en las Actividades del pipe, así que puedes cruzar ambos.
Ve a Gestionar → Actividades → Cambios de configuración para ver quién creó, renombró o restauró una versión, y cuándo.
Lo que puedes hacer vía API
Crear, renombrar, descargar y restaurar una versión
Todos estos recursos vía API están disponibles tanto para entornos ST como MT.
📌 Documentación de la API:
https://developers.pipefy.com/reference/create-pipe-snapshot https://developers.pipefy.com/reference/rename-pipe-snapshot https://developers.pipefy.com/reference/query-pipe-snapshots https://developers.pipefy.com/reference/restore-pipe-to-last-snapshot