Automatiser le SDK Amazon Chime avec EventBridge - Amazon Chime SDK
Automatiser les connecteurs vocaux du SDK Amazon Chime avec EventBridgeÉvénements de diffusion en continu du SDK Voice Connector Amazon Chime

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

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

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.

Événements de diffusion en continu du SDK Voice Connector Amazon Chime

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.

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

Exemple 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"
    }
}

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

Exemple 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"
    }
}

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

Exemple 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"
    }
}

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

Exemple 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"
  }
}