第三方应用开发 服务端API 客户联系 离职继承 分配离职成员的客户群
分配离职成员的客户群
最后更新:2023/12/01
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
分配离职成员的客户群
最后更新:2023/12/01

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

请求方式:POST(HTTPS
请求地址:https://qyapi.weixin.qq.com/cgi-bin/externalcontact/groupchat/transfer?access_token=ACCESS_TOKEN

{
    "chat_id_list" : ["wrOgQhDgAAcwMTB7YmDkbeBsgT_AAAA", "wrOgQhDgAAMYQiS5ol9G7gK9JVQUAAAA"],
    "new_owner" : "zhangsan"
}

参数说明:

参数必须说明
access_token调用接口凭证
chat_id_list需要转群主的客户群ID列表。取值范围: 1 ~ 100
new_owner新群主ID

注意:

  1. 群主离职了的客户群,才可继承
  2. 继承给的新群主,必须是配置了客户联系功能的成员
  3. 继承给的新群主,必须有设置实名
  4. 继承给的新群主,必须有激活企业微信
  5. 同一个人的群,限制每天最多分配300个给新群主
  6. 继承给的新群主,需要在最近一年内至少登陆过一次企业微信;旧群主的离职时间不能超过1年且离职前一年内至少登录过一次企业微信

 

权限说明:

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

 

返回结果:

{
	"errcode": 0,
	"errmsg": "ok",
	"failed_chat_list": [
		{
			"chat_id": "wrOgQhDgAAcwMTB7YmDkbeBsgT_KAAAA",
			"errcode": 90500,
			"errmsg": "the owner of this chat is not resigned"
		}
	]
}

参数说明:

参数说明
errcode返回码
errmsg对返回码的文本描述内容
failed_chat_list没能成功继承的群
failed_chat_list.chat_id没能成功继承的群ID
failed_chat_list.errcode没能成功继承的群,错误码
failed_chat_list.errmsg没能成功继承的群,错误描述
上一篇
查询客户接替状态
下一篇
获取客户群列表