企业内部开发 服务端API 客户联系 客户管理 获取客户列表
获取客户列表

企业可通过此接口获取指定成员添加的客户列表。客户是指配置了客户联系功能的成员所添加的外部联系人。没有配置客户联系功能的成员,所添加的外部联系人将不会作为客户返回。

请求方式:GET(HTTPS
请求地址:https://qyapi.weixin.qq.com/cgi-bin/externalcontact/list?access_token=ACCESS_TOKEN&userid=USERID

参数说明:

参数必须说明
access_token调用接口凭证
userid企业成员的userid

权限说明:

  • 企业需要使用“客户联系”secret或配置到“可调用应用”列表中的自建应用secret所获取的accesstoken来调用(accesstoken如何获取?);
  • 第三方应用需具有“企业客户权限->客户基础信息”权限
  • 第三方/自建应用只能获取到可见范围内的配置了客户联系功能的成员。

 

返回结果:

{
   "errcode": 0,
   "errmsg": "ok",
   "external_userid":
   [
   	"woAJ2GCAAAXtWyujaWJHDDGi0mACAAA",
	   "wmqfasd1e1927831291723123109rAAA"
   ]

  
}

参数说明:

参数说明
errcode返回码
errmsg对返回码的文本描述内容
external_userid外部联系人的userid列表

 

上一篇
客户联系「联系我」管理
下一篇
获取客户详情