Disponible a partir de v1.0.0-rc3 (EVO-1116).
¿Qué va dentro de un Bundle?
Un bundle incluye (cuando marcas cada categoría en el wizard de export):- Inboxes — canales conectados (configuración, sin credenciales sensibles).
- Agentes de IA — prompts, herramientas, configuraciones de modelo.
- Automation rules — reglas
trigger → action. - Respuestas predefinidas (canned responses).
- Templates de mensaje — incluyendo variables declaradas.
- Roles personalizados — papeles personalizados con permisos.
Lo que NO va: credenciales (tokens, contraseñas, API keys), datos de conversación, contactos, historial. Bundles son configuración, no datos de operación.
Accediendo
Configuración → Templates / Bundles (la entrada aparece si tienes permiso template_bundles.read o template_bundles.manage).
Exportando un Bundle
- Haz clic en Exportar Bundle.
- En el wizard, marca las categorías que deseas incluir. Cada categoría expone la lista de ítems disponibles — puedes elegir exportar todo o solo algunos ítems específicos.
- Confirma. El sistema genera un ZIP con la estructura interna del bundle.
- Haz el download.
bundle-{instalación}-{fecha}.zip. Puedes renombrar libremente después del download.
Qué esperar
- Bundles pequeños (solo templates y canned responses) salen rápido.
- Bundles grandes (todos los agentes + automation rules) pueden llevar algunos segundos.
- No hay límite duro de tamaño, pero mantén bundles enfocados (no exportes todo si solo necesitas migrar un agente).
Importando un Bundle
- Haz clic en Importar Bundle.
- Selecciona el archivo ZIP.
- El sistema valida el contenido y muestra preview de lo que será importado.
- Decides qué importar, sobrescribir o ignorar ítem por ítem.
- Confirma.
Comportamiento en caso de conflicto
Cuando un ítem del bundle ya existe en la instalación de destino (mismo nombre / mismo identificador):- Importar como nuevo: crea con sufijo para evitar colisión (ej.:
Bienvenida (importado)). - Sobrescribir: sustituye el existente. Usa con cuidado en producción.
- Ignorar: salta ese ítem específico, pero sigue con el resto del bundle.
No hay rollback automático después de confirmar el import. Haz backup de la base antes de importar en producción.
Casos de Uso
1. Staging → Producción
Ajustas agentes y automations en staging, validas con el equipo y exportas un bundle. En producción, importas sobrescribiendo solo los ítems validados.2. Plantilla de instalación
Mantienes un bundle “plantilla estándar” con automations y canned responses que toda nueva instalación debe tener. Al subir una nueva instancia, basta importar.3. Migración entre clientes (multi-tenant)
Empresas que prestan servicio de implementación pueden tener un catálogo de bundles por vertical (retail, salud, educación) e importar el relevante al iniciar un cliente.Permisos
Por defecto solo
account_owner recibe manage. Concede a otros roles con cuidado — manage permite sobrescribir configuración crítica.
Limitaciones conocidas
- Credenciales no viajan. Después de importar un inbox WhatsApp, necesitas reconectar el canal manualmente (el token de instancia no está en el bundle).
- Referencias cruzadas. Si un agente referencia un Knowledge Nexus space que no existe en el destino, el agente es importado pero la referencia queda rota (visible en la UI como “space no encontrado”). Configura los spaces en el destino antes de importar.
- Versiones de schema. Bundles exportados en versiones diferentes del CRM pueden necesitar adaptación. Mantén staging y producción cerca en versión.