Meta Tech Provider
傳送媒體：圖片、影片、音訊及文件
媒體可先上載檔案，再使用回傳的 ID，或提供公開連結讓 Meta 擷取。上載更可靠，而不同類型的大小限制各異，容易令人出錯。
按類型劃分的限制
每種類型各有不同，超出限制會回傳錯誤 131053，而不是具體說明原因。
- 圖片：5 MB。JPEG 及 PNG。
- 影片：16 MB。MP4 及 3GPP，影片使用 H.264，音訊使用 AAC。
- 音訊：16 MB。AAC、AMR、MP3、MP4 音訊，以及使用 Opus 的 OGG。
- 文件：100 MB。大部分常見文件類型，包括 PDF 及 Office 格式。
- 貼圖：動畫 100 KB，靜態 500 KB，只支援 WebP。
上載與使用連結
傳送同一檔案有兩種方式，但失敗原因各不相同。
上載會先將檔案發送至 Meta，並回傳傳送時使用的媒體 ID。使用連結則讓 Meta 在傳送時擷取 URL。連結方式看似簡單，卻增加了一個您看不見的失敗原因：可在瀏覽器載入的 URL，可能因地理位置、防火牆規則，或瀏覽器已持有的工作階段 Cookie，而無法從 Meta 的基礎設施存取。
請上載檔案。這只會多出一個請求，卻能排除整類失敗原因。
接收媒體
接收的媒體會以媒體 ID 而非位元組抵達。您的處理程式需要使用該 ID，另外擷取檔案。
- 請盡快擷取。ID 不會永久有效。
- 擷取失敗會回傳錯誤 131052，通常表示發送者的上載未完成。
- 如日後仍需使用檔案，請自行儲存。Meta 並非檔案庫。
- 即使媒體擷取失敗，也請記錄訊息，讓文字及內容背景得以保留。
Coexistence 帶來的變化
Coexistence 號碼上的媒體，運作方式與任何其他 Cloud API 號碼完全相同，限制亦一致。
值得注意的唯一差異是歷史記錄。號碼首次連接時，Meta 會從 WhatsApp Business 應用程式同步最近的訊息，而同步內容是訊息文字，並非完整的媒體檔案庫。連接前的媒體仍在手機上，位置一直如此。
常見錯誤
- 因為連結看似簡單便使用連結。Meta 的網絡不是您的瀏覽器。
- 數小時後才擷取接收的媒體。媒體 ID 會過期。
- 未檢查編解碼器便匯出影片。編輯軟件的預設格式往往不受支援。
使用 EasyCoexistence 完成這項設定
EasyCoexistence 會將接收的訊息事件直接從 Meta 傳送至您的端點，讓媒體 ID 即時抵達您的系統，並可在仍然有效時擷取。
常見問題
我可以傳送的最大檔案是多少？
100 MB，而且只適用於文件。影片及音訊上限為 16 MB，圖片為 5 MB。
我應該上載檔案，還是傳送 URL？
請上載檔案，這能排除可存取性問題這個失敗原因。
媒體 ID 有效多久？
並非永久有效，因此接收媒體後，應在事件抵達時盡快擷取。
連接時會同步舊媒體嗎？
不會。歷史同步只包括最近的訊息內容，連接前的媒體會留在手機上。
繼續閱讀
Sending interactive messages: buttons and listsWhatsApp interactive messages: reply buttons, list messages, their exact limits and how replies come back on your webhook.WhatsApp error 131053: media upload failedError 131053 means Meta could not upload the media you sent. Size limits, unsupported formats and unreachable URLs account for nearly all of them.WhatsApp error 131052: media download failedError 131052 means Meta could not download media from a message. What causes it and why asking the customer to resend is usually the fix.What syncs to the API, and what does notContacts and one-to-one history cross over. Groups, catalog, labels, quick replies and away messages do not. The complete list, in one place.The messages webhookEverything a customer sends arrives on this field. What the payload carries, how to acknowledge it, and why it never reaches a provider on a routed number.
準備開始嗎？
幾分鐘內設定 WhatsApp Coexistence，而非幾個月。應用程式在手機上仍可繼續運作。
開始免費試用驗證日期