啟用即時聯絡人分析區段串流

預設不會啟用即時聯絡分析區段串流。本主題介紹如何啟用。

步驟 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

  與您的 Amazon Connect 執行個體相關聯的服務連結角色的 ARN 在 grantee-principal。若要尋找服務連結角色的 ARN，請在 Amazon Connect 主控台中前往 概覽、分佈設定、服務連結角色。

步驟 3：關聯 Kinesis 串流

使用 Amazon Connect AssociateInstanceStorageConfigAPI 關聯下列資源類型：

• 若為語音連絡人，請使用 REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS

• 對於聊天聯繫人，請使用 REAL_TIME_CONTACT_ANALYSIS_CHAT_SEGMENTS

注意

REAL_TIME_CONTACT_ANALYSIS_SEGMENTS已取代，但仍受支援，且僅適用於語音連絡人。用REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS於向前移動的語音聯繫人。

如果您之前已將串流與關聯REAL_TIME_CONTACT_ANALYSIS_SEGMENTS，則不需要任何動作即可將串流更新至REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS。

指定將在其中發佈即時接觸分析區段的 Kinesis 串流。您需要執行個體 ID 和 Kinesis 串流 ARN。下列代碼顯示了範例：

// 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

下列範例適用於聊天連絡人。

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

下列範例適用於語音連絡人。

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

步驟 4：為您的 Amazon Connect 執行個體啟用 Contact Lens

如需說明，請參閱啟用 Amazon Connect Contact Lens。

步驟 5 (選用)：檢閱範例區段串流

我們建議您檢閱語音或聊天範例區段串流，以熟悉其外觀。