錯誤代碼
本頁彙整 WhatsApp 訊息在發送與送達過程中可能出現的錯誤碼，說明每個錯誤碼的含義與處理方式。
錯誤碼分為兩類來源，請先確認屬於哪一類，再對照下方對應章節：
| 來源 | 編號規則 |
|---|---|
| Meta 官方錯誤碼 | 與 Meta 官方完全一致 |
| EngageLab 平台錯誤碼 | 由 EngageLab 定義 |
適用範圍：本頁僅涵蓋訊息發送與送達場景。介面呼叫層面的錯誤碼請查閱 訊息傳送 API 與 範本管理 API 文件中的「錯誤碼」章節。
Meta 官方錯誤碼
以下錯誤碼均由 Meta 定義，編號與 Meta 官方保持一致，可參考 Meta 官方文件。
限流與頻率限制
此類錯誤表示觸發了發送速率或發送量的限制，訊息本身沒有問題，等待後重試即可恢復。
| 代碼 | 含義 | 說明 | 處理建議 |
|---|---|---|---|
| 4 | API 呼叫超出上限 | 應用程式的 API 呼叫頻率已達上限。 | 降低呼叫頻率或稍後重試。 |
| 80007 | 帳戶傳送頻率超出上限 | WhatsApp 商業帳號（WABA）的傳送頻率已達上限。 | 放慢傳送節奏、稍後再發；批次群發建議分批平均下發。 |
| 130429 | 傳送吞吐量超出上限 | 已達到單位時間內可傳送的訊息量上限。 | 降低瞬時併發傳送量後重試。業務需要更高吞吐可聯絡 EngageLab 技術支援評估升級。 |
| 131048 | 垃圾訊息率超出上限 | 該傳送號碼近期較多訊息被使用者封鎖或標記為垃圾訊息，已觸發傳送限制。 | 在 WhatsApp Manager 查看號碼品質評級，優化內容與目標客群精準度後再傳送。 |
| 131056 | 對同一用戶傳送過於頻繁 | 短時間內向同一收件人傳送了過多訊息。 | 拉長對同一使用者的傳送間隔；向其他收件人傳送不受影響。 |
| 131064 | 範本分類違規，已達傳送上限 | 因範本分類（行銷 / 實用通知 / 身分驗證）使用不當，帳號已達傳送上限，範本訊息與一般訊息均受影響。 | 核對範本分類與實際用途是否一致。約束期結束後限制自動解除。 |
帳戶與權限
此類錯誤與帳號狀態、接入設定或合規處罰有關，重試無法解決。
| 代碼 | 含義 | 說明 | 處理建議 |
|---|---|---|---|
| 0 | 身分驗證失敗 | 接入 Meta 的存取權杖已失效。 | 屬平台接入側問題，請聯絡 EngageLab 技術支援處理。 |
| 3 | 功能或權限不足 | 缺少呼叫該介面所需的功能或權限。 | 請聯絡 EngageLab 技術支援開通對應權限。 |
| 10 | 權限遭拒 | 權限未授予或已被移除。 | 請聯絡 EngageLab 技術支援核查權限。 |
| 190 | 存取權杖已過期 | 接入 Meta 的存取權杖已過有效期。 | 屬平台接入側問題，請聯絡 EngageLab 技術支援更新。 |
| 200 | 未提供存取權杖 | 請求中未攜帶有效的存取權杖。 | 屬平台接入設定問題，請聯絡 EngageLab 技術支援。 |
| 368 | 因違反政策遭暫時封鎖 | WhatsApp 商業帳號因違反平台政策遭限制或停用。 | 核查近期傳送內容與範本是否合規；可在 Meta 商務管理平台查看處罰詳情並申訴，限制期滿後自動解除。 |
| 130497 | 遭限制向該國家／地區傳送 | 商業帳號遭限制向特定國家/地區的使用者傳送訊息。 | 確認目標號碼所屬國家/地區是否在允許範圍內，詳見 WhatsApp 商業訊息政策。 |
| 131005 | 存取遭拒 | 呼叫該介面所需的權限未授予或已被移除。 | 請聯絡 EngageLab 技術支援核查權限。 |
| 131031 | 帳號遭鎖定 | 商業帳號因違反平台政策遭限制或停用。 | 請聯絡 EngageLab 技術支援核查帳號狀態；亦可在 Meta 商務管理平台查看帳號健康狀態。 |
| 131042 | 付款／帳單問題 | 付款方式或信用額度異常，如未綁定付款帳戶、信用額度超限或未啟用、未設定時區與貨幣。 | 在 Meta 商務管理平台檢查付款帳戶、信用額度、時區與貨幣設定是否完整。 |
| 131057 | 帳戶維護中，暫時無法傳送 | 商業帳號正在進行維護或升級。 | 稍後重試。 |
| 131063 | 行銷範本在 Cloud API 上已停用 | 範本分類為行銷類，但帳號已在 Cloud API 設定中關閉行銷範本傳送。 | 重新啟用帳號的行銷訊息開關，或改用實用通知類 / 身分驗證類範本。 |
| 134011 | WhatsApp Payments 條款待接受 | 商業帳號尚未接受 WhatsApp Payments 服務條款。 | 透過錯誤訊息中的連結接受條款後重試。 |
傳送與收件人
此類錯誤與本次傳送的請求內容、收件人狀態或對話視窗有關。
| 代碼 | 含義 | 說明 | 處理建議 |
|---|---|---|---|
| 1 | 請求無效或伺服器錯誤 | 請求格式有誤，或 Meta 側發生伺服器錯誤。 | 對照介面文件檢查請求格式；格式無誤時稍後重試。 |
| 2 | 服務暫時中斷或過載 | Meta 服務因當機或過載出現暫時性問題。 | 稍後重試。 |
| 100 | 參數無效或拼寫錯誤 | 請求中包含不受支援、拼寫錯誤或超出長度限制的參數。 | 對照介面文件檢查參數名稱、取值與長度限制。 |
| 130403 | 商家已在 WhatsApp 上封鎖該用戶 | 你的商業號在 WhatsApp 上封鎖了該收件人。 | **請勿重試。**先在 WhatsApp Manager 解除對該使用者的封鎖，再重新傳送。 |
| 130472 | 訊息因行銷實驗未傳送 | 該收件人被納入 Meta 的行銷訊息實驗對照組，依實驗規則未傳送。 | 無需處理，不代表訊息或帳號存在問題。 |
| 131000 | 不明錯誤 | 訊息因未知原因傳送失敗。 | 稍後重試；持續失敗請聯絡 EngageLab 技術支援。 |
| 131008 | 缺少必填參數 | 請求中缺少必填參數。 | 對照介面文件補齊必填參數後重發。 |
| 131009 | 參數值無效 | 一個或多個參數的取值無效。 | 對照介面文件檢查各參數的取值範圍與格式。 |
| 131016 | 服務暫時無法使用 | Meta 側某項服務暫時無法使用。 | 稍後重試。 |
| 131021 | 收發為同一號碼 | 收件人號碼與傳送號碼是同一個號碼。 | 更換為其他收件人號碼後重發。 |
| 131026 | 對方無法接收 | 收件人不是 WhatsApp 使用者、未接受最新服務條款，或用戶端版本過舊。 | 確認號碼已註冊 WhatsApp；可透過其他管道請對方接受最新條款並升級 WhatsApp。 |
| 131037 | 傳送號碼無已核准顯示名稱 | 傳送號碼沒有已核准的顯示名稱。 | 先完成顯示名稱審核，通過後再傳送。 |
| 131045 | 號碼註冊錯誤 | 訊息因傳送號碼的註冊問題而失敗。 | 確認傳送號碼已完成註冊；如有異常請重新註冊號碼。 |
| 131047 | 超出 24 小時對話視窗 | 距收件人最後一次回覆已超過 24 小時，無法再傳送自由格式訊息。 | 改用已審核通過的範本訊息觸及；使用者回覆後會重新開啟 24 小時視窗。 |
| 131049 | 為維護良好互動體驗，行銷訊息未送達 | 已達到該使用者在一定週期內可接收的行銷範本訊息上限。 | 至少等待 24 小時後再重發，並控制行銷訊息的傳送頻次與內容相關性。 |
| 131050 | 用戶已取消訂閱行銷訊息 | 收件人已選擇不再接收你的行銷訊息。 | **請勿重試。**將該使用者移出行銷名單，僅傳送必要的實用通知類訊息。 |
| 131051 | 不支援的訊息類型 | 使用了不受支援的訊息類型。 | 對照 訊息傳送 API 文件改用受支援的訊息類型。 |
| 131052 | 影音素材下載失敗 | 無法下載使用者傳送的影音內容。 | 請使用者透過其他方式重新提供檔案。 |
| 131053 | 影音素材上傳失敗 | 訊息中的影音檔案上傳失敗。 | 檢查影音檔案的格式與大小是否符合要求後重試。 |
範本與 Flow
此類錯誤與範本本身的狀態、內容或參數填入有關。
| 代碼 | 含義 | 說明 | 處理建議 |
|---|---|---|---|
| 132000 | 範本參數數量不符 | 傳入的變數數量與範本定義的變數數量不一致。 | 依範本實際的變數個數補齊或刪減參數後重發。 |
| 132001 | 範本不存在或未核准 | 範本在指定語言下不存在，或尚未通過審核。 | 確認範本名稱與語言代碼拼寫完全一致（區分大小寫與底線），且範本狀態為「已通過」。 |
| 132005 | 範本譯文過長 | 範本在該語言下的譯文超出長度限制。 | 縮短對應語言的範本文案。 |
| 132007 | 範本內容違反政策 | 範本內容違反 WhatsApp 政策。 | 參照範本審核規範修改內容後重新提交審核。 |
| 132012 | 範本參數格式錯誤 | 變數值的格式與範本定義的格式不一致。 | 依範本定義的參數格式重新填入變數。 |
| 132015 | 範本因品質過低遭暫停 | 範本因品質評分過低遭暫停，暫時無法傳送。 | 編輯範本提升品質，待重新審核通過後使用；期間可改用其他已通過的範本。 |
| 132016 | 範本因品質過低遭永久停用 | 範本多次因品質過低遭暫停，已被永久停用。 | 該範本無法恢復，請以不同內容建立新範本。 |
| 132018 | 範本參數有誤 | 範本中的參數未通過校驗。 | 依錯誤訊息修正參數設定後重新傳送。 |
| 132068 | Flow 遭封鎖 | 所使用的 Flow 處於遭封鎖狀態。 | 檢查並修正 Flow 設定，或改用其他方式觸及使用者。 |
| 132069 | Flow 遭限流 | 該 Flow 1 小時內已傳送 10 則訊息，觸發限流。 | 等待限流視窗結束後再傳送。 |
號碼註冊與驗證
| 代碼 | 含義 | 說明 | 處理建議 |
|---|---|---|---|
| 133000 | 取消註冊未完成 | 先前的取消註冊嘗試未成功，導致無法重新註冊。 | 重新執行取消註冊作業，完成後再進行註冊。 |
| 133004 | 伺服器暫時無法使用 | Meta 伺服器暫時無法使用。 | 稍後重試。 |
| 133005 | 兩步驟驗證 PIN 錯誤 | 請求中的兩步驟驗證 PIN 碼不正確。 | 確認 PIN 碼；如已遺忘，可先停用兩步驟驗證再設定新的 PIN 碼。 |
| 133006 | 號碼需重新驗證 | 號碼需先完成驗證才能註冊。 | 先完成號碼驗證，再執行註冊。 |
| 133008 | PIN 嘗試次數過多 | PIN 碼輸入錯誤次數過多，已遭暫時鎖定。 | 等待鎖定解除後再試。 |
| 133009 | PIN 輸入過快 | PIN 碼提交過於頻繁。 | 稍後再試。 |
| 133010 | 號碼未註冊 | 該號碼尚未在 WhatsApp 商業平台完成註冊。 | 先完成號碼註冊後再傳送。 |
| 135000 | 不明請求參數錯誤 | 請求參數存在未知錯誤。 | 對照介面文件檢查請求語法與參數；持續出現請聯絡 EngageLab 技術支援。 |
傳送號碼狀態
| 代碼 | 含義 | 說明 | 處理建議 |
|---|---|---|---|
| 33 | 傳送號碼已被刪除 | 用於傳送的商業號碼已被刪除。 | 核對傳送號碼是否正確；如已刪除，請改用其他有效傳送號碼或重新註冊。 |
| 133015 | 號碼近期被刪除，刪除尚未完成 | 該號碼近期被刪除，刪除流程尚未完成。 | 等待約 5 分鐘後重試。 |
| 133016 | 註冊／註銷嘗試過多，號碼遭暫時封鎖 | 短時間內對該號碼的註冊/註銷嘗試次數過多，號碼遭暫時封鎖。 | 等待封鎖解除後再試，期間請勿反覆嘗試。 |
EngageLab 平台錯誤碼
| 代碼 | 含義 | 說明 | 處理建議 |
|---|---|---|---|
| 1 | 收件人號碼無效 | 收件人號碼格式不合法，未通過校驗。 | 檢查號碼是否為純數字、帶國碼、不含 +、空格或連字號，修正後重發。 |
| 5000 | 傳送逾時 | 提交訊息至 Meta 時逾時，本則訊息未成功送出。 | 稍後重試。 |
| 5001 | 帳戶餘額不足，訊息未傳送 | 帳戶餘額不足，訊息未傳送。 | 前往主控台儲值後重新傳送；建議開啟餘額告警。 |
