用户进群

新用户进群（包含话题群）触发此事件。

注意事项：

需要订阅消息与群组分类下的用户进群事件

事件会向群内订阅了该事件的机器人进行推送

事件

基本
事件类型	im.chat.member.user.added_v1
支持的应用类型	自建应用商店应用
权限要求开启任一权限即可	获取与更新群组信息获取群组信息
字段权限要求	该接口返回体中存在下列敏感字段，仅当开启对应的权限后才会返回；如果无需获取这些字段，则不建议申请获取用户 user ID仅自建应用
推送方式	Webhook

事件体

名称收起子列表	类型	描述
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	-	-
chat_id	string	群组 ID，详情参见群ID 说明
operator_id	user_id	用户 ID
union_id	string	用户的 union id
user_id	string	用户的 user id字段权限要求：获取用户 user ID仅自建应用
open_id	string	用户的 open id
external	boolean	是否是外部群
operator_tenant_key	string	操作者租户 Key
users	chat.member.user[]	被添加的用户列表
name	string	用户名字
tenant_key	string	租户Key，为租户在飞书上的唯一标识，用来换取对应的tenant_access_token，也可以用作租户在应用中的唯一标识
user_id	user_id	用户 ID
union_id	string	用户的 union id
user_id	string	用户的 user id字段权限要求：获取用户 user ID仅自建应用
open_id	string	用户的 open id
name	string	群名称
i18n_names	i18n_names	群国际化名称
zh_cn	string	中文名
en_us	string	英文名
ja_jp	string	日文名

事件体示例

{
    "schema": "2.0",
    "header": {
        "event_id": "5e3702a84e847582be8db7fb73283c02",
        "event_type": "im.chat.member.user.added_v1",
        "create_time": "1608725989000",
        "token": "rvaYgkND1GOiu5MM0E1rncYC6PLtF7JV",
        "app_id": "cli_9f5343c580712544",
        "tenant_key": "2ca1d211f64f6438"
    },
    "event": {
        "chat_id": "oc_413871888e0d5492e25b173f0812efb7",
        "operator_id": {
            "union_id": "on_8ed6aa67826108097d9ee143816345",
            "user_id": "e33ggbyz",
            "open_id": "ou_84aad35d084aa403a838cf73ee18467"
        },
        "external": false,
        "operator_tenant_key": "3774yuu3743",
        "users": [
            {
                "name": "user name",
                "tenant_key": "3774yuu3743",
                "user_id": {
                    "union_id": "on_8ed6aa67826108097d9ee143816345",
                    "user_id": "e33ggbyz",
                    "open_id": "ou_84aad35d084aa403a838cf73ee18467"
                }
            }
        ],
        "name": "群名称测试",
        "i18n_names": {
            "zh_cn": "评审报名",
            "en_us": "Sign up",
            "ja_jp": "サインアップ"
        }
    }
}

事件#

事件体#

事件体示例#

事件

事件体

事件体示例