¿Cómo integro Amazon Connect con Amazon Kinesis?

Descripción breve

La activación del flujo de datos en su instancia de Amazon Connect le permite transmitir los eventos de agentes y los CTR a Amazon Kinesis Data Firehose o Amazon Kinesis Data Streams. Los eventos de los agentes proporcionan informes casi en tiempo real sobre la actividad de los agentes en la instancia. Los CTR proporcionan datos casi en tiempo real sobre los eventos de contacto, como las llamadas de voz, el chat y las tareas de la instancia.

Para integrar Amazon Connect con Kinesis Data Firehose o Kinesis Data Streams, complete los siguientes pasos:

1. Cree un flujo de entrega de Kinesis Data Firehose o un flujo de datos de Kinesis.
2. Activación del flujo de datos de la instancia.
3. Pruebe la configuración.

Resolución

Creación de un flujo de entrega de Kinesis Data Firehose

Para integrar Amazon Connect con Kinesis Data Firehose, complete los siguientes pasos:

1. Configure el origen, el destino y el nombre de su flujo de entrega de Kinesis Data Firehose.
   Nota: Direct PUT le permite crear una instancia de Kinesis Data Firehose que pueda transmitir flujos de datos desde Amazon Connect sin tener que crear un flujo de datos de Kinesis. El flujo de Kinesis requiere que cree un flujo de datos de Kinesis para los datos de Amazon Connect.
2. (Opcional) Configure Kinesis Data Firehose para transformar y convertir los datos de los registros.
3. (Opcional) Configure la copia de seguridad y los ajustes avanzados de su flujo de entrega de Kinesis Data Firehose.
4. Activación del flujo de datos de la instancia.
5. Pruebe el flujo de entrega con datos de muestra.

Creación de un flujo de datos de Kinesis

Para integrar Amazon Connect con Kinesis Data Streams, complete los siguientes pasos:

1. Creación de un flujo con la consola de administración de AWS.
2. Activación del flujo de datos de la instancia.
3. Para probar la configuración, complete uno de los siguientes conjuntos de pasos según su caso de uso:

Ha activado la transmisión de flujos de datos para los eventos de contacto:

1. Haga una llamada entrante o saliente para crear un registro de contactos en la instancia.
2. Confirme que el registro de contacto se haya generado en la interfaz de usuario de búsqueda de contactos.
3. Comprueba el destino configurado en el flujo de entrega para ver el evento de registro de contactos. Los eventos de contacto se entregan de forma masiva. Es posible que vea varios identificadores de contacto enviados al destino al mismo tiempo. Para ver un ejemplo, consulte Ejemplo de evento de contacto para cuando una llamada de voz está conectada a un agente.

o

Ha activado la transmisión de flujos de datos para los eventos de agentes:

1. Pida a un agente que cambie su estado o se conecte con un contacto para crear un evento de agente.
2. Compruebe el destino que está configurado para el flujo de datos de Kinesis del evento de agente. El ARN del agente es la clave de partición que se usa cuando se envían datos al flujo de datos. Todos los eventos de un solo agente se envían a la misma partición y se ignoran los eventos de refragmentación del flujo. Para ver un ejemplo, consulte Sample agent event stream (Ejemplo de flujo de eventos del agente).

Identificación y solución de errores

No veo los datos publicados en mi destino de flujo de entrega Kinesis.

Para solucionar el problema de no ver los datos publicados, haga por lo menos una de las siguientes acciones:

• Confirme que el flujo de datos de Kinesis que seleccionó esté activado para el cifrado del lado del servidor. Si el cifrado del lado del servidor está activado debido a que no se tiene permiso para llamar a KMS:GenerateDataKey, Amazon Connect no podrá publicar datos en el flujo. Para resolver este problema, siga los pasos en donde se indica como usar el cifrado del lado del servidor para Kinesis Stream.
• Pruebe su flujo de entrega mediante la opción Test demo data (Probar datos de prueba) de Kinesis Data Firehose para comprobar que el flujo de entrega esté configurado según lo esperado.
• Revise la frecuencia de entrega de datos de Kinesis Data Firehose. La frecuencia de entrega de datos puede variar según el destino seleccionado. Si pasan cinco minutos y no se entregan los datos, revise las métricas del flujo de entrega para ver los registros entrantes. Puede configurar el registro de errores para que Kinesis Data Firehose capture los errores de entrega de datos.

No puedo seleccionar la instancia de Kinesis Data Firehose o Kinesis Data Stream que se creó cuando activé el flujo de datos de Amazon Connect.

Primero, confirme que Kinesis Data Firehose o Kinesis Data Stream existen en la misma región de AWS que la instancia de Amazon Connect. Si los servicios están en la misma región, es posible que falte un permiso que permita incluir el flujo. Confirme que se han otorgado los siguientes permisos: ListDeliveryStreams para Kinesis Data Firehose o ListStreams para Kinesis Data Streams.

También puede utilizar el comando associate-instance-storage-config de la interfaz de la línea de comandos de AWS (AWS CLI) para activar la transmisión de flujos de datos.

Nota: Si se producen errores al ejecutar comandos de la Interfaz de la línea de comandos de AWS (AWS CLI), asegúrese de que utiliza la versión más reciente de la AWS CLI.

¿Dónde puedo acceder a los eventos de agentes o a los registros de seguimiento de contactos (CTR)?

Si los eventos de agentes y los CTR se envían a Kinesis Data Streams, utilice el visor de datos de la consola de Kinesis para ver estos últimos. Además, puede configurar un consumidor para que procese los datos del flujo de datos de Kinesis. Por ejemplo, puede crear una instancia de Kinesis Data Firehose para consumir los datos del flujo de datos de Kinesis de los eventos de agentes.

Si los CTR se envían a Kinesis Data Firehose, se podrá acceder a ellos en el destino que esté configurado para el flujo de entrega. Por ejemplo, si el destino es un bucket de Amazon Simple Storage Service (Amazon S3), puede acceder a los CTR del bucket de S3 elegido. Se elige el bucket de destino de Amazon S3 al crear una instancia de Kinesis Data Firehose.

¿Puedo configurar más de un flujo de entrega de Kinesis para los registros de seguimiento de contactos (CTR)?

De forma predeterminada, solo se admite un flujo de entrega para los CTR. Sin embargo, puede utilizar varios consumidores para tener varios flujos de entrega de CTR en un flujo de datos de Kinesis. Para usar esta configuración, el flujo de datos de Kinesis debe actuar como productor de los datos de CTR. A continuación, puede configurar varios consumidores para que ingieran los datos. Para obtener más información sobre los consumidores de Kinesis Data Streams, consulte Reading data from Amazon Kinesis Data Streams (Lectura de datos de Amazon Kinesis Data Streams).

Veo datos duplicados de Amazon Connect publicados en mi aplicación Kinesis Data Streams.

Se pueden producir datos duplicados debido a los reintentos del productor y del consumidor. Se recomienda hacer que el destino de los datos finales gestione los duplicados para ser resistente a los reintentos.

---

Información relacionada

Amazon Connect agent event streams (Flujos de eventos del agente de Amazon Connect)

Eventos de contacto en Amazon Connect

What Is Amazon Kinesis Data Streams? (¿Qué es Amazon Kinesis Data Streams?)

What Is Amazon Kinesis Data Firehose? (¿Qué es Amazon Kinesis Data Firehose?)