企业内部开发
基础
连接微信
办公
会议
会议统计管理
企业内部开发
服务端API
客户联系
在职继承
分配在职成员的客户
分配在职成员的客户
最后更新:2023/12/01

企业可通过此接口,转接在职成员的客户给其他成员。

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

请求示例:

{
   "handover_userid": "zhangsan",
   "takeover_userid": "lisi",
   "external_userid":
   [
   	"woAJ2GCAAAXtWyujaWJHDDGi0mACAAAA",
   	"woAJ2GCAAAXtWyujaWJHDDGi0mACBBBB"
	],
   "transfer_success_msg":"您好,您的服务已升级,后续将由我的同事李四@腾讯接替我的工作,继续为您服务。"
}

参数说明:

参数必须说明
access_token调用接口凭证
handover_userid原跟进成员的userid
takeover_userid接替成员的userid
external_userid客户的external_userid列表,每次最多分配100个客户
transfer_success_msg转移成功后发给客户的消息,最多200个字符,不填则使用默认文案

提示
原跟进成员和接替成员在最近一年内需要登录过至少一次企业微信。

 

external_userid必须是handover_userid的客户(即配置了客户联系功能的成员所添加的联系人)。
为保障客户服务体验,90个自然日内,在职成员的每位客户仅可被转接2次。
如果接替成员在转接前已成为客户好友,则不会触发添加企业客户事件
如果客户曾经被接替成员转移给其他成员,其他成员再次将此客户转移给此接替成员时,不会触发添加企业客户事件

权限说明:

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

返回结果:

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

参数说明:

参数说明
errcode返回码
errmsg对返回码的文本描述内容
customer.external_userid客户的external_userid
customer.errcode对此客户进行分配的结果, 具体可参考全局错误码, 0表示成功发起接替,待24小时后自动接替,并不代表最终接替成功
原接口分配在职或离职成员的客户后续将不再更新维护,请使用新接口
上一篇编辑客户企业标签
下一篇查询客户接替状态
    本节内容
服务端API
基础
连接微信
办公
会议
会议统计管理
客户端API
小程序
基础
连接微信
办公
WECOM-JSSDK
JS-SDK
基础
连接微信
办公
更新日志
联系我们