Activer les flux de segments d'analyse des contacts

Les flux de segments d'analyse des contacts ne sont pas activés par défaut. Cette rubrique explique comment les activer.

Étape 1 : Créer un flux Amazon Kinesis

Créez le flux de données sur le même compte et dans la même région que ceux où réside l'instance d'Amazon Connect. Pour obtenir des instructions, consultez Étape 1 : Créer un flux de données dans Guide du développeur Amazon Kinesis Data Streams.

Astuce

Nous vous recommandons de créer un flux distinct pour chaque type de données. Bien qu'il soit possible d'utiliser le même flux pour l'analyse des contacts, les flux de segments, les événements des agents et les enregistrements de contacts, il est beaucoup plus facile de gérer et d'obtenir des données à partir du flux lorsque vous utilisez un flux distinct pour chacun d'entre eux. Pour plus d'informations, consultez le Guide du développeur Amazon Kinesis Data Streams.

Étape 2 : Configurer le chiffrement côté serveur pour le flux Kinesis (facultatif mais recommandé)

Il existe plusieurs méthodes pour le faire.

• Option 1 : Utilisez Kinesis Clé gérée par AWS (aws/kinesis). Cela fonctionne sans configuration supplémentaire de votre part.

• Option 2 : Utilisez la même clé gérée par le client pour les enregistrements d'appels, les transcriptions de chat ou les rapports exportés dans l'instance d'Amazon Connect.

  Activez le chiffrement et utilisez la même clé gérée par le client pour les enregistrements d'appels, les transcriptions de chat ou les rapports exportés dans l'instance d'Amazon Connect. Choisissez ensuite la même KMS clé pour votre flux de données Kinesis. Cette clé possède déjà l'autorisation (accord) requise pour être utilisée.

• Option 3 : Utilisez une autre clé gérée par le client.

  Utilisez une clé gérée par le client existante ou créez-en une nouvelle et ajoutez les autorisations requises pour que le rôle Amazon Connect puisse utiliser la clé. Pour ajouter des autorisations à l'aide des accords AWS KMS , reportez-vous à l'exemple suivant :

  aws kms create-grant \
      --key-id your key ID \
      --grantee-principal arn:aws:iam::your AWS account ID:role/aws-service-role/connect.amazonaws.com/AWSServiceRoleForAmazonConnect_11111111111111111111 \
      --operations GenerateDataKey \
      --retiring-principal arn:aws:iam::your AWS account ID:role/adminRole

  Où se grantee-principal trouve ARN le rôle lié au service associé à votre instance Amazon Connect ? Pour trouver le ARN rôle lié au service, dans la console Amazon Connect, accédez à Présentation, Paramètres de distribution, Rôle lié au service.

Étape 3 : Associer le flux Kinesis

Utilisez Amazon Connect AssociateInstanceStorageConfigAPIpour associer les types de ressources suivants :

• Pour les contacts vocaux, utilisez REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS

• Pour les contacts par chat, utilisez REAL_TIME_CONTACT_ANALYSIS_CHAT_SEGMENTS

Note

REAL_TIME_CONTACT_ANALYSIS_SEGMENTSest obsolète, mais il est toujours pris en charge et ne s'applique qu'aux contacts vocaux. À utiliser REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS pour les contacts vocaux futurs.

Si vous avez déjà associé un flux àREAL_TIME_CONTACT_ANALYSIS_SEGMENTS, aucune action n'est nécessaire pour mettre à jour le flux versREAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS.

Spécifiez le flux Kinesis dans lequel les segments d'analyse des contacts en temps réel seront publiés. Vous aurez besoin de l'ID de l'instance et du flux Kinesis. ARN Le code suivant en présente un exemple :

// Build request
  const request: Connect.Types.AssociateInstanceStorageConfigRequest = {
    InstanceId: 'your Amazon Connect instance ID',
    ResourceType: 'REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS or REAL_TIME_CONTACT_ANALYSIS_CHAT_SEGMENTS',
    StorageConfig: {
      StorageType: 'KINESIS_STREAM',
      KinesisStreamConfig: {
        StreamArn: 'the ARN of your Kinesis stream',
      },
    }
  };      

AWS CLI

L'exemple suivant concerne les contacts de chat.

aws connect associate-instance-storage-config --instance-id your Amazon Connect instance ID --resource-type REAL_TIME_CONTACT_ANALYSIS_CHAT_SEGMENTS --storage-config StorageType=KINESIS_STREAM,KinesisStreamConfig={StreamArn=the ARN of your Kinesis stream}
                        

AWS SDK

L'exemple suivant concerne les contacts vocaux.

import { Connect } from 'aws-sdk';

async function associate (): Promise <void> {
  const clientConfig: Connect.ClientConfiguration = {
    region: 'the Region of your Amazon Connect instance',
  };

  const connect = new Connect(clientConfig);

  // Build request
  const request: Connect.Types.AssociateInstanceStorageConfigRequest = {
    InstanceId: 'your Amazon Connect instance ID',
    ResourceType: 'REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS',
    StorageConfig: {
      StorageType: 'KINESIS_STREAM',
      KinesisStreamConfig: {
        StreamArn: 'the ARN of your Kinesis stream',
      },
    }
  };

  try {
    // Execute request
    const response: Connect.Types.AssociateInstanceStorageConfigResponse = await connect.associateInstanceStorageConfig(request).promise();

    // Process response
    console.log('raw response: ${JSON.stringify(response, null, 2)}');
  } catch (err) {
    console.error('Error calling associateInstanceStorageConfig. err.code: ${err.code},' +
      'err.message: ${err.message}, err.statusCode: ${err.statusCode}, err.retryable: ${err.retryable}');
  }
}

associate().then(r => console.log('Done'));

Étape 4 : Activer Contact Lens pour l'instance d'Amazon Connect

Pour obtenir des instructions, consultez Activation d'Amazon Connect Contact Lens.

Étape 5 (facultatif) : Examiner un exemple de flux de segments

Nous vous recommandons de consulter un exemple de flux de segments vocaux ou de chat pour vous familiariser avec son apparence.