影音素材

/v1/media

使用 media 節點可上傳、擷取或刪除影音素材。

關係連線

下列關係連線連結到此節點：

準備工作

傳送影音素材訊息時，影音素材會在 WhatsApp 伺服器上儲存 14 天。如果用戶在超過 14 天後要求下載影音素材，WhatsApp 伺服器便會向 WhatsApp Business 內部部署用戶端要求相同的影音素材檔案。如果已移除影音素材，用戶將會收到已無法使用該影音素材的通知。

假設媒體只是依照投遞和讀取回條下載是不安全的，傳出的媒體在超過 30 天後移除通常仍是安全的，但您應採用符合企業的策略。

限制

• 如果您使用影音素材上傳程序而不是連結至影音素材網址，必須將檔案上傳至影音素材磁碟區。上傳完成後，您便能使用影音素材編號傳送訊息。
• 在系統將已上傳的影音素材傳送至伺服器之前，應用程式會先對其進行處理。雖然可上傳至 media 節點的影音素材檔案大小上限為 100MB，以下後續處理影音素材大小表格中說明了各種影音素材類型的後續處理限制。
• 企業需負責處理影音素材儲存空間。如果影音素材磁碟區已滿，訊息傳送便會開始失敗。
• 不支援以下方式：

  • 使用位元組串流來傳送影音素材。
  • 使用動畫貼圖來傳送訊息。

上傳

向 /v1/media 發出 POST 要求，上傳您的影音素材。內部部署要求的內文須包含二進位的影音素材資料，且 Content-Type 標頭必須設定為上傳影音素材的類型。如需瞭解支援的選項，請參閱支援的內容類型一節。

在 POST HTTP 要求中傳送二進位資料是上傳二進位資料的標準方式。例如，如果您想上傳圖像，可發出 POST 要求並在承載中附加實際的影像位元組。或者，如果想讓 cURL 讀取及使用實際提供的二進位檔案，可以使用 --data-binary。

範例

上傳影音素材：

POST /v1/media
Content-Type: image/jpeg or other appropriate media type

your-binary-media-data

使用 cURL 上傳影音素材：

curl -X POST \
https://your-webapp-hostname:your-webapp-port/v1/media \
-H 'Authorization: Bearer your-auth-token' \ 
-H 'Content-Type: image/jpeg'  \ # or other appropriate media type
--data-binary @your-file-path

在這兩種情況下，成功的回應會傳回 id 欄位，其為您擷取影音素材或傳送影音素材訊息給顧客時所需要的資訊。

{
    "media": [
        {
            "id": "f043afd0-f0ae-4b9c-ab3d-696fb4c8cd68"
        }
    ]
}

如果您收到錯誤訊息，請參閱錯誤和狀態訊息，瞭解更多資訊。

支援的內容類型

後續處理影音素材大小

此為壓縮和加密後允許的最大影音素材檔案大小。

常見問題

docker volume inspect whatsappMedia

[
    {
        "Driver": "local",
        "Labels": {},
        "Mountpoint": "/var/lib/docker/volumes/whatsappMedia/_data",
        "Name": "whatsappMedia",
        "Options": {},
        "Scope": "local"
    }
]

ls /var/lib/docker/volumes/whatsappMedia/_data/

瞭解詳情

• 最佳作法
• 訊息
• 參考資料