

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Automatiser le SDK Amazon Chime avec EventBridge
<a name="automating-chime-with-cloudwatch-events"></a>

Amazon vous EventBridge permet d'automatiser vos AWS services et de répondre automatiquement aux événements du système, tels que les problèmes de disponibilité des applications ou les modifications des ressources. Pour plus d'informations sur les événements de réunion, consultez la section [Événements de réunion](https://docs.aws.amazon.com/chime/latest/dg/using-events.html) dans le guide du développeur du *SDK Amazon Chime*.

Lorsque le SDK Amazon Chime génère des événements, il les envoie à EventBridge pour une *diffusion optimale*, ce qui signifie que le SDK Amazon Chime essaie d'envoyer tous les événements EventBridge, mais dans de rares cas, un événement peut ne pas être diffusé. Pour plus d'informations, reportez-vous à la section [Événements liés AWS aux services](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html) dans le *guide de EventBridge l'utilisateur Amazon*.

**Note**  
Si vous devez chiffrer des données, vous devez utiliser des clés gérées par Amazon S3. Nous ne prenons pas en charge le chiffrement côté serveur à l'aide des clés principales du client stockées dans le service de gestion des AWS clés. 

## Automatiser les connecteurs vocaux du SDK Amazon Chime avec EventBridge
<a name="events-cvc"></a>

Les actions qui peuvent être déclenchées automatiquement pour les connecteurs vocaux du SDK Amazon Chime sont les suivantes :
+ Invoquer une fonction AWS Lambda 
+ Lancement d'une tâche Amazon Elastic Container Service
+ Retransmission de l'événement à Amazon Kinesis Video Streams
+ Activation d'une machine à AWS Step Functions états
+ Notification d’une rubrique Amazon SNS ou d’une file d’attente Amazon SQS

Voici quelques exemples d'utilisation EventBridge avec les connecteurs vocaux du SDK Amazon Chime :
+ Activation d'une fonction Lambda pour télécharger le son d'un appel une fois celui-ci terminé.
+ Lancement d'une tâche Amazon ECS pour activer la transcription en temps réel après le début d'un appel.

Pour plus d'informations, consultez le [guide de EventBridge l'utilisateur Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/).

## Événements de diffusion en continu du SDK Voice Connector Amazon Chime
<a name="stream-events-cvc"></a>

Les connecteurs vocaux du SDK Amazon Chime permettent d'envoyer des événements au EventBridge moment où les événements décrits dans cette section se produisent.

### La diffusion en continu du connecteur vocal Amazon Chime SDK commence
<a name="stream-start-cvc"></a>

Les connecteurs vocaux du SDK Amazon Chime envoient cet événement lorsque le streaming multimédia commence vers Kinesis Video Streams.

**Example Données d’événement**  
Voici un exemple de données pour cet événement.  

```
{
    "version": "0",
    "id": "12345678-1234-1234-1234-111122223333",
    "detail-type": "Chime VoiceConnector Streaming Status",
    "source": "aws.chime",
    "account": "{{111122223333}}",
    "time": "{{yyyy-mm-ddThh:mm:ssZ}}",
    "region": "us-east-1",
    "resources": [],
    "detail": {
        "callId": "{{1112-2222-4333}}",
        "direction": "Outbound",
        "fromNumber": "+{{12065550100}}",
        "inviteHeaders": {
            "from": "\"{{John}}\" <sip:{{+12065550100}}@10.24.34.0>;{{tag=abcdefg}}",
            "to": "<sip:{{+13605550199@abcdef1ghij2klmno3pqr4M}}.voiceconnector.chime.aws:5060>",
            "call-id": "{{1112-2222-4333}}",
            "cseq": "101 INVITE",
            "contact": "<sip:user@10.24.34.0:6090>;",
            "content-type": "application/sdp",
            "content-length": "{{246}}"
        },
        "isCaller": false,
        "mediaType": "audio/L16",
        "sdp": {
            "mediaIndex": 0,
            "mediaLabel": "1"
        },
        "siprecMetadata": "<&xml version=\"1.0\" encoding=\"UTF-8\"&>;\r\n<recording xmlns='urn:ietf:params:xml:ns:recording:1'>",
        "startFragmentNumber": "{{1234567899444}}",
        "startTime": "{{yyyy-mm-ddThh:mm:ssZ}}",
        "streamArn": "arn:aws:kinesisvideo:us-east-1:{{123456M}}:stream/ChimeVoiceConnector-{{abcdef1ghij2klmno3pqr4-111aaa-22bb-33cc-44dd-111222}}/111122223333",
        "toNumber": "+{{13605550199}}",
        "transactionId": "{{12345678-1234-1234}}",
        "voiceConnectorId": "{{abcdef1ghij2klmno3pqr4}}",
        "streamingStatus": "STARTED",
        "version": "0"
    }
}
```

### Fin de la diffusion du connecteur vocal Amazon Chime SDK
<a name="stream-end-cvc"></a>

Les connecteurs vocaux du SDK Amazon Chime envoient cet événement lorsque le streaming multimédia vers Kinesis Video Streams prend fin.

**Example Données d’événement**  
Voici un exemple de données pour cet événement.  

```
{
    "version": "0",
    "id": "{{12345678-1234-1234-1234-111122223333}}",
    "detail-type": "Chime VoiceConnector Streaming Status",
    "source": "aws.chime",
    "account": "{{111122223333}}",
    "time": "{{yyyy-mm-ddThh:mm:ssZ}}",
    "region": "us-east-1",
    "resources": [],
    "detail": {
        "streamingStatus": "ENDED",
        "voiceConnectorId": "{{abcdef1ghij2klmno3pqr4}}",
        "transactionId": "{{12345678-1234-1234}}",
        "callId": "{{1112-2222-4333}}",
        "direction": "Inbound",
        "fromNumber": "+{{12065550100}}",
        "inviteHeaders": {
            "from": "\"{{John}}\" <sip:+{{12065550100}}@10.24.34.0>;tag={{abcdefg}}",
            "to": "<sip:+{{13605550199}}@{{abcdef1ghij2klmno3pqr4}}.voiceconnector.chime.aws:5060>",
            "call-id": "{{1112-2222-4333}}",
            "cseq": "101 INVITE",
            "contact": "<sip:user@10.24.34.0:6090>",
            "content-type": "application/sdp",
            "content-length": "{{246}}"
        },
        "isCaller": false,
        "mediaType": "audio/L16",
        "sdp": {
            "mediaIndex": 0,
            "mediaLabel": "1"
        },
        "siprecMetadata": "<&xml version=\"1.0\" encoding=\"UTF-8\"&>\r\n<recording xmlns='urn:ietf:params:xml:ns:recording:1'>",
        "startFragmentNumber": "{{1234567899444}}",
        "startTime": "{{yyyy-mm-ddThh:mm:ssZ}}",
        "endTime": "{{yyyy-mm-ddThh:mm:ssZ}}",
        "streamArn": "arn:aws:kinesisvideo:us-east-1:{{123456}}:stream/ChimeVoiceConnector-{{abcdef1ghij2klmno3pqr4-111aaa-22bb-33cc-44dd-111222}}/{{111122223333}}",
        "toNumber": "+13605550199",
        "version": "0"
    }
}
```

### Mises à jour en streaming du connecteur vocal Amazon Chime SDK
<a name="stream-update-cvc"></a>

Les connecteurs vocaux du SDK Amazon Chime envoient cet événement lorsque le streaming multimédia vers Kinesis Video Streams est mis à jour.

**Example Données d’événement**  
Voici un exemple de données pour cet événement.  

```
{
    "version": "0",
    "id": "{{12345678-1234-1234-1234-111122223333}}",
    "detail-type": "Chime VoiceConnector Streaming Status",
    "source": "aws.chime",
    "account": "{{111122223333}}",
    "time": "{{yyyy-mm-ddThh:mm:ssZ}}",
    "region": "us-east-1",
    "resources": [],
    "detail": {
        "callId": "{{1112-2222-4333}}",
        "updateHeaders": {
            "from": "\"{{John}}\" <sip:+{{12065550100}}@10.24.34.0>;;tag={{abcdefg}}",
            "to": "<sip:+{{13605550199@abcdef1ghij2klmno3pqr4}}.voiceconnector.chime.aws:5060>",
            "call-id": "{{1112-2222-4333}}",
            "cseq": "101 INVITE",
            "contact": "<sip:user@10.24.34.0:6090>",
            "content-type": "application/sdp",
            "content-length": "{{246}}"
        },
        "siprecMetadata": "<&xml version=\"1.0\" encoding=\"UTF-8\"&>\r\n<recording xmlns='urn:ietf:params:xml:ns:recording:1'>",
        "streamingStatus": "UPDATED",
        "transactionId": "{{12345678-1234-1234}}",
        "version": "0",
        "voiceConnectorId": "{{abcdef1ghij2klmno3pqr4}}"
    }
}
```

### Le streaming du connecteur vocal Amazon Chime SDK échoue
<a name="stream-fail-cvc"></a>

Les connecteurs vocaux du SDK Amazon Chime envoient cet événement lorsque le streaming multimédia vers Kinesis Video Streams échoue.

**Example Données d’événement**  
Voici un exemple de données pour cet événement.  

```
{
  "version": "0",
  "id": "12345678-1234-1234-1234-111122223333",
  "detail-type": "Chime VoiceConnector Streaming Status",
  "source": "aws.chime",
  "account": "{{111122223333}}",
  "time": "{{yyyy-mm-ddThh:mm:ssZ}}",
  "region": "us-east-1",
  "resources": [],
  "detail": {
       "streamingStatus":"FAILED",
       "voiceConnectorId":"{{abcdefghi}}",
       "transactionId":"{{12345678-1234-1234}}",
       "callId":"{{1112-2222-4333}}",
       "direction":"Inbound",
       "failTime":"{{yyyy-mm-ddThh:mm:ssZ}}",
       "failureReason": "Internal failure",
       "version":"0"
  }
}
```