📋 Requisitos Previos
Antes de iniciar la vinculación en la plataforma, garantiza el cumplimiento estricto de las siguientes condiciones en tu entorno de trabajo:
Cliente OAuth (OAuth Client): Haber creado exitosamente este cliente en la consola de administración de Genesys Cloud CX.
Credenciales listas: Disponer de las claves de acceso generadas para la aplicación: Client ID y Client Secret.
Permisos otorgados: Asegurar que el rol de OAuth en Genesys cuenta con la totalidad de los permisos obligatorios habilitados (ej. recepción de mensajes, vista de flujos y clasificaciones).
⚠️ Importante: Si el Cliente OAuth no posee el 100% de los permisos obligatorios requeridos por Atom, el sistema rechazará la conexión automáticamente. Esta es una medida de seguridad para proteger la integridad operativa y evitar fallas de enrutamiento en producción.
⚙️ Guía Paso a Paso
Sigue estos pasos para establecer la conexión técnica de forma exitosa:
Dirígete a Configuraciones > Integraciones en el menú lateral de tu entorno de Atom.
Localiza la tarjeta correspondiente a Genesys Cloud dentro del catálogo de integraciones disponibles.
Haz clic en el botón Conectar. Esta acción inicializará la ventana de configuración de credenciales.
Ingresa tu Client ID y tu Client Secret en los campos solicitados.
Haz clic en el botón de confirmación. En este instante, el sistema se comunicará con los servidores de Genesys para validar las claves de acceso.
Revisa la pantalla de autorización desplegada, la cual listará los alcances que Atom solicitará a Genesys:
Permisos obligatorios: Estrictamente requeridos para enrutar tráfico y mapear clasificaciones de cierre.
Permisos opcionales: Funcionalidades extendidas (sujetas a tu tipo de licencia CX) para la gestión de contactos externos.
Haz clic en Continuar para autorizar el enlace, transferir el token de seguridad y finalizar la vinculación técnica.
💡 Tip: Al copiar y pegar tu Client ID y Client Secret, verifica exhaustivamente no incluir espacios en blanco adicionales al inicio o al final de las credenciales, ya que esto generará un error de validación.
📊 Estados de la Integración y Resultados
Para auditar el estado de salud y progreso de tu integración, monitorea los indicadores visuales que presenta la tarjeta de Genesys Cloud en Atom.
Estado en Tarjeta | Significado Operativo |
Conectar | Estado inicial: La integración está inactiva y lista para comenzar el proceso de vinculación. |
Conectando... | Transición: Atom está validando los tokens y procesando los permisos contra la API de Genesys. |
Configuración pendiente | Éxito técnico parcial: Las credenciales y permisos son correctos, pero es obligatorio configurar el enrutamiento inicial y la tipificación por defecto para poder operar. |
Conectado | Éxito total: Las credenciales son válidas y los mapeos operativos están listos. Integración 100% activa. |
Conexión fallida | Interrupción: Abandonaste el proceso de permisos o tu OAuth carece de permisos obligatorios. Debes corregirlo en Genesys y hacer clic en Reintentar. |
Con error | Estado crítico: Tras una conexión exitosa, se revocó un permiso en Genesys, caducó el secret o se alteró un flujo mapeado. Requiere auditoría técnica inmediata. |
Conectar tus plataformas es el paso más importante para escalar tu estrategia de atención. Al asegurar una autenticación correcta y monitorear el estado de tu integración, garantizas que tus agentes reciban las conversaciones sin interrupciones y con todo el contexto necesario para brindar un servicio excepcional. ✅