批量获取客户详情 - Developer OpenAPI

企业/第三方可通过此接口获取指定成员添加的客户信息列表。

权限说明：企业需要使用“客户联系”secret或配置到“可调用应用”列表中的自建应用secret所获取的accesstoken来调用（accesstoken如何获取？）；第三方应用需具有“企业客户权限->客户基础信息”权限第三方/自建应用调用此接口时，userid需要在相关应用的可见范围内。规则组标签仅可通过“客户联系”获取。

文档ID: 23414
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/92994
https://open.work.weixin.qq.com/api/doc/90001/90143/93010

请求参数

Query 参数

access_token

string

调用接口凭证

必需

示例值:

{accesstoken}}

userid_list

string

必需

企业成员的userid列表，字符串类型，最多支持100个

示例值:

cursor

string

可选

用于分页查询的游标，字符串类型，由上一次调用返回，首次调用可不填

示例值:

limit

string

可选

返回的最大记录数，整型，最大值100，默认值50，超过最大值时取最大值

示例值:

Body 参数application/json

cursor

string

可选

用于分页查询的游标，字符串类型，由上一次调用返回，首次调用可不填

limit

integer <int32>

可选

返回的最大记录数，整型，最大值100，默认值50，超过最大值时取最大值

userid_list

array[string]

必需

企业成员的userid列表，字符串类型，最多支持100个

示例

{
  "userid_list": [
    "zhangsan",
    "lisi"
  ],
  "cursor": "",
  "limit": 100
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

errcode

integer

返回码

必需

errmsg

string

必需

对返回码的文本描述内容

external_contact_list

array [object {2}]

必需

external_contact

object

必需

客户的基本信息，可以参考获取客户详情

follow_info

object

必需

企业成员客户跟进信息，可以参考获取客户详情，但标签信息只会返回企业标签和规则组标签的tag_id，个人标签将不再返回

next_cursor

string

必需

分页游标，再下次请求时填写以获取之后分页的记录，如果已经没有更多的数据则返回空

示例

{
  "errcode": 0,
  "errmsg": "string",
  "external_contact_list": [
    {
      "external_contact": {
        "external_userid": "string",
        "name": "string",
        "position": "string",
        "avatar": "string",
        "corp_name": "string",
        "corp_full_name": "string",
        "type": 0,
        "gender": 0,
        "unionid": "string",
        "external_profile": {
          "external_attr": [
            {
              "type": 0,
              "name": "string",
              "text": {
                "value": "string"
              },
              "web": {
                "url": "string",
                "title": "string"
              },
              "miniprogram": {
                "appid": "string",
                "pagepath": "string",
                "title": "string"
              }
            }
          ]
        }
      },
      "follow_info": {
        "userid": "string",
        "remark": "string",
        "description": "string",
        "createtime": 0,
        "tag_id": [
          "string"
        ],
        "remark_corp_name": "string",
        "remark_mobiles": [
          "string"
        ],
        "oper_userid": "string",
        "add_way": 0,
        "state": "string"
      }
    }
  ],
  "next_cursor": "string"
}