WhatsApp 錯誤 0:無法驗證應用程式使用者
錯誤代碼 0 表示 Meta 無法驗證存取權杖背後的應用程式使用者。Meta 的說明為:「We were unable to authenticate the app user.」原因可能是存取權杖已過期、已失效,或使用者已封鎖所有應用程式存取其資料。解決方法是取得新的存取權杖,而不是重試。
Meta 對「We were unable to authenticate the app user.」所用的代碼。
存取權杖已過期、已失效,或使用者更改了設定而封鎖所有應用程式。
Meta 另設代碼,專門對應已過期的存取權杖。
WhatsApp 錯誤代碼 0 是什麼意思?
這表示平台收到請求,但無法將它對應到一個可信任的應用程式使用者。
Meta 在 Cloud API 錯誤參考中,把代碼 0 歸入授權錯誤,詳細說明為「We were unable to authenticate the app user.」Meta 列出的可能原因全部與存取權杖有關:權杖已過期、已失效,或授予權杖的人更改了設定,阻止所有應用程式存取其資料。
清單中沒有任何一項涉及電話號碼、WhatsApp Business 帳戶或正在傳送的訊息。請求還未走到那一步,這些項目都沒有被檢查。
如何修復錯誤 0?
取得新的存取權杖。這是 Meta 列出的補救方法,也是唯一有效的方法。
更換之前,請先釐清是三個成因中的哪一個,因為忽略成因,問題只會再次出現。有效期短的使用者存取權杖會按時再次過期。已失效的存取權杖在有人重新授予存取權之前會一直失敗。如果使用者已完全關閉應用程式存取,必須先重新開啟,該使用者的任何存取權杖才能運作。
對於伺服器之間的傳送,Meta 的存取權杖指南建議使用 System User 存取權杖,並指出這類權杖有效期長,適合不需要使用者操作的自動化服務。
錯誤 0 與錯誤 190 是否相同?
兩者在實際情況中有重疊,但 Meta 將它們分開列出。
錯誤 190 的詳細說明是「Your access token has expired.」錯誤 0 的範圍較廣:包括已過期的存取權杖、已失效的存取權杖,以及使用者完全封鎖應用程式存取。兩者位於同一個授權表格,處理方法同樣是取得新的存取權杖。
實際差別在於診斷。190 告訴您存取權杖已經到期。0 只告訴您驗證失敗,原因要由您自行查明。這一步值得先做,否則換上的新存取權杖可能一小時後以完全相同的方式失敗。
常見錯誤
- 重試同一個請求。未通過驗證的存取權杖仍然無法通過驗證,每次重試都會再次回傳代碼 0。
- 重新連接號碼。號碼從未被檢查,再次為它辦理接入只會要求企業主做無謂的工作。
- 為後端工作簽發新的短效使用者存取權杖。它會按時過期,錯誤隨之再現。
EasyCoexistence 為每個連接保存第二個存取權杖,所以當其中一個憑證被拒絕時,另一個仍可讀取帳戶,並顯示號碼本身是否正常。
常見問題
錯誤 0 是否表示我的號碼已斷開連接?
不是。Meta 列出代碼 0 的原因全部與存取權杖有關,與號碼及手機上的 WhatsApp Business 應用程式無關。
錯誤 0 記載在哪裡?
記載於 Meta 的 Cloud API 錯誤代碼參考中的授權錯誤表格。Cloud API 建基於 Graph API,兩者使用相同的錯誤格式。
等待一段時間,錯誤 0 會自動消失嗎?
不會。已過期或已失效的存取權杖不會自行恢復,必須取得新的存取權杖。
如何查看存取權杖的功能範圍?
使用 Meta 的存取權杖偵錯工具或 debug_token 端點。兩者都會顯示權杖是否有效、何時到期,以及附帶哪些權限。
繼續閱讀
準備開始嗎?
幾分鐘內設定 WhatsApp Coexistence,而非幾個月。應用程式在手機上仍可繼續運作。
開始免費試用驗證日期