View a markdown version of this page

Aktivieren Sie das Streaming von Chatnachrichten in Echtzeit in Connect Customer - Amazon Connect-Kunde
Wie funktionieren Nachrichten-Streaming-APIsSchritt 1: Erstellen Sie ein Standard-SNS-Thema.Schritt 2: Initiieren des Chat-KontaktsSchritt 3: Aktivieren des Nachrichtenstreamings für den KontaktSchritt 4: Erstellen der TeilnehmerverbindungNächste Schritte

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 das Streaming von Chatnachrichten in Echtzeit in Connect Customer

Connect Customer Chat bietet APIs, mit denen Sie einen Echtzeit-Stream von Chatnachrichten abonnieren können. Mit diesen APIs können Sie:

  • APIs verwenden, um Nachrichten in Echtzeit zu streamen, wenn ein neuer Chat-Kontakt erstellt wird.

  • Erweitern Sie die aktuellen Funktionen von Connect Customer Chat, um Anwendungsfälle wie den Aufbau von Integrationen mit SMS-Lösungen und Messaging-Anwendungen von Drittanbietern, die Aktivierung mobiler Push-Benachrichtigungen und die Erstellung von Analyse-Dashboards zur Überwachung und Nachverfolgung der Chatnachrichtenaktivitäten zu unterstützen.

Anmerkung

Auf dieser Seite wird beschrieben, wie Sie einen SNS-Endpunkt für das Echtzeit-Streaming von Chat-Nachrichten in Connect Customer abonnieren. Wenn Sie versuchen, das Nachrichtenstreaming für Konversations-KI-Interaktionen in Connect Customer zu aktivieren, finden Sie weitere Informationen unter. Nachrichtenstreaming für AI-powered Chat aktivieren

Wie funktionieren Nachrichten-Streaming-APIs

Die Connect-Customer-Nachrichtenstreaming-APIs werden ausgelöst, wenn bestimmte Ereignisse innerhalb eines Connect-Kunden-Chat-Kontakts eintreten. 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 mithilfe des Amazon-Simple Notification Service (Amazon SNS) an einem bestimmten Endpunkt veröffentlicht.

In diesem Thema wird beschrieben, wie Sie das Nachrichtenstreaming in Echtzeit mithilfe von Connect Customer 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.

  2. Rufen Sie die StartChatContact API auf, um den Chat-Kontakt zu initiieren.

  3. Rufen Sie die StartContactStreaming API auf, um das Nachrichtenstreaming zu initiieren.

  4. Rufen Sie die CreateParticipantConnection API auf, um die Verbindung des Teilnehmers herzustellen.

Schritt 1: Erstellen Sie ein Standard-SNS-Thema.

  1. Rufen Sie die Amazon SNS-Konsole auf.

  2. Erstelle ein SNS-Thema in deinem 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ützen die 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).

  3. Nachdem Sie das Thema erstellt haben, wird sein Amazon-Ressourcenname (ARN) im Abschnitt Details angezeigt. Kopieren Sie das Thema ARN in die Zwischenablage. Verwende das Thema ARN im nächsten Schritt und inSchritt 3: Aktivieren des Nachrichtenstreamings für den Kontakt.

    Das Thema ARN sieht ähnlich wie im folgenden Beispiel aus: 

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

  4. Wählen Sie die Registerkarte „Zugriffsrichtlinie“, wählen Sie „Bearbeiten“ und fügen Sie dann eine ressourcenbasierte Richtlinie zum SNS-Thema hinzu, sodass der Connect-Kunde die Berechtigung hat, es 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-Probleme.

  5. Wenn Sie serverseitige Verschlüsselung auf SNS verwenden, stellen Sie sicher, dass Sie die entsprechenden connect.amazonaws.com.rproxy.goskope.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 StartChatContact Connect-Kunden-API auf, um den Chat-Kontakt zu initiieren.

    Informationen zur Erstellung des SDK-Clients zum Aufrufen der Connect-Kunden-APIs finden Sie in den folgenden Themen:

  2. Behalte die StartChatContact Antwort im Auge, da diese Antwortattribute für den Aufruf anderer Chat-APIs verwendet werden, die für das Streaming erforderlich sind. ContactId ParticipantToken Dies wird in den nächsten Schritten beschrieben.

Schritt 3: Aktivieren des Nachrichtenstreamings für den Kontakt

  • Rufen Sie an StartContactStreaming, um das Nachrichtenstreaming 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 Standard-SNS-Thema.).

      Ein einzelner ARN für ein SNS-Thema kann für mehrere verwendet werden AWS-Konten, er muss sich jedoch in derselben Region wie Ihre Connect Customer-Instance befinden. Wenn Ihr Themen-ARN beispielsweise in us-east-1 ist, muss sich Ihre Connect Customer-Instanz in us-east-1 befinden.

    • Für erste Chat-Nachrichten, die nicht auf dem Streaming-Endpunkt empfangen werden, können Sie die GetTranscript API aufrufen, um die ersten Nachrichten zu empfangen.

Schritt 4: Erstellen der Teilnehmerverbindung

Nächste Schritte

Sie sind bereit, mit den Message-Streaming-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. Eine Anleitung finden Sie unter Überwachung der Amazon SNS-Themen mithilfe von CloudWatch.

  2. Da SNS nur eine begrenzte Aufbewahrung hat, empfehlen wir Ihnen, Amazon Simple Queue Service (Amazon SQS), Amazon Kinesis oder einen anderen Dienst zur Aufbewahrung von Nachrichten einzurichten.

  3. Die Verwendung StopContactStreaming ist optional und nicht erforderlich, wenn die Chats durch einen Kontaktablauf getrennt werden oder wenn der Kunde den Chat trennt. StopContactStreaming bietet jedoch die Möglichkeit, das Nachrichten-Streaming zum SNS-Thema zu beenden, auch wenn der Chat aktiv und andauernd ist.