我們即將停用內部部署 API。詳情請參閱內部部署 API 停用文件，並從中了解如何轉用新一代雲端 API。

錯誤和狀態訊息

本文件將提供更多關於下列錯誤和狀態訊息類型的資訊：

WhatsApp Business API 用戶端錯誤代碼
HTTP 狀態代碼

請參閱內嵌註冊流程錯誤，了解關於解決內嵌註冊疑難的資訊。

WhatsApp Business API 用戶端錯誤代碼

錯誤代碼	說明
`400`：媒體下載錯誤	無法下載來自傳送者的媒體。
`402`：商家資格 — 付款問題	您的付款方式出現一個或多個錯誤，因此無法傳送訊息。付款帳戶尚未附加至 WhatsApp 帳戶信用額度超出上限未設定或未啟用信用額度（付款帳戶） WhatsApp Business 帳戶已遭刪除帳戶遭我方停用未設定時區未設定貨幣 MessagingFor 要求（代表要求（OBO））正待處理或遭拒絕超出免費期間對話的限制門檻而未設定有效的付款方式（此錯誤類型於 2022 年 2 月 1 日開始生效）檢查您在 WhatsApp 管理工具中的付款設定，然後再試一次。
`408`：訊息無效	訊息處理時間太長（即多於 1 天），因此無法傳送。如果 WhatsApp Business API 用戶端關閉超過一天，然後再重新開啟，便會出現此情況。請重新傳送訊息。
`410`：訊息已過期	訊息未能在其存留時間（TTL）內傳送。
`429`：達到限速限制	傳出的訊息：此電話號碼在短時間內傳送了太多訊息，因此無法傳送訊息。重新傳送無法傳送的訊息。接收的訊息：基於限速原因，無法成功下載媒體。請傳送者重新傳送訊息。
`430`：憑證未簽署	出現憑證相關錯誤，因此無法傳送訊息。請從 WhatsApp 管理工具下載新的憑證並重新註冊。
`432`：憑證編號不符	出現憑證相關錯誤，因此無法傳送訊息。請從 WhatsApp 管理工具下載新的憑證並重新註冊。
`433`：憑證簽署無效	傳送訊息時，如果沒有以用戶端的身分驗證密鑰正確簽署商家用戶端的憑證，便會出現此代碼。這很可能代表用戶端使用了新的身分驗證密鑰重新註冊，但尚未完成整個憑證建立流程。
`470`：重新互動訊息	距離顧客上一次回覆此號碼的時間已超過 24 小時，因此無法傳送訊息。請使用訊息範本回覆。
`471`：達到垃圾訊息限速額度	此電話號碼可傳送的訊息數量受限，因此無法傳送訊息。這可能是之前有太多訊息被封鎖或被標記為垃圾訊息所致。請在 WhatsApp 管理工具中檢查品質狀態。請參閱根據品質而定的限速說明文件了解詳情。
`472`：用戶的電話號碼供實驗用途	此用戶的電話號碼供實驗用途，因此無法傳送訊息。請略過不向此用戶傳送訊息。
`480`：用戶資訊或有所變更	此電話號碼的用戶資訊或有所變更，因此無法傳送訊息。
`500`：一般錯誤	出現未知錯誤，因此無法傳送訊息。請稍後再試。
`501`：目前不支援此訊息類型。	目前不支援附上說明文字的文件訊息。
`1000`：一般錯誤
`1001`：訊息過長	訊息長度超過 4096 個字元。
`1002`：傳送對象類型無效	有效的傳送對象類型： `individual`
`1004`：資源已存在	媒體檔案上載要求可能存在 UUID 衝突，或包含該 UUID 的媒體檔案已存在。
`1005`：存取遭拒	媒體目錄不可寫入（上載要求），或憑證無效，或憑證錯誤，或應用程式已過期：需要升級版本，或此帳戶的 `button` 訊息已停用，或號碼已在 WhatsApp 上註冊（參閱轉移電話號碼以了解如何將電話號碼從 WhatsApp 轉移至 WhatsApp Business API），或如果您的商家在印度傳送商務訊息，請確保您已填寫所有必填的商家檔案和商品項目欄位。如欲了解更多相關資訊，請查看 https://www.facebook.com/business/help/1104628230079278。
`1006`：無法找到資源	無法找到檔案或資源。
`1007`：傳送對象遭封鎖而無法接收訊息（已停用）	傳送對象不在許可名單上。
`1008`：欠缺必要參數	欠缺必要的參數。若您嘗試傳送清單訊息，您可能會欠缺 `section` 物件的 `title` 部分或 `rows` 的 `ID`。如果您正在傳送單件產品訊息或多件產品訊息，您可能會欠缺 `catalog_id` 或 `product_retailer_id`。如要傳送這種類型的訊息，這些欄位均為必要項目。
`1009`：參數值無效	輸入的參數值類型錯誤，或者存在其他問題。若您嘗試傳送清單訊息，請檢查每列的編號是否為不重複。如果您正在傳送單件產品訊息，您可能傳送了錯誤的 `catalog_id`。請返回商務管理工具並再次檢查。如果您正在傳送多件產品訊息，請檢查每個部分的 `product_retailer_id` 是否為不重複，以及確保 `header` 和 `body` 物件均存在並已獲分配值。
`1010`：包含不必要參數	包含不必要的參數。
`1011`：服務尚未可供使用
`1013`：用戶無效
`1014`：內部錯誤	無法上載不良圖像（無法正確上載圖像）或無法找到端點。您提供的雜湊值與用戶的最新雜湊值不符。
`1015`：要求數量過多	用戶端達到限速限制。
`1016`：系統超載	如果系統負載過重，便會傳回此訊息，以讓系統從負載中恢復。
`1017`：非主要主節點	當您將僅適用於主節點的要求（如設定配置、獲取設定、匯入、匯出、獲取代碼要求和註冊等）傳送至並非主要主節點的節點時，就會收到此錯誤。如果 WhatsApp Business API 用戶端設定不當或存在內部錯誤，便可能會發生此類情況。請重新嘗試作出要求，應該便可解決此錯誤。如果這仍無法解決錯誤，請聯絡支援團隊。
`1018`：非主要核心應用程式	如果您向一個核心應用程式節點傳送要求，但對象並非分片擁有者，或其處於成為分片擁有者的過程中，便會收到此錯誤。當我們在多點連線設定中進行分片容錯轉移時，您可能會看到此錯誤。在大多數情況下，您可以重新嘗試作出要求，以解決此錯誤。如果無法解決，請聯絡支援團隊。
`1021`：錯誤用戶	如果您向自己傳送訊息，便會收到此錯誤。如要解決此問題，請向不屬於您的電話號碼傳送訊息。
`1022`：尚未配置 Webhooks 網址	如果您尚未配置 REST API Webhooks 的格式，便會收到此錯誤。
`1023`：發生數據庫錯誤
`1024`：需要變更密碼	您需要更改密碼。
`1025`：要求無效	要求無效。
`1026`：接收者無法接收	無法傳送訊息。請參閱「為什麼我的送達率不是 100%？」常見問題。
`1028`：需要確認 `user_identity_changed` 系統通知	您向可能有所變更的 WhatsApp 用戶傳送了一則訊息，系統已向您傳送 `user_identity_changed` 系統通知，正在等待確認。
`1031`：傳送者帳戶被鎖定	由於違反誠信政策，您的帳戶已被鎖定，無法傳送任何訊息。詳情請參閱 WhatsApp Business 平台政策執行。
`2000`：範本參數數量不符	提供的參數數量與預期參數數量不符。
`2001`：欠缺範本	範本狀態不在正常使用中，或者欠缺某個語言和本地語言的範本。
`2002`：範本擷取失敗	接收者無法下載範本。
`2003`：欠缺範本套件	欠缺特定語言和本地語言的範本。
`2004`：範本參數長度過長	參數長度過長。
`2005`：範本填入文字過長	翻譯文字過長。
`2006`：違反範本空格政策	違反空格政策。
`2007`：違反範本格式字元政策	違反格式字元政策。
`2008`：範本媒體格式不支援	所用的媒體格式不支援。
`2009`：欠缺範本所需元件	欠缺範本的所需元件。
`2010`：範本填入網址無效	按鈕元件的網址無效。
`2011`：範本電話號碼無效	按鈕元件的電話號碼無效。
`2012`：範本參數格式不符	參數格式與已建立的範本格式不符。
`2013`：範本按鈕不支援	接收者不支援按鈕。
`2014`：預期的命名空間為空白	如果尚未下載範本訊息語言套件，便會出現此錯誤。
`2015`：區塊數量無效	訊息要求包含的區塊數量小於最小值或大於最大值。如要了解更多資訊，請參閱 `section` 物件。您必須擁有 1 個至 10 個 `section` 物件。
`2016`：列數無效	列數無效。清單訊息的每個 `section` 必須存在最少一個 `rows` 物件。
`2017`：違反字元政策	違反格式字元政策。
`2023`：商品數量無效	此部分物件沒有任何商品，或商品總數超過允許的上限。
`2024`：未找到目錄編號	您提供的目錄編號不存在或不屬於您的 WhatsApp Business 帳戶（WABA）。
`2025`：目錄編號未連結至 API 號碼	您提供的目錄編號未連結至目前用於傳送訊息的電話號碼。
`2026`：欠缺產品	無法在目錄中找到您要求中提供的部分產品。
`2027`：找不到任何產品	無法在您提供的目錄中找到任何產品。
`2028`：列出所有不合規的產品	僅適用於印度的商家。當商家傳送單一商品訊息，但其中的商品欠缺電子商務合規資訊或資訊不完整時，便會傳回此錯誤。
`2029`：列出部分不合規的產品	僅適用於印度的商家。當商家傳送多商品訊息，但其中的商品欠缺電子商務合規資訊或資訊不完整時，便會傳回此錯誤。
`2030`：列出混合無效和不合規的產品	僅適用於印度的商家。當商家傳送多商品訊息，但其中混合著無效商品及欠缺電子商務合規資訊的商品，便會傳回此錯誤。
`2036`：頁首結構無效	當 `header` 物件結構無效時，便會傳回此代碼。
`2050`：欠缺合規資訊	僅適用於印度的商家。如果商家未有提供任何合規資訊，便會傳回此錯誤。參見商業合規端點。
`2060`：範本已被拒	範本狀態為 `REJECTED`，因此無法傳送。
`2061`：範本已暫停	範本狀態為 `PAUSED`，因此無法傳送。
`2062`：範本已停用	範本狀態為 `DISABLED`，因此無法傳送。
`2064`：流程編號無效	具有指定編號的流程不存在或不屬於您的 WhatsApp Business 帳戶，或處於無效狀態。
`2068`：流程已封鎖	流程處於封鎖狀態。如果流程使用端點且所需的設定並未完成，例如公開金鑰未上載或已無效，亦可能會傳回此錯誤。請參閱實現流程的端點。
`2069`：流程已限速	流程處於限速狀態，過去 1 小時內已使用此流程傳送 10 則訊息。

如需了解專屬於印度商家的商務管理工具錯誤代碼，請參見企業商家幫助中心。

HTTP 狀態代碼

此為 WhatsApp Business API 用戶端可能會用到的 HTTP 狀態代碼。

HTTP 代碼	說明
`2xx`	成功
`200`	成功（OK）
`201`	已成功建立（適用於 POST 要求）
`302`	已找到
`4xx`	用戶端錯誤
`400`	要求無效
`401`	未授權
`403`	禁止
`404`	無法找到
`405`	不得使用此方法
`412`	先決條件失效
`420`	訊息受限速限制
`429`	要求過多
`5xx`	伺服器錯誤
`500`	內部伺服器錯誤
`504`	逾時

WhatsApp Business 平台 | 雲端 API | 企業內部 API | 企業管理 API