第三方应用开发 服务端API 客户联系 离职继承 获取待分配的离职成员列表
获取待分配的离职成员列表

企业和第三方可通过此接口,获取所有离职成员的客户列表,并可进一步调用分配离职成员的客户接口将这些客户重新分配给其他企业成员。

请求方式:POST(HTTPS
请求地址:https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get_unassigned_list?access_token=ACCESS_TOKEN

请求示例:

{
  "page_id":0,
  "cursor":"",
  "page_size":100
}

参数说明:

参数必须说明
access_token调用接口凭证
page_id分页查询,要查询页号,从0开始
page_size每次返回的最大记录数,默认为1000,最大值为1000
cursor分页查询游标,字符串类型,适用于数据量较大的情况,如果使用该参数则无需填写page_id,该参数由上一次调用返回

注意:

当page_id为1,page_size为100时,表示取第101到第200条记录。
page_id和page_size参数仅适用于记录数小于五万条的情况,即 page_id*page_size < 50000
如果记录数大于五万,则需要使用cursor参数。

权限说明:

 

返回结果:

{
   "errcode":0,
   "errmsg":"ok",
   "info":[
   {
		"handover_userid":"zhangsan",
		"external_userid":"woAJ2GCAAAd4uL12hdfsdasassdDmAAAAA",
		"dimission_time":1550838571
   },
   {
		"handover_userid":"lisi",
		"external_userid":"wmAJ2GCAAAzLTI123ghsdfoGZNqqAAAA",
		"dimission_time":1550661468
	}
 ],
 "is_last":false,
 "next_cursor":"aSfwejksvhToiMMfFeIGZZ"
}

参数说明:

参数说明
errcode返回码
errmsg对返回码的文本描述内容
info.handover_userid离职成员的userid
info.external_userid外部联系人userid
info.dimission_time成员离职时间
is_last是否是最后一条记录
next_cursor分页查询游标,已经查完则返回空(""),使用page_id作为查询参数时不返回

 

上一篇
查询客户接替状态
下一篇
分配离职成员的客户