获取客户列表

GET

http://127.0.0.1/cgi-bin/externalcontact/list

第三方应用开发/客户联系/客户管理

最后修改时间：2022-08-30 03:03:36

责任人：未设置

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

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

文档ID: 16684
原文档地址：
https://open.work.weixin.qq.com/api/doc/92287

请求参数

Query 参数

access_token

string

调用接口凭证

必需

示例值:

{accesstoken}}

userid

string

必需

企业成员的userid

示例值:

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request GET 'http://127.0.0.1/cgi-bin/externalcontact/list?access_token={accesstoken}}&userid={{USERID}}'

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

返回码

可选

external_userid

array[string]

可选

外部联系人的userid列表

errmsg

string

可选

对返回码的文本描述内容

示例

{
  "errcode": 0,
  "external_userid": [
    "string"
  ],
  "errmsg": "string"
}

客户联系「联系我」管理-结束临时会话