# 用户添加好友

通过传 scene_param 中的 callback_data 可区分不同来源的添加好友场景。

# 事件

字段
事件名 FRIEND_ADD
Intent GROUP_AND_C2C_EVENT (1<<25)

# 事件体

名称 类型 描述
timestamp integer 添加时间戳(Unix 秒)
openid string 用户 OpenID
scene integer 加好友场景值。1000=缺省默认, 1001=网络搜索(全部tab), 1002=网络搜索(机器人tab), 1003=群场景, 1004=空间场景, 2001=站内分享资料页, 2002=站外分享资料页, 2003=开发者生成的分享链接(站内), 2004=开发者生成的分享链接(站外)
scene_param string 开发者自定义的回调数据(callback_data),用于区分不同来源
author FriendAuthor 用户信息
short_code string 机器人分享链接的短链code

FriendAuthor

名称 类型 描述
union_openid string 用户统一 OpenID(跨应用标识)

# 事件示例

用户添加好友(网络搜索场景)

{
  "openid": "A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4",
  "timestamp": 1784570523,
  "scene": 1001,
  "scene_param": "",
  "author": {
    "union_openid": "DB85A74E07BA08B5B44CD9ED332FCBD2"
  }
}
1
2
3
4
5
6
7
8
9

用户添加好友(开发者分享链接)

{
  "openid": "A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4",
  "timestamp": 1784570600,
  "scene": 2003,
  "scene_param": "callback_abc123",
  "author": {
    "union_openid": "DB85A74E07BA08B5B44CD9ED332FCBD2"
  }
}
1
2
3
4
5
6
7
8
9
上次更新: 8/13/2026, 12:37:16 PM
手机QQ扫码
开发者社区
加入官方频道开发者社区