View a markdown version of this page

Activez le streaming des messages de chat en temps réel dans Connect Customer - Client Amazon Connect
Fonctionnement des API de streaming de messagesÉtape 1 : créer une rubrique SNS standardÉtape 2 : initier le contact par chatÉtape 3 : activer le streaming de messages sur le contactÉtape 4 : créer la connexion du participantÉtapes suivantes

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Activez le streaming des messages de chat en temps réel dans Connect Customer

Connect Customer Chat fournit des API qui vous permettent de vous abonner à un flux de messages de chat en temps réel. À l’aide de ces API, vous pouvez :

  • diffuser des messages de chat en temps réel lorsqu’un contact par chat est créé ;

  • Étendez la fonctionnalité Connect Customer Chat actuelle pour prendre en charge des cas d'utilisation tels que la création d'intégrations avec des solutions SMS et des applications de messagerie tierces, l'activation des notifications push mobiles et la création de tableaux de bord analytiques pour surveiller et suivre l'activité des messages de chat.

Note

Cette page explique comment s'abonner à un point de terminaison SNS pour diffuser en temps réel les messages de chat dans Connect Customer. Si vous essayez d'activer le streaming de messages pour les interactions conversationnelles basées sur l'IA dans Connect Customer, consultezActiver le streaming des messages pour le AI-powered chat.

Fonctionnement des API de streaming de messages

Les API de diffusion de messages Connect Customer sont déclenchées lorsque certains événements se produisent au sein d'un contact Connect Customer Chat. Par exemple, lorsqu’un client envoie un nouveau message de chat, l’événement envoie des données utiles à un point de terminaison spécifié, qui contient des données relatives au message qui vient d’être envoyé. Les messages sont publiés à l'aide d'Amazon Simple Notification Service (Amazon SNS) sur un point de terminaison spécifique.

Cette rubrique explique comment configurer le streaming de messages en temps réel à l'aide de Connect Customer et Amazon SNS. La procédure est la suivante :

  1. Utilisez la console Amazon SNS pour créer une nouvelle rubrique SNS standard et configurer les messages.

  2. Appelez l'StartChatContactAPI pour lancer le contact par chat.

  3. Appelez l'StartContactStreamingAPI pour lancer le streaming des messages.

  4. Appelez l'CreateParticipantConnectionAPI pour créer la connexion du participant.

Étape 1 : créer une rubrique SNS standard

  1. Accédez à la console Amazon SNS.

  2. Créez une rubrique SNS dans votre AWS compte. Dans la section Détails, pour Type, choisissez Standard, entrez un nom pour la rubrique, puis choisissez Créer la rubrique.

    Note

    Actuellement, les API de streaming de messages ne prennent en charge que les rubriques SNS standard pour le streaming de messages en temps réel. Elles ne prennent pas en charge les rubriques FIFO Amazon SNS.

  3. Une fois la rubrique créée, son Amazon Resource Name (ARN) s'affiche dans la section Détails. Copiez l'ARN de la rubrique dans le Presse-papiers. Vous allez utiliser l'ARN de la rubrique à l'étape suivante et dans Étape 3 : activer le streaming de messages sur le contact.

    L'ARN de la rubrique est similaire à l'exemple suivant : 

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

  4. Choisissez l'onglet Politique d'accès, choisissez Modifier, puis ajoutez une politique basée sur les ressources dans la rubrique SNS afin que Connect Customer soit autorisé à y publier. Vous trouverez ci-dessous un exemple de politique SNS que vous pouvez copier et coller dans l'éditeur JSON, puis personnaliser avec vos valeurs :

    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"
            }
         }
      }
   ]
}
    Note

    La stratégie d'accès par défaut est assortie de conditions appliquées à sourceOwner, telles que les suivantes : 

    "Condition": {
        "StringEquals": {
          "AWS:SourceOwner": "921772911154"
        }
      }

    Assurez-vous de supprimer le paramètre et de le remplacer par SourceAccount, par exemple :

    "Condition":{
            "StringEquals":{
               "aws:SourceAccount":"YOUR_AWS_ACCOUNT_ID"
            },
            "ArnEquals":{
               "aws:SourceArn":"YOUR_CONNECT_INSTANCE_ARN"
            }
         }

    Cela évite un problème d'adjoint confus entre services.

  5. Si vous utilisez le chiffrement côté serveur sur SNS, vérifiez que l'autorisation connect.amazonaws.com est activée sur la KMS key. Voici un exemple de stratégie :

    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": "*"
        }
    ]
}

Étape 2 : initier le contact par chat

  1. Appelez l'StartChatContactAPI Connect Customer pour initier le contact par chat.

    Pour plus d'informations sur la création du client SDK permettant d'appeler les API Connect Customer, consultez les rubriques suivantes :

  2. Gardez une trace ContactId ParticipantToken de la StartChatContactréponse, car ces attributs de réponse sont utilisés pour appeler d'autres API de chat nécessaires pour activer le streaming. Les étapes suivantes décrivent cette procédure.

Étape 3 : activer le streaming de messages sur le contact

  • Appelez StartContactStreamingpour activer le streaming de messages en temps réel vers votre rubrique SNS.

    • Limites : vous pouvez vous abonner à un maximum de deux rubriques SNS par contact.

    • Lorsque vous appelez StartContactStreaming, vous devez fournir le nom de ressource Amazon (ARN) de la rubrique SNS (voirÉtape 1 : créer une rubrique SNS standard).

      Un seul ARN de rubrique SNS peut être utilisé sur plusieurs Comptes AWS, mais il doit se trouver dans la même région que votre instance Connect Customer. Par exemple, si l'ARN de votre sujet se trouve dans us-east-1, votre instance Connect Customer doit se trouver dans us-east-1.

    • Pour les messages de chat initiaux qui ne sont pas reçus sur le terminal de streaming, vous pouvez appeler l'GetTranscriptAPI pour recevoir les messages initiaux.

Étape 4 : créer la connexion du participant

Étapes suivantes

Vous êtes prêt à travailler avec les API de streaming de messages.

  1. Pour vérifier que cela fonctionne, assurez-vous que les messages sont publiés dans la rubrique SNS que vous avez créée. Vous pouvez le faire à l'aide CloudWatch des métriques Amazon. Pour obtenir des instructions, consultez la section Surveillance des rubriques Amazon SNS à l'aide de. CloudWatch

  2. La conservation des messages étant limitée sur SNS, nous vous recommandons de configurer Amazon Simple Queue Service (Amazon SQS) Amazon Kinesis ou un autre service pour conserver les messages.

  3. L'utilisation StopContactStreamingest facultative et n'est pas obligatoire si les chats sont déconnectés via un flux de contacts ou si le client déconnecte le chat. Cependant, StopContactStreaming offre la possibilité d'arrêter le streaming de messages sur la rubrique SNS, même si le chat est actif et en cours.