Aktivieren Sie die Segmentstreams der Kontaktanalyse zur Analyse Contact Lens Unterhaltungen

PDFRSS

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 anschließend denselben KMS-Schlüssel für Ihren Kinesis-Datenstrom aus. 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

  grantee-principal ist der ARN der serviceverknüpften Rolle, die Ihrer Amazon-Connect-Instance zugeordnet ist. Wenn Sie den ARN der serviceverknüpften Rolle finden möchten, gehen Sie in der Amazon-Connect-Konsole zu Übersicht, Verteilungseinstellungen, Serviceverknüpfte Rolle.

Schritt 3: Zuordnen des Kinesis-Streams

Verwenden Sie die Amazon Connect AssociateInstanceStorageConfigConnect-API, 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 Instance-ID und den Kinesis-Stream-ARN. 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.

Tipp

Wenn Sie die AWS Region (--region) nicht angeben, wird die Standardregion verwendet, die auf dem CLI-Profil basiert.

Der --storage-config Parameterwert darf nicht in einem einfachen Anführungszeichen (') stehen. Andernfalls wird ein Fehler ausgelöst.

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 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 Contact Lens für Ihre Amazon Connect Connect-Instanz

Detaillierte Anweisungen finden Sie unter Aktivieren Sie Konversationsanalysen in Amazon Connect Contact Lens.

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

Wir empfehlen Ihnen, sich einen Sprach - oder Chat-Beispiel-Segment-Stream anzusehen, um sich damit vertraut zu machen, wie er aussieht.