将客户拉入群聊

POST

/api/v1/instantReply/addFromRoom

功能说明：

本接口可以指定托管账号将客户拉入已创建的指定群聊中

💡

1.使用userId进行添加群聊时，无法保证当前企业下该userId仅在一个组内托管了一次，如果以当前userId查到了不止一个托管账号，则会报错
2.群人数40人之前默认拉入群聊，40人以后发送入群卡片链接，需要客户点击确认
3.建议拉人进群时，每分钟不超过50次
4.拉内部员工的contactWxid格式为1688851234551057
5.拉外部客户的contactWxid格式为7881301234984100
6.内部员工contactWxid获取方式：请求【获取客户列表】接口并将coworker值传为true，对应内部员工的imContactId为内部员工contactWxid

请求参数

Query 参数

Body 参数application/json

示例

{
    "imBotId": "168885****578438",
    "contactWxid": "78813****9110143",
    "roomWxid": "R:107390****3564311",
    "withMessages": false
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://zan-hub.xiaoshunai.com/api/v1/instantReply/addFromRoom?token=d12195ec829f4********9e79f1c0bc7' \
--header 'Content-Type: application/json' \
--data-raw '{
    "imBotId": "168885****578438",
    "contactWxid": "78813****9110143",
    "roomWxid": "R:107390****3564311",
    "withMessages": false
}'

返回响应

🟢200成功

application/json

Body

示例

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

修改于 2026-03-02 07:01:19

将客户移出群聊

群聊改名