抖音开放平台Logo
开发者文档
移动/网站应用
“/”唤起搜索
控制台
  • OpenAPI 列表
  • 通用参数
  • 移动/网站应用 OpenAPI SDK 总览
  • 状态码排查工具
  • 个人资料
  • 关系能力
  • 内容能力
  • 搜索能力
  • 私信群聊
  • 群聊管理
  • 粉丝群管理
  • 创建粉丝群
  • 变更用户入群申请状态
  • 粉丝群webhook
  • 查询粉丝群
  • 设置进群问候语&群公告
  • 取消进群问候语&群公告配置
  • 查询用户剩余建群额度
  • 查询群主所在群的用户入群申请状态
  • 群消息管理
  • 经营工具
  • 生活服务开放能力
  • 工具能力
  • 服务市场开放能力
  • 小程序推广计划

    • 创建粉丝群

    收藏
    我的收藏

    接口说明

    该接口用于以群主身份创建粉丝群
    当前开放用户范围：认证企业号及其员工号和小程序品牌号及员工号；后续将基于抖音经营者实际诉求逐步拓展开放用户范围
    ​

    前提条件

      •由于外部头像url存在安全风险，开发者在调用建群接口前需通过图片上传工具拿到image_Id 传入到入参 avatar_uri。抖音开放平台目前支持创建万粉群、主播粉丝群，群类型通过接口入参的group_type字段进行区分
    群类型
    数据类型
    枚举值
    建群条件
    主播粉丝群
    int
    2
    ​
      •需要用户通过实名认证
      •需要用户有开播纪录
    万粉群
    int
    5
      •需要用户粉丝量过万
      •粉丝群等级权益与条件如下图所示：
    粉丝群等级等级权益
    开通条件
    Lv.1 可创建10个粉丝群
    粉丝数量>1w
    Lv.2 可创建20个粉丝群
    以下条件满足其一：
      •粉丝数量>10w
      •月日均gmv>=2000
      •累计群人数>2000且近7天累计群发言人数>20人
    Lv.3 可创建40个粉丝群
    以下条件满足其一：
      •粉丝数量>100w
      •月日均gmv>=10000
      •累计群人数>4000且近7天累计群发言人数>30人
    Lv.4 可创建100个粉丝群
    以下条件满足其一：
      •群人数>10000
      •近7天累计群发言人数>100人
      •群主发消息条数>20条
    ​

    基本信息

    名称描述
    HTTP URL
    https://open.douyin.com/im/group/fans/create/
    HTTP Method
    POST
    Scope
    im.group_fans.create_list
    权限要求
      •小程序通过平台试运营期后默认获得的能力。注：关于小程序试运营期介绍详情请查看小程序试运营说明。
      •在开发者后台-设置-关联设置-抖音号管理为小程序经营者申请粉丝群管理能力。
    ​

    请求参数

    请求头
    access-token必填String
    示例：bus_act.1d1021d2aee3d41fee2d2adfwdf56badMFZnrhFhfWotu3Ecuiuka27L56lr
    调用https://open.douyin.com/oauth/business_token/生成的token
    content-type必填String
    固定值"application/json"
    Query
    open_id必填String
    示例：ba253642-0590-40bc-9bdf-9a1334b94059
    经营者唯一标识，可以通过：
      •通过控制台-能力-私信和群聊-群聊管理授权用户详情页中获取
      •其他OpenID获取方式获取
    Body
    avatar_uri必填String
    群头像（avatar_uri字段需根据图片上传工具imageUpload获取）链接： 图片上传工具
    group_name必填String
    群名称
    descriptionString
    群简介，不超过30个中文字符
    group_typeInt64
    不传默认创建万粉群，2对应主播粉丝群；5对应万粉群
    item_auto_syncInt64
    1 作品同步 其他 不同步
    live_auto_syncInt64
    1 直播同步 其他 不同步
    open_audit_switchInt64
    1 开启进群审批
    0 不开启
    show_at_profileInt64
    1 展示到个人主页 其他 不展示（主播粉丝群默认不在个人主页展示加群入口）
    请求示例
    curl -X POST 'https://open.douyin.com/im/group/fans/create/?open_id=123-4567-890' \
-H 'Content-Type:application/json' \
-H 'access-token:act.1d1021d2aee3d41fee2d2add43456badMFZnrhFhfWotu3Ec' \
--data '{
    "avatar_uri":"https://xxx",
    "group_name":"创建群",
    "description":"创建群", 
    "open_audit_switch":1,
    "show_at_profile":1,
    "live_auto_sync":1,
    "item_auto_sync":1
}'

    响应参数

    Body展开全部子属性
    data必填Struct
    展开子属性
    extraStruct
    请求错误信息
    ​
    展开子属性
    group_idString
    粉丝群 ID
    响应示例
    {
  "extra": {
    "description": "",
    "sub_error_code": 0,
    "sub_description": "",
    "now": 1648797449,
    "logid": "021648797449846fd1b1111000700600000000000000086dfb920",
    "error_code": 0
  },
  "data": {
    "error_code": 0,
    "description": ""
  },
  "group_id": "aaaaaaa"
}
    切换单列布局