主动转人工服务（群聊）

POST

/api/butler/open/v2/group/transferToHuman

参数规则：
dialogId、groupId、externalGroupId 至少传一个，用于定位群。
传 visitorId：单人转人工。
传 visitorId + transferAccountId：单人转人工，并限定到列表中的一个或多个托管号。
visitorId 不允许和 imBotId 同时传。
只传 imBotId：托管号转人工。
不需要传 participantId，接口会自动查找对应群成员。

请求参数

Header 参数

Body 参数application/json必填

示例

单人转人工单人转人工，并指定多个托管号托管号转人工

{
    "groupId": "group_xxx",
    "visitorId": "visitor_xxx"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

单人转人工单人转人工，并指定多个托管号托管号转人工

curl --location 'https://c2.xinheyun.com/api/butler/open/v2/group/transferToHuman' \
--header 'Cookie;' \
--header 'Content-Type: application/json' \
--data '{
    "groupId": "group_xxx",
    "visitorId": "visitor_xxx"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "code": 200,
    "data": {
        "groupId": "group_xxx",
        "participantId": "participant_xxx",
        "transferMode": "CONTACT_LEVEL"
    }
}

修改于 2026-08-14 07:45:37

主动转人工服务（单聊）

分配人工客服