Habilitación del streaming de mensajes de chat en tiempo real - Amazon Connect
¿Cómo funciona la transmisión de mensajes APIsPaso 1: Crea un SNS tema estándarPaso 2: iniciar el contacto de chatPaso 3: habilitar el streaming de mensajes en el contactoPaso 4: crear la conexión de participanteSiguientes pasos

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Habilitación del streaming de mensajes de chat en tiempo real

Amazon Connect Chat APIsle permite suscribirse a una transmisión de mensajes de chat en tiempo real. Con ellosAPIs, puede:

  • Transmitir mensajes de chat en tiempo real cuando se cree un nuevo contacto de chat.

  • Amplíe la funcionalidad actual de Amazon Connect Chat para admitir casos de uso, como la creación de integraciones con SMS soluciones y aplicaciones de mensajería de terceros, la activación de las notificaciones push móviles y la creación de paneles de análisis para supervisar y realizar un seguimiento de la actividad de los mensajes de chat.

¿Cómo funciona la transmisión de mensajes APIs

La transmisión de mensajes de Amazon Connect APIs se activa cuando se producen determinados eventos en un contacto de Amazon Connect Chat. Por ejemplo, cuando un cliente envía un nuevo mensaje de chat, el evento envía una carga a un punto de conexión especificado que contiene datos sobre el mensaje que se acaba de enviar. Los mensajes se publican mediante Amazon Simple Notification Service (AmazonSNS) en un punto final específico.

En este tema se describe cómo configurar la transmisión de mensajes en tiempo real mediante Amazon Connect y AmazonSNS. Los pasos son:

  1. Usa la SNS consola de Amazon para crear un nuevo SNS tema estándar y configurar los mensajes.

  2. Llama al StartChatContactAPIpara iniciar el contacto de chat.

  3. Llama al StartContactStreamingAPIpara iniciar la transmisión de mensajes.

  4. Llama CreateParticipantConnectionAPIal para crear la conexión del participante.

Paso 1: Crea un SNS tema estándar

  1. Ve a la SNS consola de Amazon.

  2. Crea un SNS tema en tu AWS cuenta. En la sección Detalles, para Tipo, elija Estándar, introduzca un nombre para el tema y, a continuación, elija Crear tema.

    nota

    Actualmente, la transmisión de mensajes APIs solo es compatible con el estándar SNS para la transmisión de mensajes en tiempo real. No admiten temas de Amazon SNS FIFO (primero en entrar, primero en salir).

  3. Tras crear el tema, su nombre de recurso de Amazon (ARN) aparecerá en la sección Detalles. Copia el tema ARN al portapapeles. Utilizará el tema ARN en el siguiente paso y enPaso 3: habilitar el streaming de mensajes en el contacto.

    El tema ARN tiene un aspecto similar al del siguiente ejemplo: 

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

  4. Elija la pestaña Política de acceso, elija Editar y, a continuación, añada una política basada en recursos sobre el SNS tema para que Amazon Connect tenga permiso para publicar en él. El siguiente es un ejemplo SNS de política que puede copiar y pegar en el JSON editor y, a continuación, personalizar con sus 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

    La política de acceso predeterminada incluye condiciones aplicadas a sourceOwner, como: 

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

    Asegúrese de quitarla y reemplazarla por SourceAccount, por ejemplo:

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

    Esto evita un problema de suplente confuso entre servicios.

  5. Si utilizas el cifrado del lado del servidorSNS, comprueba que tienes el connect.amazonaws.com permiso habilitado en el. KMS key A continuación, se muestra una política de ejemplo:

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

Paso 2: iniciar el contacto de chat

  1. Llama a Amazon Connect StartChatContactAPIpara iniciar el contacto de chat.

    Para obtener información sobre cómo crear el SDK cliente para llamar a Amazon ConnectAPIs, consulte los siguientes temas:

  2. Realice un seguimiento de la StartChatContactrespuesta ContactId y ParticipantToken desde ella, ya que estos atributos de respuesta se utilizan para llamar a otros chats APIs necesarios para habilitar la transmisión. Esto se describe en los siguientes pasos.

Paso 3: habilitar el streaming de mensajes en el contacto

  • Llama StartContactStreamingpara permitir la transmisión de mensajes en tiempo real a tu SNS tema.

    • Límites: puedes suscribirte a un máximo de dos SNS temas por contacto.

    • Cuando llames StartContactStreaming, tendrás que proporcionar el nombre del recurso de Amazon (ARN) del SNS tema (consultaPaso 1: Crea un SNS tema estándar).

      Se ARN puede usar un solo SNS tema en varios Cuentas de AWS, pero debe estar en la misma región que la instancia de Amazon Connect. Por ejemplo, si tu tema ARN está en us-east-1, tu instancia de Amazon Connect debe estar en us-east-1.

    • En el caso de los mensajes de chat iniciales que no se reciban en el terminal de streaming, puedes llamar al GetTranscriptAPIpara recibir los mensajes iniciales.

Paso 4: crear la conexión de participante

Siguientes pasos

Ya está todo listo para trabajar con la transmisión APIs de mensajes.

  1. Para comprobar que funciona, compruebe que los mensajes estén publicados en el SNS tema que ha creado. Puedes hacerlo con las CloudWatch métricas de Amazon. Para obtener instrucciones, consulta Cómo monitorizar SNS los temas de Amazon mediante CloudWatch.

  2. Como SNS la retención es limitada, le recomendamos que configure Amazon Simple Queue Service (AmazonSQS), Amazon Kinesis u otro servicio para conservar los mensajes.

  3. StopContactStreamingEl uso es opcional y no obligatorio si los chats se desconectan a través de un flujo de contactos o si el cliente desconecta el chat. Sin embargo, StopContactStreaming ofrece la opción de detener la transmisión de mensajes sobre el SNS tema, incluso si el chat está activo y en curso.