创建微信群

通过当前微信实例创建新的微信群聊。

接口地址： POST /createChatroom

前置条件

• 微信实例已登录，并已获得可用的 wId。
• userList 至少传入 2 个微信 ID，多个微信 ID 用英文逗号分隔。
• 本接口属于敏感接口，调用前请确认符合平台调用规范。
• 创建后，手机端可能不会立即显示该群；向该群主动发送一条消息后，手机端通常会显示该群聊。

请求参数

参数名	必选	类型	说明
wId	是	string	登录实例标识
userList	是	string	群成员微信 ID，多个用英文逗号分隔，至少 2 个
topic	否	string	群名

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data	object	建群结果
data.chatRoomID	string	群 ID
data.base64	string	群二维码图片 Base64
data.status	int	创建状态

请求示例

{
  "wId": "349be9b5-8734-45ce-811d-4e10ca568c67",
  "topic": "客户服务群",
  "userList": "wxid_wl9qchkanp9u22,wxid_i6qsbbjenjuj22"
}

成功响应

{
  "message": "成功",
  "code": "1000",
  "data": {
    "chatRoomID": "22264491511@chatroom",
    "base64": "/9j/4AAQSkZJRgABAQAAAQABAAD...",
    "status": 1
  }
}

错误响应

{
  "message": "失败",
  "code": "1001",
  "data": null
}

使用建议

• 建群成功后请保存 data.chatRoomID，后续群资料、成员、群设置接口都依赖该群 ID。
• 不建议批量高频创建群聊；业务侧应做操作权限、频率控制和调用审计。
• 建群后如需让手机端展示该群，可先发送一条业务允许的群消息。