请求方式: 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人,至多500人 |
chatid | 否 | 群聊的唯一标志,不能与已有的群重复;字符串类型,最长32个字符。只允许字符0-9及字母a-zA-Z。如果不填,系统会随机生成群id |
限制说明:
只允许企业自建应用调用,且应用的可见范围必须是根部门;
群成员人数不可超过管理端配置的“群成员人数上限”,且最大不可超过500人;
每企业创建群数不可超过1000/天;
创建群聊会话
https://qyapi.weixin.qq.com/cgi-bin/appchat/create
status: HTTP/1.1 200 OK
connection: close
error-code: 60011
error-msg: no privilege to access/modify contact/party/agent , hint: [1584585651_79_4e4820cc23f1dd7483e0141640bc15f1], from ip: 9.95.1.184, more info at https://open.work.weixin.qq.com/devtool/query?e=60011
content-type: application/json; charset=UTF-8
content-length: 224
{ "errcode": 60011, "errmsg": "no privilege to access/modify contact/party/agent , hint: [1584585651_79_4e4820cc23f1dd7483e0141640bc15f1], from ip: 9.95.1.184, more info at https://open.work.weixin.qq.com/devtool/query?e=60011" }
解决方案:
自建应用的可见目录必须是通讯录的根目录,否则调用API创建群聊会返回错误码60011,提示没有权限