企业和第三方可通过此接口查询在职成员的客户转接情况。
请求方式:POST(HTTPS)
请求地址:https://qyapi.weixin.qq.com/cgi-bin/externalcontact/transfer_result?access_token=ACCESS_TOKEN
请求示例:
{
"handover_userid": "zhangsan",
"takeover_userid": "lisi",
"cursor":"CURSOR"
}
参数说明:
参数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 |
handover_userid | 是 | 原添加成员的userid |
takeover_userid | 是 | 接替成员的userid |
cursor | 否 | 分页查询的cursor,每个分页返回的数据不会超过1000条;不填或为空表示获取第一个分页; |
权限说明:
返回结果:
{
"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"
}
参数说明:
参数 | 说明 |
---|---|
errcode | 返回码 |
errmsg | 对返回码的文本描述内容 |
customer.external_userid | 转接客户的外部联系人userid |
customer.status | 接替状态, 1-接替完毕 2-等待接替 3-客户拒绝 4-接替成员客户达到上限 |
customer.takeover_time | 接替客户的时间,如果是等待接替状态,则为未来的自动接替时间 |
next_cursor | 下个分页的起始cursor |
原接口查询客户接替结果后续将不再更新维护,请使用新接口