啟用聯絡分析客群串流以分析Contact Lens對話

PDFRSS

聯絡人分析區段串流預設為未啟用。本主題介紹如何啟用。

步驟 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 AssociateInstanceStorageConfig API 來關聯下列資源類型：

• 對於語音聯絡，請使用 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 區域 (--region)，則會根據 CLI 設定檔使用預設區域。

--storage-config 參數值不得包含在單引號 (') 中。否則會產生錯誤。

aws connect associate-instance-storage-config \
--region "us-west-2" \
--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 開發套件

下列範例適用於語音聯絡。

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：Contact Lens為您的 Amazon Connect 執行個體啟用

如需說明，請參閱 在 中啟用對話分析 Amazon Connect Contact Lens。

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

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