根据三方客户id批量查询自建客户数据

最后更新:2023/11/22

重要通告:2023年12月1日00:00后购买安装的企业将无法调用此接口,具体原因可咨询相关产品人员或开发人员

企业可通过此接口批量获取自建客户数据(一次最多不超过50个)。

请求方式: POST(HTTPS)

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

参数示例:

{
  "external_userid_list": [
    "wmDkH9EAAAd3viRGyp-upCB5hd2UQGEg",
    "ozynqsulJFCZ2z1aYeS8h-nuasdAAA"
  ],
  "userid": "admin"
}

参数说明:

参数 类型 必填 说明
access_token string 调用接口凭证
external_userid_list string[] 三方客户id集合(最多传50个)
userid string 三方用户id

返回值:

{
  "code": 0,
  "msg": "请求成功",
  "data": [
    {
      "origin_external_userid": "admin",
      "name": "段鹏飞",
      "unionid": "oLRmLxD8mdtZjzGK6p-QRxFGWmdU",
      "type": 1,
      "gender": 2,
      "follow_users": [
        {
          "origin_userid": "admin",
          "userid": "admin",
          "tags": [
            {
              "group_name": "标签分组名称",
              "tag_name": "标签名称",
              "tag_id": "etAJ2GCAAAXtWyujaWJHDDGi0mACHAAA",
              "type": 1
            }
          ]
        }
      ]
    }
  ]
}

返回说明:

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

results matching ""

    No results matching ""