我們即將停用內部部署 API。請參閱我們的內部部署 API 停用文件以取得詳細資訊，並瞭解如何轉移到我們的新一代雲端 API。

錯誤和狀態訊息

本文件提供下列錯誤和狀態訊息類型的詳細資訊：

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

如需內嵌註冊的疑難排解，請參閱內嵌註冊流程錯誤。

WhatsApp Business API 用戶端錯誤代碼

錯誤代碼	說明
`400` – 媒體下載錯誤	無法從傳送者處下載媒體。
`402` – 企業資格 – 付款問題	發生以下一或多個付款方式相關錯誤，因此無法傳送訊息。付款帳號未附加至 WhatsApp 帳號信用額度超出限制未設定或啟用信用額度（付款帳號） WhatsApp Business 帳號遭刪除帳號已遭我方停權未設定時區未設定幣別代表（OBO）發送的 MessagingFor 要求仍在處理中或已婉拒超過對話免費層級門檻且缺少有效的付款方式。（此錯誤類型將於 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 個 `section` 物件，最多可以有 10 個。
`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 帳號（WABA），或是處於無效狀態。
`2068` – 流程遭封鎖	流程處於封鎖狀態。如果流程使用端點且所需的設定不完整，也可能會傳回此錯誤，例如，公開密鑰未上傳或失效。請參閱實作流程端點。
`2069` – 流程遭限速	流程處於限速狀態，在過去一小時內已經傳送 10 則使用此流程的訊息。

如需印度企業專用的「商務管理工具」錯誤代碼，請參閱企業商家使用說明。

HTTP 狀態代碼

以下是 WhatsApp Business API 用戶端可用的 HTTP 狀態代碼。

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

WhatsApp Business 平台 | 雲端 API | 內部部署 API | Business Management API