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. # Zugreifen auf Analysen für Sprach- und Chat-Kontakte in Contact Lens mithilfe von Amazon Kinesis Data Streams Segmentstreams zur Kontaktanalyse ermöglichen Ihnen den Zugriff auf Analysen für Sprach- und Chat-Kontakte in Contact Lens. Streaming überwindet die Skalierungsbeschränkungen vorhandener [Anruf- und Chat-Analysen](contact-lens-api.md). APIs Bei Sprachkontakten bietet es auch Zugriff auf ein Datensegment mit der Bezeichnung `Utterance`, mit dem Sie partielle Transkripte aufrufen können. Auf diese Weise können Sie Anforderungen für extrem niedrige Latenzen erfüllen, um Kundendienstmitarbeiter bei Live-Anrufen zu unterstützen. In diesem Abschnitt wird die Integration in Amazon Kinesis Data Streams für das Streaming erläutert. Durch Streaming können Sie die folgenden Ereignistypen empfangen: + STARTED-Ereignisse, die zu Beginn einer Kontaktanalysesitzung veröffentlicht werden + SEGMENTS-Ereignisse, die während der Kontaktanalysesitzungen veröffentlicht werden. Diese Ereignisse enthalten eine Liste von Segmenten mit analysierten Informationen. + COMPLETED- oder FAILED-Ereignisse, die am Ende einer Kontaktanalysesitzung veröffentlicht wurden **Topics** + [Aktivieren von Segmentstreams zur Kontaktanalyse](enable-contact-analysis-segment-streams.md) + [Sprache: Datenmodell für Segmentstreams für Konversationsanalysen](real-time-contact-analysis-segment-streams-data-model.md) + [Chat: Datenmodell für Segmentstreams für Konversationsanalysen](chat-real-time-contact-analysis-segment-streams-data-model.md) + [Sprachkontakt: Beispiel-Segmentstream für Konversationsanalysen](sample-real-time-contact-analysis-segment-stream.md) + [Chat: Beispiel-Segmentstream für Konversationsanalysen](chat-sample-real-time-contact-analysis-segment-stream.md) # Aktivieren von Segmentstreams zur Kontaktanalyse von Konversationen in Contact Lens 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 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](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 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 [AssociateInstanceStorageConfig](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateInstanceStorageConfig.html)Connect-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 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 { 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 Detaillierte Anleitungen finden Sie unter [Aktivieren von Konversationsanalysen in Amazon Connect Contact Lens](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. # Datenmodell für Segmentstreams für Konversationsanalysen zum Analysieren von Sprachkontakten in Contact Lens Segmentstreams zur Kontaktanalyse in Echtzeit werden in JSON generiert. Ereignis-JSON-Blobs werden für jeden Kontakt, für den die Konversationsanalyse in Echtzeit aktiviert ist, im zugehörigen Stream veröffentlicht. Die folgenden Ereignistypen können für eine Konversationsanalyse-Sitzung zu einem Sprachkontakt veröffentlicht werden: + STARTED-Ereignisse – Jede Konversationsanalyse-Sitzung veröffentlicht zu Beginn der Sitzung ein STARTED-Ereignis. + SEGMENTS-Ereignisse – Jede Konversationsanalyse-Sitzung kann null oder mehr SEGMENTS-Ereignisse während der Sitzung veröffentlichen. Diese Ereignisse enthalten eine Liste von Segmenten mit analysierten Informationen. Bei Sprachkontakten kann die Liste die Segmente „`Utterance`“, „`Transcript`“, „`Categories`“ oder „`PostContactSummary`“ enthalten. + COMPLETED- oder FAILED-Ereignisse – Jede Konversationsanalyse-Sitzung veröffentlicht am Ende ein COMPLETED- oder FAILED-Ereignis. ## Allgemeine Eigenschaften, die in allen Ereignissen für Sprachkontakte enthalten sind Jedes Ereignis beinhaltet die folgenden Eigenschaften: **Version** Die Version des Ereignisschemas Typ: Zeichenfolge **Kanal** Der Typ des Kanals für diesen Kontakt Typ: Zeichenfolge Zulässige Werte: `VOICE`, `CHAT`, `TASK` Weitere Informationen zu Kanälen finden Sie unter [Kanäle und Parallelität für die Weiterleitung von Kontakten in Amazon Connect](channels-and-concurrency.md). **AccountId** Die Kennung des Kontos, in dem dieser Kontakt stattfindet Typ: Zeichenfolge **ContactId** Die Kennung des Kontakts, der analysiert wird Typ: Zeichenfolge **InstanceId** Die Kennung der Instance, in dem dieser Kontakt stattfindet Typ: Zeichenfolge **LanguageCode** Der diesem Kontakt zugeordnete Sprachcode Typ: Zeichenfolge Zulässige Werte: der Sprachcode für eine der [unterstützten Sprachen für Contact Lens-Anrufanalysen in Echtzeit](supported-languages.md#supported-languages-contact-lens) **EventType** Der Typ des veröffentlichten Ereignisses Typ: Zeichenfolge Zulässige Werte: `STARTED`, `SEGMENTS`, `COMPLETED`, `FAILED` ## STARTED-Ereignis `STARTED`-Ereignisse beinhalten nur die gemeinsamen Eigenschaften: + Version + Kanal + AccountId + ContactId + LanguageCode + EventType: GESTARTET ## SEGMENTS-Ereignis `SEGMENTS`-Ereignisse beinhalten die folgenden Eigenschaften: + Version + Kanal + AccountId + ContactId + LanguageCode + EventType: SEGMENTE + Segments: Zusätzlich zu den allgemeinen Eigenschaften enthalten `SEGMENTS`-Ereignisse eine Liste von Segmenten mit analysierten Informationen. Typ: Array von [Segment](#segment)-Objekten + PostContactSummary: Informationen zur Zusammenfassung nach dem Kontakt für ein Segment mit Sprachkontakt. Typ: Objekte [PostContactSummary](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-contact-lens_PostContactSummary.html) Erforderlich: Nein **Segment** Ein analysiertes Segment für eine Echtzeit-Analysesitzung Jedes Segment ist ein Objekt mit den folgenden optionalen Eigenschaften. Je nach Segmenttyp ist nur eine dieser Eigenschaften vorhanden: + Utterance + Transcript + Kategorien + PostContactSummary **Utterance** Die analysierte Äußerung Erforderlich: Nein + **Id** Die Kennung der Äußerung Typ: Zeichenfolge + ** TranscriptId** Die Kennung des mit dieser Äußerung verknüpften Transkripts Typ: Zeichenfolge + **ParticipantId** Die Kennung des/der Teilnehmer:in Typ: Zeichenfolge + ** ParticipantRole** Die Rolle des/der Teilnehmer:in. Handelt es sich beispielsweise um Kunden, Kundendienstmitarbeiter oder Systeme? Typ: Zeichenfolge + ** PartialContent** Der Inhalt der Äußerung Typ: Zeichenfolge + ** BeginOffsetMillis** Der Versatz zu Beginn im Kontakt für dieses Transkript Typ: Ganzzahl + ** EndOffsetMillis** Der Versatz zum Ende im Kontakt für dieses Transkript Typ: Ganzzahl **Transcript** Das analysierte Transkript Typ: [Transcript](https://docs.aws.amazon.com/contact-lens/latest/APIReference/API_Transcript.html)-Objekt Erforderlich: Nein **Kategorien** Die Kategorieregeln, für die eine Übereinstimmung gefunden wurde Typ: [Categories](https://docs.aws.amazon.com/contact-lens/latest/APIReference/API_Categories.html)-Objekt Erforderlich: Nein **PostContactSummary** Informationen zur Zusammenfassung nach dem Kontakt für ein Segment mit Sprachkontakt Typ: [PostContactSummary](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-contact-lens_PostContactSummary.html) Objekt Erforderlich: Nein ## COMPLETED-Ereignis `COMPLETED`-Ereignisse beinhalten nur die folgenden allgemeinen Eigenschaften: + Version + Kanal + AccountId + ContactId + LanguageCode + EventType: ABGESCHLOSSEN ## FAILED-Ereignis `FAILED`-Ereignisse beinhalten nur die folgenden allgemeinen Eigenschaften: + Version + Kanal + AccountId + ContactId + LanguageCode + EventType: FEHLGESCHLAGEN # Datenmodell für Segmentstreams für Konversationsanalysen zum Analysieren von Chats in Contact Lens Segmentstreams für Konversationsanalysen für Chat-Kontakte werden in JSON generiert. Ereignis-JSON-Blobs werden für jeden Kontakt, für den die Konversationsanalyse in Echtzeit aktiviert ist, im zugehörigen Stream veröffentlicht. Die folgenden Ereignistypen können für eine Konversationsanalyse-Sitzung zu einem Chat-Kontakt veröffentlicht werden: + STARTED-Ereignisse – Jede Konversationsanalyse-Sitzung veröffentlicht zu Beginn der Sitzung ein STARTED-Ereignis. + SEGMENTS-Ereignisse – Jede Konversationsanalyse-Sitzung kann null oder mehr SEGMENTS-Ereignisse während der Sitzung veröffentlichen. Diese Ereignisse enthalten eine Liste von Segmenten mit analysierten Informationen. Bei Chat-Kontakten kann die Liste die Segmente „`Attachments`“, „`Transcript`“, „`Categories`“, „`Events`“, „`Issues`“ oder „`PostContactSummary`“ enthalten. + COMPLETED- oder FAILED-Ereignisse – Jede Konversationsanalyse-Sitzung veröffentlicht am Ende ein COMPLETED- oder FAILED-Ereignis. ## Allgemeine Eigenschaften, die in allen Ereignissen für Chat-Kontakte enthalten sind Jedes Ereignis beinhaltet die folgenden Eigenschaften: **Version** Die Version des Ereignisschemas Für Chat-Kontakte ist dies 2.0.0. Typ: Zeichenfolge **Kanal** Der Typ des Kanals für diesen Kontakt Typ: Zeichenfolge Zulässige Werte: `VOICE`, `CHAT`, `TASK` Weitere Informationen zu Kanälen finden Sie unter [Kanäle und Parallelität für die Weiterleitung von Kontakten in Amazon Connect](channels-and-concurrency.md). **AccountId** Die Kennung des Kontos, in dem dieser Kontakt stattfindet Typ: Zeichenfolge **InstanceId** Die Kennung der Instance, in dem dieser Kontakt stattfindet Typ: Zeichenfolge **ContactId** Die Kennung des Kontakts, der analysiert wird Typ: Zeichenfolge **StreamingEventType** Der Typ des veröffentlichten Ereignisses Typ: Zeichenfolge Zulässige Werte: `STARTED`, `SEGMENTS`, `COMPLETED`, `FAILED` **StreamingSettings** Die Einstellungen in Contact Lens für diesen Kontakt Typ: [StreamingSettings](#streamingsettingsobject) Objekt ## StreamingSettings Objekt **LanguageCode** Der diesem Kontakt zugeordnete Sprachcode Typ: Zeichenfolge Zulässige Werte: der Sprachcode für eine der [unterstützten Sprachen für Contact Lens-Anrufanalysen in Echtzeit](supported-languages.md#supported-languages-contact-lens) **Ausgabe** Der für diesen Kontakt aktivierte Ausgabetyp in Contact Lens Typ: Zeichenfolge Zulässige Werte: `Raw`, `Redacted`, `RedactedAndRaw` **RedactionTypes** Die Art der Schwärzung, die für diesen Kontakt aktiviert ist Typ: Zeichenfolge-Array Zulässige Werte: `PII` **RedactionTypesMetadata** Die Schwärzungsmetadaten für jeden Schwärzungstyp Typ: RedactionType Zeichenfolge zum [RedactionMetadata](#redactionmetadata)Objekt Zulässige Werte: `PII` ## RedactionMetadata Objekt Bietet Informationen zu den Einstellungen für die Schwärzung **RedactionMaskMode** Die Ersetzungseinstellung für geschwärzte Daten Typ: Zeichenfolge Zulässige Werte: `PII`, `EntityType` ## STARTED-Ereignis `STARTED`-Ereignisse beinhalten nur die gemeinsamen Eigenschaften: + Version + Kanal + AccountId + ContactId + StreamingEventType: GESTARTET + StreamingSettings ## SEGMENTS-Ereignis `SEGMENTS`-Ereignisse beinhalten die folgenden Eigenschaften: + Version + Kanal + AccountId + OutputType + Der Ausgabetyp der aktuellen Sitzung in Contact Lens + Typ: Zeichenfolge + Zulässige Werte: `Raw`, `Redacted` + ContactId + StreamingEventType: SEGMENTE + StreamingSettings + Segmente + Eine Liste von Segmenten mit analysierten Informationen + Typ: Array von [Segment](#chat-segment)-Objekten **Segment** Ein analysiertes Segment für eine Echtzeit-Analysesitzung Jedes Segment ist ein Objekt mit den folgenden optionalen Eigenschaften. Je nach Segmenttyp ist nur eine dieser Eigenschaften vorhanden: + [Anlagen](#chat-attachments) + [Kategorien](#chat-category) + [Veranstaltung](#chat-event) + [Problembereiche](#chat-issues) + [Transkript](#chat-transcript) + [PostContactSummary](#chat-postcontactsummary) **Anlagen** Die analysierten Anlagen Erforderlich: Nein Typ: [RealTimeContactAnalysisSegmentAttachments](https://docs.aws.amazon.com/connect/latest/APIReference/API_RealTimeContactAnalysisSegmentAttachments.html) Objekt **Kategorien** Die Kategorieregeln, für die eine Übereinstimmung gefunden wurde Typ: [RealTimeContactAnalysisSegmentCategories](https://docs.aws.amazon.com/connect/latest/APIReference/API_RealTimeContactAnalysisSegmentCategories.html) Objekt Erforderlich: Nein **Veranstaltung** Segmenttyp, der ein Kontaktereignis beschreibt Typ: [RealTimeContactAnalysisSegmentEvent](https://docs.aws.amazon.com/connect/latest/APIReference/API_RealTimeContactAnalysisSegmentEvent.html) Objekt Erforderlich: Nein **Problembereiche** Segmenttyp, der eine Liste der erkannten Probleme enthält Typ: [RealTimeContactAnalysisSegmentIssues](https://docs.aws.amazon.com/connect/latest/APIReference/API_RealTimeContactAnalysisSegmentIssues.html) Objekt Erforderlich: Nein **Transcript** Das analysierte Transkriptsegment Typ: [RealTimeContactAnalysisSegmentTranscript](https://docs.aws.amazon.com/connect/latest/APIReference/API_RealTimeContactAnalysisSegmentTranscript.html) Objekt Erforderlich: Nein **PostContactSummary** Informationen zur Zusammenfassung nach dem Kontakt für ein Echtzeit-Kontaktsegment für den Chat Typ: [RealTimeContactAnalysisSegmentPostContactSummary](https://docs.aws.amazon.com/connect/latest/APIReference/API_RealTimeContactAnalysisSegmentPostContactSummary.html) Objekt Erforderlich: Nein ## COMPLETED-Ereignis `COMPLETED`-Ereignisse beinhalten nur die folgenden allgemeinen Eigenschaften: + Version + Kanal + AccountId + InstanceId + ContactId + StreamingEventType: ABGESCHLOSSEN + StreamingSettings ## FAILED-Ereignis `FAILED`-Ereignisse beinhalten nur die folgenden allgemeinen Eigenschaften: + Version + Kanal + AccountId + InstanceId + ContactId + StreamingEventType: FEHLGESCHLAGEN + StreamingSettings # Beispiel-Segmentstreams für die Konversationsanalyse von Anrufen mithilfe von Contact Lens In diesem Thema finden Sie Beispiel-Segmentstreams für die Ereignisse STARTED, SEGMENTS, COMPLETED und FAILED, die bei einem Sprachkontakt auftreten können. ## Beispiel für STARTED-Ereignis + EventType: GESTARTET + Wird zu Beginn der Konversationsanalyse-Sitzung veröffentlicht ``` { "Version": "1.0.0", "Channel": "VOICE", "AccountId": "123456789012", // your AWS account ID "InstanceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", // your Amazon Connect instance ID "ContactId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", // the ID of the contact "LanguageCode": "en-US", // the language code of the contact "EventType": "STARTED" } ``` ## Beispiel für SEGMENTS-Ereignis + EventType: SEGMENTE + Wird während einer Konversationsanalyse-Sitzung veröffentlicht. Dieses Ereignis enthält eine Liste von Segmenten mit analysierten Informationen. Die Liste kann die Segmente `Utterance`, `Transcript`, `Categories` oder `PostContactSummary` enthalten. ``` { "Version": "1.0.0", "Channel": "VOICE", "AccountId": "123456789012", // your AWS account ID "InstanceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", // your Amazon Connect instance ID "ContactId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", // the ID of the contact "LanguageCode": "en-US", // the language code of the contact "EventType": "SEGMENTS", "Segments": [ { "Utterance": { "Id": "7b48ca3d-73d3-443a-bf34-a9e8fcc01747", "TranscriptId": "121d1581-905f-4169-9804-b841bb4df04a", "ParticipantId": "AGENT", "ParticipantRole": "AGENT", "PartialContent": "Hello, thank you for calling Example Corp. My name is Adam.", "BeginOffsetMillis": 19010, "EndOffsetMillis": 22980 } }, { "Utterance": { "Id": "75acb743-2154-486b-aaeb-c960ae290e88", "TranscriptId": "121d1581-905f-4169-9804-b841bb4df04a", "ParticipantId": "AGENT", "ParticipantRole": "AGENT", "PartialContent": "How can I help you?", "BeginOffsetMillis": 23000, "EndOffsetMillis": 24598 } }, { "Transcript": { "Id": "121d1581-905f-4169-9804-b841bb4df04a", "ParticipantId": "AGENT", "ParticipantRole": "AGENT", "Content": "Hello, thank you for calling Example Corp. My name is Adam. How can I help you?", "BeginOffsetMillis": 19010, "EndOffsetMillis": 24598, "Sentiment": "NEUTRAL" } }, { "Transcript": { "Id": "4295e927-43aa-4447-bbfc-8fccc2027530", "ParticipantId": "CUSTOMER", "ParticipantRole": "CUSTOMER", "Content": "I'm having trouble submitting the application, number AX876293 on the portal. I tried but couldn't connect to my POC on the portal. So, I'm calling on this toll free number", "BeginOffsetMillis": 19010, "EndOffsetMillis": 22690, "Sentiment": "NEGATIVE", "IssuesDetected": [ { "CharacterOffsets": { "BeginOffsetChar": 0, "EndOffsetChar": 81 } } ] } }, { "Categories": { "MatchedCategories": [ "CreditCardRelated", "CardBrokenIssue" ], "MatchedDetails": { "CreditCardRelated": { "PointsOfInterest": [ { "BeginOffsetMillis": 19010, "EndOffsetMillis": 22690 } ] }, "CardBrokenIssue": { "PointsOfInterest": [ { "BeginOffsetMillis": 25000, "EndOffsetMillis": 29690 } ] } } } }, { "PostContactSummary": { "Content": "Customer contacted Example Corp because of an issue with their application", "Status": "COMPLETED" } } ] } ``` ## Beispiel für COMPLETED-Ereignis + EventType: ABGESCHLOSSEN + Wird am Ende der Konversationsanalyse-Sitzung veröffentlicht, wenn die Analyse erfolgreich abgeschlossen wurde ``` { "Version": "1.0.0", "Channel": "VOICE", "AccountId": "123456789012", // your AWS account ID "InstanceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", // your Amazon Connect instance ID "ContactId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", // the ID of the contact "LanguageCode": "en-US", // the language code of the contact "EventType": "COMPLETED" } ``` ## Beispiel für FAILED-Ereignis + EventType: FEHLGESCHLAGEN + Wird am Ende der Konversationsanalyse-Sitzung veröffentlicht, wenn die Analyse fehlgeschlagen ist ``` { "Version": "1.0.0", "Channel": "VOICE", "AccountId": "123456789012", // your AWS account ID "InstanceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", // your Amazon Connect instance ID "ContactId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", // the ID of the contact "LanguageCode": "en-US", // the language code of the contact "EventType": "FAILED" } ``` # Beispielstreams für die Konversationsanalyse von Chats in Contact Lens In diesem Thema finden Sie Beispiel-Segmentstreams für die Ereignisse STARTED, SEGMENTS, COMPLETED und FAILED, die bei einem Chat-Kontakt auftreten können. ## Beispiel für STARTED-Ereignis + EventType: GESTARTET + Wird zu Beginn der Konversationsanalyse-Sitzung veröffentlicht ``` { "Version": "2.0.0", "Channel": "CHAT", "AccountId": "123456789012", // your AWS account ID "InstanceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", // your Amazon Connect instance ID "ContactId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", // the ID of the contact "StreamingEventType": "STARTED", "StreamingSettings": { "LanguageCode": "en-US", // the language code of the contact "Output": "RedactedAndRaw", "RedactionTypes": [ "PII" ], "RedactionTypesMetadata": { "PII": { "RedactionMaskMode": "PII" } } } } ``` ## Beispiel für SEGMENTS-Ereignis + EventType: [SEGMENTE](chat-real-time-contact-analysis-segment-streams-data-model.md#chat-segment-streams-data-model-segments-event) + Wird während einer Konversationsanalyse-Sitzung veröffentlicht. Dieses Ereignis enthält eine Liste von [RealtimeContactAnalysisSegment](https://docs.aws.amazon.com/connect/latest/APIReference/API_RealtimeContactAnalysisSegment.html)Objekten mit analysierten Informationen. Die Liste der Segmente kann Segmente `"Transcript"``"Categories"`,`"Issue"`,`"Event"`,`"Attachment"`, oder "PostContactSummary" enthalten. ``` { "Version": "2.0.0", "Channel": "CHAT", "AccountId": "123456789012", // your AWS account ID "InstanceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", // your Amazon Connect instance ID "ContactId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", // the ID of the contact "OutputType": "Redacted", "StreamingEventType": "SEGMENTS", "StreamingSettings": { "LanguageCode": "en-US", // the language code of the contact "Output": "RedactedAndRaw", "RedactionTypes": [ "PII" ], "RedactionTypesMetadata": { "PII": { "RedactionMaskMode": "PII" } } }, "Segments": [{ "Transcript": { "Id": "07a2d668-5c9e-4f69-b2fe-986261b0743a", "ParticipantId": "a309ac1e-ca87-44ca-bb5d-197eca8ed77a", "ParticipantRole": "AGENT", "DisplayName": "[PII]", "Content": "Hello, thank you for contacting Example Corp. My name is Ray.", "ContentType": "text/markdown", "Time": { "AbsoluteTime": "2024-03-14T19:39:26.715Z" }, "Sentiment": "NEUTRAL" } }, { "Categories": { "MatchedDetails": { "Hi": { "PointsOfInterest": [{ "TranscriptItems": [{ "Id": "5205b050-8aa9-4645-a381-a308801649ab", "CharacterOffsets": { "BeginOffsetChar": 0, "EndOffsetChar": 40 } }] }] } } } }, { "Issues": { "IssuesDetected": [{ "TranscriptItems": [{ "Content": "I have an issue with my bank account", "Id": "0e5574a7-2aeb-4eab-8bb5-3a7f66a2284a", "CharacterOffsets": { "BeginOffsetChar": 7, "EndOffsetChar": 43 } }] }] } }, { "Attachments": { "Id": "06ddc1eb-2302-4a8e-a73f-37687fe41aa9", "ParticipantId": "7810b1de-cca8-4153-b522-2498416255af", "ParticipantRole": "CUSTOMER", "DisplayName": "Customer", "Attachments": [{ "AttachmentName": "Lily.jpg", "ContentType": "image/jpeg", "AttachmentId": "343e34da-391a-4541-8b7e-3909d931fcfa", "Status": "APPROVED" }], "Time": { "AbsoluteTime": "2024-03-14T19:39:26.715Z" } } }, { "Event": { "Id": "fbe61c5f-d0d8-4345-912a-4e81f5734d3b", "ParticipantId": "7810b1de-cca8-4153-b522-2498416255af", "ParticipantRole": "CUSTOMER", "DisplayName": "Customer", "EventType": "application/vnd.amazonaws.connect.event.participant.left", "Time": { "AbsoluteTime": "2024-03-14T19:40:00.614Z" } } }, { "PostContactSummary": { "Content": "Customer contacted Example Corp because of an issue with their bank account", "Status": "COMPLETED" } }] } ``` ## Beispiel für COMPLETED-Ereignis + EventType: ABGESCHLOSSEN + Wird am Ende der Konversationsanalyse-Sitzung veröffentlicht, wenn die Analyse erfolgreich abgeschlossen wurde ``` { "Version": "2.0.0", "Channel": "CHAT", "AccountId": "123456789012", // your AWS account ID "InstanceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", // your Amazon Connect instance ID "ContactId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", // the ID of the contact "StreamingEventType": "COMPLETED", "StreamingEventSettings": { "LanguageCode": "en-US", // the language code of the contact "Output": "RedactedAndRaw", "RedactionTypes": ["PII"], "RedactionTypesMetadata": { "PII": { "RedactionMaskMode": "PII" } } } } ``` ## Beispiel für FAILED-Ereignis + EventType: FEHLGESCHLAGEN + Wird am Ende der Konversationsanalyse-Sitzung veröffentlicht, wenn die Analyse fehlgeschlagen ist ``` { "Version": "2.0.0", "Channel": "CHAT", "AccountId": "123456789012", // your AWS account ID "InstanceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", // your Amazon Connect instance ID "ContactId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", // the ID of the contact "StreamingEventType": "FAILED", "StreamingEventSettings": { "LanguageCode": "en-US", "Output": "RedactedAndRaw", "RedactionTypes": ["PII"], "RedactionTypesMetadata": { "PII": { "RedactionMaskMode": "PII" } } } } ```