Ativar a transmissão em tempo real de mensagens de chat

O Amazon Connect Chat fornece APIsserviços que permitem que você assine um stream de mensagens de bate-papo em tempo real. Com elesAPIs, você pode:

• Transmitir mensagens de chat em tempo real quando um novo contato de chat for criado.

• Estenda a funcionalidade atual do Amazon Connect Chat para oferecer suporte a casos de uso, como criar integrações com SMS soluções e aplicativos de mensagens de terceiros, habilitar notificações push móveis e criar painéis de análise para monitorar e rastrear a atividade de mensagens de bate-papo.

Como funciona o streaming de APIs mensagens

O streaming de mensagens do Amazon Connect APIs é acionado quando certos eventos ocorrem em um contato do Amazon Connect Chat. Por exemplo, quando um cliente envia uma nova mensagem de chat, o evento envia uma carga útil para um endpoint específico contendo dados sobre a mensagem que acabou de ser enviada. As mensagens são publicadas usando o Amazon Simple Notification Service (AmazonSNS) em um endpoint específico.

Este tópico descreve como configurar o streaming de mensagens em tempo real usando o Amazon Connect e a AmazonSNS. As etapas são:

1. Use o SNS console da Amazon para criar um novo SNS tópico padrão e configurar as mensagens.

2. Ligue StartChatContactAPIpara o para iniciar o contato de bate-papo.

3. Ligue StartContactStreamingAPIpara o para iniciar o streaming de mensagens.

4. Ligue CreateParticipantConnectionAPIpara o para criar a conexão do participante.

Etapa 1: criar um SNS tópico padrão

1. Acesse o SNS console da Amazon.

2. Crie um SNS tópico na sua AWS conta. Na seção Detalhes, em Tipo, escolha Padrão, insira um nome para o tópico e escolha Criar tópico.

   nota

   Atualmente, o streaming de mensagens suporta APIs apenas o padrão SNS para streaming de mensagens em tempo real. Eles não oferecem suporte aos tópicos da Amazon SNS FIFO (primeiro a entrar, primeiro a sair).

3. Depois de criar o tópico, seu nome de recurso da Amazon (ARN) é exibido na seção Detalhes. Copie o tópico ARN para a prancheta. Você usará o tópico ARN na próxima etapa e emEtapa 3: Habilitar a transmissão de mensagens no contato.

   O tópico ARN é semelhante ao exemplo a seguir:

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

4. Escolha a guia Política de acesso, escolha Editar e, em seguida, adicione uma política baseada em recursos sobre o SNS tópico para que o Amazon Connect tenha permissão para publicar nele. Veja a seguir um exemplo de SNS política que você pode copiar e colar no JSON editor e depois personalizar com seus valores:

   {
      "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

   A Política de acesso padrão vem com condições aplicadas ao sourceOwner como:

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

   Remova e substitua por SourceAccount, por exemplo:

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

   Isso evita um problema de substituto confuso entre serviços.

5. Se você estiver usando a criptografia do lado do servidor ativadaSNS, verifique se você tem connect.amazonaws.com permissão ativada no. KMS key Veja a seguir um exemplo de política:

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

Etapa 2: Iniciar o contato do chat

1. Ligue para o Amazon Connect StartChatContactAPIpara iniciar o contato por chat.

   Para obter informações sobre como criar o SDK cliente para ligar para o Amazon ConnectAPIs, consulte os seguintes tópicos:

   • Classe AmazonConnectClientBuilder

   • Criar clientes de serviço

2. Acompanhe a StartChatContactresposta ContactId e a ParticipantToken partir dela, pois esses atributos de resposta são usados para chamar outro bate-papo APIs necessário para habilitar o streaming. Isso é descrito nas próximas etapas.

Etapa 3: Habilitar a transmissão de mensagens no contato

• Ligue StartContactStreamingpara ativar o streaming de mensagens em tempo real para o seu SNS tópico.

  • Limites: Você pode se inscrever em até dois SNS tópicos por contato.

  • Ao ligar StartContactStreaming, você precisará fornecer o Amazon Resource Name (ARN) do SNS tópico (consulteEtapa 1: criar um SNS tópico padrão).

    Um único SNS tópico ARN pode ser usado em vários Contas da AWS, mas deve estar na mesma região da sua instância do Amazon Connect. Por exemplo, se seu tópico ARN estiver em us-east-1, sua instância do Amazon Connect deverá estar em us-east-1.

  • Para mensagens de bate-papo iniciais que não são recebidas no endpoint de streaming, você pode ligar GetTranscriptAPIpara o para receber as mensagens iniciais.

Etapa 4: Criar a conexão do participante

• Chamada CreateParticipantConnectioncom o ConnectParticipant atributo passado como verdadeiro.

  • Você deve ligar CreateParticipantConnectiondentro de cinco minutos após criar o bate-papo.

  • Ligar CreateParticipantConnectioncom ConnectParticipant set como true só funciona se você habilitou o streaming Etapa 2: Iniciar o contato do chat e o participante da chamada estáCustomer.

  • Essa etapa (criar a conexão do participante) é opcional se você já se conectou com sucesso ao contato do chat usando WEBSOCKET.

Próximas etapas

Você está pronto para trabalhar com o streaming de mensagensAPIs.

1. Para verificar se está funcionando, verifique se as mensagens foram publicadas no SNS tópico que você criou. Você pode fazer isso usando as CloudWatch métricas da Amazon. Para obter instruções, consulte Monitorando SNS tópicos da Amazon usando CloudWatch.

2. Como SNS tem retenção limitada, recomendamos que você configure o Amazon Simple Queue Service (AmazonSQS) Amazon Kinesis ou outro serviço para reter mensagens.

3. StopContactStreamingO uso é opcional e não obrigatório se os bate-papos estiverem sendo desconectados por meio de um fluxo de contato ou se o cliente desconectar o bate-papo. No entanto, StopContactStreaming oferece a opção de interromper o streaming de mensagens sobre o SNS tópico, mesmo se o bate-papo estiver ativo e contínuo.