读取粉丝列表

ad_relation_scene

来源字段枚举

个微

1:通过搜索QQ号添加
3:通过搜索微信号添加
8:14:通过群聊添加
10:13:通过手机通讯录添加
15:通过搜索手机号添加
17:通过名片分享添加
18:通过附近的人添加
24:27:28:29:通过摇一摇添加
25:通过漂流瓶添加
30:通过扫一扫添加
48:雷达
65:对方通过搜索QQ号添加
67:对方通过搜索微信号添加
74:对方通过手机通讯录添加
78:对方通过群聊添加
77:79:对方通过搜索手机号添加
81:对方通过名片分享添加
82:对方通过附近的人添加
89:对方通过漂流瓶添加
93:对方通过摇一摇添加
94:对方通过扫一扫添加

企微

0:未知
1:扫描二维码
2:搜索手机号
3:名片分享
4:群聊
5:手机通讯录
6:微信联系人
7:来自微信的添加好友申请
8:安装第三方应用时自动添加的客服人员
9:搜索邮箱
10:视频号主页添加
201:内部成员共享
202:管理员/负责人分配

请求参数

Header 参数

Authorization

可选

授权TOKEN，Bearer

TenantId

可选

租户ID，仅限代理商使用

Body 参数application/json

object | null

可选

wechatId

integer

运营机ID

可选

运营机ID

wechatKey

string

运营机标识

可选

运营机标识

fansKe

string

粉丝标识

可选

粉丝标识

fansName

string

粉丝昵称

可选

粉丝昵称

addStartTime

integer

按添加时间查询开始时间

可选

按添加时间查询开始时间

addEndTime

integer

按添加时间查询结束时间

可选

按添加时间查询结束时间

bindStartTime

integer

按绑定时间查询开始时间

可选

按绑定时间查询开始时间

bindEndTime

integer

按绑定时间查询结束时间

可选

按绑定时间查询结束时间

lastChatStartTime

integer

按最后聊天时间查询开始时间

可选

按最后聊天时间查询开始时间

lastChatEndTime

integer

按最后聊天时间查询结束时间

可选

按最后聊天时间查询结束时间

staffCode

string

获取归属某个聚合聊天员工的数据

可选

获取归属某个聚合聊天员工的数据

minUpdateTime

integer

最小修改时间

可选

最小修改时间

relationType

integer

客户类型

可选

-1所有，0好友，1群，2企业微信个人号，3企业微信群，默认-1

relationState

integer

好友关系状态

可选

-1所有，0有效（可聊天的好友），1主动删除，4被动删除，5主动拉黑，6被动拉黑,默认0查询有效

wechatType

integer

运营号类型

可选

0个微、1公众号、2小程序、3企微

orderByKey

string

排序字段

必需

当前支持ad_relation_id、ad_updatechatting_time

orderByModel

string

排序方式

必需

支持asc、desc

pageIndex

integer

页码

必需

pageSize

integer

单页条数

必需

示例

{
    "wechatId": 0,
    "wechatKey": "string",
    "fansKe": "string",
    "fansName": "string",
    "addStartTime": 0,
    "addEndTime": 0,
    "bindStartTime": 0,
    "bindEndTime": 0,
    "lastChatStartTime": 0,
    "lastChatEndTime": 0,
    "staffCode": "string",
    "minUpdateTime": 0,
    "relationType": 0,
    "relationState": 0,
    "wechatType": 0,
    "orderByKey": "string",
    "orderByModel": "string",
    "pageIndex": 0,
    "pageSize": 0
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200Success

application/json

Body

requestId

null

必需

errmsg

integer

必需

succeed

boolean

必需

msgTime

string

必需

values

array [object {40}]

必需

ad_expand2

string

平台标签

必需

ad_expand

string

归属员工

必需

ad_relation_time

string

添加时间

必需

ad_del_time

string

删除时间

必需

ad_bind_time

integer

绑定时间

必需

details

string

拓展信息

必需

ad_manage_name

string

广告名称

必需

ad_ditch_name

string

媒体名称

必需

ad_order

null

订单数据

必需

ad_updatechatting_time

string

最后聊天时间

必需

ad_request_time

integer

申请时间

必需

ad_relation_remark

string

微信备注

必需

ad_relation_expand3

integer

最后修改时间

必需

ad_wechat_lei

integer

运营号类型

必需

ad_relation_isflock

integer

粉丝类型

必需

ad_wechatreply_time

integer

运营号最后回复时间

必需

ad_relation_state

integer

关系状态

必需

ad_label

string

微信标签

必需

ad_relation_scene

integer

粉丝-添加来源

必需

ad_relation_addedmode

integer

粉丝-添加方式

必需

ad_description

string

粉丝-微信描述

必需

user_moble

string | null

粉丝-手机

必需

user_nick

string | null

粉丝-昵称

必需

user_name

string | null

粉丝-真实姓名

必需

user_chenwei

string | null

粉丝-称谓

必需

user_mobletwo

string | null

粉丝-手机2

必需

user_moblethree

string | null

粉丝-手机3

必需

ad_friend_wenober

string

粉丝-原始微信号

必需

ad_friend_id

integer

粉丝-ID

必需

ad_friend_uwenober

string

粉丝-微信号

必需

username

string

粉丝-昵称

必需

sign

null

粉丝-备注

必需

avatar

string

粉丝-头像

必需

string

会话ID

必需

ad_wechat_nick

string

运营号名称

必需

ad_wechat_nober

string

运营号微信号

必需

ad_original_nober

string

运营号原始微信号

必需

ad_wechat_id

integer

运营号ID

必需

organize_id

string

企业ID

必需

user_unionid

string

用户unionid

必需

errdesc

null

必需

示例

{
    "requestId": null,
    "errmsg": 0,
    "succeed": true,
    "msgTime": "string",
    "values": [
        {
            "ad_expand2": "string",
            "ad_expand": "string",
            "ad_relation_time": "string",
            "ad_del_time": "string",
            "ad_bind_time": 0,
            "details": "string",
            "ad_manage_name": "string",
            "ad_ditch_name": "string",
            "ad_order": null,
            "ad_updatechatting_time": "string",
            "ad_request_time": 0,
            "ad_relation_remark": "string",
            "ad_relation_expand3": 0,
            "ad_wechat_lei": 0,
            "ad_relation_isflock": 0,
            "ad_wechatreply_time": 0,
            "ad_relation_state": 0,
            "ad_label": "string",
            "ad_relation_scene": 0,
            "ad_relation_addedmode": 0,
            "ad_description": "string",
            "user_moble": "string",
            "user_nick": "string",
            "user_name": "string",
            "user_chenwei": "string",
            "user_mobletwo": "string",
            "user_moblethree": "string",
            "ad_friend_wenober": "string",
            "ad_friend_id": 0,
            "ad_friend_uwenober": "string",
            "username": "string",
            "sign": null,
            "avatar": "string",
            "id": "string",
            "ad_wechat_nick": "string",
            "ad_wechat_nober": "string",
            "ad_original_nober": "string",
            "ad_wechat_id": 0,
            "organize_id": "string",
            "user_unionid": "string"
        }
    ],
    "errdesc": null
}

个微#

企微#

请求参数

示例代码

返回响应

个微

企微