登录开始免费试用
Meta Tech Provider

“您的应用缺少 Cloud API 配套配对所需的 Graph API 权限”

此消息表示发起注册的平台缺少 Meta 要求的 WhatsApp 权限,或这些权限未达到 Meta 要求的访问级别,因此无法将 WhatsApp Business 应用号码连接到 Cloud API。只有平台持有 Advanced access 的权限,Meta 才允许企业授予。企业无法解决此问题,必须由平台修复。

Advanced access

合作伙伴的客户要通过 Embedded Signup 授予各项权限之前,合作伙伴需要满足的条件。

200

在未持有 Advanced access 的情况下,对应用并不拥有的账户使用 whatsapp_business_management 时,API 调用返回的错误。

2 permissions

whatsapp_business_management 和 whatsapp_business_messaging,Meta 表示 WhatsApp 集成通常需要这两项权限。

Tech Provider

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.”(您的应用缺少 Cloud API 配套配对所需的 Graph API 权限。请确认已授予高级 WhatsApp Business 权限,然后重试。)Meta 的公开错误参考文档并未列出这句确切的措辞,但其中每一部分都对应 Meta 有文档记载的内容。

“Your app”指的是运行注册流程的平台所使用的 Meta 应用,而不是手机上的 WhatsApp Business 应用。Meta 没有公开定义 companion pairing;结合上下文来看,它描述的是 Cloud API 接入一个仍注册在 WhatsApp Business 应用中的号码,也就是 Coexistence 的运作方式。而“advanced”WhatsApp Business 权限指的是 Advanced access,即 Meta 通过应用审核授予的访问级别。

涉及哪些权限?

Meta 的权限文档列出了 WhatsApp 集成通常需要的两项权限。whatsapp_business_management 涵盖账户元数据、消息模板、电话号码、分析数据和账户 Webhook。whatsapp_business_messaging 涵盖发送消息,以及接收消息和状态 Webhook。

对于客户使用其应用的合作伙伴,Meta 要求应用所需的每一项权限都通过应用审核并获得 Advanced access。Meta 直接说明了后果:如果某项权限没有 Advanced access,客户就无法通过 Embedded Signup 把该权限授予应用。在没有 Advanced access 的情况下,使用 whatsapp_business_management 对应用并不拥有的账户发起调用,会返回错误 200。

平台可以用 Meta 的 debug_token 端点检查访问令牌,以确认企业实际授予了哪些权限,已授予的权限会列在 scopes 下。

企业可以做什么?

企业自身能做的很少,也不应尝试修改自己的 Meta 设置来消除此错误。解决办法在平台一侧:平台需要是 Tech Provider 或 Solution Partner(Meta 将其列为接入 WhatsApp Business 应用用户的要求),并且需要让 WhatsApp 权限的 Advanced access 获得批准。

企业可以做的是,把确切的消息内容反馈给平台,待平台确认已获得访问权限后再重试,或者改用已经具备该资格的平台。在此之前,在同一平台重试相同的流程只会得到相同的结果,也不会影响手机上的 WhatsApp Business 应用。

常见错误

  • 在企业自己的 Meta 设置中授予更多权限。缺少的访问权限属于平台的应用。
  • 在没有通过应用审核的开发者应用上自行托管工具。没有 Advanced access,企业就无法授予所需的权限。
  • 在同一平台上反复重试。只有该平台的访问权限发生变化,结果才会改变。
使用 EasyCoexistence 完成这些操作

EasyCoexistence 是独立的 Meta Tech Provider,拥有自己的 Meta 应用,并为 Coexistence 运行 Embedded Signup v4,因此企业连接号码时使用的平台已具备 Meta 要求的访问权限。

常见问题

我的 WhatsApp Business 应用出问题了吗?

没有。该消息指的是平台的 Meta 应用,而不是您手机上的应用,您的应用会继续正常使用。

我可以自己授予这项权限吗?

只有平台持有 Advanced access 的权限,才会出现在您的授权列表中。必须先为平台批准缺少的访问权限。

平台如何获得 Advanced access?

作为客户使用其应用的合作伙伴,针对应用所需的每一项权限,通过 Meta 应用审核获得。

企业需要通过应用审核吗?

不需要。Meta 表示,仅访问自己业务数据的直接开发者,既不需要应用审核,也不需要 Advanced access。

继续阅读

准备开始了吗?

几分钟即可设置 WhatsApp Coexistence,而不是几个月。应用会继续在手机上运行。

开始免费试用

验证时间

Coexistence 错误:缺少 Graph API 权限