请求方式: POST(HTTPS)
请求地址: https://qyapi.weixin.qq.com/cgi-bin/appchat/create?access_token=ACCESS_TOKEN
请求包体:
{
"name" : "NAME",
"owner" : "userid1",
"userlist" : ["userid1", "userid2", "userid3"],
"chatid" : "CHATID"
}
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 |
name | 否 | 群聊名,最多50个utf8字符,超过将截断 |
owner | 否 | 指定群主的id。如果不指定,系统会随机从userlist中选一人作为群主 |
userlist | 是 | 群成员id列表。至少2人,至多2000人 |
chatid | 否 | 群聊的唯一标志,不能与已有的群重复;字符串类型,最长32个字符。只允许字符0-9及字母a-zA-Z。如果不填,系统会随机生成群id |
权限说明:
只允许企业自建应用调用,且应用的可见范围必须是根部门。
限制说明:
群成员人数不可超过管理端配置的“群成员人数上限”,且最大不可超过2000人。
每企业创建群数不可超过1000/天。
返回示例:
{
"errcode" : 0,
"errmsg" : "ok",
"chatid" : "CHATID"
}
参数说明:
参数 | 说明 |
---|---|
errcode | 返回码 |
errmsg | 对返回码的文本描述内容 |
chatid | 群聊的唯一标志 |
注意:刚创建的群,如果没有下发消息,在旧版本企业微信终端上可能不会出现该群。