批量获取企业自建应用的客户信息

企业可通过此接口批量获取企业自建应用的客户信息。

请求方式: POST(HTTPS)

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

参数示例:

{
  "current_index": 1,
  "page_size": 20
}

参数说明:

参数 类型 必填 说明
access_token string 调用接口凭证
current_index Integer 页码。默认值为1
page_size Integer 列表返回长度。默认值为20,最大值为100

返回值:

{
  "code": 0,
  "msg": "请求成功",
  "data": {
    "total": 10,
    "records": [
      {
        "external_userid": "admin",
        "unionid": "oLRmLxD8mdtZjzGK6p-QRxFGWmdU",
        "type": 1,
        "gender": 2,
        "follow_users": [
          {
            "userid": "admin",
            "tag_list": [
              {
                "group_name": "标签分组名称",
                "tag_name": "标签名称",
                "tag_id": "etAJ2GCAAAXtWyujaWJHDDGi0mACHAAA"
              }
            ]
          }
        ]
      }
    ]
  }
}

返回说明:

参数 类型 说明
code int 出错返回码,为0表示成功,非0表示调用失败
msg string 返回码描述
data Page 分页对象
  total int 分页大小
  records SelfCustomerInfoResponse 数据
    external_userid string 外部联系人ID
    unionid string 外部联系人在微信开放平台的唯一身份标识(微信unionid),通过此字段企业可将外部联系人与公众号/小程序用户关联起来。仅当联系人类型是微信用户,且企业或第三方服务商绑定了微信开发者ID有此字段。
unionid从2022年6月20后产生的客户不再返回
    type int 客户类型,1:微信用户, 2:企业微信用户
    gender int 客户性别 0-未知 1-男性 2-女性
    follow_users FollowUser[] 添加人列表
      userId int 员工ID
      tag_list Tag[] 标签数据
        group_name string 标签组名称
        tag_name string 标签名称
        tag_id string 企微标签id

results matching ""

    No results matching ""