🔌 Configuración de Prerrequisitos para Genesys Cloud

📋 Requisitos Previos

Antes de iniciar la conexión en la plataforma Atom, asegúrate de cumplir con los siguientes elementos operativos:

Una cuenta activa de Genesys Cloud CX.
Privilegios de Administrador en Genesys (necesarios para crear un Cliente OAuth u OAuth Client).
Credenciales de acceso generadas desde Genesys: Client ID y Client Secret.
Acceso al módulo de integraciones en Atom (Ruta: Configuraciones > Integraciones).

⚙️ Configuración del Cliente OAuth en Genesys

Para que Atom y Genesys puedan comunicarse de forma bidireccional, necesitas crear un cliente OAuth en Genesys y otorgarle un conjunto de permisos específicos.

1. Creación de Credenciales

Ingresa a tu consola de administración de Genesys Cloud y crea un nuevo cliente OAuth. Al finalizar, el sistema te entregará un Client ID y un Client Secret. Mantén estas claves a la mano, ya que las ingresarás posteriormente en la tarjeta de integración dentro de Atom.

2. Permisos Obligatorios

Estos permisos son de carácter estrictamente funcional y son requeridos para enrutar el tráfico de conversaciones y mapear las tipificaciones correctamente.

⚠️ Importante: Si tu OAuth Client en Genesys no cuenta con la totalidad de estos permisos, el sistema de Atom rechazará la conexión para proteger la integridad del flujo de atención y será imposible finalizar la integración.

Funcionalidad	Permiso técnico en Genesys
Recibir mensajes	`conversation:message:receive`
Ver flujos	`architect:flow:view`
Gestionar enrutamiento	`routing:message:manage`
Añadir integraciones	`messaging:integration:add`
Eliminar integraciones	`messaging:integration:delete`
Clasificaciones	`routing:wrapupCode:view`

3. Permisos Opcionales

Estos permisos habilitan funcionalidades extendidas relacionadas con la sincronización y gestión de contactos externos.

💡 Tip: Dependiendo de tu tipo de licencia CX en Genesys, algunos de estos permisos podrían no estar disponibles. ¡No te preocupes! Es completamente viable establecer la conexión solo con los permisos obligatorios. Puedes actualizar los permisos opcionales más adelante sin afectar la operación base.

Funcionalidad	Permiso técnico en Genesys
Ver contactos externos	`externalContacts:contact:view`
Añadir contactos externos	`externalContacts:contact:add`
Editar contactos externos	`externalContacts:contact:edit`
Ver campos personalizados	`externalContacts:customFields:view`
Editar campos personalizados	`externalContacts:customFields:edit`

📊 Validación de Estados de la Integración

Una vez que tengas tus credenciales y te dirijas a Configuraciones > Integraciones en Atom, interactuarás con la tarjeta de Genesys Cloud. Conocer los distintos estados de conexión te ayudará a verificar que los prerrequisitos se hayan validado con éxito.

Estado en Atom	Significado Operativo
Conectar	Estado inicial por defecto. Indica que la integración está lista para ser configurada.
Conectando...	Aparece al ingresar tus credenciales. Atom está validando y cargando los permisos otorgados en Genesys.
Configuración pendiente	¡Tus credenciales y permisos son correctos! Solo falta que configures un flujo de enrutamiento y una tipificación por defecto en Atom para iniciar la operación.
Conectado	La integración ha sido validada, mapeada y está lista para enrutar tus conversaciones.
Conexión fallida	Ocurre si el usuario abandona prematuramente la ventana de credenciales o la validación antes de terminar el proceso.
Con error	Estado crítico. Significa que, tras una conexión exitosa, se perdió algún permiso obligatorio en Genesys o existe una alteración que impide enrutar mensajes. Requiere revisión inmediata de tu OAuth Client.

Preparar tu entorno y asegurar los permisos correctos desde el primer momento garantiza una configuración fluida, segura y libre de bloqueos. ¡Ya tienes todo listo para unificar el poder de automatización de Atom con la eficiencia de tus agentes en Genesys Cloud! ✅