获取离职成员列表

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

请求方式: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条记录。由于每个成员的客户数不超过5万,故page_id*page_size 必须小于5万。

权限说明:

返回结果:

{
   "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 分页查询游标,已经查完则返回空(“”)
© 1998 - 2021 Tencent Inc. All Rights Reserved