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

RCS ファイルメッセージの送信

SendRcsMessage API のFileMessageコンテンツタイプを使用して、イメージ、動画、オーディオファイル、PDFsをスタンドアロンメッセージとして受信者に送信できます。ファイルメッセージは、受信者のメッセージングアプリにインラインメディアとして表示されます。

ファイルメッセージは、リッチカードメディアとは異なります。ファイルメッセージはメッセージコンテンツ全体として 1 つのメディアを配信し、リッチカードはメディアをテキストと推奨アクションと組み合わせます。リッチカードの詳細については、「」を参照してくださいRCS リッチカードの送信。

ファイルメッセージには、メッセージレベルの提案 (返信チップやアクションボタンなど) をアタッチできます。提案の詳細については、「」を参照してくださいRCS の提案の設定。

FileMessage 構造

FileMessage オブジェクトは、 RcsMessageContentパラメータの Contentフィールド内にネストされます。メッセージレベルSuggestionsは (その中にネストContentされていない) の兄弟です。

{
    "Content": {
        "FileMessage": {
            "FileUrl": "s3://my-media-bucket/campaigns/welcome-image.png",
            "ThumbnailUrl": "s3://my-media-bucket/thumbnails/welcome-thumb.jpg"
        }
    },
    "Suggestions": []
}

ファイル URL ソース

FileUrl パラメータは 2 つの URL 形式を受け入れます。

ファイル配信用の S3 バケットポリシー

AWS エンドユーザーメッセージングが Amazon S3 バケットからファイルを取得できるようにするには、次のリソースベースのポリシーをバケットにアタッチします。

{
    "Version": "2012-10-17", 
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "sms-voice.amazonaws.com"
            },
            "Action": "s3:GetObject",
            "Resource": "arn:aws:s3:::YOUR-BUCKET/*"
        }
    ]
}

YOUR-BUCKET をバケット名に置き換えます。特定のプレフィックスへのアクセスを制限するには、 を目的のパス ( など) /*に置き換えますarn:aws:s3:::YOUR-BUCKET/rcs-media/*。

サポートされているメディアタイプとサイズ制限

次の表に、 でサポートされているメディアタイプを示しますFileMessage。

サムネイル

ThumbnailUrl パラメータを使用して、動画および PDF ファイルメッセージのサムネイルイメージを指定できます。受信者がファイル全体を開くかダウンロードする前に、サムネイルが会話のプレビューとして表示されます。

ファイルメッセージの送信

ファイルメッセージを送信するには、 RcsMessageContentパラメータ内のFileMessageオブジェクトを使用して SendRcsMessage API を呼び出します。発信元 ID (プールまたは AWS RCS エージェント) は、 --origination-identityパラメータを使用して指定します。

次の JSON は、候補を含むファイルメッセージRcsMessageContentの値を示しています。

{
    "Content": {
        "FileMessage": {
            "FileUrl": "s3://my-media-bucket/documents/invoice.pdf",
            "ThumbnailUrl": "s3://my-media-bucket/thumbnails/invoice-thumb.jpg"
        }
    },
    "Suggestions": [
        {
            "Reply": {
                "Text": "Download receipt",
                "PostbackData": "action=download_receipt"
            }
        }
    ]
}

配信とフォールバック

ファイルメッセージを送信すると、 AWS End User Messaging は RCS チャネル経由で配信しようとします。受信者のデバイスが RCS をサポートしていない場合、または配信前にメッセージの有効期限が切れた場合 ( TimeToLive値に基づく）、サービスはフォールバック設定に応じて SMS または MMS にフォールバックできます。

SMS または MMS フォールバックは、プールレベルまたはメッセージごとに設定できます。フォールバック動作の詳細については、「」を参照してくださいリッチ RCS メッセージを送信する。