# 用户出群
用户主动退群或被移出群聊时推送事件。
注意事项:
- 需要开启机器人能力
- 需要订阅 [消息与群组] 分类下的 [用户出群] 事件
- 事件会向群内订阅了该事件的机器人进行推送
# 事件
基本 | |
---|---|
事件类型 | im.group.users.leave |
支持的应用类型 | 自建应用 |
权限要求 开启任一权限即可 | 获取群用户离开群事件 |
字段权限要求 | 该接口返回体中存在下列敏感字段,仅当开启对应的权限后才会返回;如果无需获取这些字段,则不建议申请 获取用户 user ID |
# 事件体
名称 | 类型 | 描述 |
---|---|---|
schema | string | 事件模式 |
header | event_header | 事件头 |
∟event_id | string | 事件 ID |
∟event_type | string | 事件类型 |
∟create_time | string | 事件创建时间戳(单位:毫秒) |
∟token | string | 事件 Token |
∟app_id | string | 应用 ID |
∟tenant_key | string | 租户 Key |
event | ||
∟group_id | string | 群ID |
∟open_ids | array | 事件发生涉及用户的 open id 集合 |
∟user_ids | array | 事件发生涉及用户的 user id 集合 字段权限要求: 获取用户 user ID |
∟union_ids | array | 事件发生涉及用户的 union id 集合 |
# 事件体示例
字段值仅为示例值
{
"event":{
"group_id":"3ee065a7369ae8811kwYD_bi",
"open_ids":["ou_c6dfe8be6194c731125c0d58e42bc6b1","ou_49315ade9392bb7504114cbfdd1840cc"],
"union_ids":["on_e6904078fa9f91eac630dbf37abe8501","on_6dce655c581cb825afe260227b352864"],
"user_ids":["sn22mfuyswjZuCd","bb2mc7ARb400ZlZU"]
},
"header":{
"app_id":"bli_xxxxxx",
"create_time":"1702352863117",
"event_id":"47994249-de03-4d2d-a03f-5bb923abe7b4",
"event_type":"im.group.users.leave",
"tenant_key":"327ab1e8160c0b783kUZ",
"token":"df75ec28a6ce42e19cb064db24f20617"
},
"schema":"1.0"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
← 各类型消息Content 用户进群 →