Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Aktivieren Sie die Kontaktanalyse-Segment-Streams zur Analyse Contact Lens Konversationen
Segmentstreams zur Kontaktanalyse sind nicht standardmäßig aktiviert. In diesem Artikel wird erläutert, wie Sie sie aktivieren.
## Schritt 1: Erstellen eines Kinesis-Streams
Erstellen Sie den Datenstream für dasselbe Konto und dieselbe Region, in der sich Ihre Connect Customer-Instanz befindet. Eine Anleitung finden Sie unter [Schritt 1: Erstellen eines Datenstroms](https://docs.aws.amazon.com/streams/latest/dev/tutorial-stock-data-kplkcl-create-stream.html) 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 Segmentstreams zur Kontaktanalyse, Kundendienstmitarbeiter-Ereignisse und Kontaktdatensätze zu verwenden. Allerdings ist es viel einfacher, jeweils einen separaten Stream verwenden, um Daten im Stream zu verwalten und daraus abzurufen. Weitere Informationen finden Sie im [Entwicklerleitfaden für Amazon Kinesis Data Streams](https://docs.aws.amazon.com/streams/latest/dev/introduction.html).
## 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 vom Kunden verwalteten Schlüssel für Anrufaufzeichnungen, Chat-Transkripte oder exportierte Berichte in Ihrer Connect Customer-Instanz.
Aktivieren Sie die Verschlüsselung und verwenden Sie einen vom Kunden verwalteten Schlüssel für Anrufaufzeichnungen, Chat-Transkripte oder exportierte Berichte in Ihrer Connect Customer-Instanz. 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, vom Kunden verwalteten Schlüssel oder erstellen Sie einen neuen und fügen Sie die erforderlichen Berechtigungen für die Connect-Kundenrolle hinzu, um den Schlüssel zu verwenden. 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 der ARN der serviceverknüpften Rolle, die Ihrer Connect Customer-Instance zugeordnet ist. Um den ARN der serviceverknüpften Rolle zu finden, gehen Sie in der Connect Customer-Konsole zu **Überblick**, **Verteilungseinstellungen**, **Service-linked Rolle**.
## Schritt 3: Zuordnen des Kinesis-Streams
Verwenden Sie die Connect Customer [AssociateInstanceStorageConfig](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateInstanceStorageConfig.html)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_SEGMENTS` ist veraltet, wird aber noch unterstützt und gilt nur für Sprachkontakte. Verwenden Sie in Zukunft `REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS` für Sprachkontakte.
Wenn Sie zuvor einen Stream mit `REAL_TIME_CONTACT_ANALYSIS_SEGMENTS` verknüpft haben, ist keine Aktion erforderlich, um den Stream auf `REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS` zu aktualisieren.
Geben Sie den Kinesis-Stream an, in dem die Segmente der Echtzeit-Kontaktanalyse 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 Parameterwert `--storage-config` darf nicht in einfachen Anführungszeichen (') stehen. Andernfalls wird ein Fehler verursacht.
```
aws connect associate-instance-storage-config \
--region "us-west-2" \
--instance-id {{your Connect Customer 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 {
const clientConfig: Connect.ClientConfiguration = {
region: '{{the Region of your Connect Customer instance}}',
};
const connect = new Connect(clientConfig);
// Build request
const request: Connect.Types.AssociateInstanceStorageConfigRequest = {
InstanceId: '{{your Connect Customer 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 Connect Customer-Instanz
Detaillierte Anleitungen finden Sie unter [Aktivieren Sie Konversationsanalysen in Kundenkontaktlinsen Connect](enable-analytics.md).
## Schritt 5 (optional): Ansehen eines Beispiels für einen Segmentstream
Wir empfehlen Ihnen, sich ein Beispiel für einen [Sprach-](sample-real-time-contact-analysis-segment-stream.md) oder [Chat](chat-sample-real-time-contact-analysis-segment-stream.md)-Segmentstream anzusehen, um sich damit vertraut zu machen.