如何从Instagram Messenger webhook中获取Instagram用户名

基础逻辑说明 #

Instagram返回的Scoped User ID为应用专属标识，与用户全局ID、用户名不存在公开映射关系，所有非官方授权的查询方式均无法生效。 #

可落地解决方案 #

• 扩展Webhook订阅字段
  在Meta开发者后台的Instagram Webhook配置页，新增username字段的订阅权限，后续触发对应事件时，Webhook返回的payload会直接包含用户名信息，无需额外调用接口。
• 商业账号专属接口查询
  如果目标账号为Instagram商业/创作者账号且已绑定Facebook公共主页，可直接调用Graph API的用户节点查询，请求参数中指定fields=username，同时传入对应主页的有效访问令牌即可获取结果。示例请求格式：
  GET /v18.0/{ig-scoped-user-id}?fields=username&access_token={valid-page-access-token}
• 授权阶段预存映射关系
  针对普通个人账户，在用户OAuth授权环节申请instagram_basic权限，授权成功后同步获取用户的Scoped ID和用户名存入本地数据库，后续Webhook触发时直接查询本地映射表即可匹配到用户名。

不可用方案规避 #

• 所有公开爬虫、第三方非官方接口均无法通过Scoped ID查询到用户名，此类请求会返回权限错误或无效数据
• 2020年已下线的Instagram Legacy API无使用价值，所有调用请求均不会返回有效结果

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