获取客户列表

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

请求方式: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列表
© 1998 - 2021 Tencent Inc. All Rights Reserved