创建群聊

POST

/api/v1/instantReply/createRoom

功能说明：

本接口可以指定托管账号创建群聊，并将im企业员工和客户拉群群聊中，是【模拟人工手动拉群】

📌

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

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

请求参数

Query 参数

Body 参数application/json

示例

{
    "imBotId": "1688****6578438",
    "userIds": [
        "dh111"
    ],
    "unionIds": [
        "oDEUm6oVY_D_*****2EoR_Vku12I"
    ],
    "name": "api创建",
    "greeting": "test_greeting",
    "externalUserIds": [
        "wmrRhyBgAAvw*****AoGkAYsUo6XzCQ"
    ],
    "banChangeName": true,
    "onlyBot": false
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://stride-bg.dpclouds.com/hub-api/api/v1/instantReply/createRoom?token=d12195ec829f4********9e79f1c0bc7' \
--header 'Content-Type: application/json' \
--data-raw '{
    "imBotId": "1688****6578438",
    "userIds": [
        "dh111"
    ],
    "unionIds": [
        "oDEUm6oVY_D_*****2EoR_Vku12I"
    ],
    "name": "api创建",
    "greeting": "test_greeting",
    "externalUserIds": [
        "wmrRhyBgAAvw*****AoGkAYsUo6XzCQ"
    ],
    "banChangeName": true,
    "onlyBot": false
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "errcode": 0,
    "errmsg": "ok",
    "data": {
        "chatId": "66027d08bd*****c2fb62d4b",
        "roomWxid": "R:107377****2809007"
    }
}

修改于 2026-04-01 07:15:35

更新入群欢迎语

将客户移出群聊