As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Usar o Amazon EventBridge com o Amazon Transcribe
<a name="monitoring-events"></a>

Com o Amazon EventBridge, você pode responder a alterações de estado em seus trabalhos do Amazon Transcribe iniciando eventos em outros Serviços da AWS. Quando um trabalho de transcrição muda de estado, o EventBridge envia automaticamente um evento a um fluxo de eventos. Você pode criar regras que definem os eventos que você deseja monitorar no fluxo de eventos, e a ação que o EventBridge deve executar quando esses eventos ocorrerem. Por exemplo, rotear o evento para outro serviço (ou destino), que pode executar uma ação. Por exemplo, é possível configurar uma regra para rotear um evento para uma função do AWS Lambda quando um trabalho de transcrição for concluído com êxito. Para definir [regras do EventBridge](#defining-rules), consulte as seções a seguir.

É possível receber notificações para eventos por meio de diversos canais, incluindo o e-mail, o [Amazon Q Developer em aplicações de chat](https://docs.aws.amazon.com/chatbot/latest/adminguide/what-is.html), notificações por chat ou notificações push do [AWS Console Mobile Application](https://docs.aws.amazon.com/consolemobileapp/latest/userguide/what-is-consolemobileapp.html). Você também pode ver as notificações na [Central de notificações do console](https://console.aws.amazon.com/notifications/). Se quiser configurar notificações, você poderá usar o [Notificações de Usuários da AWS](https://docs.aws.amazon.com/notifications/latest/userguide/what-is.html). O Notificações de Usuários da AWS permite agregação, o que pode reduzir o número de notificações recebidas durante eventos específicos.

## Definir regras do EventBridge
<a name="defining-rules"></a>

Para definir regras do EventBridge, use o [Console de gerenciamento da AWS](https://console.aws.amazon.com/events). Ao definir uma regra, use o Amazon Transcribe como o nome do serviço. Para ver um exemplo de como criar uma regra do EventBridge, consulte [Amazon EventBridgerules](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html).

Antes de usar o EventBridge, observe as seguintes definições:
+ **Evento**: um evento indica uma alteração no estado de um dos trabalhos de transcrição. Por exemplo, quando o `TranscriptionJobStatus` de um trabalho muda de `IN_PROGRESS` para `COMPLETED`.
+ **Destino**: um destino é outro AWS service (Serviço da AWS) que processa um evento. Por exemplo, o AWS Lambda ou o Amazon Simple Notification Service (Amazon SNS). Um destino recebe eventos no formato JSON.
+ **Regra**: uma regra corresponde aos eventos de entrada que você deseja que o EventBridge observe e encaminhe a um ou mais destinos para processamento. Se uma regra rotear um evento para vários destinos, os destinos processarão o evento em paralelo. Uma regra pode personalizar o JSON enviado ao destino.

Os eventos do Amazon EventBridge são emitidos com base no melhor esforço. Para obter mais informações sobre criação e gerenciamento de eventos no EventBridge, consulte [Amazon EventBridge events](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) no *Guia do usuário do Amazon EventBridge*.

Veja a seguir um exemplo de uma regra do EventBridge para o Amazon Transcribe que é iniciada quando o status de um trabalho de transcrição muda para `COMPLETED` ou `FAILED`.

```
{
    "source": [
        "aws.transcribe"
    ],
    "detail-type": [
        "Transcribe Job State Change"
    ],
    "detail": {
        "TranscriptionJobStatus": [
            "COMPLETED",
            "FAILED"
        ]
    }
}
```

A regra contém os seguintes campos:
+ `source`: a origem do evento. Para o Amazon Transcribe, isso é sempre `aws.transcribe`.
+ `detail-type`: um identificador para os detalhes do evento. Para o Amazon Transcribe, isso é sempre `Transcribe Job State Change`.
+ `detail`: o novo status do trabalho de transcrição. Neste exemplo, a regra inicia um evento quando o status do trabalho muda para `COMPLETED` ou `FAILED`.

## Amazon TranscribeEventos do
<a name="events"></a>

O Amazon EventBridge registra em log vários eventos do Amazon Transcribe:
+ [Eventos de trabalho de transcrição](#job-event)
+ [Eventos de identificação de idiomas](#lang-id-event)
+ [Eventos do Call Analytics](#analytics-event)
+ [Eventos pós-chamada do Call Analytics](#analytics-stream-event)
+ [Eventos de vocabulário](#vocab-event)

Todos esses eventos contêm os seguintes campos compartilhados:
+ `version`: a versão dos dados do evento. Esse valor é sempre `0`.
+ `id`: um identificador exclusivo gerado pelo EventBridge para o evento.
+ `detail-type`: um identificador para os detalhes do evento. Por exemplo, `Transcribe Job State Change`.
+ `source`: a origem do evento. Para o Amazon Transcribe, isso é sempre `aws.transcribe`.
+ `account`: o ID da Conta da AWS que gerou a chamada de API.
+ `time`: a data e a hora em que o evento é entregue.
+ `region`: a Região da AWS em que a solicitação é feita.
+ `resources` os recursos usados pela chamada de API. No Amazon Transcribe, este campo está sempre vazio.
+ `detail`: detalhes adicionais sobre o evento.
  + `FailureReason`: esse campo estará presente se o estado ou status mudar para `FAILED` e descreve o motivo do estado ou status `FAILED`.
  + Cada tipo de evento tem outros campos exclusivos que são exibidos em `detail`. Esses campos exclusivos são definidos nas seções a seguir após cada exemplo de evento.

### Eventos de trabalho de transcrição
<a name="job-event"></a>

Quando o estado de um trabalho muda de `IN_PROGRESS` para `COMPLETED` ou `FAILED`, o Amazon Transcribe gera um evento. Para identificar o trabalho que mudou de estado e iniciar o evento no destino, use o campo `TranscriptionJobName` do evento. Um evento do Amazon Transcribe contém as seguintes informações. Um campo `FailureReason` será adicionado em `detail` se o status do trabalho de transcrição for `FAILED`.

Observe que esse evento se aplica somente à operação de API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html).

```
{
    "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`: o nome exclusivo que você escolheu para o trabalho de transcrição.
+ `TranscriptionJobStatus ` o status do trabalho de transcrição. Pode ser `COMPLETED` ou `FAILED`.

### Eventos de identificação de idiomas
<a name="lang-id-event"></a>

Quando você habilita a [identificação automática de idioma](lang-id.md), o Amazon Transcribe gera um evento quando o estado de identificação do idioma é `COMPLETED` ou `FAILED`. Para identificar o trabalho que mudou de estado e iniciar o evento no destino, use o campo `JobName` do evento. Um evento do Amazon Transcribe contém as seguintes informações. Um campo `FailureReason` será adicionado em `detail` se o status de identificação do idioma for `FAILED`.

Observe que esse evento se aplica somente à operação de API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html) quando o parâmetro [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_LanguageIdSettings.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_LanguageIdSettings.html) é incluído.

```
{
    "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 trabalhos de transcrição, esse valor deve ser `TranscriptionJob`.
+ `JobName`: o nome exclusivo do trabalho de transcrição.
+ `LanguageIdentificationStatus`: o status da identificação de idioma em um trabalho de transcrição. Pode ser `COMPLETED` ou `FAILED`.

### Eventos do Call Analytics
<a name="analytics-event"></a>

Quando o estado de um trabalho do [Call Analytics](call-analytics.md) muda de `IN_PROGRESS` para `COMPLETED` ou `FAILED`, o Amazon Transcribe gera um evento. Para identificar o trabalho do Call Analytics que mudou de estado e iniciou o evento no destino, use o campo `JobName` do evento. Um evento do Amazon Transcribe contém as seguintes informações. Um campo `FailureReason` será adicionado em `detail` se o status do trabalho do Call Analytics for `FAILED`.

Observe que esse evento se aplica somente à operação de API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartCallAnalyticsJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartCallAnalyticsJob.html).

```
{
    "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`: o nome exclusivo do trabalho de transcrição do Call Analytics.
+ `JobStatus`: o status do trabalho de transcrição do Call Analytics. Ele pode ser `COMPLETED` ou `FAILED`.
+ `FailureReason`: este campo está presente somente quando `JobStatus` é `FAILED` e descreve o motivo da falha.
+ `AnalyticsJobDetails`: detalhes da sua tarefa de transcrição do Call Analytics, incluindo informações sobre recursos analíticos ignorados.

### Eventos pós-chamada do Call Analytics
<a name="analytics-stream-event"></a>

Quando uma transcrição da [análise pós-chamada](tca-post-call.md) muda do estado `IN_PROGRESS` para `COMPLETED` ou `FAILED`, o Amazon Transcribe gera um evento. Para identificar o trabalho pós-chamada do Call Analytics que mudou de estado e iniciar o evento no destino, use o campo `StreamingSessionId` do evento.

Observe que esse evento se aplica somente à operação de 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) quando o 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) é incluído.

Um evento `COMPLETED` contém as seguintes informações:

```
{
    "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"
        }
    }
}
```

Um evento `FAILED` contém as seguintes informações:

```
{
    "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`: o número de identificação atribuído à solicitação de transcrição do Call Analytics em tempo real.
+ `PostCallStatus`: o status da transcrição do Call Analytics de pós-chamada. Ele pode ser `COMPLETED` ou `FAILED`.
+ `Transcript`: o URI das transcrições editadas e não editadas.
+ `Media`: o URI dos arquivos de áudio editados e não editados.

### Eventos de análise de pós-fluxo do AWS HealthScribe
<a name="health-scribe-analytics-stream-event"></a>

Quando ocorre uma mudança de estado em uma operação de análise pós-fluxo do AWS HealthScribe, como a alteração de um [ClinicalNoteGenerationResult](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_ClinicalNoteGenerationResult.html) de `IN_PROGRESS` para `COMPLETED`, o AWS HealthScribe gera um evento com as seguintes informações:

```
{
   "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": <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": <IN_PROGRESS | COMPLETED | FAILED>,
          "FailureReason": <failure_reason>
    }
   }
}
```
+ `UpdateType`: o tipo de operação de análise pós-fluxo que gerou o evento. O conteúdo do objeto resultante varia dependendo do `UpdateType`.
+ `SessionId`: o número de identificação do seu fluxo do AWS HealthScribe. Use esse ID para identificar a sessão de streaming de origem e depois encontrar as análises pós-fluxo que geraram o evento. 
+ `Status`: o status da operação de análise pós-fluxo. Pode ser `IN_PROGRESS`, `COMPLETED` ou `FAILED`.
+ `ClinicalNoteOutputLocation`: o URI do bucket de saída do Amazon S3 para o `ClinicalNoteGenerationResult`.
+ `TranscriptOutputLocation`: o URI da sua transcrição.

### Eventos de vocabulário
<a name="vocab-event"></a>

Quando o estado de um [vocabulário personalizado](custom-vocabulary.md) muda de `PENDING` para `READY` ou `FAILED`, o Amazon Transcribe gera um evento. Para identificar o vocabulário personalizado que mudou de estado e iniciar o evento no destino, use o campo `VocabularyName` do evento. Um evento do Amazon Transcribe contém as seguintes informações. Um campo `FailureReason` será adicionado em `detail` se o estado do vocabulário personalizado for `FAILED`.

**nota**  
Esse evento se aplica somente à operação de API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html).

```
{
    "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`: o nome exclusivo do vocabulário personalizado.
+ `VocabularyState`: o estado de processamento do vocabulário personalizado. Pode ser `READY` ou `FAILED`.