Aktivieren des Echtzeit-Streamings von Chat-Nachrichten

Amazon Connect Chat bietet Ihnen APIsdie 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.

• Erweitern Sie die aktuelle Amazon Connect Chat-Funktionalität, 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.

Wie funktioniert das Nachrichten-Streaming APIs

Das Amazon Connect-Nachrichtenstreaming APIs 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 an einen bestimmten Endpunkt, die Daten über die gerade gesendete Nachricht enthält. Nachrichten werden mit Amazon Simple Notification Service (AmazonSNS) an einem bestimmten Endpunkt veröffentlicht.

In diesem Thema wird beschrieben, wie Sie Nachrichtenstreaming in Echtzeit mit Amazon Connect und Amazon einrichtenSNS. Die Schritte sind:

1. Verwenden Sie die SNS Amazon-Konsole, um ein neues SNS Standardthema zu erstellen und die Nachrichten einzurichten.

2. Rufen Sie die StartChatContactAPIan, um den Chat-Kontakt zu initiieren.

3. Rufen Sie die StartContactStreamingAPIan, um das Nachrichtenstreaming zu starten.

4. Rufen Sie die CreateParticipantConnectionAPIauf, um die Verbindung des Teilnehmers herzustellen.

Schritt 1: Erstellen Sie ein SNS Standardthema

1. Gehen Sie zur SNS Amazon-Konsole.

2. Erstellen Sie ein SNS Thema 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 den Standard SNS für das Echtzeit-Streaming von Nachrichten. Sie unterstützen keine Amazon-Themen SNS FIFO (first in, first out).

3. 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 inSchritt 3: Aktivieren des Nachrichtenstreamings für den Kontakt.

   Das Thema ARN sieht dem folgenden Beispiel ähnlich:

   arn:aws:sns:us-east-1:123456789012:MyTopic                                
                              

4. Wählen Sie den Tab Zugriffsrichtlinie, wählen Sie Bearbeiten und fügen Sie dann eine ressourcenbasierte Richtlinie zu dem SNS Thema hinzu, sodass Amazon Connect die Berechtigung hat, dort zu veröffentlichen. Im Folgenden finden Sie eine SNS Beispielrichtlinie, die Sie kopieren und in den JSON Editor einfügen und dann mit Ihren Werten anpassen können:

   {
      "Version":"2012-10-17",
      "Statement":[
         {
            "Effect":"Allow",
            "Principal":{
               "Service":"connect.amazonaws.com"
            },
            "Action":"sns:Publish",
            "Resource":"YOUR_SNS_TOPIC_ARN",
            "Condition":{
               "StringEquals":{
                  "aws:SourceAccount":"YOUR_AWS_ACCOUNT_ID"
               },
               "ArnEquals":{
                  "aws:SourceArn":"YOUR_CONNECT_INSTANCE_ARN"
               }
            }
         }
      ]
   }      

   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-Probleme.

5. Wenn Sie serverseitige Verschlüsselung für verwendenSNS, stellen Sie sicher, dass Sie die connect.amazonaws.com KMS key Berechtigung für aktiviert haben. Im Folgenden finden Sie eine Beispielrichtlinie:

   {
           "Version": "2012-10-17",
           "Id": "key-consolepolicy-3",
           "Statement": [
               {
                   "Sid": "Enable IAM User Permissions",
                   "Effect": "Allow",
                   "Principal": {
                       "AWS": "arn:aws:iam::your_accountId:root",
                       "Service": "connect.amazonaws.com"
                   },
                   "Action": "kms:*",
                   "Resource": "*"
               },
               {
                   "Sid": "Allow access for Key Administrators",
                   "Effect": "Allow",
                   "Principal": {
                       "AWS": "arn:aws:iam::your_accountId: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 Amazon Connect StartChatContactAPIan, um den Chat-Kontakt aufzunehmen.

   Informationen zum Erstellen des SDK Clients für den Aufruf von Amazon Connect APIs finden Sie in den folgenden Themen:

   • Klasse AmazonConnectClientBuilder

   • Erstellen von Service-Clients

2. Behalten Sie den Überblick über ContactId und ParticipantToken von der StartChatContactAntwort, 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, 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, müssen Sie den Amazon-Ressourcennamen (ARN) des SNS Themas angeben (sieheSchritt 1: Erstellen Sie ein SNS Standardthema).

    Ein einzelnes SNS Thema ARN kann für mehrere verwendet werden AWS-Konten, es muss sich jedoch in derselben Region wie Ihre Amazon Connect Connect-Instance befinden. Wenn sich Ihr Thema beispielsweise in us-east-1 ARN befindet, muss sich Ihre Amazon Connect Connect-Instance in us-east-1 befinden.

  • Für erste Chat-Nachrichten, die am Streaming-Endpunkt nicht empfangen werden, können Sie den anrufen, GetTranscriptAPIum die ersten Nachrichten zu erhalten.

Schritt 4: Erstellen der Teilnehmerverbindung

• Rufen Sie an, CreateParticipantConnectionwobei das ConnectParticipant Attribut als wahr übergeben wurde.

  • Sie müssen CreateParticipantConnectioninnerhalb von fünf Minuten nach der Erstellung des Chats anrufen.

  • Ein Anruf CreateParticipantConnectionmit der ConnectParticipant Einstellung „true“ funktioniert nur, wenn Sie das Einstreamen aktiviert haben Schritt 2: Initiieren des Chat-Kontakts und der Teilnehmer des Anrufers 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 zu 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 SNS Amazon-Themen mit CloudWatch.

2. Da die Aufbewahrung begrenzt SNS ist, empfehlen wir Ihnen, Amazon Simple Queue Service (AmazonSQS), Amazon Kinesis oder einen anderen Dienst zur Aufbewahrung von Nachrichten einzurichten.

3. Die Verwendung StopContactStreamingist optional und nicht erforderlich, wenn die Chats über einen Kontaktablauf unterbrochen werden oder wenn der Kunde die Chat-Verbindung unterbricht. StopContactStreamingBietet jedoch die Möglichkeit, das Streamen von Nachrichten zu dem SNS Thema zu beenden, auch wenn der Chat aktiv und andauernd ist.