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. # Uso de las configuraciones de análisis de llamadas para Amazon Chime SDK Uso de configuraciones de análisis de llamadas Para procesar el audio mediante una configuración de análisis de llamadas, debe crear un canal de análisis de llamadas, también conocido como canal de información multimedia. La canalización se crea durante una llamada para gestionar el audio y finaliza al final de la llamada. Los canales de análisis de llamadas requieren el ARN de una configuración de análisis de llamadas e información sobre la fuente de audio. La configuración de análisis de llamadas incluye detalles sobre los procesadores de audio, los destinos de la información y las configuraciones de los eventos de alerta, *pero no sobre la fuente de audio*. Esto le permite reutilizar la configuración en diferentes flujos de trabajo de análisis de llamadas, por ejemplo, con distintos Voice Connectors o fuentes KVS. La canalización de análisis de llamadas invoca los servicios de machine learning especificados en la configuración y graba el audio. Puede detener la canalización de forma manual o automática cuando finaliza la llamada. Puede usar los canales de análisis de llamadas en una amplia variedad de casos de uso. Los siguientes flujos de trabajo muestran posibles formas de utilizar una configuración y un proceso de análisis de llamadas. **Topics** + [ # Descripción de los flujos de trabajo para grabar llamadas para Amazon Chime SDK ](recording-workflows.md) + [ # Descripción de los flujos de trabajo de las analíticas basadas en el machine learning para el Amazon Chime SDK ](ml-based-analytics.md) # Descripción de los flujos de trabajo para grabar llamadas para Amazon Chime SDK Descripción de los flujos de trabajo para grabar llamadas En los temas de esta sección se enumeran y describen los flujos de trabajo para grabar llamadas y Kinesis Video Streams. # Grabar llamadas de Voice Connector Utilice este flujo de trabajo cuando: + Ya usa, o planea usar, un Voice Connector para incorporar los medios SIP al análisis de llamadas. **nota** Los Voice Connectors admiten SIP y SIPREC. Para obtener más información, consulte [Administración de Voice Connectors de Amazon Chime SDK](https://docs.aws.amazon.com/chime-sdk/latest/ag/voice-connectors.html), en la Guía del administrador de Amazon Chime SDK**. + Desea grabar automáticamente las llamadas SIP o SIPREC con baja latencia a los destinos de Amazon Simple Storage Service que elija. + Desea usar la consola de Amazon Chime SDK para crear la configuración y asociarla a un Voice Connector. + Desea aplicar la misma configuración de grabación a todas las llamadas de Voice Connector. Si desea aplicar varias configuraciones a uno o más Voice Connectors, consulte la siguiente sección. Para habilitar las llamadas mediante programación, utilice el siguiente SDK de Amazon Chime. APIs + Use la API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html) para crear una configuración de análisis de llamadas + Use [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_CreateVoiceConnector.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_CreateVoiceConnector.html) para crear un Voice Connector. + Use la API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html) para asociar la configuración a un Voice Connector. Para obtener más información, consulte [Configuración de Voice Connectors para utilizar el análisis de llamadas](https://docs.aws.amazon.com/chime-sdk/latest/ag/configure-voicecon.html) en la *Guía del administrador de Amazon Chime SDK*. El siguiente diagrama muestra el flujo de datos cuando un Voice Connector inicia una sesión de grabación de llamadas. Los números del diagrama corresponden al texto numerado que aparece a continuación. ![\[Imagen que muestra el flujo de datos cuando un Voice Connector comienza a grabar una llamada.\]](http://docs.aws.amazon.com/es_es/chime-sdk/latest/dg/images/call-analytics-workflow-1.png) En el diagrama: 1. Utilice la consola de Amazon Chime SDK o la API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html) para crear una configuración de análisis de llamadas. Durante el proceso de creación de la configuración, solo tiene que activar la grabación de llamadas, elegir el formato de archivo de grabación deseado y especificar el destino de Amazon S3 para almacenar los archivos de grabación. Para obtener más información, consulte [Creación de configuraciones de análisis de llamadas](https://docs.aws.amazon.com/chime-sdk/latest/ag/create-ca-config.html) en la *Guía del administrador de Amazon Chime SDK*. 1. Utilice la consola de Amazon Chime SDK o la API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html) para asociar la configuración a un Voice Connector. Para usar la consola, consulte [Configuración de Voice Connectors para usar el análisis de llamadas](https://docs.aws.amazon.com/chime-sdk/latest/ag/configure-voicecon.html). 1. Durante una llamada saliente, el Voice Connector recibe el audio de cada participante de la llamada. 1. Si hay una configuración de grabación de análisis de llamadas conectada al Voice Connector, el servicio Voice Connector utiliza el servicio de canalización de medios para iniciar una sesión de grabación de análisis de llamadas. 1. El servicio de canalización de medios inicia el procesador de grabación de llamadas que supervisa la llamada en curso. 1. Cuando finaliza la llamada, el servicio de canalización de medios entrega el archivo de grabación de llamadas al bucket de Amazon S3 designado y proporciona los metadatos de la grabación a través de Amazon Kinesis Data Streams. Si hay un almacenamiento de datos activado, los metadatos de la llamada también se envían al almacenamiento de datos de Amazon Simple Storage Service. En los casos en que se utiliza el SIPREC para incorporar el audio SIP en el análisis de llamadas, los metadatos de las llamadas incluyen los metadatos del SIPREC en formato de tabla. Para obtener más información sobre las tablas de grabación, consulte [Descripción de las tablas del catálogo de AWS Glue datos del SDK de Amazon Chime](glue-tables.md), más adelante en esta sección. 1. El servicio Media Pipeline envía los eventos de estado de la canalización a Amazon por defecto EventBridge. Para obtener más información, consulta [Cómo usar EventBridge las notificaciones](https://docs.aws.amazon.com/chime-sdk/latest/dg/ca-eventbridge-notifications.html) en esta guía. **nota** Tenga en cuenta que debe habilitar la transmisión por Voice Connector para poder grabar con un Voice Connector. Esta característica permite la transmisión de los datos de las llamadas a las transmisiones de Kinesis Video Streams gestionadas por Voice Connector en su cuenta. Para obtener más información, consulte [Transmisión de contenido multimedia del Voice Connector de Amazon Chime SDK a Kinesis Video Streams](https://docs.aws.amazon.com/chime-sdk/latest/ag/start-kinesis-vc.html) en la *Guía del administrador de Amazon Chime SDK.* También puede almacenar los datos de llamadas creados por Voice Connector en Kinesis Video Streams durante períodos variables, desde horas hasta días o incluso años. La opción de no retener datos limita la usabilidad de los datos de las llamadas para su consumo inmediato. El costo de Kinesis Video Streams se determina en función del ancho de banda y el almacenamiento total utilizados. Puede ajustar el período de retención de datos en cualquier momento dentro de la configuración de transmisión del Voice Connector. Para habilitar el registro de análisis de llamadas, debe asegurarse de que Kinesis Video Stream conserve los datos el tiempo suficiente para realizar el análisis de llamadas. Para ello, especifique un período de retención de datos adecuado. Puede asociar una configuración de canalización de información sobre llamadas a tantos Voice Connectors como desee. También puede crear una configuración diferente para cada Voice Connector. Los conectores de voz los utilizan AWSService RoleForAmazonChimeVoiceConnector para llamar a la [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html)API en su nombre una vez por ID de transacción. Para obtener información sobre el rol, consulte [Uso del rol vinculado al servicio de Amazon Chime SDK para los Voice Connectors de Amazon Chime SDK](https://docs.aws.amazon.com/chime-sdk/latest/ag/using-service-linked-roles-stream.html#service-linked-role-permissions-stream) en la *Guía del administrador de Amazon Chime SDK*. # Grabación con productores de Amazon Kinesis Video Streams Las transmisiones de Amazon Kinesis Video Streams se graban cuando: + Debe aplicar diferentes configuraciones a una llamada en lugar de usar la misma configuración para todas las llamadas de Voice Connector. + Desea grabar audio SIP o no SIP que no sea procesado por un Voice Connector. Para utilizar esta opción de grabación de llamadas, debe publicar el audio en Kinesis Video Streams (KVS) y, a continuación, llamar a la API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html) con la información del canal de transmisión de KVS y un ARN de configuración de análisis de llamadas. **nota** El análisis de llamadas APIs admite un máximo de dos canales de audio. También puedes activar la transmisión del Voice Connector y, a continuación, utilizar la información de KVS publicada en las EventBridge notificaciones del Voice Connector para iniciar la grabación de una llamada. Al llamar a la API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html), puede elegir si desea especificar o no los números de los fragmentos para cada definición de canal de transmisión de KVS. Si proporciona un número de fragmento, el análisis de llamadas empezará a procesar la transmisión en ese fragmento. Si no especifica un identificador de fragmento, el análisis de llamadas empezará a procesar la transmisión a partir del último fragmento disponible. El siguiente diagrama muestra el flujo de datos cuando un Voice Connector inicia una sesión de grabación de llamadas. Los números del diagrama corresponden al texto numerado que aparece a continuación. ![\[Imagen que muestra el flujo de datos cuando un Voice Connector comienza a grabar una llamada.\]](http://docs.aws.amazon.com/es_es/chime-sdk/latest/dg/images/call-analytics-workflow-2.png) En el diagrama: 1. Puede usar la consola de Amazon Chime SDK o la API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html) para crear una configuración de grabación de llamadas. 1. Usa el AWS SDK para crear una aplicación que transfiera audio externo al KVS o habilita la transmisión por Voice Connector para publicar automáticamente el audio de las llamadas en un KVS. Para obtener más información, consulte [Transmisión de contenido multimedia del Voice Connector de Amazon Chime SDK a Kinesis Video Streams](https://docs.aws.amazon.com/chime-sdk/latest/ag/start-kinesis-vc.html) en la *Guía del administrador de Amazon Chime SDK.* 1. Si la transmisión mediante Voice Connector está habilitada, el servicio Voice Connector envía las notificaciones de forma predeterminada. EventBridge 1. En el caso de la transmisión por Voice Connector, la aplicación puede usar el Amazon Chime Voice Connector desde donde se retransmiten `STARTED` eventos EventBridge para recopilar información de transmisión en KVS sobre los períodos de una llamada. 1. Una vez que la aplicación tenga la información de audio de los eventos de transmisión de Voice Connector o de una fuente externa, invocará la API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html) de Amazon Chime SDK. 1. El servicio de canalización de medios inicia el procesador de grabación de llamadas que supervisa la llamada en curso. 1. El servicio Media Pipeline envía los eventos de estado de la canalización a Amazon por defecto EventBridge. Para obtener más información, consulta Cómo [usar EventBridge las notificaciones](https://docs.aws.amazon.com/chime-sdk/latest/dg/ca-eventbridge-notifications.html). 1. Una vez finalizada la llamada, el servicio de canalización de medios entregará el archivo de grabación de la llamada al bucket de Amazon S3 designado y proporcionará los metadatos de la grabación a través de Amazon Kinesis Data Streams. Si se habilita un almacenamiento de datos, los metadatos de la llamada también se enviarán al almacenamiento de datos de Amazon S3. En los casos en que se utilice el SIPREC para incorporar el audio SIP en el análisis de llamadas, los metadatos de las llamadas incluirán los metadatos del SIPREC en un práctico formato de tabla. Para obtener más información sobre las tablas de grabación, consulte [Descripción de las tablas del catálogo de AWS Glue datos del SDK de Amazon Chime](glue-tables.md), más adelante en esta sección. 1. Tu aplicación puede monitorizar la canalización y, en el caso de un conector de voz, el estado de la llamada mediante eventos publicados en Amazon EventBridge. Para obtener más información, consulta [Cómo usar EventBridge las notificaciones](https://docs.aws.amazon.com/chime-sdk/latest/dg/ca-eventbridge-notifications.html) en esta guía. 1. Para finalizar la grabación, llame a la API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaPipeline.html) para finalizar la grabación de la llamada. Para ver ejemplos y grabaciones basadas en API, consulte [Receptor de grabación de Amazon S3](https://docs.aws.amazon.com/chime-sdk/latest/dg/ca-processors-sinks.html#ca-s3-recording-sink) en esta guía. # Uso de la CLI para iniciar la grabación Los ejemplos de esta sección muestran cómo hacer lo siguiente: + Utilice la CLI para ejecutar una configuración de análisis de llamadas e invocar [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html). + Utilice la CLI para especificar los destinos de grabación, los formatos de archivos de audio y los nombres de los archivos de audio. **Topics** + [ ## Ejecutar una configuración e iniciar una canalización ](#cli-run-config) + [ ## Establecer destinos, nombres y formatos ](#cli-set-buckets-formats) ## Ejecutar una configuración e iniciar una canalización Utilice el siguiente comando para ejecutar una configuración e iniciar una canalización de información multimedia. El archivo pipeline.json contiene los ajustes de configuración. ``` aws chime-sdk-media-pipeline create-media-insights-pipeline --cli-input-json file://pipeline.json ``` El siguiente ejemplo muestra un archivo `pipeline.json` típico. ``` { "MediaInsightsPipelineConfigurationArn": arn:aws:chime:region;account_id:media-insights-pipeline-configuration/MyConfiguration, "KinesisVideoStreamRecordingSourceRuntimeConfiguration": { "Streams": [ { "StreamArn": kinesis_video_stream_arn_1 }, { "StreamArn": kinesis_video_stream_arn_2 } ], "FragmentSelector": { "FragmentSelectorType": "selector_type", // Specify "server_timestamp" or "producer_timestamp" as the fragment selector type "TimestampRange": { "StartTimestamp": epoch_time_seconds, "EndTimestamp": epoch_time_seconds } } }, "S3RecordingSinkRuntimeConfiguration": { "Destination": arn:aws:s3:::bucket_name/prefix/optional_file_name, "RecordingFileFormat": file_format // Specify "Opus" or "WAV" as the recording file format, if you want to override the configuration } } ``` `MediaInsightsPipelineConfigurationArn` es el ARN de configuración que recibe después de crear una configuración de análisis de llamadas. ## Establecer destinos, nombres y formatos En el siguiente ejemplo, se utiliza una carpeta denominada `MyRecordingBucket` como valor de `S3SinkConfiguration.Destination` y `Opus` como valor de `RecordingFileFormat`. ``` arn:aws:s3:::MyRecordingBucket/voice-connector-id/transaction-id_year-month-date-hour-minute-second-millisecond.ogg ``` El siguiente ejemplo usa `MyRecordingBucket` como el valor de `S3SinkConfiguration.Destination` y `Wav` como el valor de `RecordingFileFormat`. ``` arn:aws:s3:::MyRecordingBucket/voice-connector-id/transaction-id_year-month-date-hour-minute-second-millisecond.wav ``` # Descripción de los flujos de trabajo de las analíticas basadas en el machine learning para el Amazon Chime SDK Descripción de flujos de trabajo para análisis basados en el machine learning En las secciones siguientes se describe cómo utilizar las características de análisis de machine learning que proporciona el análisis de llamadas de Amazon Chime SDK. **nota** Si planea ejecutar varios análisis de machine learning en la misma transmisión de video de Kinesis, es posible que necesite aumentar el límite de nivel de conexión para `GetMedia` y para la transmisión de video de `GetMediaForFragmentList`. Para obtener más información, consulte [Límites de descuencias de Kinesis Video Streams](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html) en la *Guía para desarrolladores de Kinesis Video Streams*. # Uso de Voice Connectors para iniciar automáticamente el análisis de llamadas Utilice este flujo de trabajo cuando: + Desea una configuración basada en una consola. + Ya usa o planea usar un Voice Connector para incorporar los medios SIP al análisis de llamadas. Los Voice Connectors son compatibles con SIP y SIPREC. Para obtener más información sobre la configuración de los Voice Connectors, consulte [Administración de Amazon Chime SDK Voice Connector](https://docs.aws.amazon.com/chime-sdk/latest/ag/voice-connectors.html). + Desea aplicar la misma configuración de Media Insights a todas las llamadas de Voice Connector. + Debe usar el análisis de voz de Amazon Chime SDK, que requiere un Voice Connector o una canalización de información multimedia. Para habilitar este flujo de trabajo en la consola de Amazon Chime SDK, siga los pasos para crear una configuración de grabación en [Configuración de Voice Connectors para utilizar el análisis de llamadas](https://docs.aws.amazon.com/chime-sdk/latest/ag/configure-voicecon.html). Para habilitar este flujo de trabajo mediante programación, utilice lo siguiente APIs: [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html)API para crear una configuración de análisis de llamadas y, a continuación, asocie la configuración a un conector de voz mediante la [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html)API. Para obtener más información, consulte [Configuración de Voice Connectors para usar análisis de voz](https://docs.aws.amazon.com/chime-sdk/latest/ag/configure-voicecon.html) en la *Guía del administrador de Amazon Chime SDK*. El siguiente diagrama muestra el flujo de datos cuando un Voice Connector inicia una sesión de análisis de llamadas. Los números del diagrama corresponden al texto numerado que aparece a continuación. ![\[Image showing the flow of data when a Voice Connector initiates a call.\]](http://docs.aws.amazon.com/es_es/chime-sdk/latest/dg/images/call-analytics-workflow-1.png) En el diagrama: 1. Para crear una configuración de canalización de Media Insights, utilice la consola de Amazon Chime SDK o la API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html). 1. Utilice la consola de Amazon Chime SDK o la API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html) para asociar la configuración a un Voice Connector. Para asociar una configuración existente a un Voice Connectors, consulte [Configuración de Voice Connectors para utilizar el análisis de llamadas](https://docs.aws.amazon.com/chime-sdk/latest/ag/configure-voicecon.html), en la *Guía del administrador de Amazon Chime SDK*. 1. Durante una llamada saliente, el Voice Connector recibe el audio de cada participante de la llamada. 1. Gracias a la integración integrada con el análisis de llamadas, si una configuración de análisis de llamadas está conectada a un Voice Connector, el servicio Voice Connector inicia una sesión de análisis de llamadas mediante el servicio de canalización de medios. 1. El servicio de canalización de medios invoca uno o más procesadores multimedia, tal y como se especifica en la configuración. 1. El servicio de canalización de medios envía los datos de salida a uno o más destinos en función de la configuración. Por ejemplo, puede enviar análisis en tiempo real a través de Amazon Kinesis Data Streams y, si está configurado, puede enviar los metadatos y análisis de la llamada a un almacenamiento de datos de Amazon S3. 1. El servicio Media Pipeline envía los eventos de estado de la canalización a Amazon por defecto EventBridge. Si has configurado reglas, las notificaciones correspondientes también se enviarán EventBridge a Amazon. Para obtener más información, consulta Cómo [usar EventBridge las notificaciones](https://docs.aws.amazon.com/chime-sdk/latest/dg/ca-eventbridge-notifications.html). **nota** Un procesador de análisis de voz solo se inicia automáticamente cuando llamas al [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html)quirófano [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StartVoiceToneAnalysisTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StartVoiceToneAnalysisTask.html) APIs. Debe habilitar la transmisión por Voice Connector para utilizar el análisis de llamadas con Voice Connector. Esta característica permite la transmisión de los datos de las llamadas a las transmisiones de Kinesis Video Streams gestionadas por Voice Connector en su cuenta. Para obtener más información, consulte [Transmisión de contenido multimedia del Voice Connector de Amazon Chime SDK a Kinesis Video Streams](https://docs.aws.amazon.com/chime-sdk/latest/ag/start-kinesis-vc.html) en la *Guía del administrador de Amazon Chime SDK.* Puede almacenar los datos de llamadas de Voice Connector en Kinesis Video Streams durante períodos de tiempo variables, desde horas hasta años. La opción de no retener datos limita la usabilidad de los datos de las llamadas para su consumo inmediato. El costo de Kinesis Video Streams se determina en función del ancho de banda y el almacenamiento total utilizados. Es posible ajustar el período de retención de datos en cualquier momento editando la configuración de transmisión de su Voice Connector. Para habilitar el registro de análisis de llamadas, debe asegurarse de que Kinesis Video Stream conserve los datos hasta que finalice el análisis de llamadas. Para ello, especifique un período de retención de datos adecuado. Puede asociar una configuración de canalización de información multimedia a tantos Voice Connectors como desee. También puede crear una configuración diferente para cada Voice Connector. Los conectores de voz lo utilizan AWSService RoleForAmazonChimeVoiceConnector para llamar a la [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html)API en su nombre una vez por ID de transacción. Para obtener información sobre el rol, consulte [Uso del rol vinculado al servicio de Amazon Chime SDK para los Voice Connectors de Amazon Chime SDK](https://docs.aws.amazon.com/chime-sdk/latest/ag/using-service-linked-roles-stream.html#service-linked-role-permissions-stream) en la *Guía del administrador de Amazon Chime SDK*. # Uso del análisis de llamadas APIs con conectores de voz Utilice este flujo de trabajo si utiliza un Voice Connector pero necesita controlar cuándo aplicar una configuración de análisis de llamadas y a qué llamada aplicar la configuración. Para usar este método, debe crear un EventBridge objetivo para los eventos que publica Voice Connector y, a continuación, usar los eventos para activar el proceso APIs de análisis de llamadas. Para obtener más información, consulte [Automatización del SDK de Amazon Chime EventBridge con la Guía del administrador del SDK](https://docs.aws.amazon.com/chime-sdk/latest/ag/automating-chime-with-cloudwatch-events.html) de *Amazon Chime*. En el siguiente diagrama, se muestra cómo implementar un control más detallado al utilizar el análisis de llamadas con Voice Connector. Los números del diagrama corresponden a los números del texto siguiente. ![\[Imagen que muestra el flujo de datos cuando se utilizan llamadas a la API con Voice Connectors.\]](http://docs.aws.amazon.com/es_es/chime-sdk/latest/dg/images/analytics-vc-with-apis.png) En el diagrama: 1. Para crear una configuración de canalización de Media Insights, utilice la consola de Amazon Chime SDK o la API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html). 1. Durante una llamada saliente, el Voice Connector recibirá el audio de los participantes. 1. El conector de voz envía el audio de la llamada a Kinesis Video Stream y los eventos correspondientes a. EventBridge Estos eventos tienen metadatos de transmisión y llamadas. 1. La suscripción a su aplicación se realiza a EventBridge través de un EventBridge Target. 1. La aplicación invoca la API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html) de Amazon Chime SDK. 1. El servicio de canalización de medios invoca uno o más procesadores multimedia en función de los elementos del procesador de la configuración de la canalización de información multimedia. 1. El servicio de canalización de medios envía los datos de salida a uno o más destinos en función de la configuración. El análisis de llamadas de Amazon Chime SDK proporcionará análisis en tiempo real a través de Amazon Kinesis Data Streams y, si está configurado, realizará análisis de metadatos de llamadas a un almacenamiento de datos de Amazon S3. 1. El servicio Media Pipeline envía los eventos a Amazon EventBridge. Si has configurado reglas, las notificaciones correspondientes también se enviarán EventBridge a Amazon. 1. Puede pausar o reanudar la sesión de análisis de llamadas invocando la API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_UpdateMediaInsightsPipelineStatus.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_UpdateMediaInsightsPipelineStatus.html). **nota** La grabación de llamadas no permite pausar ni reanudar las llamadas. Además, las tareas de análisis de voz iniciadas para la llamada también se detienen al pausar una sesión. Para reiniciarlos, debe llamar al [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html)quirófano [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartVoiceToneAnalysisTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartVoiceToneAnalysisTask.html) APIs. 1. Si selecciona el análisis del tono de voz durante la configuración, para iniciar el análisis de voz, llame al [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html)quirófano [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartVoiceToneAnalysisTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartVoiceToneAnalysisTask.html) APIs. # Uso del análisis de llamadas con productores de Kinesis Video Streams Para usar esta opción, debe publicar los datos de audio en Kinesis Video Streams (KVS) y, a continuación, llamar a la API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html) con la información del canal de transmisión KVS. **nota** El análisis de llamadas APIs admite un máximo de dos canales de audio. Al llamar a la API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html), puede especificar los números de fragmento para cada definición de canal de transmisión KVS. Si proporciona un número de fragmento, Call Analytics comienza a procesar la transmisión en ese fragmento. De lo contrario, el análisis de llamadas comienza a procesar la transmisión desde el último fragmento disponible. El análisis de llamadas admite audio PCM (solo formatos de audio little-endian de 16 bits firmados, que no incluyen WAV) con una frecuencia de muestreo de audio entre 8 kHz y 48 kHz. El audio de baja calidad, como el audio de telefonía, suele rondar los 8000 Hz. El audio de alta calidad suele oscilar entre 16 000 Hz y 48 000 Hz. La frecuencia de muestreo que especifique debe coincidir con la del audio. Para obtener más información, consulte [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_KinesisVideoStreamSourceRuntimeConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_KinesisVideoStreamSourceRuntimeConfiguration.html) en la *Referencia de la API de Amazon Chime SDK*. El SDK para productores de Kinesis Video Streams proporciona un conjunto de bibliotecas que puede utilizar para transmitir datos de audio a un Kinesis Video Stream. Para obtener más información, consulte [Bibliotecas de productores de Kinesis Video Streams](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/producer-sdk.html) en la *Guía para desarrolladores de Amazon Kinesis Video Streams*. El siguiente diagrama muestra el flujo de datos cuando se utiliza el análisis de llamadas con un productor de Kinesis Video Stream personalizado. Los números del diagrama corresponden al texto numerado que aparece a continuación. ![\[Imagen que muestra el flujo de datos cuando se utiliza el análisis de llamadas con un productor de Kinesis Video Stream.\]](http://docs.aws.amazon.com/es_es/chime-sdk/latest/dg/images/analytics-kvs-with-apis.png) 1. Utiliza la AWS consola o la [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html)API para crear una configuración de canalización de Media Insights. 1. Utilice un productor de Kinesis Video Stream para escribir audio en Kinesis Video Streams. 1. La aplicación invoca a la API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html). 1. El servicio de canalización de medios lee el audio de las transmisiones de Kinesis Video Streams del cliente. 1. El servicio Media Pipeline envía los eventos a Amazon EventBridge. Si has configurado reglas, las notificaciones correspondientes también se enviarán EventBridge a Amazon. 1. El servicio de canalización de medios invoca uno o más elementos del procesador. 1. El servicio de canalización de medios envía los datos de salida a uno o más elementos receptores. 1. Puede pausar o reanudar la sesión de análisis de llamadas invocando la API [ UpdateMediaInsightsPipelineStatus](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_UpdateMediaInsightsPipelineStatus.html). **nota** La grabación de llamadas no admite pausas ni reanudaciones. 1. Tu aplicación puede procesar los EventBridge eventos de Amazon para activar flujos de trabajo empresariales personalizados. 1. Si seleccionas el análisis de voz al crear una configuración, tu aplicación puede iniciar el análisis de voz llamando al [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html)o [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartVoiceToneAnalysisTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartVoiceToneAnalysisTask.html) APIs.