Integración de cliente Guide - Amazon Connect
Introducción
Esta página ayuda a los clientes que integran Amazon Connect ACD con CXone WFM mediante Engagement Hub. Proporciona orientación de implementación para integraciones de canal de voz y chat entrantes, dirigida a administradores de TI, integradores de sistemas y planificadores de WFM.
Ámbito
-
Colas separadas para datos históricos de entrada y salida.
-
Cubre datos históricos, en tiempo real e intradía.
-
Aplicable a las integraciones de canal de voz entrante.
-
Reporte de actividad del agente.
-
Solo admite 1 Acuerdo de Nivel de servicio por cola (Solo se debe configurar un campo para Contactos contestados en X segundos, Contactos abandonados en X segundos al programar los informes en Amazon Connect. Aquí X es el nivel de servicio).
-
La configuración de cola gestiona los contactos para un canal de medio (voz o chat) y en una dirección (entrante). Se admite la Habilidad como cola.
Ejemplo: voz-entrante, chat-entrante.
No está en el ámbito
-
Eventos de canal saliente y digital.
-
Entrantes y salientes en la misma cola. Si los datos (tanto entrantes como salientes) se envían en la misma cola, por ejemplo, datos de devolución de llamada de voz, entonces este registro completo se ignorará y no se tomará en cuenta para el cálculo del pronóstico.
-
Volver a cargar los datos históricos para ACD.
-
La máquina de estados de agente que genera el informe de actividad de agente no admite la reproducción de eventos históricos de estado de agente para generar el informe histórico de actividad de Agente.
-
Los eventos desordenados recibidos de ACD para un agente se descartan y no se mostrarán en el informe de actividad del agente.
-
Nivel de servicio de abandono.
-
Manual: volver a cargar los datos históricos.
-
La configuración de cola para manejar contactos de medio múltiple (voz, chat, correo electrónico, tareas) de ambas direcciones (entrante y saliente) no es compatible (no se admite Habilidad como atributo). Por ejemplo, voz-entrante-saliente, voz-chat-entrante.
Responsabilidades del cliente
-
El cliente es responsable de descargar e instalar el conector, con la orientación del equipo de implementación.
Debe tener la sesión iniciada en la aplicación WFM de CXone para acceder a la página Downloads. Si no tiene la sesión iniciada, no habrá archivos disponibles para Descargar.
-
Asegúrese de la conectividad de red desde el entorno AWS del cliente hasta el entorno de NiCE AWS.
-
Configure los canales de Amazon Connect y el enrutamiento según sea necesario.
-
Se requiere una suscripción activa a Amazon Connect, junto con las licencias correspondientes para:
-
Canales
-
CXone WFM
-
-
Proporcione los detalles de conexión del bucket de S3 y del flujo de Kinesis durante la instalación del conector.
-
Asigne un punto de contacto técnico para coordinar con el equipo de implementación.
-
Para usar el Agent Activity Report se requieren los siguientes elementos.
-
Habilitación de la función de máquina de Estado de agente (a cargo del equipo de I+D durante la implementación)
Nota: No se recomienda alternar con frecuencia la máquina de estados de Estado de agente.
-
Se requiere un mapeo independiente para RTA y datos históricos en la pantalla “mapeado de actividad de ACD” de CXone Work Force Management (actualmente se usa el mismo mapeado para RTA y datos históricos).
-
El evento de cierre de sesión debe asignarse al código DE actividad “desconectarse” como se muestra a continuación. El estado desconectado no se mostrará en el informe de cumplimiento histórico; sin embargo, es necesario para evitar que las entradas aparezcan como no asignadas.
-
Perspectiva general de integrar
Prerrequisitos
Asegúrese de que las siguientes configuraciones y accesos estén implementados antes de la implementación:
-
Acceso de lectura al bucket de S3 para leer los reportes históricos.
-
Acceso de lectura a la secuencia de Kinesis Amazon para datos en tiempo real.
-
Los id de agent y los Id de habilidades deben mapearse en CXone WFM según los requisitos específicos del cliente.
-
Acceso a un entorno de prueba para validación y configuración (si corresponde).
Parámetros de la pila de CloudFormation requeridos del cliente
|
parámetro |
Tipo |
Descripción |
Valor predeterminado |
|---|---|---|---|
| VpcId | AWS::EC2::VPC::Id | Id de VPC existente | Ninguno |
| SubnetId1 | AWS::EC2::Subnet::Id | ID de subred en la primera zona de disponibilidad con acceso de salida (NAT Gateway) para la implementación de ECS | Ninguno |
| SubnetId2 | AWS::EC2::Subnet::Id | ID de subred en la segunda zona de disponibilidad con acceso de salida (NAT Gateway) para la implementación de ECS | Ninguno |
| AvailabilityZone1 | AWS::EC2::AvailabilityZone::Name | Primera zona de disponibilidad para la implementación de ECS | Ninguno |
| AvailabilityZone2 | AWS::EC2::AvailabilityZone::Name | Segunda zona de disponibilidad para la implementación de ECS | Ninguno |
| InstanceType | Cadena de caracteres | Tipo de instancia de EC2 para el clúster de ECS | t3.small |
| AmazonConnectS3BucketName | Cadena de caracteres | Nombre del bucket de S3 para los informes históricos de esta instancia específica de Amazon Connect | Ninguno |
| AmazonConnectS3FolderPrefix | Cadena de caracteres | Prefijo de carpeta para las cargas de esta instancia de Amazon Connect | Ninguno |
| AmazonConnectKinesisStreamArn | Cadena de caracteres | ARN de transmisión Kinesis para los datos en tiempo real de la instancia de Amazon Connect | Ninguno |
| AmazonConnectKinesisStreamName | Cadena de caracteres | Amazon Connect Nombre de flujo Kinesis | Ninguno |
| EnableCloudWatchAlarms | Cadena de caracteres | ¿Se deben habilitar las alarmas de CloudWatch para la supervisión? (Sí/No) | Sí, No |
| AlarmNotificationEmail1 | Cadena de caracteres | Correo electrónico para enviar la suscripción de las notificaciones de alarma (obligatorio si EnableCloudWatchAlarms está establecido en "Sí"; de lo contrario, se puede dejar vacío) | Ninguno |
| AlarmNotificationEmail2 | Cadena de caracteres | Correo electrónico para enviar la suscripción de notificaciones de alarma | Ninguno |
| AlarmNotificationEmail3 | Cadena de caracteres | Correo electrónico para enviar la suscripción de las notificaciones de alarma | Ninguno |
| AlarmNotificationEmail4 | Cadena de caracteres | Correo electrónico para enviar la suscripción para las notificaciones de alarma | Ninguno |
| AlarmNotificationEmail5 | Cadena de caracteres | Correo electrónico para enviar la suscripción de las notificaciones de alarma | Ninguno |
Arquitectura de alto nivel
Arquitectura
-
Conector → ACD Hub → NiCE CXone WFM.
-
El conector desarrollado por NiCE proporciona funcionalidad Historic y RTA para la integración de Engagement Hub.
-
La configuración de Engagement Hub está hospedada en la cuenta AWS propiedad de NiCE.
-
La configuración del conector está hospedada en la cuenta de AWS del cliente.
-
El conector está diseñado para leer datos de informes solo de los streams de Amazon Kinesis y buckets de S3. Envía estos datos al servicio ACD Hub para su procesamiento. No crea, actualiza ni modifica ningún dato existente dentro del abonado.
-
El cliente debe agregar un prefijo a los nombres de los archivos de informes en el bucket de S3 de la siguiente manera, con un intervalo de 15 minutos entre archivos:
-
Reporte de Cola – QR
-
AQR: Informe de Cola de Agente
-
ASPR – Reporte de Rendimiento del Sistema del Agente
-
Componentes clave
S3 Bucket
-
Almacena reportes históricos.
-
Se crea una función Lambda única para configurar un activador que se activa cada vez que se agrega un nuevo archivo al bucket.
Kinesis Stream
-
Procesa registros de Amazon Connect datos de agente en tiempo real.
-
Requiere los permisos adecuados para el acceso y el procesamiento de datos.
Cola SQS histórica: se crea para rastrear los informes históricos cargados en el bucket de S3.
Dead Letter Queue (DLQ): captura y almacena los datos de archivo no procesados para su análisis posterior.
Conector unificado: aloja y ejecuta el servicio de Conector de Amazon Connect.
Roles y permisos
Roles de iam necesarios para ejecutar el conector
El conector crea automáticamente los siguientes IAM roles cuando se ejecuta el script de configuración.
Rol de Ejecución de Tarea de ECS
Nombre: acdhub-amazon-connector-task-execution-role
-
Propósito: Permite que ECS administre el ciclo de vida del contenedor (ejemplos: extraer imágenes, enviar registros)
-
**Entidad de confianza:** ecs-tasks.amazonaws.com
-
Políticas administradas: AmazonECSTaskExecutionRolePolicy
ECS Instancia Role
Nombre: acdhub-amazon-connector-instance-role
-
Propósito: Permite que las instancias EC2 se unan al clúster de ECS
-
Entidad de confianza: ec2.amazonaws.com
-
Políticas administradas: AmazonEC2ContainerServiceforEC2Role
Rol de Tarea de ECS
Nombre: acdhub-amazon-connector-task-role
-
Propósito: Proporciona permisos a nivel de aplicación para el servicio del conector
-
**Entidad de confianza: ecs-tasks.amazonaws.com**
- Políticas insertadas personalizadas:
Rol de ejecución de Lambda
Nombre: Role849a3c81
-
Propósito:
-
Admite la gestión de notificaciones de bucket de S3 (utilizada por un recurso personalizado de CloudFormation)
-
-
Entidad de confianza: lambda.amazonaws.com
-
Políticas administradas: AWSLambdaBasicExecutionRole
-
Política en línea personalizada: DefaultPolicye3c7c10e
Comportamiento
-
s3:GetBucketNotification
-
s3:PutBucketNotification
Recursos
-
*
-
Para Notificación de SQS
-
sqs:GetQueueAttributes
-
sqs:GetQueueUrl
-
sqs:SendMessage
Principal
-
Servicio: http://s3.amazonaws.com
Condición
-
ArnLike: "aws:SourceArn":
"arn:aws:s3:::{amazon_connect_s3_bucket.bucket_name}"
Dependencias externas
-
Instancia de Amazon Connect: Requiere credenciales DE acceso y configuración.
-
VPC existente: Debe proporcionar el ID de VPC y los ID de subred.
-
Repositorio de ECR: Debe existir con la imagen de contenedor del conector.
-
Configuraciones
Configuración de abonado
-
Abra administrador de abonados y navegue a:
Abonados > Aplicaciones y funciones > WFM > editar configuración de la Aplicación WFM > Configurar ajustes
-
En algunas funciones, elija WFM Advanced.
-
Seleccione la opción vía WFM Engagement Hub de la lista desplegable Integración ACD y haga clic en Finalizar.
-
Nombre: nombre de ACD sin espacios
-
Versión: Ejemplo 17.0.0 y arriba.
-
Mapeado de datos
Estados del agente por defecto
|
Nombre |
Id de evento |
EVENT REASON |
Código DE actividad |
Estado |
|---|---|---|---|---|
| Receso | Receso | Receso | Cerrado | |
| Disponible | Disponible | Abierto | Abierto | |
| Inicio de sesión | Inicio de sesión | Abierto | Abierto | |
| Desconectarse | Desconectarse | Desconectarse | Cerrado | |
| Desconectado | Desconectado | Desconectarse | Cerrado | |
| Voz-INBOUND-CONNECTING | Voz-INBOUND-CONNECTING | Abierto | Abierto | |
| Voz-INBOUND-CONNECTED | Voz-INBOUND-CONNECTED | Abierto | Abierto | |
| Voz-INBOUND-CONNECTED_Onhold | Voz-INBOUND-CONNECTED_Onhold | Abierto | Abierto | |
| Voz-INBOUND-ENDED | Voz-INBOUND-ENDED | Abierto | Abierto | |
| Voz-INBOUND-MISSED | Voz-INBOUND-MISSED | Abierto | Abierto | |
| VOICE-INBOUND-ERROR | VOICE-INBOUND-ERROR | Abierto | Abierto | |
| Voz-INBOUND-Onhold | Voz-INBOUND-Onhold | Abierto | Abierto | |
| Voz-Transferencia-CONECTANDO | Voz-Transferencia-CONECTANDO | Abierto | Abierto | |
| Voz-Transferencia-conectado | Voz-Transferencia-CONECTADA | Abierto | Abierto | |
| Voz-Transferencia-CONECTADA_Onhold | Voz-Transferencia-conectado_Onhold | Abierto | Abierto | |
| Voz-Transferencia-FINALIZADA | Voz-Transferencia-FINALIZADA | Abierto | Abierto | |
| CHAT-API-CONNECTING | CHAT-API-CONNECTING | Abierto | Abierto | |
| CHAT-API-CONNECTED | CHAT-API-CONNECTED | Abierto | Abierto | |
| CHAT-API-ENDED | CHAT-API-ENDED | Abierto | Abierto | |
| CHAT-API-MISSED | CHAT-API-MISSED | Abierto | Abierto | |
| CHAT-API-ERROR | CHAT-API-ERROR | Abierto | Abierto | |
| CHAT-API-Onhold | CHAT-API-Onhold | Abierto | Abierto | |
| CHAT-QUEUE_TRANSFER-CONNECTING | CHAT-QUEUE_TRANSFER-CONNECTING | Abierto | Abierto | |
| CHAT-QUEUE_TRANSFER-CONNECTED | CHAT-QUEUE_TRANSFER-CONNECTED | Abierto | Abierto | |
| CHAT-QUEUE_TRANSFER-ENDED | CHAT-QUEUE_TRANSFER-ENDED | Abierto | Abierto |
Métricas históricas
Informe de cola
-
Número de contactos recibidos
-
Abandonada corta
-
Abandonada Long
-
Manejado corto
-
Manejado largo
-
Tiempo gestionado
-
Tiempo en espera
-
Work (ACW) Time
-
Tiempo de Intervalo de cola
-
Porcentaje de nivel de servicio
-
Registros pendientes
-
Backlog Caducado
-
Backlog no Caducado
-
Contactos de persona adecuada
-
Tiempo de conversación / Tiempo de manejo de persona adecuada
-
Contactos con Parte Equivocada
-
Tiempo de conversación/Tiempo de manejo de la parte equivocada
-
Active
Reporte de cola de agente
-
AgentValue
-
Id de agente
-
Tiempo gestionado
-
Tiempo en espera
-
Tiempo de trabajo (ACW)
-
Contactos de persona adecuada
-
Tiempo de conversación/manejo de persona adecuada
-
Contactos de Parte Equivocada
-
Contactos de Parte Equivocada
-
Active
Reporte de actividad de agente
-
ACDLoginId
-
Código de evento
-
Código de motivo
-
Hora de inicio del agente
-
Hora de inicio del agente
Informe de rendimiento del sistema del agente
-
AgentValue
-
Id de agente
-
ReadyTime
-
NotReadyTime
-
Hora de inicio de sesión
Tipos DE medio compatibles
-
Voz entrante
-
Conversación
Clasificaciones de Canal de medio
-
Respuesta inmediata (por voz entrante)
-
Respuesta diferible (vía chat)
Protocolos
-
Para en tiempo real, el conector establece conexión con la transmisión de Kinesis de Amazon.
-
Para los informes históricos, el cliente debe configurar el bucket de S3 en la cuenta de AWS del cliente.
Tipos de datos admitidos
-
Datos históricos (15 MIn)
-
Datos de previsión
-
Intraday
-
-
Observancia en tiempo real (transiciones de Estado de agente)
Detalles de recuperación de datos
El conector admite los siguientes mecanismos de recuperación de datos:
-
**tiempo real:** el Conector escucha el flujo de Kinesis de Amazon Connect para eventos de estado de agente.
-
Histórico: El Conector obtiene periódicamente datos históricos del bucket de S3.
-
When el ACD o el conector está inactivo, el estado del agente se muestra como el último estado en la pantalla de RTA de WFM de CXone.
-
Para los intervalos de medianoche/feriados (en los que el ACD no genera ningún dato), no se muestra ningún dato en la pantalla Intraday de CXone WFM.
Modelos de implementación
Amazon Connect ACD integrado con el conector desarrollado por NiCE y CXone WFM.
-
El conector se ejecuta exclusivamente en tareas de ECS en instancias de EC2.
-
Configuración multi-AZ de ECS garantiza la resiliencia. Las Tareas consumen Kinesis transmisiones y colas de SQS por abonado.
-
Los intervalos de verificación de punto de control y sondeo SOn configurables.
Datos del contacto Pegging
**Valores de tiempo de contacto** se asignan al intervalo en el que se completa el contacto.
Todos los valores para los contactos de integrar de Engagement Hub se registran al final en el intervalo cuando se completa el contacto.
Ejemplo:
Si un contacto inicia en el intervalo de 12:00–12:15 y se completa en el intervalo de 12:15–12:30, se asigna al intervalo de 12:15–12:30.
Limitaciones conocidas
-
El Informe de cumplimiento histórico no está disponible.
-
Una cola puede ser compatible con un solo tipo DE soporte DE medios y una sola dirección (por ejemplo, voz-entrante o chat-entrante).
-
Hay un intervalo de 6 a 16 minutos después del final de cada intervalo antes de que Amazon Connect ACD envíe los datos históricos al NiCE connector.
Como resultado, los datos de Intraday pueden aparecer en la UI de CXone WFM aproximadamente 25 minutos después de que finaliza el intervalo.
-
Solo se admite un Acuerdo de Nivel de servicio por cola.
-
Si el cliente ya está integrado con el producto IEX, se debe crear un bucket de S3 independiente para el consumo de CXone WFM Engagement Hub.
-
Manual reload of historical data is supported for up to 30 days prior.
-
La exportación de datos de RTA no está disponible para el ACD de Amazon connect.
-
Cuando ACD o el conector no está disponible, no hay ningún cambio en el estado de agente en la pantalla de RTA en CXone WFM; continúa mostrando el último estado actualizado.
Preguntas frecuentes
Consulta: ¿Se pueden integrar múltiples instancias de Amazon Connect ACD en un solo entorno de NiCE WFM?
Ans: Actualmente, solo se admite 1 mapeado de ACD.
Consulta: ¿Qué sucede si la integración falla o los datos se retrasan?
R: Comuníquese con el equipo de soporte.
Consulta: ¿Se requiere algún tiempo de inactividad durante la configuración?
Resp.: Para un cliente nuevo, el tiempo de inactividad sigue el proceso de configuración estándar de CXone WFM.
Consulta: ¿Qué debo hacer si el estado de agente predeterminado cambia?
Resp.: Comuníquese con el equipo de Implementación para actualizar el mapeado de datos de ACD en el administrador de abonados de CXone WFM.
Consulta: ¿Qué debo hacer si se cambia el nombre de la cola?
R: Comuníquese con el equipo de Implementación para actualizar el mapeado de nombres de colas en el CXone WFM Tenant Manager.
Consulta: ¿Qué debo hacer si se agrega un nuevo Agente?
R: Comuníquese con el equipo de Implementación para actualizar el nombre del agente en la sección Empleados de CXone WFM.
Consulta: ¿Qué debo hacer cuando se cambia el nombre de ACD?
Ans: Importar manualmente los datos históricos en la aplicación CXone WFM.
Consulta: ¿Qué debo hacer cuando se cambia el nombre DE habilidad de WEM?
Resp: Importe manualmente los datos históricos en la aplicación WFM de CXone.
Consulta: ¿Qué sucede si los id de agent cambian?
Ans: Garantice un mapeado de ID coherente para evitar discrepancias de RTA.
Consulta: ¿Qué sucede si cambian los parámetros de la pila de CloudFormation?
Resp: Comuníquese con el equipo de Implementación para actualizar los parámetros.
Consulta: ¿Qué debo hacer si queremos agregar más canales de medio?
Resp: Comuníquese con el equipo de producto para analizar las opciones admitidas.
Soporte y Recursos
-
Contacto de Servicios Profesionales de NICE.
-
CXone WFM Centro de ayuda.