- OpenAPI基本介绍
- 错误码参考表
- 访问频率和并发限制
- 消息订阅
- 获取访问凭据
- 员工管理
- 自定义订单管理
- 客户管理
- 客户积分管理
- 客户标签管理
- 客户画像管理
- 标签库管理
- 群聊管理
- 工单管理
- 销售过程管理
- 聊天记录管理
- 拉新排行榜
- 群裂变
- 群打卡
- 企微任务宝
- 拉新排行榜
- 自定义表单
- 客户转化
- 员工个人群发记录管理
- 渠道码管理
- 素材库管理
- 互动雷达管理
- 自定义侧边栏身份校验
- 有赞订单管理
- 小鹅通订单管理
- 项目管理
- 门店信息
- 人群包
- 客户群发
- 企微朋友圈
- 个人SOP
- 部门管理
- 群标签管理
- 话术库
- 企微数据专区
批量获取客户详情
POST
/open-api/external_user/batch_get
| 错误码 | 说明 |
|---|---|
| 20205 | 批量查询最多只支持同时查询20个用户详情数据 |
| 20206 | id_list 错误，找不到对应客户 |
| 20207 | unionid_list 错误，找不到对应客户 |
| 20208 | unionid_list 和 id_list 必须至少提供一个 |
| 调用此接口需购买基础席位。 |
请求参数
Query 参数
access_token
string
调用接口凭证
默认值:
{{access_token}}
Body 参数application/json
id_list
array[string]
必需
unionid_list
array[string]
必需
示例
{
"id_list": [
"string"
],
"unionid_list": [
"string"
]
}示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://open.weibanzhushou.com/open-api/external_user/batch_get?access_token=' \
--header 'Content-Type: application/json' \
--data-raw '{
"id_list": [
"string"
],
"unionid_list": [
"string"
]
}'返回响应
🟢200成功
application/json
Body
errcode
integer
可选
errmsg
string
可选
total
integer
session总量
external_user
array [object {12}]
客户列表
id
string
可选
type
integer
可选
unionid
string | null
可选
created_at
integer
可选
name
string
外部联系人昵称
avatar
string
外部联系人头像
corp_full_name
string | null
可选
corp_name
string | null
可选
gender
integer
可选
position
string | null
可选
external_profile
object | null
可选
follow_staffs
array [object {26}]
可选
custom_fields
array[object (CustomRemarkField) {9}]
客户自定义信息列表
corp_id
string
客户所在公司ID
created_at
integer
自定义信息创建时间
deleted
boolean
是否被删除
field_type
string
可选
field_value
string
自定义信息的值
has_staff_used
boolean
可选
id
integer
自定义信息id
name
string
自定义信息名称
rank_num
integer
自定义信息排序
示例
{
"errcode": 0,
"errmsg": "ok",
"external_user": [
{
"avatar": "http://wx.qlogo.cn/mmhead/Q3auHgzwzM7yFiaRtEAkUefCeyu0XzfOZYrA6gNmghcpdHaGGpicH41g/0",
"corp_full_name": null,
"corp_name": null,
"created_at": 1624518685,
"external_profile": null,
"follow_staffs": [
{
"address": "上海浦东区陆家嘴xx大厦11层",
"age": "18",
"birthday": "2000-01-01",
"custom_fields": [
{
"corp_id": "1703429757388935169",
"created_at": 1681468753,
"deleted": false,
"field_type": "text",
"field_value": "",
"has_staff_used": true,
"id": 3000008661,
"name": "如果第三个东方饭店",
"rank_num": 32
},
{
"corp_id": "1703429757388935169",
"created_at": 1681376042,
"deleted": false,
"field_type": "text",
"field_value": "",
"has_staff_used": true,
"id": 3000008660,
"name": "11",
"rank_num": 31
},
{
"corp_id": "1703429757388935169",
"created_at": 1681374858,
"deleted": false,
"field_type": "option_text",
"field_value": "",
"has_staff_used": true,
"id": 3000008658,
"name": "234234",
"option_list": [
{
"corp_id": "1703429757388935169",
"created_at": 1681374858,
"deleted": false,
"field_id": 3000008658,
"id": 3000006345,
"name": "222"
}
],
"rank_num": 30
},
{
"corp_id": "1703429757388935169",
"created_at": 1681374845,
"deleted": false,
"field_type": "text",
"field_value": "",
"has_staff_used": true,
"id": 3000008657,
"name": "123123",
"rank_num": 29
},
{
"corp_id": "1703429757388935169",
"created_at": 1681373155,
"deleted": false,
"field_type": "text",
"field_value": "",
"has_staff_used": true,
"id": 3000008656,
"name": "时间",
"rank_num": 28
},
{
"corp_id": "1703429757388935169",
"created_at": 1681201850,
"deleted": false,
"field_type": "datetime",
"field_value": "",
"has_staff_used": true,
"id": 3000008644,
"name": "大家都在发大家都在发大家都在发大家都",
"rank_num": 26
},
{
"corp_id": "1703429757388935169",
"created_at": 1681201327,
"deleted": false,
"field_type": "text",
"field_value": "",
"has_staff_used": true,
"id": 3000008643,
"name": "封禁端口是否记录卡撒旦放假啦空手道解",
"rank_num": 25
},
{
"corp_id": "1703429757388935169",
"created_at": 1681201112,
"deleted": false,
"field_type": "option_text",
"field_value": "",
"has_staff_used": true,
"id": 3000008642,
"name": "测试选择",
🟢200正常返回
修改于 2024-03-05 06:42:36