媒體

/v1/media

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

關係連線

以下關係連線連接至此節點：

準備工作

傳送媒體訊息時，媒體將在 WhatsApp 伺服器中儲存 14 天。如果用戶在 14 天後要求下載該媒體，則 WhatsApp 伺服器會透過 WhatsApp Business 企業內部用戶端要求相同的媒體檔案。如果媒體已被移除，則系統會通知用戶該媒體無法使用。

您無法單靠已送達和已讀通知，便假設影音素材已下載。一般來說，在 30 天後移除傳出的影音素材會較為安全，但您應該採用最適合您企業的策略。

限制

• 如果您使用媒體上載程序，而不是連結至媒體網址，則必須將檔案上載至媒體磁碟區。上載完成後，您可以使用媒體編號傳送訊息。
• 應用程式會先處理已上載媒體，然後才將其傳送至伺服器。上載至 media 節點的媒體檔案大小上限是 100 MB，另外下方的處理後媒體大小表格亦列出了各種媒體類型的處理後大小限制。
• 媒體儲存空間需由企業處理。如果影音素材磁碟區已滿，您便無法傳送訊息。
• 不支援：

  • 透過位元組流傳送影音素材。
  • 傳送附有動畫貼圖的訊息。

上載

向 /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/

了解詳情

• 最佳操作實例
• 訊息
• 參考資料