📋 Requisitos Previos
Antes de gestionar los accesos y permisos de tu integración, asegúrate de cumplir con los siguientes puntos:
Acceso de Administrador: Debes contar con privilegios administrativos en la consola de Genesys Cloud Admin para crear o modificar los roles del Cliente OAuth.
Conocimiento de permisos: Comprender la diferencia entre permisos obligatorios (para enrutamiento base) y permisos opcionales (para sincronización avanzada de contactos).
Conexión en curso: Haber iniciado el proceso de conexión desde la plataforma de Atom en Configuraciones > Integraciones.
🛡️ Validación Estricta de Permisos Obligatorios
La plataforma Atom cuenta con mecanismos de validación de alta seguridad para garantizar que ninguna conversación se pierda por falta de privilegios técnicos en la API de Genesys.
Durante el proceso de conexión inicial, Atom evalúa automáticamente el token de acceso (Token) generado por Genesys.
⚠️ Importante: Regla de negocio crítica. Si tu Cliente OAuth carece de tan solo un (1) permiso obligatorio (ej. architect:flow:view o routing:message:manage), la conexión será rechazada. El sistema bloqueará el avance y mostrará una pantalla detallando exactamente qué permiso falta habilitar, ignorando si cuentas o no con los permisos opcionales.
Si posees todos los permisos obligatorios, la conexión será exitosa y serás redirigido a la configuración de flujos y Tipificación.
📊 Impacto de las Licencias CX en Funciones Opcionales
Dependiendo del nivel de licencia que tengas contratado en Genesys Cloud (ej. CX1, CX2, CX3), tu integración tendrá distintos alcances habilitados dentro de Atom.
Nivel de Licencia | Impacto en la Plataforma | Visualización en Interfaz |
Licencia Básica (ej. CX1) | Las funciones que requieren sincronización avanzada o edición de datos de contactos externos estarán deshabilitadas. | Los módulos bloqueados mostrarán un indicador visual de candado cerrado. |
Licencias Superiores (ej. CX2/CX3) | Permite el uso total de funcionalidades opcionales (ej. | Módulos completamente interactivos y sin bloqueos visibles. |
🔄 Estrategia de Actualización: Actualizar Token
Si en algún momento realizas un upgrade de tu licencia en Genesys o agregas permisos faltantes a tu Cliente OAuth, no necesitas eliminar la integración y empezar de cero.
Sigue estos pasos para sincronizar tus nuevos privilegios:
Ve a Configuraciones > Integraciones y abre la tarjeta de Genesys Cloud.
Navega hasta la sección de conexión o al módulo que se encuentra bloqueado.
Haz clic en el botón Actualizar Token.
Completa la pantalla de autorización de Meta/Genesys que Atom desplegará para absorber los nuevos permisos.
💡 Tip: Usar "Actualizar Token" es completamente seguro. Refrescará la validación de permisos en la API sin borrar, alterar ni perder tu configuración de enrutamiento, Tipificación o mapeo actual.
⚠️ Manejo de Errores al Refrescar
Existen escenarios donde al hacer clic en Actualizar Token, la plataforma puede arrojar un error. Esto sucede si:
Los permisos no fueron guardados correctamente en la consola de Genesys.
El cambio de licencia o asignación de rol aún no se ha propagado en la API de Genesys.
Solución: Si ves el modal de alerta de "Permisos insuficientes", dirígete a Genesys Cloud Admin, verifica que el rol OAuth tenga los alcances correctos guardados, espera unos minutos a que se propague el cambio en sus servidores y vuelve a intentarlo en Atom.
✅ Resultados Esperados y Verificación
Para auditar el estado actual de tu licenciamiento y verificar que el refresco fue exitoso:
Abre la tarjeta de Genesys Cloud en Atom y despliega la pestaña de Conexión.
Verifica el valor en el campo Licencia. Allí visualizarás el nivel de plan detectado por Atom en tiempo real (ej. CX1 o CX2).
Navega hacia las pestañas de configuración avanzada (como el mapeo de contactos). Si tu actualización fue exitosa, los candados habrán desaparecido y los menús desplegables estarán listos para configurarse.
Mantener tu integración de Genesys Cloud al día con los permisos correctos garantiza un flujo de datos limpio y sin interrupciones. Al entender cómo interactúan tus licencias con las funciones opcionales y utilizar el refresco de token de forma estratégica, empoderas a tu equipo para escalar su operación comercial con total seguridad técnica. ✅