分配在职成员的客户 - 企业微信 API

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

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

权限说明：

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

第三方应用需拥有“企业客户权限->客户联系->在职继承”权限

接替成员必须在此第三方应用或自建应用的可见范围内。

接替成员需要配置了客户联系功能。

接替成员需要在企业微信激活且已经过实名认证。

原接口分配在职或离职成员的客户后续将不再更新维护，请使用新接口

curl --location -g --request POST 'https://qyapi.weixin.qq.com/cgi-bin/externalcontact/transfer_customer?access_token=' \ --header 'Content-Type: application/json' \ --data-raw '{"handover_userid":"zhangsan","takeover_userid":"lisi","external_userid":["woAJ2GCAAAXtWyujaWJHDDGi0mACAAAA","woAJ2GCAAAXtWyujaWJHDDGi0mACBBBB"],"transfer_success_msg":"您好，您的服务已升级，后续将由我的同事李四@腾讯接替我的工作，继续为您服务。"}'

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

请求参数

Query 参数

access_token

调用接口凭证

必需

示例值:

Body 参数application/json

handover_userid

string

必需

原跟进成员的userid

external_userid

array[string]

必需

客户的external_userid列表，每次最多分配100个客户

transfer_success_msg

string

可选

转移成功后发给客户的消息，最多200个字符，不填则使用默认文案

takeover_userid

string

必需

接替成员的userid

示例

返回响应

🟢200成功

application/json

Body

errcode

integer

返回码

必需

errmsg

string

必需

对返回码的文本描述内容

customer

array [object {2}]

必需

external_userid

string

必需

客户的external_userid

errcode

integer

必需

对此客户进行分配的结果, 具体可参考全局错误码, 0表示成功发起接替,待24小时后自动接替,并不代表最终接替成功