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 de las secuencias de segmentos de análisis de contactos para analizar las conversaciones con Contact Lens
Las secuencias de segmentos de análisis de contactos no están habilitadas 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](https://docs.aws.amazon.com/streams/latest/dev/tutorial-stock-data-kplkcl-create-stream.html) en la *Guía para desarrolladores de Amazon Kinesis Data Streams*.
**sugerencia**
Recomendamos crear un flujo independiente para cada tipo de datos. Aunque es posible utilizar la misma secuencia para las secuencias de segmentos de análisis de contactos, eventos de agentes y registros de contactos, es mucho más fácil administrar y obtener datos de la secuencia cuando se utiliza una secuencia independiente para cada una de ellos. Para obtener más información, consulte la [Guía para desarrolladores de Amazon Kinesis Data Streams](https://docs.aws.amazon.com/streams/latest/dev/introduction.html).
## 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 clave de KMS para el flujo 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` es el ARN del rol vinculado al servicio asociado a su instancia de Amazon Connect. Para encontrar el ARN del rol vinculado al servicio, en la consola de Amazon Connect, vaya a **Información general**, **Configuración de distribución**, **Función vinculada al servicio**.
## Paso 3: asociar el flujo de Kinesis
Utilice la [AssociateInstanceStorageConfig](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateInstanceStorageConfig.html)API Amazon Connect para asociar los siguientes tipos de recursos:
+ Para contactos de voz, utilice `REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS`
+ Para contactos de chat, utilice `REAL_TIME_CONTACT_ANALYSIS_CHAT_SEGMENTS`
**nota**
`REAL_TIME_CONTACT_ANALYSIS_SEGMENTS` está obsoleto, pero aún se admite y se aplica solo a los contactos de voz. En adelante, se utiliza `REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS` para los contactos de voz.
Si ya ha asociado anteriormente una transmisión a `REAL_TIME_CONTACT_ANALYSIS_SEGMENTS`, no es necesario realizar ninguna acción para actualizar la a `REAL_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 instancia y el ARN de flujo de Kinesis. 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 los contactos de chat.
**sugerencia**
Si no incluye la AWS región (`--region`), utilizará la región predeterminada según el perfil CLI.
El valor del parámetro `--storage-config` no debe incluirse entre comillas simples ('). De lo contrario, se generará un error.
```
aws connect associate-instance-storage-config \
--region "us-west-2" \
--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 ejemplo siguiente es para los contactos de voz.
```
import { Connect } from 'aws-sdk';
async function associate (): Promise {
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: activación de Contact Lens en su instancia de Amazon Connect
Para obtener instrucciones, consulte [Activación del análisis de conversación en Amazon Connect Contact Lens](enable-analytics.md).
## Paso 5 (opcional): revisar un flujo de segmentos de muestra
Le recomendamos que revise una secuencia de segmentos de muestra de [voz](sample-real-time-contact-analysis-segment-stream.md) o [chat](chat-sample-real-time-contact-analysis-segment-stream.md) para familiarizarse con su aspecto.