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

# 上傳媒體檔案以使用 WhatsApp 傳送
<a name="managing-media-files-s3"></a>

當您傳送或接收媒體檔案時，它必須存放在 Amazon S3 儲存貯體中，並從 WhatsApp 上傳或擷取。Amazon S3 儲存貯體必須與 WhatsApp 商業帳戶 AWS 區域 (WABA) 位於相同的 AWS 帳戶 和 。這些指示說明如何建立 Amazon S3 儲存貯體、上傳檔案，以及建置檔案的 URL。如需 Amazon S3 命令的詳細資訊，請參閱[搭配 AWS CLI 使用高階 (s3) 命令](https://docs.aws.amazon.com/cli/latest/userguide/cli-services-s3-commands.html)。如需設定 的詳細資訊 AWS CLI，請參閱*[AWS Command Line Interface 《 使用者指南](https://docs.aws.amazon.com/cli/latest/userguide/)*》中的[設定 AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html)，以及《*[Amazon S3 使用者指南](https://docs.aws.amazon.com/AmazonS3/latest/userguide/)*》中的[建立儲存貯](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html)體和[上傳物件](https://docs.aws.amazon.com//AmazonS3/latest/userguide/upload-objects.html)。

**注意**  
WhatsApp 在刪除媒體檔案之前存放媒體檔案 30 天，請參閱 *WhatsApp Business Platform Cloud API 參考*中的[上傳媒體](https://developers.facebook.com/docs/whatsapp/cloud-api/reference/media#upload-media)。

您也可以建立媒體檔案[的預先簽章 URL](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-presigned-url.html)。使用預先簽章的 URL，您可以授予物件的時間限制存取，並上傳物件，而不需要其他方擁有 AWS 安全登入資料或許可。

1. 若要建立 Amazon S3 儲存貯體，請使用 [create-bucket](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/create-bucket.html) AWS CLI 命令。在命令列中輸入以下命令：

   ```
   aws s3api create-bucket --region 'us-east-1' --bucket BucketName
   ```

   在上述命令中：
   + 將 *us-east-1* 取代 AWS 區域 為您的 WABA 所在的 。
   + 將 *BucketName* 取代為新儲存貯體的名稱。

1. 若要將檔案複製到 Amazon S3 儲存貯體，請使用 [cp](https://docs.aws.amazon.com/cli/latest/userguide/cli-services-s3-commands.html#using-s3-commands-managing-objects-copy) AWS CLI 命令。在命令列中輸入以下命令：

   ```
   aws s3 cp SourceFilePathAndName s3://BucketName/FileName 
   ```

   在上述命令中：
   + 將 *SourceFilePathAndName* 取代為要複製的檔案路徑和檔案名稱。
   + 將 *BucketName* 取代為儲存貯體的名稱。
   + 將 *FileName* 取代為 檔案要使用的名稱。

   傳送時使用的 url 為：

   ```
   s3://BucketName/FileName
   ```

   若要建立[預先簽章的 URL](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-presigned-url.html)，請以您自己的資訊取代*使用者輸入預留位置*。

   ```
   aws s3 presign s3://amzn-s3-demo-bucket1/mydoc.txt --expires-in 604800 --region af-south-1 --endpoint-url https://s3.af-south-1.amazonaws.com
   ```

   傳回的 URL 將為： `https://amzn-s3-demo-bucket1.s3.af-south-1.amazonaws.com/mydoc.txt?{Headers}`

1. 使用 post-WhatsApp-message-media 命令將媒體檔案上傳至 WhatsApp。 [post-whatsapp-message-media](https://docs.aws.amazon.com/cli/latest/reference/socialmessaging/post-whatsapp-message-media.html) 成功完成時，命令會傳回 *\$1MEDIA\$1ID\$1*，這是傳送媒體訊息的必要項目。

   ```
   aws socialmessaging post-whatsapp-message-media --origination-phone-number-id {ORIGINATION_PHONE_NUMBER_ID}  --source-s3-file bucketName={BUCKET},key={MEDIA_FILE}
   ```

   針對上述命令執行以下事項：
   + 將 *\$1ORIGINATION\$1PHONE\$1NUMBER\$1ID\$1* 取代為您的電話號碼 ID。
   + 將 *\$1BUCKET\$1* 取代為 Amazon S3 儲存貯體的名稱。
   + 以媒體檔案名稱取代 *\$1MEDIA\$1FILE\$1*。

   您也可以使用 `--source-s3-presigned-url`而非 來使用[預先簽章 URL](#managing-media-files-s3.title) 上傳`--source-s3-file`。您必須在 `headers` `Content-Type`欄位中新增 。如果您同時使用兩者，`InvalidParameterException`則會傳回 。

   ```
   --source-s3-presigned-url headers={"Name":"Value"},url=https://BUCKET.s3.REGION/MEDIA_FILE
   ```

1. 成功完成時，會傳回 *MEDIA\$1ID*。*MEDIA\$1ID* 用於在[傳送媒體訊息時參考媒體](send-message-media.md)檔案。

# WhatsApp 中支援的媒體檔案類型和大小
<a name="supported-media-types"></a>

傳送或接收媒體訊息時，必須支援 檔案類型，且檔案大小上限以下。如需詳細資訊，請參閱 *WhatsApp Business Platform Cloud API 參考*中的[支援的媒體類型](https://developers.facebook.com/docs/whatsapp/cloud-api/reference/media#supported-media-types)。

## 媒體檔案類型
<a name="reference_body"></a>


**音訊格式**  

| 音訊類型 | 延伸 | MIME 類型  | 大小上限 | 
| --- | --- | --- | --- | 
| AAC | .aac | 音訊/aac | 16 MB | 
| AMR | .amr | 音訊/amr | 16 MB | 
| MP3 | .mp3 | 音訊/mpeg | 16 MB | 
| MP4 音訊 | .m4a | 音訊/mp4 | 16 MB | 
| OGG 音訊 | .ogg | 音訊/霧 | 16 MB | 


**文件格式**  

| 文件類型 | 延伸 | MIME 類型  | 大小上限 | 
| --- | --- | --- | --- | 
| 文字 | .text | text/plain | 100 MB | 
| Microsoft Excel | .xls、.xlsx | application/vnd.ms-excel、application/vnd.openxmlformats-officedocument.spreadsheetml.sheet | 100 MB | 
| Microsoft Word | .doc、.docx | application/msword、application/vnd.openxmlformats-officedocument.wordprocessingml.document | 100 MB | 
| Microsoft PowerPoint | .ppt、.pptx | application/vnd.ms-powerpoint、application/vnd.openxmlformats-officedocument.presentationml.presentation | 100 MB | 
| PDF | .pdf | application/pdf | 100 MB | 


**映像格式**  

| 影像類型 | 延伸 | MIME 類型  | 大小上限 | 
| --- | --- | --- | --- | 
| JPEG | .jpeg | 影像/JPEG | 5 MB | 
| PNG | .png | 圖片/png | 5 MB | 


**標籤格式**  

| 標籤類型 | 延伸 | MIME 類型  | 大小上限 | 
| --- | --- | --- | --- | 
| 動畫貼圖 | .webp | 映像/webp | 500 KB | 
| 靜態貼圖 | .webp | 映像/webp | 100 KB | 


**影片格式**  

| 影片類型 | 延伸 | MIME 類型  | 大小上限 | 
| --- | --- | --- | --- | 
| 3GPP | .3gp | 影片/3gp | 16 MB | 
| MP4 影片 | .mp4 | 影片/mp4 | 16 MB |