# 用户出群

用户主动退群或被移出群聊时推送事件。

注意事项:

  • 需要开启机器人能力
  • 需要订阅 [消息与群组] 分类下的 [用户出群] 事件
  • 事件会向群内订阅了该事件的机器人进行推送

# 事件

基本
事件类型 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
最后更新于 : 4/15/2024, 9:31:23 PM