# 建立群活码(平台号)

请求方式:POST

请求地址:https://$basehost/gateway/qopen/CreateGroupActiveCode

body参数

{
	"ac_task_name": "",
	"ac_title": "",
	"group_id_list": ["群id"],
	"max_group_member_num": 40,
	"is_auto_create_group": true,
	"robot_id_list": ["机器人id"],
	"contact_id_list": ["创建新群被拉企业成员id"],
	"group_name": "",
	"group_init_num": 1
}

参数说明

参数 参数类型 必填 说明
ac_task_name string 群活码任务名(不超过20个字符)
ac_title string 群活码标题 (不超过20个字符)
group_id_list array 群id列表(不超过200)
max_group_member_num int 群人数上限(50~200)
is_auto_create_group boolean 是否群满自动拉新群(默认否)
robot_id_list array 机器人id(不超过30)
contact_id_list array 创建群被拉企业成员id(不超过30)
group_name string 群聊名称(不超过15个字符)
group_init_num int 拉新群初始编号

返回值:

{
    "data": {
        "ac_url": "群活码二维码url",
        "real_ac_url": "群活码链接",
        "str_open_id": "群活码id"
    },
    "errcode":0,
    "errmsg": "",
    "hint": ""
}

返回参数说明

参数 参数类型 说明
errcode int 状态码,0为正常,非0代表错误
errmsg string 错误信息
data json json返回值
   ac_url string 群活码二维码url
   real_ac_url string 群活码链接
str_open_id string 群活码id
hint string 请求日志ID

完整请求示例:

curl -X POST \
  https://$basehost/gateway/qopen/CreateGroupActiveCode \
  -H 'Content-Type: application/json; charset=UTF-8' \
  -H 'Token: c2NdxDHKXIJ5j1zrhJeq2eJEHjh9xxx' \
  -d '{
	"ac_task_name": "",
	"ac_title": "",
	"group_id_list": ["群id"],
	"max_group_member_num": 40,
	"is_auto_create_group": true,
	"robot_id_list": ["机器人id"],
	"contact_id_list": ["创建新群被拉企业成员id"],
	"group_name": "",
	"group_init_num": 1
}'
最后更新时间: 2024/5/8 16:28:46