企业可通过此接口,转接在职成员的客户给其他成员。
请求方式: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次。
如果接替成员在转接前已成为客户好友,则不会触发添加企业客户事件。
如果客户曾经被接替成员转移给其他成员,其他成员再次将此客户转移给此接替成员时,不会触发添加企业客户事件。
权限说明:
返回结果:
{
"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小时后自动接替,并不代表最终接替成功 |
原接口分配在职或离职成员的客户后续将不再更新维护,请使用新接口