Intégration client Guide - Amazon Connect
Introduction
Cette page aide les clients intégrant Amazon Connect ACD à CXone WFM à l'aide d'Engagement Hub. Elle fournit des conseils d'implémentation pour les intégrations de canal voix et chat entrants, destinés aux administrateurs informatiques, aux intégrateurs système et aux planificateurs WFM.
Portée
-
Files d’attente distinctes pour les données historiques entrantes et sortantes.
-
Couvre les données historiques, en temps réel et intrajournalières.
-
Applicable aux intégrations de canal voix entrant.
-
Rapport d'activité de l'Agent.
-
Ne prend en charge qu'un seul Accord de Niveau de service par file d'attente (un seul champ doit être configuré pour les contacts répondus en X secondes, les contacts abandonnés en X secondes, lors de la programmation des rapports sur Amazon Connect. Ici, X représente le niveau de service).
-
La configuration de la file d’attente traite les contacts pour un canal média (voix ou chat) et dans une direction (entrant). La Compétence en tant que file d’attente est prise en charge.
Exemple : voix-entrant, chat-entrant.
Hors portée
-
Sortant et événements de canal numérique.
-
Entrant et sortant dans la même file d’attente. Si les données (entrantes et sortantes) sont envoyées dans la même file d’attente, par exemple des données de rappel d’appel vocal, cet enregistrement complet sera alors ignoré et ne sera pas pris en compte pour le calcul de la prévision.
-
Recharger les données historiques pour ACD.
-
La machine à états Agent qui génère le rapport d'activité Agent ne prend pas en charge le rejouer des événements d'état de l'agent historiques afin de générer un rapport d'activité d'agent historique.
-
Les événements non ordonnés reçus de ACD pour un agent sont rejetés et ne seront pas affichés dans le rapport d'activité de l'agent.
-
Abandon Niveau de service.
-
Rechargement manuel des données historiques.
-
Configuration de file d’attente pour traiter des contacts de plusieurs canaux média (voix, chat, e-mail, tâches) dans les deux sens (entrant et sortant) n'est pas prise en charge (Compétence en tant qu'attribut n'est pas prise en charge). Par exemple, voix-entrant-sortant, voix-chat-entrant.
Responsabilités du client
-
Le client est responsable du téléchargement et de l'installation du connecteur, avec les conseils de l'équipe d'implémentation.
Vous devez être connecté à l'application CXone WFM pour accéder à la page Téléchargements. Si vous n'êtes pas connecté, aucun fichier ne sera disponible au téléchargement.
-
Assurez-vous de la connectivité réseau entre l'environnement AWS du client et l'environnement AWS de NiCE.
-
Configurez les canaux et le routage Amazon Connect selon les besoins.
-
Un abonnement actif à Amazon Connect est requis, ainsi que les licences appropriées pour :
-
Canaux
-
CXone WFM
-
-
Fournissez les détails de connexion du compartiment S3 et du flux Kinesis lors de l'installation du connecteur.
-
Désignez un point de contact technique pour assurer la coordination avec l'équipe d'implémentation.
-
Pour utiliser le Agent Activity Report, les éléments suivants sont requis.
-
Activation de la fonctionnalité de machine à états État de l’agent (à réaliser par l'équipe R&D pendant le déploiement)
Remarque : il n’est pas recommandé de basculer fréquemment la machine à états de Agent.
-
Un mappage distinct est requis pour le Ctr (meaning « adhésion en temps réel ») et les données historiques sur l'écran « mappage des activités ACD » de CXone Work Force Management (actuellement, le même mappage est utilisé pour le CTR & l'historique).
-
L'événement de déconnexion doit être mappé au code d’activité « Se déconnecter » comme indiqué ci-dessous. L'état hors ligne ne sera pas affiché dans le rapport de conformité historique, cependant cela est nécessaire pour éviter que des entrées s'affichent comme non mappées.
-
Vue d’ensemble de l’intégration
Conditions préalables
Veillez à ce que les configurations et accès suivants soient en place avant l'implémentation :
-
Accès en lecture au bucket S3 pour la lecture des rapports historiques.
-
Accès en lecture au flux Amazon Kinesis pour les données en temps réel.
-
Les id d’agent et les Id de compétence doivent être mappés dans CXone WFM selon les exigences spécifiques du client.
-
Accès à un environnement de tests pour la validation et la configuration (si applicable).
Paramètres de la pile CloudFormation requis de la part du client
|
paramètre |
type |
description |
Valeur par défaut |
|---|---|---|---|
| VpcId | AWS::EC2::VPC::Id | ID VPC existant | Aucun |
| SubnetId1 | AWS::EC2::Subnet::Id | ID de sous-réseau dans la première zone de disponibilité avec accès de sortie (NAT Gateway) pour le déploiement ECS | Aucun |
| SubnetId2 | AWS::EC2::Subnet::Id | ID du sous-réseau dans la deuxième zone de disponibilité avec accès de sortie (passerelle NAT) pour le déploiement ECS | Aucun |
| AvailabilityZone1 | AWS::EC2::AvailabilityZone::Name | Première zone de disponibilité pour le déploiement ECS | Aucun |
| AvailabilityZone2 | AWS::EC2::AvailabilityZone::Name | Deuxième zone de disponibilité pour le déploiement ECS | Aucun |
| InstanceType | Chaîne | Type d'instance EC2 pour le cluster ECS | t3.small |
| AmazonConnectS3BucketName | Chaîne | Nom du compartiment S3 pour les rapports historiques de cette instance Amazon Connect spécifique | Aucun |
| AmazonConnectS3FolderPrefix | Chaîne | Préfixe de dossier pour les téléversements de cette instance Amazon Connect | Aucun |
| AmazonConnectKinesisStreamArn | Chaîne | ARN de flux Kinesis pour les données en temps réel de l'instance Amazon Connect | Aucun |
| AmazonConnectKinesisStreamName | Chaîne | Amazon Connect Nom du flux Kinesis | Aucun |
| EnableCloudWatchAlarms | Chaîne | Faut-il activer les alarmes CloudWatch pour la surveillance (Oui/NON) | Oui, Non |
| AlarmNotificationEmail1 | Chaîne | E-mail d'envoi de l'abonnement pour les notifications d'alarme (obligatoire si EnableCloudWatchAlarms est défini sur « YES », sinon peut être laissé vide) | Aucun |
| AlarmNotificationEmail2 | Chaîne | Courriel à envoyer pour l'abonnement aux notifications d'alarme | Aucun |
| AlarmNotificationEmail3 | Chaîne | Courriel d'envoi d'abonnement pour les notifications d'alarme | Aucun |
| AlarmNotificationEmail4 | Chaîne | Courriel à envoyer pour l'abonnement aux notifications d'alarme | Aucun |
| AlarmNotificationEmail5 | Chaîne | Courriel à envoyer pour l'abonnement aux notifications d'alarme | Aucun |
Architecture de haut niveau
Architecture
-
Connecteur → ACD Hub → NiCE CXone WFM.
-
Le connecteur développé par NiCE fournit les fonctionnalités Historique et Ctr (meaning « adhésion en temps réel ») pour l'intégration Engagement Hub.
-
La configuration de Engagement Hub est hébergée sur le compte AWS appartenant à NiCE.
-
La configuration du connecteur est hébergée sur le compte AWS du client.
-
Le connecteur est conçu pour lire les données de rapport uniquement à partir des flux Amazon Kinesis et des buckets S3. Il envoie ces données au service ACD Hub pour traitement. Il ne crée, ne met à jour ni ne modifie aucune donnée existante au sein du locataire.
-
Le client doit préfixer les noms des fichiers de rapport dans le compartiment S3 comme suit, avec un intervalle de 15 minutes entre les fichiers :
-
Rapport QR – File d’attente
-
AQR – Rapport sur les files d'attente des agents
-
ASPR – Rapport de performance Système de l'Agent
-
Composants clés
S3 Bucket
-
Stocke les rapports historiques.
-
Une fonction Lambda ponctuelle est créée pour configurer un déclencheur qui s'active chaque fois qu'un nouveau fichier est ajouté au bucket.
Flux Kinesis
-
Traite les enregistrements provenant de Amazon Connect données Agent en temps réel.
-
Nécessite des autorisations appropriées pour l'accès aux données et leur traitement.
File d’attente SQS historique : est créée pour suivre les rapports historiques chargés dans le compartiment S3.
File d’attente des lettres mortes (DLQ) : capture et stocke les données de fichier non traitées pour une analyse ultérieure.
Connecteur unifié : héberge et exécute le service Connecteur Amazon Connect.
Rôles et autorisations
Rôles iam requis pour exécuter le connecteur
Le connecteur crée automatiquement les Rôles iam suivants lors de l'exécution du script.
Rôle d'Exécution de tâche ECS
Name : acdhub-amazon-connector-task-execution-role
-
But : Permet à ECS de gérer le cycle de vie du conteneur (par exemple, extraction d'images, envoi de journaux)
-
Entité de confiance : ecs-tasks.amazonaws.com
-
Politiques gérées : AmazonECSTaskExecutionRolePolicy
Rôle d'exemple ECS
acdhub-amazon-connector-instance-role
-
Objectif : Permet aux instances EC2 de rejoindre le cluster ECS
-
Entité de confiance : ec2.amazonaws.com
-
Politiques gérées : AmazonEC2ContainerServiceforEC2Role
Rôle Tâche ECS
acdhub-amazon-connector-task-role
-
But : fournit des autorisations au niveau de l'application pour le service du connecteur
-
Entité de confiance : ecs-tasks.amazonaws.com
- Politiques en ligne personnalisées :
Rôle d'exécution Lambda
Name (nom) : Role849a3c81
-
But :
-
Prend en charge la gestion des notifications de bucket S3 (utilisée par une ressource CloudFormation personnalisée)
-
-
Entité de confiance : lambda.amazonaws.com
-
Politiques gérées : AWSLambdaBasicExecutionRole
-
Politique en ligne personnalisée : DefaultPolicye3c7c10e
Actions
-
s3:GetBucketNotification
-
s3:PutBucketNotification
Ressources
-
*
-
Pour Notification SQS
-
sqs:GetQueueAttributes
-
sqs:GetQueueUrl
-
sqs:SendMessage
Principal
-
Service : http://s3.amazonaws.com
Condition
-
ArnLike: "aws:SourceArn":
"arn:aws:s3:::{amazon_connect_s3_bucket.bucket_name}"
Dépendances externes
-
Instance Amazon Connect : Nécessite des identifiants d’accès et une configuration.
-
VPC existant : doit fournir l'ID du VPC et les ID de sous-réseau.
-
Référentiel ECR : doit exister avec l'image conteneur du connecteur.
-
Configurations
Configuration du locataire
-
Ouvrez Locataire Manager et accédez à :
Locataires > Applications et fonctionnalités > WFM > modifier la configuration de l'application WFM > Configurer les paramètres
-
Dans certaines fonctionnalités, sélectionnez WFM Advanced.
-
Sélectionnez l'option via WFM Engagement Hub dans la liste déroulante ACD Integration et cliquez sur Terminer.
-
Nom : ACD nom sans espaces
-
Version : Example 17.0.0 et supérieures.
-
Mappage des données
Par défaut, états de l’agent
|
Nom |
Identifiant de l’événement |
Raison de l’événement |
Code d’activité |
État |
|---|---|---|---|---|
| Pause | Pause | Pause | Fermé | |
| Disponible | Disponible | Ouvert | Ouvert | |
| Connexion | Connexion | Ouvert | Ouvert | |
| Déconnexion | Déconnexion | Se déconnecter | Fermé | |
| Hors ligne | Hors ligne | Se déconnecter | Fermé | |
| Voix-INBOUND-CONNECTING | Voix-INBOUND-CONNECTING | Ouvert | Ouvert | |
| Voix-INBOUND-CONNECTED | Voix-INBOUND-CONNECTED | Ouvert | Ouvert | |
| Voix-INBOUND-CONNECTED_ONHOLD | Voix-INBOUND-CONNECTED_ONHOLD | Ouvert | Ouvert | |
| Voix-INBOUND-ENDED | Voix-INBOUND-ENDED | Ouvert | Ouvert | |
| Voix-INBOUND-MISSED | Voix-INBOUND-MISSED | Ouvert | Ouvert | |
| Voix-entrante-Erreur | Voix-entrant-Erreur | Ouvert | Ouvert | |
| Voix-INBOUND-en attente | Voix-INBOUND-en attente | Ouvert | Ouvert | |
| Voix-Transférer-connexion | Voix-Transférer-connexion | Ouvert | Ouvert | |
| Voix-Transférer-connecté | Voix-Transférer-connecté | Ouvert | Ouvert | |
| Voix-Transférer-CONNECTED_ONHOLD | Voix-Transférer-connecté_ONHOLD | Ouvert | Ouvert | |
| Voix-TRANSFERT-terminé | Voix-TRANSFERT-terminé | Ouvert | Ouvert | |
| CHAT-API-CONNECTING | CHAT-API-CONNECTING | Ouvert | Ouvert | |
| CHAT-API-CONNECTED | CHAT-API-CONNECTED | Ouvert | Ouvert | |
| CHAT-API-ENDED | CHAT-API-ENDED | Ouvert | Ouvert | |
| CHAT-API-MISSED | CHAT-API-MISSED | Ouvert | Ouvert | |
| CHAT-API-ERROR | CHAT-API-ERROR | Ouvert | Ouvert | |
| CHAT-API-en attente | CHAT-API-en attente | Ouvert | Ouvert | |
| CHAT-File d’attente_Transférer-connexion en cours | CHAT-File d’attente_Transférer-connexion en cours | Ouvert | Ouvert | |
| CHAT-File d’attente_TRANSFERT-connecté | CHAT-File d’attente_Transférer-connecté | Ouvert | Ouvert | |
| CHAT-QUEUE_TRANSFER-ENDED | CHAT-QUEUE_TRANSFER-ENDED | Ouvert | Ouvert |
Métriques historiques
Rapport sur la file d’attente
-
Nombre de contacts reçus
-
Abandonné rapidement
-
Abandonné Long
-
Manipulé court
-
Manipulé long
-
Temps de traitement
-
Temps d’attente
-
Temps de travail après appel (ACW)
-
Durée du Délai de file d’attente
-
Pourcentage de niveau de service
-
Arriéré
-
Backlog Expiré
-
Backlog non Expiré
-
Contacts bon correspondant
-
Temps de conversation du bon correspondant / Temps de traitement
-
Contacts de mauvaise partie
-
Temps de conversation / Temps de traitement de la mauvaise partie
-
actif
Rapport de file d’attente Agent
-
Valeur d'agent
-
Id de l’agent
-
Temps de traitement
-
Temps d’attente
-
ACW (After-call work) Time
-
Contacts bon correspondant
-
Temps de conversation / Temps de traitement du bon correspondant
-
Contacts de la mauvaise partie
-
Mauvais contacts de partie
-
actif
Rapport sur l'activité des Agents
-
ACDLoginId
-
Code d’événement
-
Code de raison
-
Heure de début de l'Agent
-
Heure de début de l’Agent
Rapport de performance système de l'Agent
-
AgentValue
-
Id de l’agent
-
ReadyTime
-
NotReadyTime
-
Heure de connexion
Types DE supports pris en charge
-
Appel vocal entrant
-
Conversation
Classifications de Canal média
-
Réponse immédiate (via voix entrante)
-
Réponse différable (par chat)
Protocoles
-
Pour le temps réel, le connecteur établit une connexion avec le flux Amazon Kinesis.
-
Pour les rapports historiques, le client doit configurer un compartiment S3 dans le compte AWS du client.
Types de données prises en charge
-
Données historiques (15 min)
-
Données prévisionnelles
-
Intrajournalier
-
-
Application conforme en temps réel (transitions de l'état de l'agent)
Détails sur la récupération des données
Le connecteur prend en charge les mécanismes de récupération de données suivants :
-
Temps réel : le Connecteur écoute le flux Kinesis Amazon Connect pour les événements d'état de l'agent.
-
Historique : le Connecteur récupère périodiquement les données historiques depuis le bucket S3.
-
Lorsque le ACD ou le connecteur est hors service, l'état de l'agent s'affiche comme le dernier état sur l'écran Ctr (meaning « adhésion en temps réel ») WFM de CXone.
-
Pour les intervalles de minuit/jours fériés (pour lesquels aucune donnée n'est générée par ACD), aucune donnée n'est affichée sur l'écran Intraday de CXone WFM.
Modèles de déploiement
Amazon Connect ACD intégré avec le connecteur développé par NiCE et CXone WFM.
-
Le connecteur s'exécute exclusivement sur des tâches ECS sur des instances EC2.
-
Configuration ECS multi-AZ garantit la résilience. Les Tâches consomment les flux Kinesis et les files d’attente SQS par locataire.
-
Les intervalles de contrôle et d'interrogation sont configurables.
Données de contact Pegging
Valeurs de la durée du contact sont rattachées à l'intervalle lorsque le contact se termine.
Toutes les valeurs des contacts d'intégration Engagement Hub sont comptabilisées à la fin de l'intervalle lorsque le contact se termine.
Exemple:
Si un contact commence dans l'intervalle 12:00–12:15 et se termine dans l'intervalle 12:15–12:30, il est rattaché à l'intervalle 12:15–12:30.
Limitations connues
-
Le Rapport de conformité historique n'est pas disponible.
-
Une file d'attente ne peut prendre en charge qu'un seul type DE support et une seule direction (par exemple, voix-entrant ou chat-entrant).
-
Il y a un délai de 6 à 16 minutes après la fin de chaque intervalle avant que l'ACD Amazon Connect n'envoie les données historiques au Connecteur nice.
Par conséquent, les données Intraday peuvent apparaître dans l'interface utilisateur de CXone WFM environ 25 minutes après la fin de l'intervalle.
-
Un seul Accord de Niveau de service par file d’attente est pris en charge.
-
Si le client est déjà intégré au produit IEX, un compartiment S3 distinct doit être créé pour la consommation de CXone WFM Engagement Hub.
-
Le rechargement manuel des données historiques est pris en charge jusqu'à 30 jours auparavant.
-
L'exportation des données CTR (adhésion en temps réel) n'est pas disponible pour l'ACD connect Amazon.
-
Lorsque ACD ou le connecteur est hors service, il n'y a aucun changement de l'état de l’agent sur l'écran Ctr (meaning « adhésion en temps réel ») dans CXone WFM, il continue d'afficher l'état de la dernière mise à jour.
FAQ
Requête : Des instances multiple Amazon Connect ACD peuvent-elles être intégrées dans un seul environnement NiCE WFM ?
R. : Actuellement, un seul mappage de ACD est pris en charge.
Requête : Que se passe-t-il si l'intégration échoue ou si les données sont retardées ?
Réponse : Contactez l'Équipe du soutien.
Requête : Un temps d'arrêt est-il nécessaire lors de la configuration ?
Réponse : Pour un nouveau client, l'interruption de service suit le processus de configuration Standard de CXone WFM.
Requête : Que dois-je faire si l'état par défaut de l'agent change ?
Rép. : Contactez l'équipe Implémentation pour mettre à jour le mappage des données ACD dans le CXone WFM Tenant Manager.
Requête : Que dois-je faire si le nom de la file d’attente est modifié ?
Réponse : Contactez l'équipe Implémentation pour mettre à jour le mappage du nom de file d'attente dans le Gestionnaire de locataires CXone WFM.
Requête : Que dois-je faire si un nouvel Agent est ajouté ?
Rép. : Contactez l'équipe Implémentation pour mettre à jour le nom de l'agent dans la Section Employés de CXone WFM.
Requête : Que dois-je faire lorsque le nom de ACD est modifié ?
Ans: Importez manuellement les données historiques sur l'application CXone WFM.
Requête : Que dois-je faire lorsque le nom DE LA compétence WEM est modifié ?
Ans: Importez manuellement les données historiques sur l'application CXone WFM.
Requête : Que se passe-t-il si les id d’agent changent ?
Réponse : Assurez-vous d'un mappage cohérent des ID pour éviter les incohérences de Ctr (meaning « adhésion en temps réel »).
Requête : Que se passe-t-il si les paramètres de la pile CloudFormation changent ?
Rép. : Contactez l'équipe Implémentation pour mettre à jour les paramètres.
Requête : Que dois-je faire si nous souhaitons ajouter d'autres canaux média ?
Réponse : Contactez l'équipe produit pour discuter des options prises en charge.
Soutien et Ressources
-
Contact Services Professionnel NiCE.
-
CXone WFM Centre d'aide.