Saltar al contenido principal

​
Descripción General

Meetzy soporta control de versiones para playbooks, permitiéndote:
  • Mantener un historial de todos los cambios hechos a tu playbook
  • Designar una versión específica como “producción”
  • Probar versiones específicas antes de desplegar a producción
  • Usar versiones históricas para llamadas API específicas

​
Cómo Funciona el Versionado

​
Versión de Producción

Cada playbook tiene una versión marcada como producción. Esta es la versión que se usará para:
  • Llamadas entrantes: Todas las llamadas entrantes a tu número de Meetzy
  • Llamadas salientes via API: Cuando no especificas un version_id
  • Llamadas en cola/programadas: Usa la versión que estaba marcada como producción cuando la llamada fue programada

​
Prioridad de Selección de Versión

Cuando se inicia una llamada, el sistema sigue esta prioridad:
  1. Versión específica solicitada: Si proporcionas version_id en la llamada API, esa versión exacta se usa
  2. Versión de producción: Si no se proporciona version_id, se usa la versión de producción
  3. Configuración actual (fallback): Si no existen versiones para el playbook, se usa la configuración actual del playbook

​
Usar Versiones en Llamadas API

​
Comportamiento por Defecto (Recomendado)

Simplemente llama a la API sin especificar una versión. La versión de producción se usará automáticamente: 
curl -X POST https://api.meetzy.io/call \
  -H "Authorization: Bearer TU_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+34600000000",
    "playbook_id": "your-playbook-id",
    "firstname": "Juan",
    "lastname": "García"
  }'

​
Usar una Versión Específica

Para usar una versión específica (ej. para pruebas), incluye el parámetro version_id: 
curl -X POST https://api.meetzy.io/call \
  -H "Authorization: Bearer TU_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+34600000000",
    "playbook_id": "your-playbook-id",
    "version_id": "abc123-version-uuid",
    "firstname": "Juan",
    "lastname": "García"
  }'
El version_id debe pertenecer al playbook_id especificado. Si la versión no existe o pertenece a un playbook diferente, la API usará la versión de producción como fallback.

​
Respuesta

Cuando recuperas detalles de llamada, la respuesta incluye el version_id que se usó: 
{
  "id": "call-uuid",
  "playbook_id": "your-playbook-id",
  "version_id": "abc123-version-uuid",
  "status": "completed",
  "duration": 120,
  "...": "..."
}
Si version_id está vacío o null, significa:
  • No había control de versiones activo para este playbook en ese momento
  • La llamada usó el sistema legacy (antes de implementar control de versiones)

​
Gestionar Versiones en el Dashboard

Puedes gestionar versiones de playbook en el Editor Avanzado:
  1. Ver Historial: Ve todas las versiones con sus timestamps y mensajes de commit
  2. Marcar como Producción: Designa cualquier versión como la versión de producción
  3. Restaurar Versión: Revierte a la configuración de una versión anterior
  4. Comparar Cambios: Ve diferencias entre versiones
Cambiar la versión de producción tiene efecto inmediato para todas las nuevas llamadas entrantes y llamadas API que no especifiquen una versión.

​
Mejores Prácticas

  1. Siempre haz commit antes de ir a producción: Usa el sistema de commit para crear un snapshot antes de cambios importantes
  2. Prueba antes de marcar como producción: Usa el parámetro version_id para probar nuevas versiones con llamadas específicas antes de hacerlas producción
  3. Usa mensajes de commit descriptivos: Esto ayuda a rastrear qué cambió en cada versión
  4. Mantén producción estable: Solo marca como producción versiones completamente probadas

​
Casos de Uso

​
A/B Testing

Prueba un nuevo saludo o prompt con leads específicos antes de desplegarlo a todos: 
# Llamada de prueba con nueva versión
curl -X POST https://api.meetzy.io/call \
  -d '{
    "phone": "+34600000000",
    "playbook_id": "your-playbook-id",
    "version_id": "new-greeting-version-id"
  }'

​
Rollback

Si notas problemas con una nueva versión de producción, puedes:
  1. Ir al Editor Avanzado → pestaña Historial
  2. Encontrar una versión conocida como buena
  3. Hacer clic en “Mark as Prod” para hacer rollback instantáneo

​
Campañas Programadas

Al programar llamadas masivas, puedes especificar una versión para asegurar consistencia incluso si actualizas el playbook después: 
# Programar llamadas con versión bloqueada
curl -X POST https://api.meetzy.io/call \
  -d '{
    "phone": "+34600000000",
    "playbook_id": "your-playbook-id",
    "version_id": "campaign-v1-version-id"
  }'

​
FAQ

El sistema hace fallback a usar la configuración actual del playbook. Esto asegura compatibilidad hacia atrás con playbooks creados antes de implementar el control de versiones.
Actualmente, las versiones no pueden eliminarse para mantener la integridad del audit trail. Siempre puedes marcar una versión diferente como producción.
No hay límite estricto en el número de versiones. Sin embargo, recomendamos mantener commits significativos en lugar de hacer commit de cada pequeño cambio.
¡Sí! Las llamadas entrantes siempre usan la versión de producción. Esto asegura que tus clientes siempre experimenten la configuración que has designado como lista para producción.