用户个人主页 API

用户个人主页 API 可帮助您使用 Instagram 范围编号 (IGSID) 检索客户个人主页信息。您可使用此信息，为与您的公司互动的客户提供个性化体验。

用户同意

访问用户个人主页需要获得用户同意。仅在用户向商家发送消息或点击开场白或固定菜单时，才会设置用户同意。如果用户是对帖子或评论发表评论，而未向商家发送消息，您的应用将收到错误：访问用户个人主页需要获得用户同意。

要求

您将需要：

instagram_basic 权限
instagram_manage_messages 权限
pages_manage_metadata 权限
pages_read_engagement 权限
pages_show_list 权限
可在公共主页上执行 MODERATE 任务的用户所请求的公共主页访问口令

限制

如果客户已屏蔽您的公司，您将无法查看其信息。

用户个人主页的字段

所有图谱 API 版本均可提供以下个人主页字段。

字段名称	描述
`name` 字符串	客户名称（如果未设置名称，可为 null）
`profile_pic` 网址	客户头像的网址（如果未设置头像，可为 null）。此网址会在数天后过期。

图谱 API v12.0 和更高版本可提供以下个人主页字段。

字段名称	描述
`is_verified_user` 布尔值	客户认证状态
`follower_count` 整数	客户的关注者人数
`is_user_follow_business` 布尔值	指明客户是否关注公司
`is_business_follow_user` 布尔值	指明公司是否关注客户

图谱 API v14.0 和更高版本可提供以下字段。

字段	描述
`username` 字符串	客户 Instagram 帐户的帐号

示例

若要获取客户的个人主页信息，请向客户的 Instagram 范围编号节点发送 GET 请求，并加入要查看的字段。

请求示例

为方便阅读，已设置格式。

curl -X GET "https://graph.facebook.com/v19.0/instagram-scoped-user-id
  ?fields=name,username,profile_pic,follower_count,is_user_follow_business,is_business_follow_user
  &access_token=page-access-token"

若请求成功，应用会收到以下 JSON 响应：

{
  "name": "Peter Chang",
  "username": "peter_chang_live",
  "profile_pic": "https://fbcdn-profile-...",
  "follower_count": 1234
  "is_user_follow_business": false,
  "is_business_follow_user": true,
}

开发者支持

使用 Meta 状态工具可查看 Meta 商务产品的状态和中断情况。
使用 Meta 开发者支持工具可报告漏洞、查看报告的漏洞、获取有关广告或商务管理平台的帮助等等。
访问 Messenger 开放平台支持资源可查看 Messenger 开放平台的更多支持资源。