Plataforma y Operadores
Por Conversa Labs
Por Conversa Labs
Super Admin (cuentas, planes, licencia), instalador/deploy, tenancy y temas de operador. Contenido a nivel de operador.
Visión general para operadores de la plataforma
Visión general Esta categoría es para operadores de la plataforma — quienes administran la instalación como un todo, no solo una cuenta. Cubre temas de Super Admin (cuentas, planes, licencia), instalación y deploy, tenancy y aprovisionamiento de servicios auxiliares. Requisitos previos - Acceso de Super Admin a la instalación. - Acceso de infraestructura (servidor/clúster) para tareas de instalación y deploy. Paso a paso 1. Abre el panel Super Admin para gestionar cuentas, planes y licencia. 2. Usa los artículos de instalación/deploy para aprovisionar o actualizar la plataforma. 3. Configura la tenancy y los servicios auxiliares (por ejemplo, el gateway de WhatsApp Web). 4. Monitorea la salud de la instalación y la validez de la licencia. Configuración y opciones - Cuentas y planes: creación, límites y features por cuenta. - Licencia: activación y estado de la licencia de la instalación. - Infraestructura: imágenes, variables de entorno y servicios. Casos de uso - Operar una instalación que atiende múltiples cuentas. - Aprovisionar nuevas instancias y mantener las actualizaciones. Consejos, límites y buenas prácticas - Restringe el acceso de Super Admin al mínimo necesario. - Mantén copias de seguridad y un plan de rollback antes de cada deploy. Solución de problemas - No veo Super Admin: confirma que tu usuario tenga el rol de operador de la instalación. - Funcionalidad no disponible: verifica el plan/licencia y las variables de entorno. Ver también - Super Admin: cuentas, planes y licencia - Instalador y deploy
Super Admin: cuentas, planes y licencia
Visión general El panel de Super Admin es donde el operador gestiona toda la instalación: crear y administrar cuentas, definir planes y features, y seguir el estado de la licencia. Requisitos previos - Un usuario con el rol de Super Admin. - Una licencia válida para la instalación. Paso a paso 1. Abre el panel de Super Admin. 2. En Cuentas, crea o edita cuentas y ajusta límites y features. 3. En Planes, define los planes disponibles y lo que habilita cada uno. 4. En Licencia, revisa el estado de activación y la validez. Configuración y opciones - Features por cuenta: habilita/deshabilita módulos por cuenta. - Límites: agentes, bandejas y otros límites por plan. - Licencia: clave, estado y renovación. Casos de uso - Aprovisionar una nueva cuenta para un cliente. - Ajustar el plan de una cuenta según el contrato. Consejos, límites y buenas prácticas - Documenta el plan y las features de cada cuenta. - Monitorea la validez de la licencia para evitar interrupciones. Solución de problemas - Cuenta sin un módulo: revisa las features habilitadas en el plan/cuenta. - Licencia inválida: verifica la clave y el estado de activación. Ver también - Visión general para operadores - Instalador y deploy
Instalador y deploy
Visión general El operador aprovisiona y mantiene la plataforma mediante un instalador automatizado y un proceso de deploy basado en imágenes versionadas. El objetivo es levantar y actualizar la instalación de forma predecible, con rollback a mano. Requisitos previos - Acceso de infraestructura (servidor único o clúster). - Credenciales del registro de imágenes y DNS/TLS del dominio. Paso a paso 1. Aprovisiona la infraestructura (servidor único o clúster) con el instalador. 2. Configura dominios, DNS y certificados TLS. 3. Despliega la imagen versionada de la plataforma. 4. Ejecuta las migraciones de base de datos y verifica la salud de los servicios. 5. En actualizaciones, despliega la nueva versión con una estrategia de despliegue gradual. Configuración y opciones - Variables de entorno: secretos y parámetros de la instalación. - Imágenes versionadas: fija la versión a desplegar (evita etiquetas genéricas en producción). - Migraciones: ejecuta las migraciones como un paso controlado del deploy. Casos de uso - Levantar una nueva instalación desde cero. - Actualizar a una nueva versión con rollback disponible. Consejos, límites y buenas prácticas - Ten siempre el comando de rollback escrito antes de iniciar el deploy. - Actualiza un servicio a la vez y verifica la salud antes de continuar. - Nunca expongas secretos en archivos versionados. Solución de problemas - El servicio no arranca: revisa las variables de entorno y los logs del servicio. - La migración falló: verifica la conectividad de la base de datos y ejecuta la migración aislada. Ver también - Super Admin: cuentas, planes y licencia - Tenancy y ZuckZapGo
Tenancy y ZuckZapGo
Visión general El operador define cómo las cuentas comparten (o no) los servicios auxiliares. Un ejemplo central es el gateway de WhatsApp Web (ZuckZapGo), que aloja las sesiones vinculadas usadas por las bandejas de WhatsApp Web. Requisitos previos - Un servicio de gateway aprovisionado y accesible por la plataforma. - El token administrativo del gateway (solo en el backend, nunca expuesto). Paso a paso 1. Define el modelo de tenancy: un gateway único compartido por el operador, o un gateway por cuenta. 2. Configura la URL del gateway y el token administrativo en la instalación. 3. Al crear una bandeja de WhatsApp Web, la plataforma aprovisiona automáticamente un usuario en el gateway. 4. Monitorea el estado de las sesiones (conectado, vinculando, desconectado). Configuración y opciones - Modo de tenancy: compartido (operador) o por cuenta. - Credenciales: token administrativo y URL del gateway (cifrados/seguros). - Webhooks: el gateway notifica a la plataforma sobre eventos de sesión y mensajes. Casos de uso - Operar un único gateway para todas las cuentas (self-hosted). - Permitir que cada cuenta apunte a su propio gateway externo. Consejos, límites y buenas prácticas - Nunca expongas el token administrativo del gateway en respuestas de API o logs. - Monitorea la salud del gateway y la validez de las sesiones vinculadas. Solución de problemas - La bandeja no se vincula: verifica la conectividad con el gateway y el token. - La sesión se cae a menudo: revisa la estabilidad del dispositivo/origen y los webhooks. Ver también - Conectar WhatsApp Web (vinculación por QR) - Instalador y deploy