分配离职成员的客户群

POST

/cgi-bin/externalcontact/groupchat/transfer

服务端API第三方应用开发企业内部开发

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

注意：：

群主离职了的客户群，才可继承
继承给的新群主，必须是配置了客户联系功能的成员
继承给的新群主，必须有设置实名
继承给的新群主，必须有激活企业微信
同一个人的群，限制每天最多分配300个给新群主
权限说明:

企业需要使用“客户联系”secret或配置到“可调用应用”列表中的自建应用secret所获取的accesstoken来调用（accesstoken如何获取？）。
第三方应用需拥有“企业客户权限->客户联系->分配离职成员的客户群”权限
对于第三方/自建应用，群主必须在应用的可见范围。

文档ID: 19416
原文档地址：
https://open.work.weixin.qq.com/api/doc/90001/90143/93242
https://open.work.weixin.qq.com/api/doc/90000/90135/92127

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://qyapi.weixin.qq.com/cgi-bin/externalcontact/groupchat/transfer?access_token=' \
--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": 90500,
      "errmsg": "the owner of this chat is not resigned"
    }
  ]
}

请求参数

Query 参数

access_token

调用接口凭证

必需

示例值:

Body 参数application/json

chat_id_list

array[string]

必需

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

new_owner

string

新群主ID

必需

示例

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

返回码

可选

errmsg

string

可选

对返回码的文本描述内容

failed_chat_list

array [object {3}]

没能成功继承的群

可选

errcode

integer <int32>

可选

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

errmsg

string

可选

对返回码的文本描述内容

chat_id

string

可选

没能成功继承的群ID

修改于 2022-01-14 04:25:42

查询客户接替状态

获取客户群列表