抖音开放平台Logo
开发者文档
小程序
“/”唤起搜索
控制台
  • OpenAPI 简介
  • 通用参数
  • 小程序 OpenAPI SDK 总览
  • 签名算法
  • 基础能力
  • 触达与营销
  • 订阅消息
  • 分发
  • 搜索能力
  • 私信和群聊
  • 私信管理
  • 群聊管理
  • 群消息管理
  • 粉丝群管理
  • 粉丝群webhook
  • 用户加群申请 webhook
  • 用户加群webhook
  • 查询群信息
  • 创建粉丝群
  • 设置进群问候语&群公告
  • 取消进群问候语&群公告配置
  • 查询用户剩余建群额度
  • 变更用户入群申请状态
  • 查询群主所在群的用户入群申请状态
  • 经营工具
  • 私域经营常见问题
  • 挂载
  • 支付
  • 运营
  • 生活服务
  • 垂直行业
  • 其它

    • 概述

    Webhooks 说明文档可参考 Webhooks 概述。
    权限要求：
      ◦在开发者后台-设置-关联设置-抖音号管理为小程序经营者申请粉丝群管理能力。
    用户加群事件如下：
    事件名
    事件介绍
    group_fans_event
    用户加入授权万粉群或主播粉丝群成功后推送给开发者。

    使用限制

      •仅限粉丝群。
      •小程序通过平台试运营期后默认获得该能力。
    说明
    关于小程序试运营期介绍详情请查看小程序试运营说明。

    事件参数

    参数
    类型
    含义
    event
    ​
    string
    事件名，唯一标识
    from_user_id
    ​
    string
    申请入群用户 open_id
    to_user_id
    ​
    string
    群主openID
    client_key
    ​
    string
    开发者唯一标识
    content
    ​
    string
    具体内容
    ​
    open_id
    string
    群主open_id
    ​
    im_group_id
    string
    群ID
    ​
    group_type
    int
    群操作类型 1-加群
    ​
    create_group_type
    int
    建群类型，2-主播粉丝群，5万粉群
    ​
    create_time
    int
    加群时间

    事件参数示例：

    { 
  "event": "group_fans_event",
  "client_key": "gjegd89bebgd9uehd",
  "from_user_id": "500a9e2f-ca96-4225-865d-a341914502ae",
  "to_user_id": "a70c3dde-d0f3-45b3-828e-0f1a81cd5245",
  "content": "{\"open_id\":\"500a9e2f-ca96-4225-865d-a341914502ae\",\"im_group_id\":\"@9VxQh6rGTNAjPS/4do48Es7912frNf2APZB0rQqgKFMUafD160zdRmYqig357zEBN69eGVtkZMdXc4EKtu****==\",\"group_type\":1,\"create_time\":1681720393151,\"create_group_type\":\"5\"}",
  "log_id": "02168172039281400000000000000000000ffff0ac64157ea0731"
}