View a markdown version of this page

Habilite la transmisión de mensajes de chat en tiempo real en Connect Customer - Amazon Connect Customer
Cómo funcionan las API de streaming de mensajesPaso 1: crear tema de SNS 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.

Habilite la transmisión de mensajes de chat en tiempo real en Connect Customer

Connect Customer Chat proporciona API que puede usar para suscribirse a una transmisión de mensajes de chat en tiempo real. Con estas API, puede:

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

  • Amplíe la funcionalidad actual del chat con el cliente de Connect para adaptarla a casos prácticos, como la creación de integraciones con soluciones de SMS 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 rastrear la actividad de los mensajes de chat.

nota

En esta página se describe cómo suscribirse a un terminal de SNS para transmitir en tiempo real los mensajes de chat en Connect Customer. Si estás intentando habilitar la transmisión de mensajes para las interacciones conversacionales con IA en Connect Customer, consulta. Habilitar la transmisión de mensajes para el AI-powered chat

Cómo funcionan las API de streaming de mensajes

Las API de transmisión de mensajes de Connect Customer se activan cuando se producen ciertos eventos en un contacto del chat de Connect Customer. 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 (Amazon SNS) en un punto de conexión específico.

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

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

  2. Llame a la StartChatContact API para iniciar el contacto de chat.

  3. Llame a la StartContactStreaming API para iniciar la transmisión de mensajes.

  4. Llama a la CreateParticipantConnection API para crear la conexión del participante.

Paso 1: crear tema de SNS estándar

  1. Vaya a la consola de Amazon SNS.

  2. Crea un tema de SNS 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, las API de streaming de mensajes solo admiten SNS estándar para el streaming de mensajes en tiempo real. No son compatibles con los temas FIFO (primero en entrar, primero en salir) de Amazon SNS.

  3. Tras crear el tema, su nombre de recurso de Amazon (ARN) aparece en la sección Detalles. Copie el ARN del tema en el portapapeles. Usa el tema ARN en el siguiente paso y en. Paso 3: habilitar el streaming de mensajes en el contacto

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

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

  4. Seleccione la pestaña Política de acceso, elija Editar y, a continuación, añada una política basada en recursos sobre el tema de las redes sociales para que Connect Customer tenga permiso para publicar en ella. A continuación, encontrará un ejemplo de política de SNS que puede copiar y pegar en el editor JSON y, a continuación, personalizar con sus valores:

    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"
            }
         }
      }
   ]
}
    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 utiliza el cifrado del servidor en SNS, verifique que tiene el permiso connect.amazonaws.com habilitado en la KMS key. A continuación, se muestra una política de ejemplo:

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

Paso 2: iniciar el contacto de chat

  1. Llame a la StartChatContact API de Connect Customer para iniciar el contacto de chat.

    Para obtener información sobre cómo crear el cliente del SDK para llamar a las API de clientes de Connect, consulte los siguientes temas:

  2. Realice un seguimiento ParticipantToken de ContactId la StartChatContact respuesta, ya que estos atributos de respuesta se utilizan para llamar a otras API de chat necesarias para habilitar la transmisión. Esto se describe en los siguientes pasos.

Paso 3: habilitar el streaming de mensajes en el contacto

  • Llama StartContactStreaming para habilitar la transmisión de mensajes en tiempo real a tu tema de SNS.

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

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

      Un único ARN de un tema de SNS puede usarse en varios Cuentas de AWS, pero debe estar en la misma región que tu instancia de cliente de Connect. Por ejemplo, si el ARN de tu tema está en us-east-1, tu instancia de cliente de Connect debe estar en us-east-1.

    • En el caso de los mensajes de chat iniciales que no se reciben en el punto final de transmisión, puedes llamar a la GetTranscript API para recibir los mensajes iniciales.

Paso 4: crear la conexión de participante

Siguientes pasos

Ya está todo listo para trabajar con las API de streaming de mensajes.

  1. Para comprobar que funciona, compruebe que los mensajes se publican en el tema de SNS que ha creado. Puedes hacerlo usando las CloudWatch métricas de Amazon. Para obtener instrucciones, consulte los temas de monitorización de Amazon SNS utilizando CloudWatch.

  2. Como SNS tiene una retención limitada, le recomendamos que establezca Amazon Simple Queue Service (Amazon SQS), Amazon Kinesis u otro servicio para retener los mensajes.

  3. Su uso StopContactStreaming es opcional y no es obligatorio si los chats se desconectan a través de un flujo de contactos o si el cliente desconecta el chat. No obstante, StopContactStreaming ofrece la opción de detener el streaming de mensajes en el tema de SNS, aunque el chat esté activo y en curso.