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

企业可通过此接口,分配离职成员的客户给其他成员。

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

请求示例:

{
   "handover_userid": "zhangsan",
   "takeover_userid": "lisi",
   "external_userid": 
	[
		"woAJ2GCAAAXtWyujaWJHDDGi0mACBBBB",
		"woAJ2GCAAAXtWyujaWJHDDGi0mACAAAA"
	]
 
}

参数说明:

参数必须说明
access_token调用接口凭证
handover_userid原跟进成员的userid
takeover_userid接替成员的userid
external_userid客户的external_userid列表,最多一次转移100个客户

提示
原跟进成员离职时间不能超过1年且离职前一年内至少登录过一次企业微信; 接替成员最近一年内至少登陆过一次企业微信。

 

handover_userid必须是已离职用户。
external_userid必须是handover_userid的客户(即配置了客户联系功能的成员所添加的联系人)。

 

权限说明:

  • 企业需要使用配置到“可调用应用”列表中的自建应用secret所获取的accesstoken来调用(accesstoken如何获取?)。
  • 第三方应用需拥有“企业客户权限->客户联系->离职分配”权限
  • 接替成员必须在此第三方应用或自建应用的可见范围内。
  • 接替成员需要配置了客户联系功能
  • 接替成员需要在企业微信激活且已经过实名认证。

返回结果:

{
   "errcode": 0,
   "errmsg": "ok",
   "customer":
   [
	{
		"external_userid":"woAJ2GCAAAXtWyujaWJHDDGi0mACBBBB",
		"errcode":0
	},
	{
		"external_userid":"woAJ2GCAAAXtWyujaWJHDDGi0mACAAAA",
		"errcode":40096
	}
   ]
}

参数说明:

参数说明
errcode返回码
errmsg对返回码的文本描述内容
customer.external_userid客户的external_userid
customer.errcode对此客户进行分配的结果, 具体可参考全局错误码, 0表示开始分配流程,待24小时后自动接替,并不代表最终分配成功

 

原接口分配在职或离职成员的客户后续将不再更新维护,请使用新接口
上一篇
获取待分配的离职成员列表
下一篇
查询客户接替状态