Paquetes de configuración
La función Paquetes de configuración le permite exportar e importar la configuración de su instalación como un archivo ZIP portátil. Es útil para migrar entre entornos (puesta en escena → producción), replicar configuraciones entre clientes o crear plantillas de instalación reutilizables.
Disponible a partir de v1.0.0-rc3 (WTO-1116).
¿Qué hay dentro de un paquete?
Un paquete incluye (cuando marca cada categoría en el asistente de exportación):- Bandejas de entrada: canales conectados (configuración, sin credenciales confidenciales).
- Agentes de IA: indicaciones, herramientas y configuración del modelo.
- Reglas de automatización — Reglas
trigger → action. - Respuestas enlatadas.
- Plantillas de mensajes: incluidas las variables declaradas.
- Roles personalizados: roles personalizados con permisos.
Lo que NO entra: credenciales (tokens, contraseñas, claves API), datos de conversación, contactos, historial. Los paquetes son configuración, no datos operativos.
Accediendo
Settings → Templates / Bundles (la entrada aparece si tiene el permiso template_bundles.read o template_bundles.manage).
Exportando un paquete
- Haga clic en Exportar paquete.
- En el asistente, marque las categorías que desea incluir. Cada categoría expone la lista de elementos disponibles; puede optar por exportar todo o solo elementos específicos.
- Confirmar. El sistema genera un ZIP con la estructura del paquete interno.
- Descárgalo.
bundle-{installation}-{date}.zip. Puede cambiarle el nombre libremente después de la descarga.
Qué esperar
- Los paquetes pequeños (solo plantillas y respuestas predeterminadas) se publican rápidamente.
- Los paquetes grandes (todos los agentes + reglas de automatización) pueden tardar unos segundos.
- No hay un límite de tamaño estricto, pero mantenga los paquetes enfocados (no exporte todo si solo necesita migrar un agente).
Importando un paquete
- Haga clic en Importar paquete.
- Seleccione el archivo ZIP.
- El sistema valida los contenidos y muestra una vista previa de lo que se importará.
- Tú decides qué importar, sobrescribir o ignorar elemento por elemento.
- Confirmar.
Comportamiento conflictivo
Cuando un elemento del paquete ya existe en la instalación de destino (mismo nombre/mismo identificador):- Importar como nuevo: se crea con un sufijo para evitar colisiones (por ejemplo,
Welcome (imported)). - Sobrescribir: reemplaza el existente. Úselo con cuidado en producción.
- Ignorar: omite ese elemento específico pero continúa con el resto del paquete.
No hay reversión automática después de confirmar la importación. Haga una copia de seguridad de la base de datos antes de importarla en producción.
Casos de uso
1. Puesta en escena → Producción
Usted ajusta los agentes y las automatizaciones en la preparación, los valida con el equipo y exporta un paquete. En producción, importa sobrescribiendo solo los artículos validados.2. Plantilla de instalación
Mantiene un paquete de “plantilla predeterminada” con automatizaciones y respuestas predeterminadas que toda nueva instalación debería tener. Al crear una nueva instancia, simplemente importe.3. Migración entre clientes (multiinquilino)
Las empresas que brindan servicios de implementación pueden tener un catálogo vertical de paquetes (minorista, atención médica, educación) e importar el relevante al iniciar un cliente.Permisos
De forma predeterminada, sólo
account_owner obtiene manage. Otorgue otros roles con precaución: manage le permite sobrescribir la configuración crítica.
Limitaciones conocidas
- Las credenciales no viajan. Después de importar una bandeja de entrada WhatsApp, debe volver a conectar el canal manualmente (el token de instancia no está en el paquete).
- Referencias cruzadas. Si un agente hace referencia a un espacio de Knowledge Nexus que no existe en el destino, el agente se importa pero la referencia se rompe (visible en la interfaz de usuario como “espacio no encontrado”). Configure espacios en el destino antes de importar.
- Versiones de esquema. Los paquetes exportados en diferentes versiones de CRM pueden necesitar adaptación. Mantenga la puesta en escena y la producción cerca en versión.