Flujos de trabajo para grabar llamadas - Amazon Chime SDK

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.

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.

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, 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 las siguientes API de Amazon Chime SDK.

Para obtener más información, consulte Configuración de Voice Connectors para utilizar el análisis de llamadas 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.

En el diagrama:

  1. Utilice la consola del SDK de Amazon Chime o la CreateMediaInsightsPipelineConfigurationAPI 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 en la Guía del administrador de Amazon Chime SDK.

  2. Utiliza la consola del SDK de Amazon Chime o la PutVoiceConnectorStreamingConfigurationAPI para asociar la configuración a un conector de voz. Para usar la consola, consulte Configuración de Voice Connectors para usar el análisis de llamadas.

  3. Durante una llamada saliente, el Voice Connector recibe el audio de cada participante de la llamada.

  4. 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.

  5. El servicio de canalización de medios inicia el procesador de grabación de llamadas que supervisa la llamada en curso.

  6. 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 Tablas de catálogos de datos de  Glue, más adelante en esta sección.

  7. 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 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 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 AWSServiceRoleForAmazonChimeVoiceConnector para llamar a la CreateMediaInsightsPipelineAPI 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 en la Guía del administrador de Amazon Chime SDK.

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 CreateMediaInsightsPipelinela API con la información del canal de transmisión de KVS y un ARN de configuración de análisis de llamadas.

nota

Las API de análisis de llamadas admiten un máximo de dos canales de audio. También puede 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 CreateMediaInsightsPipelineAPI, puede elegir si desea especificar o no los números de fragmento para cada definición de canal de transmisión 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.

En el diagrama:

  1. Puede usar la consola del SDK de Amazon Chime o la CreateMediaInsightsPipelineConfigurationAPI para crear una configuración de grabación de llamadas.

  2. Use el AWS SDK para crear una aplicación que inserte audio externo en KVS o habilite 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 en la Guía del administrador de Amazon Chime SDK.

  3. Si la transmisión mediante Voice Connector está habilitada, el servicio Voice Connector envía las notificaciones de forma predeterminada. EventBridge

  4. 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.

  5. Una vez que la aplicación tenga la información de audio de los eventos de streaming de Voice Connector o de una fuente externa, invocará la API del SDK de Amazon Chime CreateMediaInsightsPipeline.

  6. El servicio de canalización de medios inicia el procesador de grabación de llamadas que supervisa la llamada en curso.

  7. 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.

  8. 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 Tablas de catálogos de datos de  Glue, más adelante en esta sección.

  9. 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 en esta guía.

  10. Para finalizar la grabación, llama a la DeleteMediaPipelineAPI para finalizar la grabación de la llamada.

Para ver ejemplos y grabaciones basadas en API, consulte Receptor de grabación de Amazon S3 en esta guía.

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 el CreateMediaInsightsPipeline.

  • Utilice la CLI para especificar los destinos de grabación, los formatos de archivos de audio y los nombres de los archivos de audio.

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