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

インバウンド RCS メディアの受信

ユーザーは、エージェントとの RCS 会話でメディア (イメージ、ビデオ、オーディオファイル、ドキュメント) を送信できます。インバウンドメディアストレージを設定すると、AWSEnd User Messaging は RCS プロバイダーからメディアをダウンロードし、Amazon S3 バケットにアップロードし、S3 の場所とファイルメタデータを含む双方向 Amazon SNS トピックに通知を発行します。

インバウンド RCS メッセージ (テキスト、場所、提案応答) の受信に関する一般的な情報については、「」を参照してくださいインバウンド RCS メッセージの受信。リッチメディアをユーザーに送信する方法については、「」を参照してくださいリッチ RCS メッセージを送信する。

インバウンドメディアの仕組み

ユーザーが RCS 会話でメディアファイルを送信すると、AWSEnd User Messaging は次の手順でメッセージを処理します。

LOCATION および SUGGESTION メッセージタイプでは、S3 アップロードは行われません。コンテンツは SNS 通知本文に直接配信されます。これらのメッセージタイプの詳細については、「」を参照してくださいインバウンド RCS メッセージの受信。

インバウンドメディアストレージの設定

インバウンドメディアを受信するには、 UpdateRcsAgent API を使用して RCS エージェントで次のフィールドを設定します。メディアストレージを設定する前に、エージェントで双方向メッセージングを有効にする必要があります。

S3 バケットと IAM ロールは一緒に必要です。いずれかを指定する場合は、両方を指定する必要があります。

S3 キー形式

メディアオブジェクトは次のキー形式で保存されます。元のファイル名は#区切り文字の後に付加されます。

{prefix}/rcs/{messageId}#{fileName}

たとえば、キープレフィックスを に設定するとinbound-media、メディアファイルは次のように保存される場合があります。

inbound-media/rcs/msg-abc123def456#photo_2026.jpg

インバウンドメディアの IAM ロールの作成

AWSエンドユーザーメッセージングサービスがメディアファイルを S3 バケットにアップロードできるようにする IAM ロールを作成します。ロールには、サービスがロールを引き受けることを許可する信頼ポリシーと、バケットs3:PutObjectへのアクセスを許可するアクセス許可ポリシーが必要です。

信頼ポリシー

次の信頼ポリシーは、AWSエンドユーザーメッセージングサービスプリンシパルがロールを引き受けることを許可します。をAWSアカウント ID 123456789012に置き換えます。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "sms-voice.amazonaws.com"
            },
            "Action": "sts:AssumeRole",
            "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "123456789012"
                }
            }
        }
    ]
}

アクセス許可ポリシー

次のアクセス許可ポリシーは、S3 バケットにオブジェクトを書き込むアクセス許可をロールに付与します。my-rcs-media-bucket をバケット名に置き換えます。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "s3:PutObject"
            ],
            "Resource": "arn:aws:s3:::my-rcs-media-bucket/*"
        }
    ]
}

メディアストレージの設定 (CLI)

次の AWSCLI コマンドは、既存の RCS エージェントにインバウンドメディアストレージを設定します。

aws pinpoint-sms-voice-v2 update-rcs-agent \
    --rcs-agent-id rcs-agent-1234567890abcdef0 \
    --two-way-media-s3-bucket-name my-rcs-media-bucket \
    --two-way-media-s3-key-prefix "inbound-media" \
    --two-way-media-s3-role arn:aws:iam::123456789012:role/RcsInboundMediaRole \
    --region us-east-1

インバウンドメディア通知ペイロード

AWSエンドユーザーメッセージングは、メディアファイルを受信すると、双方向 SNS トピックに通知を発行します。通知は、メディアステータスと成功時に S3 の場所とファイルメタデータを含む文字列化された JSON ドキュメントを含むmessageBodyフィールドを持つ JSON オブジェクトです。

次の例は、正常なインバウンドメディア通知を示しています。

{
    "originationNumber": "+14255551234",
    "destinationNumber": "rcs-cb1e6e519e9049fabf8c0ae38e4d876b",
    "messageBody": "{\"mediaStatus\":\"SUCCESS\",\"s3Bucket\":\"my-rcs-media-bucket\",\"s3Key\":\"inbound-media/rcs/msg-abc123def456#photo_2026.jpg\",\"mimeType\":\"image/jpeg\",\"fileName\":\"photo_2026.jpg\",\"fileSizeBytes\":1211843}",
    "inboundMessageId": "8821d750-4bc5-4cb1-a8c3-c3d64a38d019"
}

最上位の通知には、次のフィールドが含まれます。

JSON messageBody には次のフィールドが含まれます。

メディアダウンロードの失敗処理

AWSエンドユーザーメッセージングが RCS プロバイダーからメディアをダウンロードまたは保存できない場合でも、サービスは双方向 SNS トピックに通知を発行します。messageBody には障害 mediaStatus (UPLOAD_FAILED または ROLE_ASSUME_FAILED) と原因mediaStatusMessageを説明する があり、S3 の場所フィールドはありません。

たとえば、IAM ロールの引き受けに失敗すると、次のmessageBody内容が生成されます。

{
    "mediaStatus": "ROLE_ASSUME_FAILED",
    "mediaStatusMessage": "Media received but could not assume the configured IAM role",
    "mimeType": "image/heic",
    "fileName": "IMG_7115.heic",
    "fileSizeBytes": 1211843
}

メディアのダウンロードに失敗する一般的な原因は次のとおりです。

配信の失敗をトラブルシューティングするには、IAM ロールの信頼ポリシーとアクセス許可ポリシーが正しく設定されていること、および S3 バケットが存在し、サービスからアクセスできることを確認します。メディアアップロードの失敗について、エージェントの CloudWatch メトリクスをモニタリングします。

受け入れられるメディアタイプ

AWSエンドユーザーメッセージングは、次のインバウンドメディア MIME タイプを受け入れます。

ベストプラクティス