获取去重后的客户列表

最后更新:2023/01/05

企业可通过此接口获取按去重后的客户列表(按企业内第一添加人去重,仅返回客户的第一添加人与其给客户的备注信息)。

第一添加人:企业内第一个添加客户为好友的员工(若该员工与客户解除好友关系,则顺延为下一个添加的员工)

请求方式: POST(HTTPS)

请求地址: https://open.wshoto.com/openapi/customer/info/list

参数示例:

{
  "userids": [
    "wmJYSuBgAAFyDEU2SLeCVZbblxaxzX4w",
    "ozynqfsdf2dkjsfsdfhsdf-nuasdBBB",
    "woAJ2GCAAAXtWyujaWJHDDGi0mACHAAA",
    "ozynqsulJFCZ2z1aYeS8h-nuasdAAA"
  ],
  "type": 2,
  "current_index": 1,
  "page_size": "100"
}

参数说明:

参数 类型 必填 说明
access_token string 调用接口凭证
userids string[] 企业客户的userid,多个userid用逗号隔开。 一次不超过100个
current_index int 页码。默认值为1
page_size int 列表返回长度。默认值为20,最大值为100

返回值:

{
  "code": 0,
  "msg": "请求成功",
  "data": {
    "total": 4,
    "records": [
      {
        "external_userid": "wmJYSuBgAAFyDEU2SLeCVZbblxaxzX4w",
        "name": "凉夏",
        "type": 1,
        "gender": 2,
        "add_user_id": "YunHanceshi",
        "avatar": "http://p.qlogo.cn/bizmail/IcsdgagqefergqerhewSdage/0",
        "corp_full_name": "极速快递",
        "add_time": 1608269181797
      },
      {
        "external_userid": "woAJ2GCAAAXtWyujaWJHDDGi0mACHAAA",
        "name": "西西",
        "type": 1,
        "gender": 2,
        "add_user_id": "YunHanceshi",
        "avatar": "http://p.qlogo.cn/bizmail/IcsdgagqefergqerhewSdage/0",
        "corp_full_name": "极速快递",
        "add_time": 1608269181797
      }
    ]
  }
}

返回说明:

参数 类型 说明
code int 出错返回码,为0表示成功,非0表示调用失败
msg string 返回码描述
data Page 分页对象
  total int 总量
  records Customer[] 客户列表
    external_userid string 外部联系人id
    name string 姓名
    type int 外部联系人的类型,1表示该外部联系人是微信用户,2表示该外部联系人是企业微信用户
    gender int 外部联系人性别 0-未知 1-男性 2-女性
    add_user_id string 添加人账号id
    avatar string 头像地址完整url
    corp_full_name string 公司全称
    add_time long 添加时间

results matching ""

    No results matching ""