第三方应用开发 服务端API 客户联系 在职继承 查询客户接替状态
查询客户接替状态

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

请求方式: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条;不填或为空表示获取第一个分页;

权限说明:

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

 

返回结果:

{
   "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-接替成员客户达到上限 5-无接替记录
customer.takeover_time接替客户的时间,如果是等待接替状态,则为未来的自动接替时间
next_cursor下个分页的起始cursor
原接口查询客户接替结果后续将不再更新维护,请使用新接口
上一篇
分配在职成员的客户
下一篇
获取待分配的离职成员列表