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.
# Utilización Amazon EventBridge por Amazon Transcribe
Con Amazon EventBridgeél, puede responder a los cambios de estado en sus Amazon Transcribe trabajos iniciando eventos en otros Servicios de AWS. Cuando un trabajo de transcripción cambia de estado, envía EventBridge automáticamente un evento a una transmisión de eventos. Puede crear reglas que establezcan los eventos que desee monitorizar en la secuencia de eventos y la acción que EventBridge debe realizar cuando se produzcan dichos eventos. Por ejemplo, el evento puede direccionarse a otro servicio (o destino), que a su vez realizará una acción. Podría, por ejemplo, configurar una regla para enrutar un evento a una AWS Lambda función cuando un trabajo de transcripción se haya completado correctamente. Para definir las [reglas EventBridge](#defining-rules), consulte las siguientes secciones.
Puede recibir notificaciones de eventos a través de varios canales, como correo electrónico, notificaciones por chat de [Amazon Q Developer en aplicaciones de chat](https://docs.aws.amazon.com/chatbot/latest/adminguide/what-is.html) o notificaciones push de [AWS Console Mobile Application](https://docs.aws.amazon.com/consolemobileapp/latest/userguide/what-is-consolemobileapp.html). También puede ver las notificaciones en el [Centro de notificaciones de la consola](https://console.aws.amazon.com/notifications/). Si quieres configurar las notificaciones, puedes usar [AWS User Notifications](https://docs.aws.amazon.com/notifications/latest/userguide/what-is.html). AWS User Notifications admite la agregación, lo que puede reducir la cantidad de notificaciones que recibe durante eventos específicos.
## Definir EventBridge reglas
Para definir EventBridge reglas, utilice la [Consola de administración de AWS](https://console.aws.amazon.com/events). Al definir una regla, utilice Amazon Transcribe como nombre del servicio. Para ver un ejemplo de cómo crear una EventBridge regla, consulte [Amazon EventBridge reglas](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html).
Antes de usarla EventBridge, tenga en cuenta las siguientes definiciones:
+ **Evento**: un evento indica un cambio en el estado de uno de sus trabajos de transcripción. Por ejemplo, cuando el valor de `TranscriptionJobStatus` de un trabajo cambia de `IN_PROGRESS` a `COMPLETED`.
+ **Objetivo**: un objetivo es otro Servicio de AWS que procesa un evento. Por ejemplo, AWS Lambda o Amazon Simple Notification Service (Amazon SNS). Un destino recibe eventos en formato JSON.
+ **Regla**: una regla hace coincidir los eventos entrantes que EventBridge desea observar y los dirige a uno o varios objetivos para su procesamiento. Si una regla dirige un evento a varios destinos, todos los destinos procesarán el evento en paralelo. Las reglas pueden personalizar el JSON enviado al destino.
Amazon EventBridge los eventos se emiten en función del mejor esfuerzo posible. Para obtener más información sobre la creación y la gestión de eventos en EventBridge, consulte [Amazon EventBridge los eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) en la *Guía del Amazon EventBridge usuario*.
A continuación se muestra un ejemplo de una EventBridge regla Amazon Transcribe que se inicia cuando el estado de un trabajo de transcripción cambia a `COMPLETED` o`FAILED`.
```
{
"source": [
"aws.transcribe"
],
"detail-type": [
"Transcribe Job State Change"
],
"detail": {
"TranscriptionJobStatus": [
"COMPLETED",
"FAILED"
]
}
}
```
La regla contiene los siguientes campos:
+ `source`: origen del evento. Porque Amazon Transcribe esto es siempre`aws.transcribe`.
+ `detail-type`: un identificador de los detalles del evento. En Amazon Transcribe, este siempre es `Transcribe Job State Change`.
+ `detail`: el nuevo estado laboral del trabajo de transcripción. En este ejemplo, la regla iniciará un evento cuando el estado del trabajo cambie a `COMPLETED` o `FAILED`.
## Amazon Transcribe eventos
Amazon EventBridge registra varios Amazon Transcribe eventos:
+ [Transcripción de eventos de trabajo](#job-event)
+ [Eventos de identificación del idioma](#lang-id-event)
+ [Eventos de Call Analytics](#analytics-event)
+ [Eventos posteriores a la llamada de Call Analytics](#analytics-stream-event)
+ [Eventos de vocabulario](#vocab-event)
Todos estos eventos contienen los siguientes campos compartidos:
+ `version`: la versión de los datos del evento. Este valor siempre es `0`.
+ `id`: un identificador único generado EventBridge por el evento.
+ `detail-type`: un identificador de los detalles del evento. Por ejemplo, `Transcribe Job State Change`.
+ `source`: el origen del evento. Porque Amazon Transcribe esto es siempre`aws.transcribe`.
+ `account`: El Cuenta de AWS ID de la cuenta que generó la llamada a la API.
+ `time`: la fecha y la hora en que se entrega el evento.
+ `region`: el lugar Región de AWS en el que se realiza la solicitud.
+ `resources`: los recursos utilizados por la llamada a la API. Para Amazon Transcribe, este campo siempre está vacío.
+ `detail`: detalles adicionales sobre el evento.
+ `FailureReason`: este campo está presente si el estado o condición cambia a `FAILED`, y describe el motivo del estado o condición `FAILED`.
+ Cada tipo de evento tiene campos únicos adicionales que se muestran debajo de `detail`. Estos campos únicos se definen en las siguientes secciones después de cada ejemplo de evento.
### Transcripción de eventos de trabajo
Cuando el estado de un trabajo cambia de `IN_PROGRESS` a `COMPLETED` o`FAILED`, Amazon Transcribe genera un evento. Para identificar el trabajo que cambió de estado e inició el evento en el destino, utilice el campo del evento `TranscriptionJobName`. Un Amazon Transcribe evento contiene la siguiente información. Se agrega un campo `FailureReason` debajo de `detail` si el estado de su trabajo de transcripción es `FAILED`.
Tenga en cuenta que este evento sólo se aplica a la operación [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html) de la API.
```
{
"version": "0",
"id": "{{event ID}}",
"detail-type":"Transcribe Job State Change",
"source": "aws.transcribe",
"account": "{{111122223333}}",
"time": "{{timestamp}}",
"region": "{{us-west-2}}",
"resources": [],
"detail": {
"TranscriptionJobName": "{{my-first-transcription-job}}",
"TranscriptionJobStatus": "{{COMPLETED}}" (or "{{FAILED}}")
}
}
```
+ `TranscriptionJobName`: el nombre único que eligió para su trabajo de transcripción.
+ `TranscriptionJobStatus `: el estado del trabajo de transcripción. Este valor puede ser `COMPLETED` o `FAILED`.
### Eventos de identificación del idioma
Al activar la [identificación automática del idioma](lang-id.md), Amazon Transcribe genera un evento cuando el estado de identificación del idioma es `COMPLETED` o `FAILED`. Para identificar el trabajo que cambió de estado e inició el evento en el destino, utilice el campo del evento `JobName`. Los eventos de Amazon Transcribe contienen la siguiente información: Se agrega un campo `FailureReason` debajo de `detail` si el estado de identificación del idioma es `FAILED`.
Tenga en cuenta que este evento sólo se aplica a la operación de la API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html) cuando se incluye el parámetro [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_LanguageIdSettings.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_LanguageIdSettings.html).
```
{
"version": "0",
"id": "{{event ID}}",
"detail-type": "Language Identification State Change",
"source": "aws.transcribe",
"account": "{{111122223333}}",
"time": "{{timestamp}}",
"region": "{{us-west-2}}",
"resources": [],
"detail": {
"JobType": "TranscriptionJob",
"JobName": "{{my-first-lang-id-job}}",
"LanguageIdentificationStatus": "{{COMPLETED}}" (or "{{FAILED}}")
}
}
```
+ `JobType`: para los trabajos de transcripción, este valor debe ser `TranscriptionJob`.
+ `JobName`: el nombre único de su trabajo de transcripción.
+ `LanguageIdentificationStatus`: el estado de la identificación del idioma en un trabajo de transcripción. Este valor puede ser `COMPLETED` o `FAILED`.
### Eventos de Call Analytics
Cuando el estado de un trabajo de [Call Analytics](call-analytics.md) cambia de `IN_PROGRESS` a `COMPLETED` o `FAILED`, Amazon Transcribe genera un evento. Para identificar el trabajo de Call Analytics que cambió de estado e inició el evento en el destino, utilice el campo `JobName` del evento. Los eventos de Amazon Transcribe contienen la siguiente información: Se agrega un campo `FailureReason` debajo de `detail` si el estado del trabajo de Call Analytics es `FAILED`.
Tenga en cuenta que este evento sólo se aplica a la operación [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartCallAnalyticsJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartCallAnalyticsJob.html) de la API.
```
{
"version": "0",
"id": "{{event ID}}",
"detail-type": "Call Analytics Job State Change",
"source": "aws.transcribe",
"account": "{{111122223333}}",
"time": "{{timestamp}}",
"region": "{{us-west-2}}",
"resources": [],
"detail": {
"JobName": "{{my-first-analytics-job}}",
"JobStatus": "{{COMPLETED}}" (or "{{FAILED}}"),
"FailureReason": "{{failure reason}}", // only present when JobStatus is FAILED
"AnalyticsJobDetails": { // only when you enable optional features such as Generative Call Summarization
"Skipped": []
}
}
}
```
+ `JobName`: el nombre exclusivo de su trabajo de transcripción de Call Analytics.
+ `JobStatus`: el estado de su trabajo de transcripción de Call Analytics. Puede ser `COMPLETED` o `FAILED`.
+ `FailureReason`: este campo solo está presente cuando el `JobStatus` es `FAILED` y describe el motivo del error.
+ `AnalyticsJobDetails`: los detalles de su trabajo de transcripción de Call Analytics, incluida la información sobre las características de análisis omitidas.
### Eventos posteriores a la llamada de Call Analytics
Cuando una transcripción de [análisis posterior a la llamada](tca-post-call.md) cambia de estado de `IN_PROGRESS` a `COMPLETED` o `FAILED`, Amazon Transcribe genera un evento. Para identificar el trabajo de Call Analytics posterior a la llamada que cambió de estado e inició el evento en el destino, utilice el campo `StreamingSessionId` del evento.
Tenga en cuenta que este evento sólo se aplica a la operación de la API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartCallAnalyticsStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartCallAnalyticsStreamTranscription.html) cuando se incluye el parámetro [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_PostCallAnalyticsSettings.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_PostCallAnalyticsSettings.html).
Un evento `COMPLETED` contiene la siguiente información:
```
{
"version": "0",
"id": "{{event ID}}",
"detail-type": "Call Analytics Post Call Job State Change",
"source": "aws.transcribe",
"account": "{{111122223333}}",
"time": "{{timestamp}}",
"region": "{{us-west-2}}",
"resources": [],
"detail": {
"StreamingSessionId": "{{session-id}}",
"PostCallStatus": "{{COMPLETED}}",
"Transcript": {
"RedactedTranscriptFileUri": "s3://{{amzn-s3-demo-bucket}}/{{my-output-files}}/{{my-redacted-file}}.JSON",
"TranscriptFileUri": "s3://{{amzn-s3-demo-bucket}}/{{my-output-files}}/{{my-file}}.JSON"
},
"Media": {
"MediaFileUri": "s3://{{amzn-s3-demo-bucket}}/{{my-output-files}}/{{my-redacted-file}}.WAV",
"RedactedMediaFileUri": "s3://{{amzn-s3-demo-bucket}}/{{my-output-files}}/{{my-redacted-file}}.WAV"
}
}
}
```
Un evento `FAILED` contiene la siguiente información:
```
{
"version": "0",
"id": "{{event ID}}",
"detail-type": "Call Analytics Post Call Job State Change",
"source": "aws.transcribe",
"account": "{{111122223333}}",
"time": "{{timestamp}}",
"region": "{{us-west-2}}",
"resources": [],
"detail": {
"StreamingSessionId": "{{session-id}}",
"PostCallStatus": "{{FAILED}}"
}
}
```
+ `StreamingSessionId`: el número de identificación asignado a su solicitud de transcripción de Call Analytics en tiempo real.
+ `PostCallStatus`: el estado de su trabajo de transcripción de Call Analytics posterior a la llamada. Puede ser `COMPLETED` o `FAILED`.
+ `Transcript`: el URI de sus transcripciones redactadas y no redactadas.
+ `Media`: el URI de sus archivos de audio redactados y no redactados.
### AWS HealthScribe eventos de análisis posteriores a la transmisión
Cuando un estado cambia en una operación de análisis AWS HealthScribe posterior a la transmisión, como [ClinicalNoteGenerationResult](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_ClinicalNoteGenerationResult.html)cambiar de `IN_PROGRESS` a`COMPLETED`, se AWS HealthScribe genera un evento con la siguiente información:
```
{
"version":"0",
"id":"event ID",
"detail-type":"MedicalScribe Post Stream Analytics Update",
"source":"aws.transcribe",
"account":"111122223333",
"time":"timestamp",
"region":"us-east-1",
"resources":[],
"detail":{
"SessionId": ,
"UpdateType": "ClinicalNoteGenerationResult",
"ClinicalNoteGenerationResult": {
"ClinicalNoteOutputLocation": s3://{{amzn-s3-demo-bucket}}/{{clinical-note-output-files}}/{{clinical-notes}}.JSON,
"TranscriptOutputLocation": s3://{{amzn-s3-demo-bucket}}/{{my-output-files}}/{{my-file}}.JSON,
"Status": ,
"FailureReason":
}
}
}
```
+ `UpdateType`: el tipo de operación de análisis posterior a la transmisión que generó el evento. El contenido del objeto resultante varía en función del `UpdateType`.
+ `SessionId`: el número de identificación de tu AWS HealthScribe transmisión. Use este ID para identificar la sesión de transmisión de origen y, a continuación, busque los análisis posteriores a la transmisión que generaron el evento.
+ `Status`: el estado de la operación de análisis posterior a la transmisión. Este valor puede ser `IN_PROGRESS`, `COMPLETED` o `FAILED`.
+ `ClinicalNoteOutputLocation`: el URI del bucket Amazon S3 de salida para `ClinicalNoteGenerationResult`.
+ `TranscriptOutputLocation`: el URI de su transcripción.
### Eventos de vocabulario
Cuando el estado de un [vocabulario personalizado](custom-vocabulary.md) cambia de `PENDING` a `READY` o`FAILED`, se Amazon Transcribe genera un evento. Para identificar el vocabulario personalizado que cambió de estado e inició el evento en el destino, utilice el campo `VocabularyName` del evento. Un Amazon Transcribe evento contiene la siguiente información. Se agrega un campo `FailureReason` debajo de `detail` si el estado de su vocabulario personalizado es `FAILED`.
**nota**
Este evento solo se aplica a la operación [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html) de la API.
```
{
"version": "0",
"id": "{{event ID}}",
"detail-type": "Vocabulary State Change",
"source": "aws.transcribe",
"account": "{{111122223333}}",
"time": "{{timestamp}}",
"region": "{{us-west-2}}",
"resources": [],
"detail": {
"VocabularyName": "{{unique-vocabulary-name}}",
"VocabularyState": "{{READY}}" (or "{{FAILED}}")
}
}
```
+ `VocabularyName`: el nombre exclusivo de su vocabulario personalizado.
+ `VocabularyState`: el estado de procesamiento de su vocabulario personalizado. Este valor puede ser `READY` o `FAILED`.