登录开始免费试用
Meta Tech Provider

WhatsApp 错误 131005:访问被拒绝,缺少权限

错误 131005 表示访问令牌缺少 WhatsApp 端点所需的某项权限,原因是该权限从未授予,或之后被移除。Meta 的说明是 “Permission is either not granted or has been removed.”。解决办法是先用访问令牌调试器检查令牌,再授予缺失的权限,或改用已具备该权限的令牌。

131005

Meta 对此代码的说明为 “Permission is either not granted or has been removed.”

whatsapp_business_messaging

向 WhatsApp 用户发送任何类型的消息所需的权限。

3 permissions

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 完成这些操作

EasyCoexistence 通过 Meta 的 Embedded Signup 为每个号码完成接入,由企业向应用授予所需权限;其 MCP 连接器会报告号码的连接状态,助手可在发送前先行检查。

常见问题

131005 与 10 是同一个错误吗?

两者在 Meta 的参考文档中说明相同。131005 属于 WhatsApp 范围,10 属于 Graph API 范围。

设置完成后权限还会被移除吗?

会。Meta 的说明明确包含已被移除的权限,而不只是从未授予的权限。

错误 131005 会影响手机上的 WhatsApp Business 应用吗?

不会。它只涉及 API 访问令牌。手机上的应用照常使用。

出现错误 131005 后应该重试吗?

不应该。使用同一令牌重试只会得到相同的结果。请先修复权限。

继续阅读

准备开始了吗?

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

开始免费试用

验证时间

WhatsApp 错误 131005:访问被拒绝,缺少权限