「Your app is missing required Graph API permissions for Cloud API companion pairing」
此訊息表示啟動註冊流程的平台,缺少 Meta 要求的 WhatsApp 權限,或權限未達 Meta 要求的存取層級,因而無法將 WhatsApp Business 應用程式號碼連接至 Cloud API。Meta 只允許企業授予平台已取得進階存取權限的權限。企業無法自行修正,必須由平台處理。
合作夥伴須先為每項權限取得相應資格,其客戶才能透過 Embedded Signup 授予該權限。
當 whatsapp_business_management 用於應用程式並非擁有者的帳戶,且沒有進階存取權限時,API 呼叫會回傳的錯誤。
whatsapp_business_management 與 whatsapp_business_messaging,Meta 指 WhatsApp 整合一般都需要這兩項。
Meta 要求平台必須已是 Solution Partner 或 Tech Provider,才能讓 WhatsApp Business 應用程式用戶完成接入。
這則訊息是什麼意思?
完整內容為:「Your app is missing required Graph API permissions for Cloud API companion pairing. Please verify advanced WhatsApp Business permissions are granted, then try again.」Meta 的公開錯誤參考文件並未列出這段確切字句,但其中每個部分都對應到 Meta 有記載的內容。
「Your app」指的是執行註冊流程的平台所使用的 Meta 應用程式,而不是手機上的 WhatsApp Business 應用程式。Meta 沒有公開定義 companion pairing;依上下文理解,它指的是 Cloud API 加入一個仍登記在 WhatsApp Business 應用程式內的號碼,也就是 Coexistence 的運作方式。至於「advanced」WhatsApp Business 權限,指的是進階存取權限,即 Meta 透過 App Review 授予的層級。
涉及哪些權限?
Meta 的權限文件列出 WhatsApp 整合一般都需要的兩項權限。whatsapp_business_management 涵蓋帳戶中繼資料、訊息範本、電話號碼、分析資料與帳戶 Webhook。whatsapp_business_messaging 涵蓋傳送訊息,以及接收訊息與狀態 Webhook。
對於由客戶使用其應用程式的合作夥伴,Meta 要求應用程式所需的每項權限都須通過 App Review 並取得進階存取權限。Meta 直接說明了後果:若某項權限沒有進階存取權限,客戶就無法透過 Embedded Signup 將該權限授予應用程式。在沒有進階存取權限的情況下,以 whatsapp_business_management 對應用程式並非擁有者的帳戶發出呼叫,會回傳錯誤 200。
平台可以使用 Meta 的 debug_token 端點檢查存取權杖,確認企業實際授予了哪些權限,已授予的權限會列在 scopes 之下。
企業可以怎樣做?
企業自身能做的很少,也不應嘗試更改 Meta 設定來消除這個錯誤。問題出在平台:平台必須是 Tech Provider 或 Solution Partner,Meta 將此列為接入 WhatsApp Business 應用程式用戶的要求,而且平台須為相關 WhatsApp 權限取得已獲批的進階存取權限。
企業可以做的是將確切的訊息回報給平台,待平台確認已取得存取權限後再重試,或改用已具備該資格的平台。在此之前,於同一平台重複同一流程只會得到相同結果,也不會影響手機上的 WhatsApp Business 應用程式。
常見錯誤
- 在企業自己的 Meta 設定中授予更多權限。缺少的存取權限屬於平台的應用程式。
- 在開發者應用程式上自行架設工具,卻沒有通過 App Review。沒有進階存取權限,企業就無法授予所需的權限。
- 在同一平台反覆重試。只有該平台的存取權限改變,結果才會改變。
EasyCoexistence 是獨立的 Meta Tech Provider,擁有自己的 Meta 應用程式,並以 Embedded Signup v4 提供 Coexistence,讓企業透過已具備 Meta 所要求存取權限的平台連接號碼。
常見問題
我的 WhatsApp Business 應用程式出了問題嗎?
沒有。這則訊息指的是平台的 Meta 應用程式,不是您手機上的應用程式,後者會繼續正常運作。
我可以自行授予這項權限嗎?
只有平台已取得進階存取權限的權限,才會顯示讓您授予。缺少的存取權限必須先為平台獲批。
平台如何取得進階存取權限?
作為由客戶使用其應用程式的合作夥伴,須為應用程式所需的每項權限,通過 Meta App Review。
企業需要通過 App Review 嗎?
不需要。Meta 指出,直接的開發者若只存取自己的企業資料,既不需要 App Review,也不需要進階存取權限。
繼續閱讀
準備開始嗎?
幾分鐘內設定 WhatsApp Coexistence,而非幾個月。應用程式在手機上仍可繼續運作。
開始免費試用驗證日期