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 des Echtzeit-Streamings von Chat-Nachrichten in Amazon Connect Amazon Connect Chat bietet Ihnen [APIs](https://docs.aws.amazon.com/connect/latest/APIReference/Welcome.html)die Möglichkeit, einen Echtzeit-Stream von Chat-Nachrichten zu abonnieren. Mit diesen APIs können Sie: + APIs verwenden, um Nachrichten in Echtzeit zu streamen, wenn ein neuer Chat-Kontakt erstellt wird. + die aktuelle Funktion von Amazon-Connect-Chats erweitern, um Anwendungsfälle wie den Aufbau von Integrationen mit SMS-Lösungen und Messaging-Anwendungen von Drittanbietern, die Aktivierung von mobilen Push-Benachrichtigungen und die Erstellung von Analyse-Dashboards zur Überwachung und Nachverfolgung von Chat-Nachrichtenaktivitäten zu unterstützen. **Anmerkung** Auf dieser Seite wird beschrieben, wie Sie einen SNS-Endpunkt abonnieren, um Chat-Nachrichten in Amazon Connect in Echtzeit zu streamen. Wenn Sie versuchen, Nachrichtenstreaming für Konversations-AI-Interaktionen in Amazon Connect zu aktivieren, finden Sie weitere Informationen unter[Nachrichtenstreaming für KI-gestützten Chat aktivieren](message-streaming-ai-chat.md). ## Wie funktioniert das Nachrichten-Streaming APIs Das [Amazon Connect-Nachrichtenstreaming APIs](https://docs.aws.amazon.com/connect/latest/APIReference/Welcome.html) wird ausgelöst, wenn bestimmte Ereignisse innerhalb eines Amazon Connect Chat-Kontakts auftreten. Sendet ein Kunde beispielsweise eine neue Chat-Nachricht, so sendet das Ereignis eine [Nutzlast](sns-payload.md) an einen bestimmten Endpunkt, die Daten über die gerade gesendete Nachricht enthält. Nachrichten werden mithilfe des [Amazon-Simple Notification Service](https://docs.aws.amazon.com/sns/latest/dg/welcome.html) (Amazon SNS) an einem bestimmten Endpunkt veröffentlicht. In diesem Thema wird beschrieben, wie Sie Nachrichtenstreaming in Echtzeit mithilfe von Amazon Connect und Amazon SNS einrichten. Die Schritte sind: 1. Verwenden Sie die Amazon SNS-Konsole, um ein neues Standard-SNS-Thema zu erstellen und die Nachrichten einzurichten. 1. Rufen Sie die [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html)API auf, um den Chat-Kontakt zu initiieren. 1. Rufen Sie die [StartContactStreaming](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartContactStreaming.html)API auf, um das Nachrichtenstreaming zu initiieren. 1. Rufen Sie die [CreateParticipantConnection](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_CreateParticipantConnection.html)API auf, um die Verbindung des Teilnehmers herzustellen. ## Schritt 1: Erstellen Sie ein Standard-SNS-Thema. 1. Rufen Sie die Amazon SNS-Konsole auf. 1. [Erstellen Sie ein SNS-Thema](https://docs.aws.amazon.com/sns/latest/dg/sns-create-topic.html) in Ihrem AWS Konto. Wählen Sie im Abschnitt **Details** für **Typ** die Option **Standard** aus, geben Sie einen Namen für das Thema ein und wählen Sie dann **Thema erstellen** aus. **Anmerkung** Derzeit unterstützt das Nachrichten-Streaming APIs nur Standard-SNS für das Echtzeit-Streaming von Nachrichten. Sie unterstützen keine [Amazon SNS FIFO-Themen (First in, First out)](https://docs.aws.amazon.com/sns/latest/dg/sns-fifo-topics.html). 1. Nachdem Sie das Thema erstellt haben, wird sein Amazon-Ressourcenname (ARN) im Abschnitt **Details** angezeigt. Kopieren Sie das Thema ARN in die Zwischenablage. Sie verwenden das Thema ARN im nächsten Schritt und in [Schritt 3: Aktivieren des Nachrichtenstreamings für den Kontakt](#step3-chat-streaming). Das Thema ARN sieht ähnlich wie im folgenden Beispiel aus: ``` arn:aws:sns:{{us-east-1}}:{{123456789012}}:{{MyTopic}} ``` 1. Wählen Sie die Registerkarte **Zugriffsrichtlinie**, wählen Sie **Bearbeiten** und fügen Sie dann eine ressourcenbasierte Richtlinie zum SNS-Thema hinzu, sodass Amazon Connect die Erlaubnis hat, dort zu veröffentlichen. Im Folgenden finden Sie ein Beispiel für eine SNS-Richtlinie, die Sie in den JSON-Editor einfügen und dann mit Ihren Werten anpassen können: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement":[ { "Effect":"Allow", "Principal":{ "Service":"connect.amazonaws.com" }, "Action":"sns:Publish", "Resource":"arn:aws:sns:{{us-east-1}}:{{111122223333}}:{{TopicName}}", "Condition":{ "StringEquals":{ "aws:SourceAccount":"{{111122223333}}" }, "ArnEquals":{ "aws:SourceArn":"arn:aws:connect:{{us-east-1}}:{{111122223333}}:instance/{{InstanceId}}" } } } ] } ``` ------ **Anmerkung** Die standardmäßige **Zugriffsrichtlinie** enthält Bedingungen, die auf `sourceOwner` angewendet werden. Zum Beispiel: ``` "Condition": { "StringEquals": { "AWS:SourceOwner": "921772911154" } } ``` Stellen Sie sicher, dass Sie sie entfernen und mit `SourceAccount` ersetzen. Zum Beispiel: ``` "Condition":{ "StringEquals":{ "aws:SourceAccount":"YOUR_AWS_ACCOUNT_ID" }, "ArnEquals":{ "aws:SourceArn":"YOUR_CONNECT_INSTANCE_ARN" } } ``` Dies verhindert [serviceübergreifende Confused-Deputy](cross-service-confused-deputy-prevention.md)-Probleme. 1. Wenn Sie serverseitige Verschlüsselung auf SNS verwenden, stellen Sie sicher, dass Sie die entsprechenden `connect.amazonaws.com`-Berechtigungen auf dem KMS key aktiviert haben. Im Folgenden finden Sie eine Beispielrichtlinie: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Id": "key-consolepolicy-3", "Statement": [ { "Sid": "Enable IAM User Permissions", "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::{{111122223333}}:root", "Service": "connect.amazonaws.com" }, "Action": "kms:*", "Resource": "*" }, { "Sid": "Allow access for Key Administrators", "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::{{111122223333}}:root", "Service": "connect.amazonaws.com" }, "Action": [ "kms:Create*", "kms:Describe*", "kms:Enable*", "kms:List*", "kms:Put*", "kms:Update*", "kms:Revoke*", "kms:Disable*", "kms:Get*", "kms:Delete*", "kms:TagResource", "kms:UntagResource", "kms:ScheduleKeyDeletion", "kms:CancelKeyDeletion" ], "Resource": "*" } ] } ``` ------ ## Schritt 2: Initiieren des Chat-Kontakts 1. Rufen Sie die Amazon Connect [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html)Connect-API auf, um den Chat-Kontakt zu initiieren. Informationen zum Erstellen des SDK-Clients für den Aufruf von Amazon Connect APIs finden Sie in den folgenden Themen: + [Klasse AmazonConnectClientBuilder](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/connect/AmazonConnectClientBuilder.html) + [Erstellen von Service-Clients](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/creating-clients.html) 1. Behalten Sie den Überblick über `ContactId` und `ParticipantToken` von der [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html)Antwort, da diese Antwortattribute für das Aufrufen anderer Chats verwendet werden, die für das Streaming APIs erforderlich sind. Dies wird in den nächsten Schritten beschrieben. ## Schritt 3: Aktivieren des Nachrichtenstreamings für den Kontakt + Rufen Sie an [StartContactStreaming](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartContactStreaming.html), um das Streamen von Nachrichten in Echtzeit zu Ihrem SNS-Thema zu aktivieren. + **Einschränkungen**: Sie können bis zu zwei SNS-Themen pro Kontakt abonnieren. + Wenn Sie anrufen [StartContactStreaming](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartContactStreaming.html), müssen Sie den Amazon-Ressourcennamen (ARN) des SNS-Themas angeben (siehe[Schritt 1: Erstellen Sie ein Standard-SNS-Thema.](#step1-chat-streaming)). Ein einziger SNS-Themen-ARN kann für mehrere verwendet werden AWS-Konten, er muss sich jedoch in derselben Region wie Ihre Amazon Connect Connect-Instance befinden. **Wenn sich Ihr Themen-ARN beispielsweise in **us-east-1** befindet, muss sich Ihre Amazon Connect Connect-Instance in us-east-1 befinden.** + Für erste Chat-Nachrichten, die nicht auf dem Streaming-Endpunkt empfangen werden, können Sie die [GetTranscript](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_GetTranscript.html)API aufrufen, um die ersten Nachrichten zu empfangen. ## Schritt 4: Erstellen der Teilnehmerverbindung + Rufen Sie auf, [CreateParticipantConnection](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_CreateParticipantConnection.html)wobei das `ConnectParticipant` Attribut als wahr übergeben wurde. + Sie müssen [CreateParticipantConnection](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_CreateParticipantConnection.html)innerhalb von fünf Minuten nach der Erstellung des Chats anrufen. + Ein Anruf [CreateParticipantConnection](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_CreateParticipantConnection.html)mit der `ConnectParticipant` Einstellung „true“ funktioniert nur, wenn Sie das Einstreamen aktiviert haben [Schritt 2: Initiieren des Chat-Kontakts](#step2-chat-streaming) und der Anrufer dies `Customer` tut. + Dieser Schritt (Erstellen der Teilnehmerverbindung) ist optional, wenn Sie bereits mit `WEBSOCKET` erfolgreich eine Verbindung zum Chat-Kontakt hergestellt haben. ## Nächste Schritte Sie sind bereit, mit dem Nachrichtenstreaming APIs zu arbeiten. 1. Um sicherzustellen, dass es funktioniert, überprüfen Sie, ob die Nachrichten unter dem von Ihnen erstellten SNS-Thema veröffentlicht wurden. Sie können dies mithilfe von CloudWatch Amazon-Metriken tun. Anweisungen finden Sie unter [Überwachung von Amazon SNS unter Verwendung CloudWatch von](https://docs.aws.amazon.com/sns/latest/dg/sns-monitoring-using-cloudwatch.html). 1. Da SNS nur eine [begrenzte Aufbewahrung](https://aws.amazon.com/blogs//aws/sns-ttl-control/) hat, empfehlen wir Ihnen, [Amazon Simple Queue Service (Amazon SQS)](https://aws.amazon.com/sqs/), [Amazon Kinesis](https://aws.amazon.com/kinesis/) oder einen anderen Dienst zur Aufbewahrung von Nachrichten einzurichten. 1. Die Verwendung [StopContactStreaming](https://docs.aws.amazon.com/connect/latest/APIReference/API_StopContactStreaming.html)ist optional und nicht erforderlich, wenn die Chats im Rahmen eines Kontaktablaufs [unterbrochen](disconnect-hang-up.md) werden oder wenn der Kunde die Chat-Verbindung unterbricht. `StopContactStreaming` bietet jedoch die Möglichkeit, das Nachrichten-Streaming zum SNS-Thema zu beenden, auch wenn der Chat aktiv und andauernd ist.