Iniciar una transcripción Call Analytics en tiempo real - Amazon Transcribe

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.

Iniciar una transcripción Call Analytics en tiempo real

Antes de iniciar una transcripción de Call Analytics en tiempo real, debe crear todas las categorías que Amazon Transcribe desee que coincidan en su llamada.

nota

Las transcripciones de Call Analytics no se pueden asociar retroactivamente a nuevas categorías. Sólo las categorías que cree antes de iniciar una transcripción de Call Analytics se pueden aplicar a esa salida de transcripción.

Si ha creado una o más categorías y su audio coincide con todas las reglas dentro de al menos una de sus categorías, Amazon Transcribe marca su salida con las categorías coincidentes. Si decide no usar categorías o si su audio no coincide con las reglas especificadas en sus categorías, la transcripción no aparecerá marcada.

Para incluir los análisis posteriores a sus llamadas en la transcripción de Call Analytics en tiempo real, debe incluir un bucket Amazon S3 en su solicitud mediante el parámetro OutputLocation. También debe incluir un DataAccessRoleArn que tenga permisos de escritura en el bucket especificado. Al finalizar la sesión de streaming de Call Analytics en tiempo real, se genera una transcripción independiente que se almacena en el bucket especificado.

Con Call Analytics en tiempo real, también tiene la opción de crear alertas de categorías en tiempo real; consulte Crear alertas en tiempo real para las coincidencias de categorías para obtener instrucciones.

Para iniciar una transcripción de Call Analytics en tiempo real AWS Management Console, puedes usar HTTP/2 o bien WebSockets, consulta los siguientes ejemplos:

importante

Actualmente, AWS Management Console solo ofrece una demostración del análisis de llamadas en tiempo real con ejemplos de audio precargados. Si quieres usar tu propio audio, debes usar la API (HTTP/2 o un SDK). WebSockets

Utilice el siguiente procedimiento para iniciar una solicitud de Call Analytics. Las llamadas que coinciden con todas las características definidas por una categoría se etiquetan con esa categoría.

nota

Sólo hay una demostración disponible en AWS Management Console. Para iniciar una transcripción analítica personalizada en tiempo real, debe utilizar la API.

  1. En el panel de navegación, en Análisis de Amazon Transcribe llamadas, selecciona Analizar una llamada en tiempo real.

    Amazon Transcribe captura de pantalla de la consola: la página de demostración de «analizar una llamada en streaming».
  2. En el Paso 1: especifique el audio de entrada, elija un archivo de prueba de demostración en el menú desplegable.

    Amazon Transcribe captura de pantalla de la consola: una selección desplegable para el audio de entrada de la demo.
  3. En el Paso 2: revise las categorías de llamadas, tiene la opción de revisar las categorías de análisis de llamadas en tiempo real que creo anteriormente. Todas las categorías de Call Analytics en tiempo real se aplican a la transcripción.

    Al seleccionar Ver categorías, se abre un nuevo panel que muestra las categorías de Call Analytics en tiempo real existentes y proporciona un enlace para crear otras nuevas.

    Amazon Transcribe captura de pantalla de la consola: la página de «categorías de análisis de llamadas».
  4. En el Paso 3: configurar la entrada y la salida, tiene la opción de aplicar ajustes adicionales.

    Si selecciona Configurar ajustes avanzados, se abre un nuevo panel en el que puede especificar los ajustes de redacción de contenido.

    Amazon Transcribe captura de pantalla de la consola: los paneles de configuración avanzada están todos colapsados.

    Una vez que haya hecho todas sus selecciones, elija Guardar para volver a la página principal.

  5. Para aplicar análisis adicionales, active el Análisis posterior a la llamada. De este modo, dispondrá de los mismos datos analíticos que una transcripción de los análisis posteriores a una llamada: interrupciones, volumen, tiempo de inactividad, velocidad de conversación, tiempo de conversación, problemas, acciones y resultados. Los resultados del análisis posterior a la llamada se almacenan en un archivo independiente de su transcripción de Call Analytics en tiempo real.

    Amazon Transcribe captura de pantalla de la consola: el panel de análisis posterior a la llamada, colapsado.

    Si aplicas análisis posteriores a la llamada, debes especificar un destino para el archivo Amazon S3 de salida y una IAM función. Si lo desea, puede cifrar el resultado.

    Amazon Transcribe captura de pantalla de la consola: el panel de análisis posterior a la llamada, ampliado.
  6. Elija Comenzar streaming.

En este ejemplo, se crea una solicitud HTTP/2 con Call Analytics activado. Para obtener más información sobre el uso de la transmisión mediante HTTP/2 Amazon Transcribe, consulte. Configuración de una secuencia HTTP/2 Para obtener más información sobre los parámetros y encabezados específicos de Amazon Transcribe, consulte. StartCallAnalyticsStreamTranscription

En este ejemplo se incluyen los análisis posteriores a la llamada. Si no desea realizar análisis posteriores a la llamada, elimine la sección PostCallAnalyticsSettings de la solicitud.

Tenga en cuenta que el evento de configuración que se muestra en el siguiente ejemplo debe pasarse como el primer evento de la secuencia.

POST /stream-transcription HTTP/2 host: transcribestreaming.us-west-2.amazonaws.com X-Amz-Target: com.amazonaws.transcribe.Transcribe.StartCallAnalyticsStreamTranscription Content-Type: application/vnd.amazon.eventstream X-Amz-Content-Sha256: string X-Amz-Date: 20220208T235959Z Authorization: AWS4-HMAC-SHA256 Credential=access-key/20220208/us-west-2/transcribe/aws4_request, SignedHeaders=content-type;host;x-amz-content-sha256;x-amz-date;x-amz-target;x-amz-security-token, Signature=string x-amzn-transcribe-language-code: en-US x-amzn-transcribe-media-encoding: flac x-amzn-transcribe-sample-rate: 16000 transfer-encoding: chunked { "AudioStream": { "AudioEvent": { "AudioChunk": blob }, "ConfigurationEvent": { "ChannelDefinitions": [ { "ChannelId": 0, "ParticipantRole": "AGENT" }, { "ChannelId": 1, "ParticipantRole": "CUSTOMER" } ], "PostCallAnalyticsSettings": { "OutputLocation": "s3://DOC-EXAMPLE-BUCKET/my-output-files/", "DataAccessRoleArn": "arn:aws:iam::111122223333:role/ExampleRole" } } } }

Las definiciones de los parámetros se encuentran en la referencia de la API; los parámetros comunes a todas las operaciones de la AWS API se enumeran en la sección Parámetros comunes.

En este ejemplo, se crea una URL prefirmada que utiliza Call Analytics en una WebSocket transmisión. Se han añadido saltos de línea para facilitar la lectura. Para obtener más información sobre el uso de WebSocket transmisiones con Amazon Transcribe, consulteConfigurar una WebSocket transmisión. Para obtener más información, consulte StartCallAnalyticsStreamTranscription.

En este ejemplo se incluyen los análisis posteriores a la llamada. Si no desea realizar análisis posteriores a la llamada, elimine la sección PostCallAnalyticsSettings de la solicitud.

Tenga en cuenta que el evento de configuración que se muestra en el siguiente ejemplo debe pasarse como el primer evento de la secuencia.

GET wss://transcribestreaming.us-west-2.amazonaws.com:8443/call-analytics-stream-transcription-websocket? &X-Amz-Algorithm=AWS4-HMAC-SHA256 &X-Amz-Credential=AKIAIOSFODNN7EXAMPLE%2F20220208%2Fus-west-2%2Ftranscribe%2Faws4_request &X-Amz-Date=20220208T235959Z &X-Amz-Expires=300 &X-Amz-Security-Token=security-token &X-Amz-Signature=string &X-Amz-SignedHeaders=content-type%3Bhost%3Bx-amz-date &language-code=en-US &media-encoding=flac &sample-rate=16000 { "AudioStream": { "AudioEvent": { "AudioChunk": blob }, "ConfigurationEvent": { "ChannelDefinitions": [ { "ChannelId": 0, "ParticipantRole": "AGENT" }, { "ChannelId": 1, "ParticipantRole": "CUSTOMER" } ], "PostCallAnalyticsSettings": { "OutputLocation": "s3://DOC-EXAMPLE-BUCKET/my-output-files/", "DataAccessRoleArn": "arn:aws:iam::111122223333:role/ExampleRole" } } } }

Las definiciones de los parámetros se encuentran en la referencia de la API; los parámetros comunes a todas las operaciones de la AWS API se enumeran en la sección Parámetros comunes.

sugerencia

El HTTP/2 anterior y WebSocket algunos ejemplos incluyen el análisis posterior a la llamada. Si no desea realizar análisis posteriores a la llamada, elimine la sección PostCallAnalyticsSettings de la solicitud.

Si habilita PostCallAnalyticsSettings, debe enviar un evento de configuración como primer evento. El evento de configuración incluye los ajustes para ChannelDenifitions yPostStreamAnalyticsSettings, como se muestra en los ejemplos anteriores.

Los datos binarios se transmiten como un mensaje binario con content-type application/octet-stream y el evento de configuración se transmite como un mensaje de texto con content-type application/json.

Para obtener más información, consulte Configuración de una transcripción de streaming.

Crear alertas en tiempo real para las coincidencias de categorías

Para configurar alertas en tiempo real, primero debe crear una categoría TranscriptFilterType con la maraca REAL_TIME. Esta marca permite que su categoría se aplique a transcripciones de Call Analytics en tiempo real.

Para obtener instrucciones sobre la creación de una nueva categoría, consulte Crear categorías para transcripciones en tiempo real.

Al iniciar la transcripción de Call Analytics en tiempo real, todas las categorías que tienen la marca REAL_TIME se aplican automáticamente al resultado de la transcripción a nivel de segmento. Si se produce una coincidencia TranscriptFilterType, aparece en la sección CategoryEvent de su transcripción. A continuación, puede utilizar este parámetro y sus subparámetros, MatchedCategories y MatchedDetails, para configurar alertas personalizadas en tiempo real.

Este es un ejemplo del resultado de la transcripción de Call Analytics en tiempo real para una coincidencia CategoryEvent:

"CategoryEvent": { "MatchedCategories": [ "shipping-complaint" ], "MatchedDetails": { "my package never arrived" : { "TimestampRanges": [ { "BeginOffsetMillis": 19010, "EndOffsetMillis": 22690 } ] } } },

El ejemplo anterior representa una coincidencia de texto exacta con la frase “mi pedido nunca llegó”, que representa una regla de la categoría “queja de envío”.

Puede configurar su alerta en tiempo real para que incluya cualquier combinación de los parámetros de la lista. Por ejemplo, puede configurar la alerta para que incluya sólo la frase que coincida (MatchedDetails) o sólo el nombre de la categoría (MatchedCategories). O bien, puede configurar la alerta para que incluya todos los parámetros.

La forma de configurar las alertas en tiempo real depende de las interfaces de su organización y del tipo de alerta que desee. Por ejemplo, puede configurar una coincidencia CategoryEvent para enviar una notificación emergente, un correo electrónico, un mensaje de texto o cualquier otra alerta que su sistema pueda aceptar.