View a markdown version of this page

傳送 RCS 檔案訊息 - AWS 最終使用者傳訊簡訊
FileMessage 結構檔案 URL 來源用於檔案交付的 S3 儲存貯體政策支援的媒體類型和大小限制縮圖傳送檔案訊息交付和備用

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

傳送 RCS 檔案訊息

您可以使用 SendRcsMessage API 中的FileMessage內容類型，將影像、影片、音訊檔案和 PDFs做為獨立訊息傳送給收件人。檔案訊息會在收件人的訊息應用程式中顯示為內嵌媒體。

檔案訊息與豐富的卡片媒體不同。檔案訊息會將單一媒體作為整個訊息內容傳遞，而多張卡片則結合媒體與文字和建議的動作。如需多張卡片的詳細資訊，請參閱 傳送 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": []
}
FileUrl (必要)

要傳送之檔案的 S3 或 HTTPS URL。長度上限為 2，000 個字元。URL 必須符合模式 ^(https://|s3://).+$。 檔案大小上限為 100 MB。

ThumbnailUrl (選用)

縮圖影像的 S3 或 HTTPS URL。長度上限為 2，000 個字元。遵循與 相同的 URL 模式FileUrl。建議用於影片和 PDF 檔案。

檔案 URL 來源

FileUrl 參數接受兩種 URL 格式：

  • Amazon S3 URLs(s3://bucket-name/object-key)。當您指定 S3 URL 時， AWS 最終使用者傳訊會擷取物件、重新託管物件，並產生時間限制的預先簽章 URL 以交付至收件人的裝置。S3 儲存貯體必須具有以資源為基礎的政策，以授予服務讀取存取權。請參閱 用於檔案交付的 S3 儲存貯體政策。

  • HTTPS URLs(https://cdn.example.com/path/to/file.jpg)。URL 會傳遞給電信業者以進行交付。URL 必須在沒有身分驗證的情況下可公開存取。不支援純 http:// URLs。

注意

當您使用 S3 URL 時，API 會在請求時驗證物件是否存在、在大小限制內，並且可存取。如果驗證失敗，API 會傳回ValidationException具有描述性錯誤訊息的 。HTTPS URLs請求時間不會以相同的方式進行驗證。

用於檔案交付的 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/*)。

注意

如果您的儲存貯體使用 SSE-KMS 加密，您還必須在金鑰政策中授予sms-voice.amazonaws.com服務使用 KMS 金鑰的許可。SSE-S3 加密不需要額外的組態。

支援的媒體類型和大小限制

下表列出 支援的媒體類型FileMessage。

MIME 類型 延伸模組 大小上限 備註
image/jpeg .jpeg、.jpg 100 MB 建議用於相片。
image/png .png 100 MB 支援透明度。建議用於圖形和標誌。
image/gif .gif 100 MB 動畫 GIFs Android 上播放。在 iOS 上轉譯為靜態。
video/mp4 .mp4 5 MB 建議使用 H.264 轉碼器以獲得最廣泛的相容性。
video/webm .webm 5 MB VP8/VP9 轉碼器。Android 主要支援 。
audio/mp3 .mp3 100 MB 最廣泛的音訊播放支援。
audio/aac .aac 100 MB 替代音訊格式。
application/pdf .pdf 100 MB 支援因電信業者和區域而異。
重要

API 層強制執行 100 MB 檔案大小限制。個別電信業者可能會對交付至終端裝置施加較低的限制。對於影片，電信業者通常會強制執行最多 5 MB。將影片檔案保留在 5 MB 以下，以確保成功交付。

縮圖

您可以使用 ThumbnailUrl 參數提供影片和 PDF 檔案訊息的縮圖影像。在收件人開啟或下載完整檔案之前，縮圖會在對話中顯示為預覽。

  • 支援的縮圖格式：JPEG、PNG。

  • 縮圖 URL 遵循與 相同的格式規則 FileUrl(S3 或 HTTPS，最多 2，000 個字元）。

  • 使用符合原始檔案的長寬比，以避免在裝置上裁切。

傳送檔案訊息

若要傳送檔案訊息，請呼叫RcsMessageContent具有 參數內FileMessage物件的 SendRcsMessage API。您可以使用 --origination-identity 參數指定起始身分 （集區或 AWS RCS 代理程式）。

下列 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 最終使用者傳訊會嘗試透過 RCS 頻道傳遞訊息。如果收件人的裝置不支援 RCS，或如果訊息在交付前過期 （根據 TimeToLive值），服務可能會根據您的備用組態回復為 SMS 或 MMS。

您可以在集區層級或每則訊息設定 SMS 或 MMS 備用。如需備用行為的詳細資訊，請參閱 傳送豐富的 RCS 訊息。

重要

RCS 檔案訊息可在支援 RCS 的所有國家/地區使用。如需目前的清單，請參閱 RCS 支援的國家/地區。