Activez le streaming des messages de chat en temps réel dans Amazon Connect - Amazon Connect
Comment APIs fonctionne le streaming des 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 Amazon Connect

Amazon Connect Chat vous permet APIsde vous abonner à un flux de messages de chat en temps réel. Grâce à ces APIs outils, vous pouvez :

  • Diffuser des messages de chat en temps réel lorsqu'un nouveau contact par chat est créé.

  • Étendez les fonctionnalités actuelles d'Amazon Connect Chat 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.

Comment APIs fonctionne le streaming des messages

Le streaming APIs des messages Amazon Connect est déclenché lorsque certains événements se produisent au sein d'un contact Amazon Connect Chat. Par exemple, lorsqu'un client envoie un nouveau message de chat, l'événement envoie une charge utile à 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 avec Amazon Connect 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 initier 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, le streaming de messages APIs ne prend en charge que le SNS standard pour le streaming en temps réel des messages. 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 Stratégie d'accès, sélectionnez Modifier, puis ajoutez une politique basée sur les ressources à la rubrique SNS afin qu'Amazon Connect 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 : 

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

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

Étape 2 : Initier le contact par chat

  1. Appelez l'StartChatContactAPI Amazon Connect pour lancer le contact par chat.

    Pour plus d'informations sur la création du client SDK permettant d'appeler Amazon Connect APIs, 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 discussions APIs 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 Amazon Connect. Par exemple, si l'ARN de votre sujet se trouve dans us-east-1, votre instance Amazon Connect 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 le streaming des messages APIs.

  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.