在WhatsApp Cloud API添加手机号时遭遇权限错误的技术问询

数据老陈

2026-7-6

解决WhatsApp Cloud API添加手机号时的权限错误

当调用WhatsApp Cloud API添加手机号时出现 this whatsapp business account does not have permission to add phone numbers to the account 错误，可按以下步骤排查解决：

确认账号角色权限
你当前使用的Meta账号必须拥有目标WhatsApp Business Account的管理员或账号编辑者角色，仅"查看者"角色无添加号码权限。可在Meta Business Suite的「商务设置」→「账号」→「WhatsApp Business账号」→「人员与资产」中检查并调整角色分配。
验证商务管理平台关联与权限
确保你的个人Meta账号已与目标WhatsApp Business账号正确绑定，且在Meta商务管理平台（Business Manager）中拥有完整的账号管理权限。新创建的账号可能存在权限延迟，若刚注册完成，可等待1-2小时后重试。
检查API调用凭证权限
调用API时使用的访问令牌（系统用户令牌或用户令牌）必须包含whatsapp_business_management权限，且权限范围覆盖phone_numbers操作。生成令牌时需明确勾选对应WhatsApp Business账号的管理权限，同时确认令牌未过期。
排查账号状态限制
若WhatsApp Business账号存在违规记录、未完成商业信息审核或身份验证，会被限制添加号码操作。可在Meta Business Suite的「账号设置」→「账号健康」中查看账号状态，完成未完成的验证流程或申诉违规记录。
确认待添加号码合规性
待添加的手机号必须是你拥有合法使用权的号码，且未被WhatsApp封禁，号码归属地建议与账号主体信息匹配，避免因合规问题触发权限限制。