EventBridge による Amazon Chime の自動化 - Amazon Chime

このガイドのステップを完了するには、Amazon Chime システム管理者である必要があります。Amazon Chime デスクトップクライアント、ウェブアプリケーション、またはモバイルアプリに関するヘルプが必要な場合は、「Amazon Chime ユーザーガイド」の「Getting support」を参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

EventBridge による Amazon Chime の自動化

Amazon EventBridge を使用すると、AWS サービスを自動化して、アプリケーションの可用性の問題やリソースの変更などのシステムイベントに自動的に対応できます。会議イベントの詳細については、Amazon Chime デベロッパーガイドの「会議イベント」を参照してください。

Amazon Chime は生成したイベントをベストエフォートで配信で EventBridge に送信し、これは Amazon Chime がすべてのイベントを EventBridgeに送信しようとするけれどもまれにイベントが配信されないことがあることを意味します。詳細については、Amazon EventBridge ユーザーガイドの「AWS サービスからのイベント」を参照してください。

注記

データを暗号化する必要がある場合、Amazon S3 マネージドキーを使用する必要があります。AWS Key Management Service に保存されているカスタマーマスターキーを使用したサーバー側の暗号化はサポートされていません。

EventBridge による Amazon Chime Voice Connector の自動化

Amazon Chime Voice Connector について自動的にトリガーできる アクションには、以下があります。

  • AWS Lambda 関数の呼び出し

  • Amazon Elastic Container Service タスクの起動

  • Amazon Kinesis Video Streams へのイベントの中継

  • AWS Step Functions ステートマシンのアクティブ化

  • Amazon SNS トピックまたは Amazon SQS キューの通知

Amazon Chime で EventBridge を使用する例を以下に示します。

  • 通話終了後に通話の音声をダウンロードする Lambda 関数を有効にします。

  • 通話の開始後に Amazon ECS タスクを起動してリアルタイム文字起こしを可能にする。

詳細については、「Amazon EventBridge ユーザーガイド」を参照してください。

Amazon Chime Voice Connector ストリーミングイベント

Amazon Chime Voice Connector は、このセクションで説明するイベントの発生時に EventBridge へのイベントの送信をサポートします。

Amazon Chime Voice Connector は、Kinesis Video Streams へのメディアストリーミング開始時にこのイベントを送信します。

例 イベントデータ

以下はこのイベントのサンプルデータです。

{ "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@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", "streamArn": "arn:aws:kinesisvideo:us-east-1:123456:stream/ChimeVoiceConnector-abcdef1ghij2klmno3pqr4-111aaa-22bb-33cc-44dd-111222/111122223333", "toNumber": "+13605550199", "transactionId": "12345678-1234-1234", "voiceConnectorId": "abcdef1ghij2klmno3pqr4", "streamingStatus": "STARTED", "version": "0" } }

Amazon Chime Voice Connector は、Kinesis Video Streams へのメディアストリーミング終了時にこのイベントを送信します。

例 イベントデータ

以下はこのイベントのサンプルデータです。

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

Amazon Chime Voice Connector は、Kinesis Video Streams へのメディアストリーミング更新時にこのイベントを送信します。

例 イベントデータ

以下はこのイベントのサンプルデータです。

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

Amazon Chime Voice Connector は、Kinesis Video Streams へのメディアストリーミング失敗時にこのイベントを送信します。

例 イベントデータ

以下はこのイベントのサンプルデータです。

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