View a markdown version of this page

Activez la diffusion de 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 la diffusion de messages de chat en temps réel dans Connect Customer

Connect Customer Chat fournit des API que vous pouvez utiliser pour 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 terminal SNS pour diffuser en temps réel des messages de chat dans Connect Customer. Si vous essayez d'activer la diffusion de messages pour les interactions conversationnelles basées sur l'IA dans Connect Customer, consultezActiver la diffusion de 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 la diffusion 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 la diffusion 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. Utilisez la rubrique ARN à 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:111122223333:MyTopic

  4. Choisissez l'onglet Politique d'accès, choisissez Modifier, puis ajoutez une politique basée sur les ressources sur le sujet 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 pour appeler les API Connect Customer, consultez les rubriques suivantes :

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

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

  • Appelez StartContactStreaming pour activer la diffusion de messages en temps réel sur votre sujet 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 ARN de rubrique SNS unique peut être utilisé sur plusieurs sujets 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 premiers messages de chat qui ne sont pas reçus sur le terminal de streaming, vous pouvez appeler l'GetTranscriptAPI pour recevoir les premiers messages.

É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 statistiques Amazon. Pour obtenir des instructions, consultez la section Surveillance des rubriques Amazon SNS à l'aide CloudWatch de.

  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 StopContactStreaming est facultative et non 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.