Abilitazione dello streaming di messaggi di chat in tempo reale - Amazon Connect
Come funziona lo streaming dei messaggi APIsFase 1: Creare un argomento standard SNSPassaggio 2: avviare il contatto di chatPassaggio 3: abilitare lo streaming dei messaggi sul contattoPassaggio 4: creare la connessione del partecipantePassaggi successivi

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Abilitazione dello streaming di messaggi di chat in tempo reale

Amazon Connect Chat consente APIsdi abbonarsi a un flusso di messaggi di chat in tempo reale. Usando questiAPIs, puoi:

  • Eseguire lo streaming di messaggi in tempo reale quando viene creato un nuovo contatto di chat.

  • Estendi l'attuale funzionalità di Amazon Connect Chat per supportare casi d'uso come la creazione di integrazioni con SMS soluzioni e applicazioni di messaggistica di terze parti, l'attivazione di notifiche push per dispositivi mobili e la creazione di dashboard di analisi per monitorare e tracciare l'attività dei messaggi di chat.

Come funziona lo streaming dei messaggi APIs

Lo streaming APIs dei messaggi di Amazon Connect viene attivato quando si verificano determinati eventi all'interno di un contatto Amazon Connect Chat. Ad esempio, quando un cliente invia un nuovo messaggio di chat, l'evento trasmette un payload a un endpoint specifico contenente dati sul messaggio appena inviato. I messaggi vengono pubblicati utilizzando Amazon Simple Notification Service (AmazonSNS) su un endpoint specifico.

Questo argomento descrive come configurare lo streaming di messaggi in tempo reale utilizzando Amazon Connect e AmazonSNS. La procedura è la seguente:

  1. Usa la SNS console Amazon per creare un nuovo SNS argomento standard e configurare i messaggi.

  2. Chiama il StartChatContactAPIper avviare il contatto in chat.

  3. Chiama il StartContactStreamingAPIper avviare lo streaming dei messaggi.

  4. Chiama il CreateParticipantConnectionAPIper creare la connessione del partecipante.

Fase 1: Creare un argomento standard SNS

  1. Vai alla SNS console Amazon.

  2. Crea un SNS argomento nel tuo AWS account. Nella sezione Dettagli, per Tipo scegli Standard, inserisci un nome per l'argomento e seleziona Crea argomento.

    Nota

    Attualmente, lo streaming dei messaggi supporta APIs solo lo standard SNS per lo streaming di messaggi in tempo reale. Non supportano gli argomenti di Amazon SNS FIFO (first in, first out).

  3. Dopo aver creato l'argomento, il relativo Amazon Resource Name (ARN) viene visualizzato nella sezione Dettagli. Copia l'argomento ARN negli appunti. Utilizzerai l'argomento ARN nel passaggio successivo e in. Passaggio 3: abilitare lo streaming dei messaggi sul contatto

    L'argomento è ARN simile all'esempio seguente: 

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

  4. Scegli la scheda Politica di accesso, scegli Modifica, quindi aggiungi una politica basata sulle risorse sull'SNSargomento in modo che Amazon Connect abbia l'autorizzazione a pubblicare su di esso. Di seguito è riportato un esempio di SNS politica che puoi copiare e incollare nell'JSONeditor e quindi personalizzare con i tuoi valori: 

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

    La policy di accesso predefinita prevede l'applicazione a sourceOwner di condizioni quali: 

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

    Assicurati di rimuoverla e di sostituirla con SourceAccount, ad esempio:

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

    Ciò eviterà che si verifichi un problema di “confused deputy” tra i servizi.

  5. Se utilizzi la crittografia lato server attivaSNS, verifica di avere l'connect.amazonaws.comautorizzazione abilitata su. KMS key Di seguito è riportata una policy di esempio:

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

Passaggio 2: avviare il contatto di chat

  1. Chiama Amazon Connect StartChatContactAPIper avviare il contatto di chat.

    Per informazioni su come creare il SDK client per chiamare Amazon ConnectAPIs, consulta i seguenti argomenti:

  2. Tieni traccia della risposta ContactId e ParticipantToken della StartChatContactrisposta poiché questi attributi di risposta vengono utilizzati per chiamare altre chat APIs necessarie per abilitare lo streaming. Ciò viene descritto nei passaggi successivi.

Passaggio 3: abilitare lo streaming dei messaggi sul contatto

  • Chiama StartContactStreamingper abilitare lo streaming di messaggi in tempo reale sul tuo SNS argomento.

    • Limiti: puoi iscriverti a un massimo di due SNS argomenti per contatto.

    • Quando chiami StartContactStreaming, devi fornire l'Amazon Resource Name (ARN) dell'SNSargomento (vediFase 1: Creare un argomento standard SNS).

      Un singolo SNS argomento ARN può essere utilizzato su più argomenti Account AWS, ma deve trovarsi nella stessa regione dell'istanza Amazon Connect. Ad esempio, se l'argomento ARN è in us-east-1, l'istanza Amazon Connect deve essere in us-east-1.

    • Per i messaggi di chat iniziali che non vengono ricevuti sull'endpoint di streaming, puoi chiamarli GetTranscriptAPIper ricevere i messaggi iniziali.

Passaggio 4: creare la connessione del partecipante

Passaggi successivi

Sei pronto per lavorare con lo streaming dei messaggi. APIs

  1. Per verificare che funzioni, controlla che i messaggi siano pubblicati nell'SNSargomento che hai creato. Puoi farlo utilizzando i CloudWatch parametri di Amazon. Per istruzioni, consulta gli SNSargomenti Monitoraggio dell'utilizzo di Amazon CloudWatch.

  2. Poiché la conservazione dei messaggi SNS è limitata, ti consigliamo di configurare Amazon Simple Queue Service (AmazonSQS) Amazon Kinesis o un altro servizio per conservare i messaggi.

  3. L'utilizzo StopContactStreamingè facoltativo e non richiesto se le chat vengono disconnesse tramite un flusso di contatti o se il cliente disconnette la chat. Tuttavia, StopContactStreaming offre la possibilità di interrompere lo streaming dei messaggi sull'SNSargomento, anche se la chat è attiva e in corso.