创建群聊会话

POST

http://127.0.0.1/cgi-bin/appchat/create

企业内部开发/消息推送/发送消息到群聊会话

最后修改时间：2022-08-30 03:03:35

责任人：未设置

限制说明：
只允许企业自建应用调用，且应用的可见范围必须是根部门；
群成员人数不可超过管理端配置的“群成员人数上限”，且最大不可超过2000人；
每企业创建群数不可超过1000/天；
注意：刚创建的群，如果没有下发消息，在企业微信不会出现该群。

文档ID: 13288
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/90245

请求参数

Query 参数

access_token

string

调用接口凭证

必需

示例值:

Body 参数application/json

owner

string

可选

指定群主的id。如果不指定，系统会随机从userlist中选一人作为群主

userlist

array[string]

必需

群成员id列表。至少2人，至多2000人

chatid

string

可选

群聊的唯一标志，不能与已有的群重复；字符串类型，最长32个字符。只允许字符0-9及字母a-zA-Z。如果不填，系统会随机生成群id

name

string

可选

群聊名，最多50个utf8字符，超过将截断

示例

{
  "name": "NAME",
  "owner": "userid1",
  "userlist": [
    "userid1",
    "userid2",
    "userid3"
  ],
  "chatid": "CHATID"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST 'http://127.0.0.1/cgi-bin/appchat/create?access_token={{accesstoken}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "NAME",
    "owner": "userid1",
    "userlist": [
        "userid1",
        "userid2",
        "userid3"
    ],
    "chatid": "CHATID"
}'

返回响应

🟢200成功

application/json

Body

errcode

integer

返回码

必需

errmsg

string

必需

对返回码的文本描述内容

chatid

string

群聊的唯一标志

必需

示例

{
  "errcode": 0,
  "errmsg": "ok",
  "chatid": "CHATID"
}

设置应用

修改群聊会话