Aktivieren Sie Segmentstreams zur Kontaktanalyse

Segmentstreams für Kontaktanalysen sind standardmäßig nicht aktiviert. In diesem Artikel wird erläutert, wie Sie sie aktivieren.

Schritt 1: Erstellen eines Kinesis-Streams

Erstellen Sie den Datenstrom im selben Konto und in derselben Region, in der sich Ihre Amazon-Connect-Instance befindet. Eine Anleitung finden Sie unter Schritt 1: Erstellen eines Datenstroms im Entwicklerleitfaden für Amazon Kinesis Data Streams.

Tipp

Wir empfehlen, für jeden Datentyp einen separaten Stream zu erstellen. Es ist zwar möglich, denselben Stream für Kontaktanalyse-Segment-Streams, Agentenereignisse und Kontaktdatensätze zu verwenden, es ist jedoch viel einfacher, Daten aus dem Stream zu verwalten und abzurufen, wenn Sie für jeden Stream einen separaten Stream verwenden. Weitere Informationen finden Sie im Entwicklerleitfaden für Amazon Kinesis Data Streams.

Schritt 2: Einrichten serverseitiger Verschlüsselung für den Kinesis-Stream (optional, aber empfohlen)

Hierfür stehen Ihnen verschiedene Möglichkeiten zur Verfügung.

• Option 1: Verwenden Sie den Kinesis-Schlüssel ( Von AWS verwalteter Schlüssel , aws/kinesis). Dies funktioniert ohne zusätzliche Einrichtungsschritte Ihrerseits.

• Option 2: Verwenden Sie denselben kundenverwalteten Schlüssel für Anrufaufzeichnungen, Chat-Transkripte oder exportierte Berichte in Ihrer Amazon-Connect-Instance.

  Aktivieren Sie die Verschlüsselung und verwenden Sie einen kundenverwalteten Schlüssel für Anrufaufzeichnungen, Chat-Transkripte oder exportierte Berichte in Ihrer Amazon-Connect-Instance. Wählen Sie dann denselben KMS Schlüssel für Ihren Kinesis-Datenstream. Dieser Schlüssel verfügt bereits über die erforderliche Berechtigung (Erteilung), um verwendet zu werden.

• Option 3: Verwenden Sie einen anderen kundenverwalteten Schlüssel.

  Verwenden Sie einen vorhandenen kundenverwalteten Schlüssel oder erstellen Sie einen neuen und fügen Sie die erforderlichen Berechtigungen hinzu, damit die Amazon-Connect-Rolle den Schlüssel verwenden kann. Im folgenden Beispiel sehen sie, wie Sie Berechtigungen mithilfe von AWS KMS -Erteilungen hinzufügen:

  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

  Wo grantee-principal ist die ARN serviceverknüpfte Rolle, die mit Ihrer Amazon Connect Connect-Instance verknüpft ist. Um die ARN serviceverknüpfte Rolle zu finden, gehen Sie in der Amazon Connect Connect-Konsole zu Übersicht, Vertriebseinstellungen, Serviceverknüpfte Rolle.

Schritt 3: Zuordnen des Kinesis-Streams

Verwenden Sie Amazon Connect AssociateInstanceStorageConfigAPI, um die folgenden Ressourcentypen zuzuordnen:

• Verwenden Sie für Sprachkontakte REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS

• Verwenden Sie für Chat-Kontakte REAL_TIME_CONTACT_ANALYSIS_CHAT_SEGMENTS

Anmerkung

REAL_TIME_CONTACT_ANALYSIS_SEGMENTSist veraltet, wird aber weiterhin unterstützt und gilt nur für Sprachkontakte. Wird REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS für zukünftige Sprachkontakte verwendet.

Wenn Sie zuvor einen Stream mit verknüpft habenREAL_TIME_CONTACT_ANALYSIS_SEGMENTS, ist keine Aktion erforderlich, um den Stream zu aktualisierenREAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS.

Geben Sie den Kinesis-Stream an, in dem Echtzeit-Kontaktanalyse-Segmente veröffentlicht werden. Sie benötigen die Instanz-ID und den Kinesis-StreamARN. Der folgende Code zeigt ein Beispiel dafür:

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

Das folgende Beispiel bezieht sich auf Chat-Kontakte.

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

Das folgende Beispiel bezieht sich auf Sprachkontakte.

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

Schritt 4: Aktivieren von Contact Lens für Ihre Amazon-Connect-Instance

Anweisungen finden Sie unter Aktivieren von Amazon Connect Contact Lens.

Schritt 5 (optional): Ansehen eines Beispiels für einen Segmentstream

Wir empfehlen Ihnen, sich einen Beispiel-Segment-Stream für Sprach - oder Chatnachrichten anzusehen, um sich mit dessen Aussehen vertraut zu machen.