Habilite los flujos de segmentos del análisis de contactos

Los flujos de segmentos de análisis de contactos no están habilitados de forma predeterminada. En este tema se explica cómo habilitarlos.

Paso 1: crear un flujo de Kinesis

Cree el flujo de datos en la misma cuenta y región donde reside su instancia de Amazon Connect. Para obtener instrucciones, consulte Paso 1: crear un flujo de datos en la Guía para desarrolladores de Amazon Kinesis Data Streams.

sugerencia

Recomendamos crear un flujo independiente para cada tipo de datos. Si bien es posible usar la misma transmisión para las secuencias de segmentos del análisis de contactos, los eventos de los agentes y los registros de contactos, es mucho más fácil administrar y obtener datos de la transmisión cuando se usa una transmisión independiente para cada una de ellas. Para obtener más información, consulte la Guía para desarrolladores de Amazon Kinesis Data Streams.

Paso 2: configurar el cifrado del servidor para el flujo de Kinesis (opcional, pero recomendable)

Puede hacer esto de varias formas.

• Opción 1: utilizar Kinesis Clave administrada de AWS (aws/kinesis). Esto funciona sin ninguna configuración adicional por su parte.

• Opción 2: utilizar la misma clave administrada por el cliente para las grabaciones de llamadas, las transcripciones de chat o los informes exportados en su instancia de Amazon Connect.

  Habilite el cifrado y utilice una clave administrada por el cliente para las grabaciones de llamadas, las transcripciones de chat o los informes exportados en su instancia de Amazon Connect. A continuación, elija la misma KMS clave para la transmisión de datos de Kinesis. Esta clave ya tiene el permiso (concesión) necesario para su uso.

• Opción 3: utilizar una clave administrada por el cliente.

  Utilice una clave administrada por el cliente existente o cree una nueva y agregue los permisos necesarios para que el rol de Amazon Connect pueda utilizar la clave. Para agregar permisos mediante concesiones de AWS KMS , consulte el siguiente ejemplo:

  aws kms create-grant \
      --key-id your key ID \
      --grantee-principal arn:aws:iam::your AWS account ID:role/aws-service-role/connect.amazonaws.com/AWSServiceRoleForAmazonConnect_11111111111111111111 \
      --operations GenerateDataKey \
      --retiring-principal arn:aws:iam::your AWS account ID:role/adminRole

  Dónde grantee-principal está el ARN rol vinculado al servicio asociado a tu instancia de Amazon Connect. Para encontrar el rol vinculado al servicio, en la consola ARN de Amazon Connect, vaya a Descripción general, Configuración de distribución, rol vinculado al servicio.

Paso 3: asociar el flujo de Kinesis

Utilice Amazon Connect AssociateInstanceStorageConfigAPIpara asociar los siguientes tipos de recursos:

• Para los contactos de voz, utilice REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS

• Para los contactos de chat, usa REAL_TIME_CONTACT_ANALYSIS_CHAT_SEGMENTS

nota

REAL_TIME_CONTACT_ANALYSIS_SEGMENTSestá en desuso, pero sigue siendo compatible y solo se aplica a los contactos de voz. Se usa REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS para los contactos de voz en el futuro.

Si ya has asociado una transmisión aREAL_TIME_CONTACT_ANALYSIS_SEGMENTS, no es necesario realizar ninguna acción para actualizarlaREAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS.

Especifique la transmisión de Kinesis en la que se publicarán los segmentos de análisis de contactos en tiempo real. Necesitará el ID de la instancia y la transmisión de Kinesis. ARN En el siguiente código se muestra un ejemplo:

// Build request
  const request: Connect.Types.AssociateInstanceStorageConfigRequest = {
    InstanceId: 'your Amazon Connect instance ID',
    ResourceType: 'REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS or REAL_TIME_CONTACT_ANALYSIS_CHAT_SEGMENTS',
    StorageConfig: {
      StorageType: 'KINESIS_STREAM',
      KinesisStreamConfig: {
        StreamArn: 'the ARN of your Kinesis stream',
      },
    }
  };      

AWS CLI

El siguiente ejemplo es para contactos de chat.

aws connect associate-instance-storage-config --instance-id your Amazon Connect instance ID --resource-type REAL_TIME_CONTACT_ANALYSIS_CHAT_SEGMENTS --storage-config StorageType=KINESIS_STREAM,KinesisStreamConfig={StreamArn=the ARN of your Kinesis stream}
                        

AWS SDK

El siguiente ejemplo es para contactos de voz.

import { Connect } from 'aws-sdk';

async function associate (): Promise <void> {
  const clientConfig: Connect.ClientConfiguration = {
    region: 'the Region of your Amazon Connect instance',
  };

  const connect = new Connect(clientConfig);

  // Build request
  const request: Connect.Types.AssociateInstanceStorageConfigRequest = {
    InstanceId: 'your Amazon Connect instance ID',
    ResourceType: 'REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS',
    StorageConfig: {
      StorageType: 'KINESIS_STREAM',
      KinesisStreamConfig: {
        StreamArn: 'the ARN of your Kinesis stream',
      },
    }
  };

  try {
    // Execute request
    const response: Connect.Types.AssociateInstanceStorageConfigResponse = await connect.associateInstanceStorageConfig(request).promise();

    // Process response
    console.log('raw response: ${JSON.stringify(response, null, 2)}');
  } catch (err) {
    console.error('Error calling associateInstanceStorageConfig. err.code: ${err.code},' +
      'err.message: ${err.message}, err.statusCode: ${err.statusCode}, err.retryable: ${err.retryable}');
  }
}

associate().then(r => console.log('Done'));

Paso 4: habilitar Contact Lens para la instancia de Amazon Connect

Para ver instrucciones, consulte Habilitación de Amazon Connect Contact Lens.

Paso 5 (opcional): revisar un flujo de segmentos de muestra

Te recomendamos que revises un ejemplo de transmisión de segmentos de voz o chat para familiarizarte con su aspecto.