WhatsApp Cloud API注册手机号时权限缺失问题排查

调用[POST] https://graph.facebook.com/v23.0/PHONE_NUMBER_ID/register接口时返回如下权限错误：

{
    "error": {
        "message": "(#100) Missing Permission",
        "type": "OAuthException",
        "code": 100,
        "fbtrace_id": "xxxxxxxxxx"
    }
}

请求体配置符合文档要求：

{
    "messaging_product": "whatsapp",
    "pin": "000000",
    "tier": "prod",
    "access_token": "xxx......."
}

已确认access_token包含business_management、whatsapp_business_management和whatsapp_business_messaging权限，可能的问题点如下：

• 缺少whatsapp_business_phone_number_registration权限：该权限是WhatsApp手机号注册/验证操作的专属权限，嵌入式注册流程明确要求此权限，若未添加会直接触发缺失权限错误。
• 权限未完成审核：即使token显示包含权限，若权限处于待审核或未通过状态，实际调用时会被拒绝。需到Meta开发者后台检查应用权限的审核状态，确保所有必要权限已获批。
• token所属账号角色不足：生成access_token的账号需是对应WhatsApp Business账户的管理员或运营者角色，普通成员角色无法执行注册操作。
• ID或版本不匹配：确认PHONE_NUMBER_ID属于当前token关联的Business账户，同时检查v23.0版本是否兼容该注册接口，版本不兼容也可能引发权限类报错。

内容的提问来源于stack exchange，提问作者gilzonme