创建群聊

POST

/api/v1/instantReply/createRoom

功能说明：

本接口可以指定托管账号创建群聊，并将企业微信员工和客户拉群群聊中

📌

使用userId进行建群时，无法保证当前企业下该userId仅在一个微信组内托管了一次，如果以当前userId查到了不止一个托管账号，则会报错。

创建群聊时 unionIds 和 externalUserId 联系人组合的总人数应位于2～40之间，两个参数可以共存。

请求参数

Query 参数

Body 参数application/json

示例

{
    "imBotId": "string",
    "botUserId": "string",
    "userIds": [
        "string"
    ],
    "unionIds": [
        "string"
    ],
    "name": "string",
    "greeting": "string",
    "externalUserIds": [
        "string"
    ],
    "banChangeName": true,
    "onlyBot": true
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://ae-bg.ddregion.com/hub-api/api/v1/instantReply/createRoom?token=*' \
--header 'Content-Type: application/json' \
--data-raw '{
    "imBotId": "string",
    "botUserId": "string",
    "userIds": [
        "string"
    ],
    "unionIds": [
        "string"
    ],
    "name": "string",
    "greeting": "string",
    "externalUserIds": [
        "string"
    ],
    "banChangeName": true,
    "onlyBot": true
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "errcode": 0,
    "errmsg": "ok",
    "data": {
        "chatId": "66027d08bd25acec2fb62d4b",
        "roomWxid": "R:10737747932809007"
    }
}

修改于 2025-06-03 07:26:40

更新入群欢迎语

将客户移出群聊