查询客户接替状态 - 企业微信 API

企业和第三方可通过此接口查询在职成员的客户转接情况。

权限说明：企业需要使用“客户联系”secret或配置到“可调用应用”列表中的自建应用secret所获取的accesstoken来调用（accesstoken如何获取？）。第三方应用需拥有“企业客户权限->客户联系->在职继承”权限接替成员必须在此第三方应用或自建应用的可见范围内。

原接口查询客户接替结果后续将不再更新维护，请使用新接口

curl --location -g --request POST 'https://qyapi.weixin.qq.com/cgi-bin/externalcontact/transfer_result?access_token=' \ --header 'Content-Type: application/json' \ --data-raw '{"handover_userid":"zhangsan","takeover_userid":"lisi","cursor":"CURSOR"}'

{ "errcode": 0, "errmsg": "ok", "customer": [ { "external_userid": "woAJ2GCAAAXtWyujaWJHDDGi0mACCCC", "status": 1, "takeover_time": 1588262400 }, { "external_userid": "woAJ2GCAAAXtWyujaWJHDDGi0mACBBBB", "status": 2, "takeover_time": 1588482400 }, { "external_userid": "woAJ2GCAAAXtWyujaWJHDDGi0mACAAAA", "status": 3, "takeover_time": 0 } ], "next_cursor": "NEXT_CURSOR" }

请求参数

Query 参数

access_token

调用接口凭证

必需

示例值:

Body 参数application/json

handover_userid

string

必需

原添加成员的userid

cursor

string

可选

分页查询的cursor，每个分页返回的数据不会超过1000条；不填或为空表示获取第一个分页；

takeover_userid

string

必需

接替成员的userid

示例

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

返回码

可选

next_cursor

string

可选

下个分页的起始cursor

errmsg

string

可选

对返回码的文本描述内容

customer

array [object {3}]

可选

external_userid

string

可选

转接客户的外部联系人userid

takeover_time

integer <int32>

可选

接替客户的时间，如果是等待接替状态，则为未来的自动接替时间

status

integer <int32>

可选

接替状态， 1-接替完毕 2-等待接替 3-客户拒绝 4-接替成员客户达到上限 5-无接替记录