启用实时联系人分析分段流

默认情况下，未启用实时联系人分析分段流。本主题介绍如何启用它们。

步骤 1：创建 Kinesis 流

在您的 Amazon Connect 实例所驻留的同一账户和区域创建数据流。有关说明，请参阅《Amazon Kinesis Data Streams 开发人员指南》中的步骤 1：创建数据流。

提示

建议为每种类型的数据创建一个单独的流。虽然可以将同一个流用于实时联系人分析分段流、座席事件和联系人记录，但是当您为每个流使用单独的流时，管理数据和从流中获取数据要容易得多。有关更多信息，请参阅 Amazon Kinesis Data Streams 开发人员指南。

步骤 2：为 Kinesis 流设置服务器端加密（可选，但建议使用）

可通过多种方式执行此操作。

• 选项 1：使用 Kinesis AWS 托管式密钥 (aws/kinesis)。这无需您进行额外的设置即可使用。

• 选项 2：在您的 Amazon Connect 实例中使用相同的客户自主管理型密钥进行通话录音、聊天转录或导出报告。

  启用加密，并在您的 Amazon Connect 实例中使用客户自主管理型密钥进行通话录音、聊天转录或导出报告。然后为您的 Kinesis 数据流选择相同的 KMS 密钥。此密钥已具有使用所需的权限（授权）。

• 选项 3：使用其他客户自主管理型密钥。

  使用现有客户自主管理型密钥或创建一个新密钥并添加 Amazon Connect 角色使用相应密钥所需的权限。要使用 AWS KMS 授权添加权限，请参阅以下示例：

  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

  其中 grantee-principal 是与您的 Amazon Connect 实例关联的服务相关角色的 ARN。要查找服务相关角色的 ARN，请在 Amazon Connect 控制台中，转至概述、分配设置、服务相关角色。

步骤 3：关联 Kinesis 流

对于语音联系人，请使用 Amazon Connect AssociateInstanceStorageConfigAPI 将资源类型REAL_TIME_CONTACT_ANALYSIS_SEGMENTS与发布实时联系人分析区段的 Kinesis 直播关联起来。您需要相应的实例 ID 和 Kinesis 流 ARN。

AWS CLI

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

AWS SDK

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_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'));

第 4 步：为您的 Amazon Connect 实例启用 Contact Lens

有关说明，请参阅启用 Amazon Connect Contact Lens。

步骤 5（可选）：查看示例分段流

建议您查看示例分段流，以熟悉其外观。请参阅 示例实时联系人分析分段流。