Préparer l'Environnement Amazon Connect pour Real-Time Third Party Telephony Recording (Multi-ACD)

Ce sujet décrit les étapes de préparation de l'environnement AWS requises avant que Real-Time Third Party Telephony Recording (Multi-ACD) puisse enregistrer les appels de votre instance Amazon Connect. Vous effectuez toutes les étapes dans votre compte AWS. une fois ces étapes terminées, votre représentant de compte NiCE CXone utilise les valeurs que vous avez recueillies pour terminer la configuration du côté NiCE CXone.

Cette procédure est fournie uniquement comme exemple de la manière de configurer AWS pour une intégration avec NiCE CXone. Il incombe au client de configurer et de déployer correctement les éléments AWS afin qu'ils s'intègrent correctement avec NiCE CXone.

Avant de commencer

  • Assurez-vous de disposer d'un accès administrateur à votre compte AWS et à votre instance Amazon Connect.

  • Votre ingénieur Services Professionnel NiCE vous fournira les valeurs spécifiques à NiCE mentionnées dans cette procédure.

  • Pour en savoir plus sur les licences et les autorisations, consultez Recording téléphonique En temps réel par un tiers.

Workflow

Effectuez ces étapes dans l'ordre approprié pour préparer votre environnement AWS pour l'enregistrement.

Étape 1 : Trouvez l'ARN de votre exemple Amazon Connect

Étape 2 : Activer le streaming Média actif

Étape 3 : Configurer les Flux Amazon Connect

Étape 4 : Créer le Rôle iam d'accès KVS

Étape 5 : Configurer EventBridge

Étape 6 : Configurer les Événements Agent

Étape 1 : Trouvez l'ARN de votre exemple Amazon Connect

Vous aurez besoin de l'ARN de votre instance Amazon Connect pour plusieurs étapes de cette procédure. Trouvez-le et enregistrez-le en lieu sûr à titre de référence.

Pour trouver votre ARN d'instance :

  1. Ouvrez AWS Console et accédez à Amazon Connect.

  2. Sélectionnez votre instance.

  3. Copiez l'ARN de l'Exemple à partir de la page de présentation de l'instance et enregistrez-le dans un endroit sécurisé.

Étape 2 : Activer le streaming Média actif

Amazon Connect doit diffuser l'audio de l'appel vers Kinesis Video Streams (KVS) avant que NiCE puisse le récupérer. Amazon Connect crée automatiquement un flux KVS pour chaque appel une fois la diffusion de média en direct activée. L'ARN du flux est inclus dans la charge utile de l'événement de contact, et NiCE CXone l'utilise pour récupérer l'audio.

Pour activer la diffusion en direct des médias :

  1. Ouvrez AWS Console et accédez à Amazon Connect.

  2. Sélectionnez votre instance.

  3. Accédez à stockage des données.

  4. Sous Actif diffusion média en direct, activez la diffusion média en direct et configurez un préfixe de flux et une période DE conservation.

  5. Dans les paramètres de chiffrement, sélectionnez une des options suivantes :

    • Utilisez la clé par défaut gérée par AWS : aws/kinesisvideo.

    • Utiliser une clé gérée par le client (CMK).

  6. Enregistrez la configuration.

Si les directives de conformité de votre organisation exigent une Customer Managed Key (CMK) pour le chiffrement KVS, vous devez explicitement mettre à jour votre politique de Clé KMS afin d'accorder les autorisations KMS:Decrypt et KMS:DescribeKey au Rôle iam de la solution d'enregistrement externe. Si vous n'accordez pas ces autorisations, l'enregistreur ne parvient pas à traiter les fragments antérieurs, même s'il dispose d'autorisations de flux IAM valides.

Étape 3 : Configurer les Flux Amazon Connect

Vous devez effectuer ces étapes pour chaque flux Amazon Connect où l'enregistrement est requis. Les blocs Démarrer la diffusion Média et Balises de contact doivent être inclus dans tous les flux pertinents, plus précisément :

  • Flux de transfert d'Agent

  • File d’attente Transférer les flux

  • Flux entrants

Pour configurer les flux :

  1. Ouvrez l'éditeur de flux dans le AWS Console.

  2. Sélectionnez le flux que vous souhaitez configurer pour l'enregistrement.

  3. Ajoutez le bloc Démarrer le flux multimédia.

  4. Sous Démarrer le flux, cochez les cases suivantes :

    • Du client

    • Au client

  5. Ensuite, ajoutez le Contact Tags Block.

    Le bloc Contact tags doit être ajouté après le bloc Start media streaming.

  6. Pour Select tag action, sélectionnez Balise.

  7. Pour Tag key, entrez kvsStreamArn (sensible à la casse).

  8. Définissez la valeur de manière dynamique, en utilisant Media streams comme espace de noms et Customer audio stream ARN comme clé.

  9. Enfin, ajoutez les Données commerciales personnalisées (si nécessaire).

  10. Créez un nouveau bloc balises de contact.

  11. Définissez la clé de balise sur le champ de données commerciales.

  12. Définissez la valeur manuellement ou dynamiquement.

  13. Cliquez sur Confirmer.

Étape 4 : Créer le Rôle iam d'accès KVS

NiCE CXone lit l'audio des appels à partir de vos Kinesis Video Streams en utilisant un accès cross-account. Vous devez créer un rôle IAM que NiCE CXone peut assumer.

Avant de créer le rôle, obtenez les valeurs suivantes auprès de votre ingénieur Services Professionnel NiCE :

Valeur

description

Utilisé pour :

NiCE-compteCompte NiCE ID de compte AWSIl s'agit du principal qui assume le rôle.
cxone-tenant-idVotre id du locataire NiCE CXoneIl s'agit de l'id externe STS utilisé.

Pour créer le Rôle iam d'accès KVS :

  1. Créez un Rôle iam avec la politique d'approbation suivante. Remplacez les valeurs d'espace réservé par celles fournies par votre ingénieur Services Professionnel NiCE.

    var(--codeSnippetCopyLabel)
    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Principal": {
            "AWS": "arn:aws:iam::<NiCE-account>:root"
          },
          "Action": "sts:AssumeRole",
          "Condition": {
            "StringEquals": {
              "sts:ExternalId": "<cxone-tenant-id>"
            }
          }
        }
      ]
    }
  2. Joignez la politique d'autorisations suivante au rôle pour accorder à NiCE CXone un accès en lecture à vos Kinesis flux vidéo.

    var(--codeSnippetCopyLabel)
    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": [
            "kinesisvideo:GetDataEndpoint",
            "kinesisvideo:GetMedia",
            "kinesisvideo:GetMediaForFragmentList",
            "kinesisvideo:ListFragments",
            "kinesisvideo:DescribeStream"
          ],
          "Resource": "arn:aws:kinesisvideo:<region>:<customer-account-id>:stream/kvs-connect-*"
        }
      ]
    }
  3. Enregistrez le rôle arn. Vous en aurez besoin pour l'entrer dans la configuration de NiCE CXone en tant que KVS Access Role ARN.

Étape 5 : Configurer EventBridge

Amazon Connect transfère les événements de contact et d'Agent depuis votre compte AWS vers NiCE CXone à l'aide de Amazon EventBridge. Vous devez créer un rôle IAM de transfert et une règle EventBridge sur votre bus d'événements par défaut.

Avant de continuer, obtenez les valeurs suivantes auprès de votre NiCE ingénieur Services Professionnels :

Valeur

description

NiCE-compteID de compte NiCE du compte AWS
Nom du bus d'événements cibleLe bus d'événements NiCE qui reçoit vos événements transférés
NiCE-régionLa région NiCE AWS

Pour créer le Rôle iam de transfert :

  1. Créez un Rôle iam permettant à EventBridge d'envoyer des événements entre comptes vers le bus d'événements NiCE.

  2. Utilisez la politique de confiance suivante. Remplacez les valeurs d'espace réservé par celles fournies par votre ingénieur Services Professionnel NiCE.

    var(--codeSnippetCopyLabel)
    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Principal": { "Service": "events.amazonaws.com" },
          "Action": "sts:AssumeRole"
        }
      ]
    }
  3. Joignez la politique d'autorisation suivante au rôle pour envoyer des événements entre comptes vers le bus d'événements NiCE.

    var(--codeSnippetCopyLabel)
    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": "events:PutEvents",
          "Resource": "arn:aws:events:<NiCE-region>:<NiCE-account>:event-bus/<target-event-bus-name>"
        }
      ]
    }
  4. Enregistrez le rôle arn.

Pour créer la règle EventBridge :

  1. Sur votre bus d'événements EventBridge par défaut, créez une règle avec le modèle d'événement suivant. Ce modèle correspond à la fois aux événements de contact Amazon Connect et aux événements d'agent.

    var(--codeSnippetCopyLabel)
    {
      "source": ["aws.connect", "cxone.amc.agentdata.kinesis"],
      "detail-type": [
        "Amazon Connect Contact Event",
        "Amazon Connect Agent Event via Kinesis"
      ],
      "resources": [
        "arn:aws:connect:<region>:<customer-account-id>:instance/<instance-id>"
      ]
    }
  2. Définissez la cible de la règle sur le bus d'événements NiCE CXone :

    Paramètres

    Évaluer

    Type cibleBus d'événements EventBridge
    Bus d'événements ciblearn:aws:events:<région>:<NiCE-openrec-account>:event-bus/<target-event-bus-name>
    Rôle d'exécutionLe Rôle iam de transfert que vous avez créé au-dessus

Étape 6 : Configurer les Événements Agent

Les événements Agent nécessitent deux composants supplémentaires : un flux de données Kinesis connecté à votre instance Amazon Connect, et un EventBridge Pipe qui republie ces événements vers votre bus d'événements par défaut afin que la règle que vous avez créée ci-dessus puisse les récupérer.

Pour créer le Flux de données Kinesis :

  1. Ouvrez AWS Console et accédez à Kinesis.

  2. Créez un nouveau flux de données.

  3. Configurez le nombre de partitions en fonction du volume d'événements agent attendu.

    Pour les déploiements de taille petit, une partition est généralement suffisante. Une seule partition prend en charge jusqu'à 1 Mo/s de données entrantes ou 1 000 enregistrements/s.
    Pour les déploiements plus importants, augmentez le nombre de partitions selon les besoins.

  4. Définissez la rétention sur 24 heures, au minimum.

  5. Dans la console AWS, accédez à Data Streaming>Agent Événements.

  6. Associez le flux Kinesis à votre instance Amazon Connect.

  7. Enregistrez la configuration.

Pour créer le pipe EventBridge :

Créez un pipe EventBridge pour lire à partir du flux Kinesis et republier sur le bus d'événements par défaut.

  1. Configurez les paramètres en fonction du tableau ci-dessous.

    Paramètre

    Évaluer

    SourceLe flux de données Kinesis que vous avez créé au-dessus (Position de départ : LATEST, taille du lot : un)
    CibleBus d'événements EventBridge par défaut
    Champ cible > Sourcecxone.amc.agentdata.kinesis
    Type de détail cibleAmazon Connect Événement Agent via Kinesis
    Cible > RessourcesVotre ARN d'instance Amazon Connect
  2. Utilisez le modèle suivant pour le transformateur de saisie Cible :

    var(--codeSnippetCopyLabel)
    {"data": <$.data>, "sequenceNumber": "<$.sequenceNumber>"}

Architecture de réplication multi-régions

Dans l'architecture multirégion, chaque région est configurée pour envoyer les événements de l'EventBridge du client vers le pont d'événements NiCE CXone.

Si votre déploiement Amazon Connect est configuré dans un modèle de réplication multi-régions, vous devez créer et configurer les mêmes ressources dans chaque compte/région AWS participant (Rôle iam/KVS, Kinesis Flux de données + EventBridge Pipe pour les événements Agent, règle EventBridge et rôle de transfert). Configurez chaque région pour transférer les événements et autoriser l'accès au média de manière indépendante.

Paramètres

CustomerAccountIdYour AWS account ID that hosts Amazon Connect.
ConnectInstanceIdYour Amazon Connect instance ID (from the instance ARN).
KvsAccessRoleArnThe ARN of the KVS access IAM role you created above.

Paramètres fournis par NiCE CXone Services

paramètre

description

NiceAccountIdNiCE CXone compte AWS ID de compte, le principal pour la politique de confiance du rôle KVS.
CXoneTenantIdVotre id du locataire NiCE CXone, utilisé comme id externe STS dans le rôle KVS.
NiceOpenRecAccountLe compte NiCE CXone Open Recording AWS qui possède le bus EventBridge cible.
TargetEventBusNameLe nom du bus d'événements NiCE CXone qui reçoit vos événements transférés.
CXoneTargetRegionVotre NiCE CXone région cible.

Liste de contrôle Installer

Utilisez cette liste de contrôle pour vérifier que vous avez terminé toutes les étapes avant de passer le relais à votre ingénieur NiCE Services Professionnel :

  • Le flux média actif est activé sur l'instance Amazon Connect.

  • Chaque flux enregistré inclut les blocs Démarrer la diffusion multimédia et balises de contact.

  • Le Rôle iam d'accès KVS est créé, avec à la fois la politique d'approbation et la politique d'autorisation associées.

  • Le Kinesis flux de données est créé et associé à l'instance Amazon Connect en tant que stockage des événements de l'Agent.

  • La Pipe EventBridge est créée avec le Source, le detail type, les ressources et le modèle de saisie corrects.

  • Le Rôle iam de transfert EventBridge est créé.

  • La règle EventBridge est créée sur le bus d'événements par défaut à l'aide du modèle d'événement au-dessus, avec la cible définie sur le bus multicompte NiCE CXone à l'aide du rôle de transfert.