Meta Tech Provider
傳送媒體:圖片、影片、音訊及文件
媒體可先上載檔案,再使用回傳的 ID,或提供公開連結讓 Meta 擷取。上載更可靠,而不同類型的大小限制各異,容易令人出錯。
EasyCoexistence 會將接收的訊息事件直接從 Meta 傳送至您的端點,讓媒體 ID 即時抵達您的系統,並可在仍然有效時擷取。
按類型劃分的限制
每種類型各有不同,超出限制會回傳錯誤 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 完成這項設定
常見問題
我可以傳送的最大檔案是多少?
100 MB,而且只適用於文件。影片及音訊上限為 16 MB,圖片為 5 MB。
我應該上載檔案,還是傳送 URL?
請上載檔案,這能排除可存取性問題這個失敗原因。
媒體 ID 有效多久?
並非永久有效,因此接收媒體後,應在事件抵達時盡快擷取。
連接時會同步舊媒體嗎?
不會。歷史同步只包括最近的訊息內容,連接前的媒體會留在手機上。
繼續閱讀
傳送互動訊息:按鈕及清單WhatsApp 互動訊息:回覆按鈕、清單訊息及 Webhook 回覆。WhatsApp 錯誤 131053:媒體上載失敗錯誤 131053 表示 Meta 無法上載您傳送的媒體,主因是大小、格式或 URL 無法連接。WhatsApp 錯誤 131052:媒體下載失敗錯誤 131052 表示 Meta 無法下載訊息中的媒體,通常要求客戶重發即可。哪些內容會同步至 API,哪些不會聯絡人及一對一記錄會同步,群組、目錄、標籤、快速回覆及離開訊息不會同步。完整清單一覽。messages Webhook客戶訊息由此欄位送達,了解負載內容、快速確認,以及為何不會到達路由號碼的供應商。
準備開始嗎?
幾分鐘內設定 WhatsApp Coexistence,而非幾個月。應用程式在手機上仍可繼續運作。
開始免費試用驗證日期