批量获取客户详情 - 企业微信 API

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

权限说明：企业需要使用“客户联系”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

curl --location -g --request POST 'https://qyapi.weixin.qq.com/cgi-bin/externalcontact/batch/get_by_user?access_token={accesstoken}}&userid_list={{userid_list}}' \ --header 'Content-Type: application/json' \ --data-raw '{"userid_list":["zhangsan","lisi"],"cursor":"","limit":100}'

{"errcode":0,"errmsg":"ok","external_contact_list":[{"external_contact":{"external_userid":"woAJ2GCAAAXtWyujaWJHDDGi0mACHAAA","name":"李四","position":"Manager","avatar":"http://p.qlogo.cn/bizmail/IcsdgagqefergqerhewSdage/0","corp_name":"腾讯","corp_full_name":"腾讯科技有限公司","type":2,"gender":1,"unionid":"ozynqsulJFCZ2z1aYeS8h-nuasdAAA","external_profile":{"external_attr":[{"type":0,"name":"文本名称","text":{"value":"文本"}},{"type":1,"name":"网页名称","web":{"url":"http://www.test.com","title":"标题"}},{"type":2,"name":"测试app","miniprogram":{"appid":"wx8bd80126147df384","pagepath":"/index","title":"myminiprogram"}}]}},"follow_info":{"userid":"rocky","remark":"李部长","description":"对接采购事务","createtime":1525779812,"tag_id":["etAJ2GCAAAXtWyujaWJHDDGi0mACHAAA"],"remark_corp_name":"腾讯科技","remark_mobiles":["13800000001","13000000002"],"oper_userid":"rocky","add_way":1}},{"external_contact":{"external_userid":"woAJ2GCAAAXtWyujaWJHDDGi0mACHBBB","name":"王五","position":"Engineer","avatar":"http://p.qlogo.cn/bizmail/IcsdgagqefergqerhewSdage/0","corp_name":"腾讯","corp_full_name":"腾讯科技有限公司","type":2,"gender":1,"unionid":"ozynqsulJFCZ2asdaf8h-nuasdAAA"},"follow_info":{"userid":"lisi","remark":"王助理","description":"采购问题咨询","createtime":1525881637,"tag_id":["etAJ2GCAAAXtWyujaWJHDDGi0mACHAAA","stJHDDGi0mAGi0mACHBBByujaW"],"state":"外联二维码1","oper_userid":"woAJ2GCAAAd1asdasdjO4wKmE8AabjBBB","add_way":3}}],"next_cursor":"r9FqSqsI8fgNbHLHE5QoCP50UIg2cFQbfma3l2QsmwI"}

请求参数

Query 参数

access_token

调用接口凭证

必需

示例值:

{accesstoken}}

userid_list

必需

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

示例值:

cursor

可选

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

示例值:

limit

可选

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

示例值:

Body 参数application/json

cursor

string

可选

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

limit

integer <int32>

可选

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

userid_list

array[string]

必需

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

示例

返回响应

🟢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

必需

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