WhatsApp 錯誤 131005:存取遭拒,缺少權限
錯誤 131005 表示存取權杖缺少 WhatsApp 端點所需的權限,原因是從未授予,或其後被移除。Meta 的說明是「Permission is either not granted or has been removed.」。解決方法是先用存取權杖偵錯工具檢查該權杖,再授予缺少的權限,或改用已具備該權限的權杖。
Meta 為「Permission is either not granted or has been removed.」所定的錯誤代碼。
向 WhatsApp 使用者傳送任何類型訊息所需的權限。
business_management、whatsapp_business_management 和 whatsapp_business_messaging,在產生系統使用者存取權杖時指派。
WhatsApp 錯誤 131005 是甚麼意思?
這表示權杖本身有效,但沒有端點所檢查的權限。
Meta 的 Cloud API 參考文件列出 131005,詳細說明為「Permission is either not granted or has been removed.」。Graph API 錯誤 10 的句子與此完全相同。差別只在範圍:10 是通用的 Graph API 代碼,而 131005 屬於以 131 開頭的 WhatsApp 代碼。
由於文字相同,診斷方式也相同。Meta 對兩者的建議都是使用存取權杖偵錯工具,確認應用程式持有該端點所需的權限。
通常缺少哪項權限?
通常是兩項 WhatsApp 權限之一,視乎呼叫的用途而定。
Meta 的權限指南按用途劃分兩者。傳送任何類型的訊息,以及接收訊息和狀態 Webhook,需要 whatsapp_business_messaging。存取帳戶資料、管理訊息範本、列出電話號碼、查看分析數據和帳戶 Webhook,則需要 whatsapp_business_management。
只帶有管理權限的權杖可以讀取帳戶並列出訊息範本,但一嘗試傳送就會失敗。產生系統使用者存取權杖時,Meta 的存取權杖指南要求同時指派 business_management、whatsapp_business_management 和 whatsapp_business_messaging。
如何修正錯誤 131005?
先讀取權杖,再只更改缺少的部分。
呼叫 debug_token 端點,或把權杖貼到存取權杖偵錯工具。`scopes` 屬性會列出所有已授予的權限。將它與失敗端點的參考頁面作比較。
如果缺少某項權限,請產生包含該權限的新權杖;如果權杖來自合作夥伴流程,則請企業擁有者重新授予。若所有權限都齊備但錯誤仍然出現,請檢查權杖背後的系統使用者是否已獲授權存取該特定 WhatsApp Business Account,因為權杖即使權限範圍完整,仍可能沒有指派到該資產。
常見錯誤
- 以為權杖已過期。權杖過期會回傳 190 或 0。這個代碼表示權杖可用,但缺少權限。
- 產生只有管理權限的權杖,然後用來傳送訊息。傳送訊息需要 whatsapp_business_messaging。
- 只檢查 scopes 就停手。系統使用者還需要獲授權存取該特定 WhatsApp Business Account。
EasyCoexistence 透過 Meta 的 Embedded Signup 為每個號碼完成接入,由企業向應用程式授予權限,而其 MCP 連接器會回報號碼的健康狀況,讓助理在傳送前先作檢查。
常見問題
131005 與錯誤 10 是同一個錯誤嗎?
兩者在 Meta 的參考文件中說明相同。131005 屬於 WhatsApp 範圍,10 則屬於 Graph API 範圍。
設定完成後,權限可以被移除嗎?
可以。Meta 的說明明確涵蓋已被移除的權限,不只是從未授予的權限。
錯誤 131005 會影響手機上的 WhatsApp Business 應用程式嗎?
不會。它只涉及 API 存取權杖。手機上的應用程式會照常運作。
遇到錯誤 131005 後應該重試嗎?
不應該。使用同一個權杖重試只會得到相同結果。請先修正權限。
繼續閱讀
準備開始嗎?
幾分鐘內設定 WhatsApp Coexistence,而非幾個月。應用程式在手機上仍可繼續運作。
開始免費試用驗證日期