分配在职成员的客户群

POST

https://qyapi.weixin.qq.com/cgi-bin/externalcontact/groupchat/onjob_transfer

企业可通过此接口，将在职成员为群主的群，分配给另一个客服成员。

注意：

继承给的新群主，必须是配置了客户联系功能的成员

继承给的新群主，必须有设置实名

继承给的新群主，必须有激活企业微信

同一个人的群，限制每天最多分配300个给新群主

为保障客户服务体验，90个自然日内，在职成员的每个客户群仅可被转接2次。

权限说明:

企业需要使用“客户联系”secret或配置到“可调用应用”列表中的自建应用secret所获取的accesstoken来调用（accesstoken如何获取？）。

第三方应用需拥有“企业客户权限->客户联系->分配在职成员的客户群”权限

对于第三方/自建应用，群主必须在应用的可见范围。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://qyapi.weixin.qq.com/cgi-bin/externalcontact/groupchat/onjob_transfer' \
--header 'Content-Type: application/json' \
--data-raw '{
    "chat_id_list" : ["wrOgQhDgAAcwMTB7YmDkbeBsgT_AAAA", "wrOgQhDgAAMYQiS5ol9G7gK9JVQUAAAA"],
    "new_owner" : "zhangsan"
}'

响应示例

{
    "errcode": 0,
    "errmsg": "ok",
    "failed_chat_list": [
        {
            "chat_id": "wrOgQhDgAAcwMTB7YmDkbeBsgT_KAAAA",
            "errcode": 90501,
            "errmsg": "chat is not external group chat"
        }
    ]
}

请求参数

Query 参数

access_token

string

调用接口凭证

可选

示例值:

ACCESS_TOKEN

Body 参数application/json

chat_id_list

array[string]

必需

需要转群主的客户群ID列表。取值范围： 1 ~ 100

new_owner

string

新群主ID

必需

示例

返回响应

🟢200成功

application/json

Body

errcode

integer

返回码

必需

errmsg

string

必需

对返回码的文本描述内容

failed_chat_list

array [object {3}]

没能成功继承的群

必需

chat_id

string

可选

没能成功继承的群ID

errcode

integer

可选

没能成功继承的群，错误码

errmsg

string

可选

没能成功继承的群，错误描述

修改于 2022-12-01 07:40:12

查询客户接替状态

获取待分配的离职成员列表