第三方应用开发 服务端API 客户联系 离职继承 获取待分配的离职成员列表
获取待分配的离职成员列表
最后更新:2023/12/01
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
获取待分配的离职成员列表
最后更新:2023/12/01

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

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

请求示例:

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

参数说明:

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

 

权限说明:

  • 企业需要使用配置到“可调用应用”列表中的自建应用secret所获取的accesstoken来调用(accesstoken如何获取?
  • 第三方应用需拥有“企业客户权限->客户联系->分配离职成员的客户”权限

 

返回结果:

{
   "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作为查询参数时不返回

 

上一篇
分配在职成员的客户群
下一篇
分配离职成员的客户