友米聚合 - 开放API
  1. 接口详情
友米聚合 - 开放API
  • 应用场景
    • 自有订单系统 嵌入 企客聊侧边栏
  • v1
    • 文档
      • 介绍
        • 开发文档阅读说明
        • 错误码返回说明
      • 入门说明
        • 生成signature
        • 获取TOKEN方法
        • 请求Headers说明
      • 接口详情
        • 基础数据类接口
        • 数据读取类接口
        • 行为操作类接口
        • 回调数据
  • v2
    • 事件发布格式说明
    • ChatMess
      • 发送消息
      • 申请接管
      • 终止接管
      • 激活会话
      • 发送通知
      • 读取聊天记录
    • Report
      • 获取员工客服统计
      • 获取员工激活客户数统计
    • System
      • 获取部门列表
      • 根据部门获得组
      • 根据组获得员工
      • 获得员工列表
    • Friend
      • 读取粉丝列表
      • 读取粉丝总数
    • Todo
      • 新增待办记录
      • 新增待办记录(返回编号)
      • 获取待办列表
      • 获取待办列表总数
    • Ad
      • 读取广告列表
      • 读取广告条数
    • BulkSend
      • 保存RPA群发
      • 删除RPA群发
    • 注册回调地址
      POST
    • 订阅事件
      POST
    • 获取商户TOKEN
      POST
  1. 接口详情

数据读取类接口

读取好友

接口URL:friend

请求方式:Get

Headers:
access_token:token
Content-type: text/json

###### 其他参数参考Headers说明

请求参数

以下参数均是可选参数,当不传任何参数情况下,系统会默认返回前20个好友!

参数名数据类型是否必须说明
Wechat_idint否聚合聊天系统微信号ID
Wechat_Nostring否要查询的微信号
StartTimestring否按添加时间查询开始时间(该时间格式时:2018-08-08 10:01:03)
EndTimestring否按添加时间查询 截止时间(该时间格式时:2018-08-08 10:01:03)
ad_bind_Stimeint否按绑定时间查询开始时间(该时间格式时:精确到秒的时间戳)
ad_bind_Etimeint否按绑定时间查询截止时间(该时间格式时:精确到秒的时间戳)
ad_updatechatting_Stimeint否按最后聊天时间查询开始时间(该时间格式时:精确到秒的时间戳)
ad_updatechatting_Etimeint否按最后聊天时间查询截止时间(该时间格式时:精确到秒的时间戳)
Pageint否页数(默认1)
PageSizeint否每页多少行(默认20)
ad_staff_codestring否获取归属某个聚合聊天员工的数据
ad_relation_expand3int否大于最后修改时间的数据,精确到秒的时间戳
ad_relation_isflockint否客户类型(-1所有,0好友,1群,2企业微信个人号,3企业微信群,默认-1)
ad_relation_stateint否好友关系状态(-1所有,0有效(可聊天的好友),1主动删除,4被动删除,5主动拉黑,6被动拉黑,默认0查询有效)
ad_wechat_leiint否运营号类型(0 个微、3 企微)
order_by_keystring否排序字段;当前支持ad_relation_id、ad_updatechatting_time
order_by_modelstring否排序方式;支持asc、desc

请求示例

http://《你服务器IP》:5003/v1/friend?Wechat_id=2538

接收返回结果

{
	"msgTime": "2018/5/11 14:32:40",
	"errmsg": 20000,
	"succeed": true,
	"values": {
		"ad_friend_id": 1153549,
		"ad_friend_uwenober": "www_7182453",
		"ad_friend_wenober": "wxid_167px6des5ie22",
		"username": "A宝儿",
		"avatar": "http://wx.qlogo.cn/mmhead/ver_1/15HPPguo4E1bFMkHbSVrd6pY1HXvwRbmawsN57AicLWKwqRJrtjGOdRwlG4vg0Mo0IAG8KicN0tLWhq7vmTRtTw3XawhtOyiaDjRW8JMUoibfBA/132",
		"ad_ring": "{}",
		"ad_expand2": "[]",
		"ad_relation_state": 0,
		"ad_expand": "",
		"ad_expand3": "{\"describe\": \"\"}",
		"ad_relation_remark": "",
		"ad_relation_expand3": 1592895700,
		"ad_relation_isflock":0,
		"ad_wechat_nick": "测试8240",
		"ad_original_nober": "wxid_30tas02fxbfq22",
		"ad_wechat_id": 2538,
		"ad_staff_code": "10000",
		"ad_relation_time": "2018-04-13T18:03:55+08:00",
		"ad_del_time": "2018-04-13T18:03:55+08:00",
		"ad_bind_time": 0,
		"details": "{}",
		"ad_manage_name": "",
		"ad_ditch_name": "",
		"ad_order": "{}",
		"ad_updatechatting_time": "1587893701",
        "ad_request_time": 1587893700,
        "user_moble": null,
        "user_nick": null,
        "user_name": null,
        "user_chenwei": null,
        "user_mobletwo": null,
        "user_moblethree": null,
        "ad_label": ["标签"],
        "ad_relation_addedmode": 0,
        "ad_relation_scene": 30
	}
}

返回结果说明(自定义字段通过好友详情获取)

参数名数据类型说明
ad_friend_idint1150933(聚合聊天系统专用ID)
ad_friend_uwenoberstringG887009(好友微信更改后微信号)
ad_friend_wenoberstringwxid_ujwy4r6nkjdb22(好友微信原始微信号)
usernamestringA宝儿(微信昵称)
avatarstringhttp://wx.qlogo.cn/mmhead/ver_1/yVUnQictAnCl21MU2Bma7PI1mHFGJNmFgq8WtARJhA7f89VOialcarvsMxsrNIqMA7Nz6IicF4CWFyg3ARsajrA/96(微信头像)
ad_ringstring已弃用
ad_expand2string["1","2"],选中标签
ad_relation_stateint0有效(可聊天的好友),1主动删除,4被动删除,5主动拉黑,6被动拉黑
ad_expandstring10000(绑定员工工号)
ad_expand3object描述
ad_relation_remarkstringiiii(备注信息)
ad_relation_expand3int最后修改时间(精确到秒的时间戳)
ad_relation_isflockint客户类型(0好友,1群)
ad_wechat_nickstringP5(所属机号)
ad_original_noberstringwxid_w4ebc6txje66229(所属机号的原始微信号)
ad_wechat_idint1906(所属机号ID)
ad_relation_time2018-03-09T18:24:32+0800入库时间
ad_del_time2018-03-09T18:24:32+08001主动删除,4被动删除,5主动拉黑,6被动拉黑的操作时间,0有效时该时间无效
ad_bind_time1523929223绑定时间
detailsobject"{"sex": 2, "city": "广东", "sign": "深圳富士康招聘大量普工长期工、临时工【咨询报名处】·另招代理", "province": "中国"}"
ad_manage_namestringfff(所属广告名称)
ad_ditch_namestringff(所属媒体名称)
ad_orderobject{}(聚合聊天同步的订单信息)
ad_updatechatting_timeint1587893701(客户最后聊天时间,精确到秒的时间戳)
ad_request_timeint1587893700
user_moblestring客户详细资料的电话号码
user_mobletwostring客户详细资料的电话号码2
user_moblethreestring客户详细资料的电话号码2
user_nickstring客户详细资料的客户昵称
user_chenweistring客户详细资料的称谓
user_namestring真实姓名
ad_labelobject["自动测试224"] (好友微信标签)
ad_relation_addedmodeint0(加好友方式:-1未知 0你添加对方 1对方添加你)
ad_descriptionstring好友微信详细描述
ad_relation_sceneint30(来源)

好友来源说明

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

读取好友总数

接口URL:friend/count

请求方式:Get

Headers:
access_token:token
Content-type: text/json

###### 其他参数参考Headers说明

请求参数

以下参数均是可选参数

参数名数据类型是否必须说明
Wechat_idint否聚合聊天系统微信号ID
Wechat_Nostring否要查询的微信号
StartTimestring否按添加时间查询开始时间(该时间格式时:2018-08-08 10:01:03)
EndTimestring否按添加时间查询 截止时间(该时间格式时:2018-08-08 10:01:03)
ad_bind_Stimeint否按绑定时间查询开始时间(该时间格式时:精确到秒的时间戳)
ad_bind_Etimeint否按绑定时间查询截止时间(该时间格式时:精确到秒的时间戳)
ad_updatechatting_Stimeint否按最后聊天时间查询开始时间(该时间格式时:精确到秒的时间戳)
ad_updatechatting_Etimeint否按最后聊天时间查询截止时间(该时间格式时:精确到秒的时间戳)
ad_staff_codestring否获取归属某个聚合聊天员工的数据
ad_relation_expand3int否大于最后修改时间的数据,精确到秒的时间戳
ad_relation_isflockint否客户类型(-1所有,0好友,1群,2企业微信个人号,3企业微信群,默认-1)
ad_relation_stateint否好友关系状态(-1所有,0有效(可聊天的好友),1主动删除,4被动删除,5主动拉黑,6被动拉黑,默认0查询有效)
ad_wechat_leiint否运营号类型(0 个微、3 企微)

请求示例

http://《你服务器IP》:5003/v1/friend/count?Wechat_id=2538

接收返回结果

{
	"msgTime": "2018/5/11 14:32:40",
	"errmsg": 20000,
	"succeed": true,
	"values": 1000
}

返回结果说明(自定义字段通过好友详情获取)

参数名数据类型说明
valuesint总条数

好友详情

接口URL:friend/GetDetail

请求方式:Get

Headers:
access_token:token
Content-type: text/json

###### 其他参数参考Headers说明

请求参数

参数名数据类型是否必须说明
ad_friend_wenoberstring是好友原始微信号/修改后的微信号
ad_wechat_idint否查询机号对应的ID(二选1)
ad_wechat_noberstring否查询机号的微信号(二选1)
ad_wechat_leiint否运营号类型(0 个微、3 企微)

请求示例

http://《你服务器IP》:5003/v1/friend/GetDetail?ad_friend_wenober=wxid_cdh8t1ajl8qm22&ad_wechat_id=3308&ad_wechat_lei=0

接收返回结果

{
    "errmsg": 20000,
    "succeed": true,
    "msgTime": "2020-03-11T14:23:49.3410444+08:00",
    "values": {
        "ad_friend_id": 2716147,
        "ad_friend_uwenober": "zznn72537",
        "ad_friend_wenober": "wxid_2yfwlz5fu21922",
        "ad_friend_name": "测试",
        "ad_friend_photo": "http://wx.qlogo.cn/mmhead/ver_1/L9Qqvt4c3Wf20AtTiaKxcLViaibqZHibbpyah1vl8e1KAITtcxNq5XoClLRV4NMY9qUM6UydI1icia2rFThDdcGjMrrX98WYQtgM4FcleC7RDKmCY/96",
        "ad_ring": "{}",
        "ad_expand2": "["1","2"]",
        "ad_relation_addedmode": 0,
        "ad_relation_scene": 30,
        "ad_relation_state": 0,
        "ad_expand": "10000",
        "ad_expand3": "{\"describe\": \"\"}",
        "ad_relation_remark": "",
        "ad_wechat_nick": "P11",
        "ad_original_nober": "wxid_1r8a1mfrbdek22",
        "ad_wechat_id": 3527,
        "ad_staff_code": "5427",
        "ad_relation_time": "2020-03-10T10:53:32+08:00",
        "ad_del_time": "2020-03-10T10:53:32+08:00",
        "ad_bind_time": 0,
        "ad_wechatreply_time":0,
        "details": "{\"sex\": 2, \"city\": \"朝阳\", \"sign\": \"嘎嘎嘎\", \"phoneNum\": \"\", \"province\": \"北京\"}",
        "ad_manage_name": "",
        "ad_updatechatting_time": "1583808812",
        "ad_request_time": 1587893700,
        "ad_ditch_name": "",
        "ad_order": "{}",
        "ad_relation_isflock": 0,
        "ad_relation_expand": "0",
        "ad_relation_expand4": 0,
        "chatroomflag": 0,
        "ad_wechat_nober": "yg1811121",
        "user_moble": null,
        "user_nick": null,
        "user_chenwei": null,
        "user_mobletwo": null,
        "user_moblethree": null,
        "user_name":"张三",
		"ad_label": ["标签"],
		"ad_description": "描述",
        "ad_relation_adcode"|string|广告码
       "user_extend": "[{\"17\": \"122\"}, {\"16\": \"男女\"}, {\"15\": \"1222\"}, {\"14\": [\"足球\", \"篮球\", \"游泳\"]}, {\"13\": \"2020-06-18\"}, {\"12\": \"122\"}]"
    }
}

返回结果说明

参数名数据类型说明
ad_friend_idint27161479(聚合聊天系统专用ID)
ad_friend_uwenoberstringzznn72537(微信更改后微信号)
ad_friend_wenoberstringwxid_2yfwlz5fu21922(微信原始微信号)
ad_friend_namestring测试(微信昵称)
ad_friend_photostringhttp://wx.qlogo.cn/mmhead/ver_1/L9Qqvt4c3Wf20AtTiaKxcLViaibqZHibbpyah1vl8e1KAITtcxNq5XoClLRV4NMY9qUM6UydI1icia2rFThDdcGjMrrX98WYQtgM4FcleC7RDKmCY/96(微信头像)
ad_ringobject已放弃
ad_expand2object["1","2"],选中标签
ad_relation_addedmodeint0(加好友方式:-1未知 0你添加对方 1对方添加你)
ad_relation_sceneint30(来源)
ad_relation_stateint状态(0有效,1主动删除,4被动删除,5主动拉黑,6被动拉黑)
ad_expandstring10000(绑定员工工号)
ad_expand3object{"describe": ""}
ad_relation_remarkstringiiii(备注信息)
ad_wechat_nickstringP5(所属机号)
ad_original_noberstringwxid_w4ebc6txje6622(所属机号的原始微信号)
ad_wechat_idint1906(所属机号ID)
ad_staff_codestring10000(接线员工工号)
ad_relation_timedatetime2018-03-09T18:24:32+0800
ad_del_time2018-03-09T18:24:32+08001主动删除,4被动删除,5主动拉黑,6被动拉黑的操作时间,0有效时该时间无效
ad_bind_timeint1523929223(绑定时间,精确到秒的时间戳)
ad_wechatreply_timeint0(运营号最后聊天时间,精确到秒的时间戳)
detailsobject"{"sex": 2, "city": "广东", "sign": "深圳富士康招聘大量普工长期工、临时工【咨询报名处】·另招代理", "province": "中国"}"(微信上的详细信息)
ad_updatechatting_timeint1583808812(客户最后聊天时间,精确到秒的时间戳)
ad_request_timeint1587893700(客户申请时间,精确到秒的时间戳)
ad_manage_namestringfff(所属广告名称)
ad_ditch_namestringff(所属媒体名称)
ad_orderobject{}(聚合聊天同步的订单信息)
ad_relation_isflockint0(客户类,0好友,1群)
ad_relation_expand4int0(0微信号,1公众号,2小程序)
chatroomflagint0
ad_wechat_noberintyg1811121(运营机微信号)
user_moblestring客户详细资料的电话号码
user_mobletwostring客户详细资料的电话号码2
user_moblethreestring客户详细资料的电话号码2
user_nickstring客户详细资料的客户昵称
user_chenweistring客户详细资料的称谓
user_namestring真实姓名
ad_labelobject["自动测试224"] (好友微信标签)
ad_descriptionstring描述
ad_relation_adcodestring广告码
user_extendobject自定义字段返回数据(根据自定义字段接口列表取出相对应的值)

好友来源说明

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

聊天历史

接口URL:ChatMess

请求方式:Get

Headers:
access_token:token
Content-type: text/json

###### 其他参数参考Headers说明

请求参数

参数名数据类型是否必须说明
ad_friend_wenoberstring否好友原始微信号(如果不传即所有聊天记录)
ad_wechat_idint否机号ID
startDateint否聊天记录开始时间(精确到秒的时间戳)
endDateint否聊天记录结束时间(精确到秒的时间戳)
ad_chatting_idint否聊天编号(传入即查询大于该聊天编号的数据)
pageint否页数(默认1)
pagesizeint否每页多少条(默认10)

请求示例

http://《你服务器IP》:5003/v1/ChatMess?ad_friend_wenober=wxid_ujwy4r6nkjdb22&ad_wechat_id=1906

接收返回结果


{
    msgTime: {2018/5/11 14:47:48}
    errmsg: 20000
    succeed: true
    values: {[
  {
    "ad_chatting_talter": "wxid_ujwy4r6nkjdb22",
    "ad_chatting_issend": 1,
    "ad_chatting_resvred": null,
    "ad_wechat_id": 1906,
    "merchantid": "333513091",
    "ad_chatting_updatetime": "2018-04-26T16:23:21.838195+08:00",
    "ad_chatting_sate": 3,
    "ad_sermsgid": "1524730993715m",
    "ad_chatting_time": "1524730993",
    "ad_chatting_content": "imgs[6d1472bf5f6cebbcd013d89c68a461111524730993]",
    "ad_staff_code": "10000",
    "ad_friend_photo": "http://wx.qlogo.cn/mmhead/ver_1/yVUnQictAnCl21MU2Bma7PI1mHFGJNmFgq8WtARJhA7f89Z0VOialcarvsMxsrNIqMA7Nz6IicF4CWFyg3ARsajrA/96",
    "ad_friend_name": "心赠于你w",
    "ad_expand": "0",
    "ad_wechat_nober": "wcy_candice2"
  },
  {
    "ad_chatting_talter": "wxid_ujwy4r6nkjdb22",
    "ad_chatting_issend": 0,
    "ad_chatting_resvred": null,
    "ad_wechat_id": 1906,
    "merchantid": "333513091",
    "ad_chatting_updatetime": "2018-04-18T10:01:00.784618+08:00",
    "ad_chatting_sate": 1,
    "ad_sermsgid": "348722752404833281",
    "ad_chatting_time": "1524016859",
    "ad_chatting_content": "早上好",
    "ad_staff_code": null,
    "ad_friend_photo": "http://wx.qlogo.cn/mmhead/ver_1/yVUnQictAnCl21MU2Bma7PI1mHFGJNmFgq8WtARJhA7f89Z0VOialcarvsMxsrNIqMA7Nz6IicF4CWFyg3ARsajrA/96",
    "ad_friend_name": "心赠于你w",
    "ad_expand": "0",
    "ad_wechat_nober": "wcy_candice2"
  },
  {
    "ad_chatting_talter": "wxid_ujwy4r6nkjdb22",
    "ad_chatting_issend": 1,
    "ad_chatting_resvred": null,
    "ad_wechat_id": 1906,
    "merchantid": "333513091",
    "ad_chatting_updatetime": "2018-04-17T21:42:59.897157+08:00",
    "ad_chatting_sate": 1,
    "ad_sermsgid": "1497183686434128180",
    "ad_chatting_time": "1523972438",
    "ad_chatting_content": "晚上好[嘿哈]",
    "ad_staff_code": "10000",
    "ad_friend_photo": "http://wx.qlogo.cn/mmhead/ver_1/yVUnQictAnCl21MU2Bma7PI1mHFGJNmFgq8WtARJhA7f89Z0VOialcarvsMxsrNIqMA7Nz6IicF4CWFyg3ARsajrA/96",
    "ad_friend_name": "心赠于你w",
    "ad_expand": "0",
    "ad_wechat_nober": "wcy_candice2"
  }
]}
}

返回结果说明

参数名数据类型说明
ad_chatting_idlong聊天编号
ad_chatting_talterstringwxid_ujwy4r6nkjdb22(发送的好友原始微信号)
ad_chatting_issendstring0(0客户发送信息,1运营机发送消息)
ad_chatting_resvredstring(内容格式默认null)
ad_wechat_idint1906(运营机编号)
ad_chatting_updatetimedatetime2018-04-11T10:08:37.847551+08:00(入库时间)
ad_chatting_sateint1(信息状态)
ad_sermsgidint728806287326258317m(信息唯一ID)
ad_chatting_timeint1523412516(聊天时间)
ad_chatting_contentstring给你04月11日的朋友圈<人民网北京4月11日电 (邢郑) 据国家市场监管总局网站显示...>\n点赞(聊天内容)
ad_staff_codestringnull(当是自己发送的时候会产生工号)
ad_friend_photohttp://wx.qlogo.cn/mmhead/用户头像
ad_friend_name心赠于你w用户名称
ad_expandint是否已读(0已读,1未读,主要针对语音)
ad_wechat_noberstring运营机微信号
ad_voice_txtstring语音转文本内容

信息状态说明

CDN资源访问:http://ttimg.agsoft.net/商家编号/chatRes/对应的key

类型 含义 ad_chatting_content格式 ad_chatting_resvred格式(urlDecode解码)
1 文本
2/3/4 图片 imgs[图片KEY];需要查看大图时:key_hd,助手必须打开自动查看原图或客户端发送查看大图的任务
4/34 语音 audio[语音KEY]或audioT[语音KEY] {"downloadKey":"语音文件","type":-1,"videoLen":语音长度(秒)}
42 名片 MP[联系人昵称] {"nickname":"名片名称"}
48 位置 a(位置链接) {"desc":"详细地址","thumbUrl":"缩略图","title":"位置标题","url":"位置链接"}
49 链接 a(链接地址) {"title":"链接标题","url":"链接地址"}
50 视频聊天
495 群聊邀请 {"desc":"邀请描述","thumbUrl":"缩略图","title":"邀请标题","url":"邀请链接"}
496 文件 file[文件KEY] {"title":"文件名称","totalLen":文件大小,"url":""}
1001 分享名片
4919 聊天记录转发
4933 小程序 {"appIconUrl":"小程序小图标","displayName":"小程序名称","downloadKey":"小程序封面KEY","title":"小程序标题"}
4362 群收款,群红包,红包
7549 视频号 {"avatar":"视频号头像","description":"视频号描述","nickname":"视频号名称","thumbUrl":"封面缩略图"}
8220 引用 {"type":"消息类型,与原有消息类型一致,代表引用的是什么类型的消息","content":"引用的消息的文本内容","title":"文件和链接消息的标题","downloadKey":"需要下载资源的消息(图片视频文件)","url":"链接消息的url"}
9730 直播 {"avatar":"直播头像","description":"直播描述","nickname":"直播名称","thumbUrl":"封面缩略图"}
10000 系统消息
10001 标识符更新
10002 好友验证
10003 好友申请
10004 异常通知
10005 实名信息
11001 待办消息
12001 托管消息 {"key":"托管标识","name":"申请人昵称","reason":"申请理由"}

统计员工发送文本消息关键字数量

接口URL:staff/GetKeywordDataByStaff

请求方式:Post

Headers:
access_token:token
Content-type: text/json

###### 其他参数参考Headers说明

请求参数

参数名数据类型是否必须说明
ad_staff_code_listarray否员工列表
depart_idint否部门ID
depart_group_idint否分组ID
start_timeint否聊天记录开始时间(精确到秒的时间戳)
end_timeint否聊天记录结束时间(精确到秒的时间戳)
keywordstring是统计关键字

请求示例

{
	"ad_staff_code_list": [],
	"depart_id": 0,
	"depart_group_id": 0,
	"start_time": 0,
	"end_time": 0,
	"keyword": "好"
}

接收返回结果


{
  "requestId": null,
  "errmsg": 20000,
  "succeed": true,
  "msgTime": "2023-01-03T17:05:53.0614882+08:00",
  "values": [
    {
      "ad_staff_code": "S01",
      "ad_staff_name": "S01",
      "departname": "技术部",
      "departgroupname": "开发一组",
      "start_time": "2023-01-02 00:00:00",
      "end_time": "2023-01-03 00:00:00",
      "keyword": "好",
      "fans_count": 10,
      "keyword_count": 20
    },
    {
      "ad_staff_code": "10000",
      "ad_staff_name": "10000",
      "departname": "技术部",
      "departgroupname": "开发二组",
      "start_time": "2023-01-02 00:00:00",
      "end_time": "2023-01-03 00:00:00",
      "keyword": "好",
      "fans_count": 89,
      "keyword_count": 190
    }
  ],
  "errdesc": null
}

返回结果说明

参数名数据类型说明
ad_staff_codestring员工编号
ad_staff_namestring员工名称
depart_namestring部门名称
depart_group_namestring分组名称
start_timestring开始时间
end_timestring结束时间
keywordstring关键字
fans_countint发送粉丝数量
keyword_countint关键字数量

加好友结果

==该接口结果每刷新一次会删除一次当前获取到的结果==

接口URL:friend/Get_Friend

请求方式:Get

Headers:
access_token:token
Content-type: text/json

###### 其他参数参考Headers说明

请求参数

暂无

请求示例

http://《你服务器IP》:5003/v1/friend/Get_Friend

接收返回结果

{ msgTime: 2018/5/11 14:32:40
    errmsg: 20000
    succeed: true
    values: [{
  "friendList": [
    {
      "phoneNum": "yyyy",
      "wechatId": "scyule888",
      "type": 1
    },
    {
      "phoneNum": "yyyy",
      "wechatId": "scyule888",
      "type": 1
    },
    {
      "phoneNum": "yyyy",
      "wechatId": "scyule888",
      "type": 1
    }
  ]
},{
  "friendList": [
    {
      "phoneNum": "yyyy",
      "wechatId": "scyule888",
      "type": 1
    },
    {
      "phoneNum": "yyyy",
      "wechatId": "scyule888",
      "type": 1
    },
    {
      "phoneNum": "yyyy",
      "wechatId": "scyule888",
      "type": 1
    }
  ]
}]}

返回结果说明

参数名数据类型说明
phoneNumstring自定义ID
wechatIdstring好友微信号
typeint类型(1.对方已通过 2.任务执行失败 3.等待验证 4.已是好友 5.未开通微信 6.被搜帐号异常 7.操作过于频繁 8.好友申请发送失败)

好友重复记录

接口URL:friend/Get_RedFaind

请求方式:Get

Headers:
access_token:token
Content-type: text/json

###### 其他参数参考Headers说明

请求参数

参数名数据类型是否必须说明
ad_friend_wenoberstring是好友原始微信号/修改后的微信号
wechat_leiint是运营号类型;默认为0;0=个微、3=企微

请求示例

http://《你服务器IP》:5003/v1/friend/Get_RedFaind?ad_friend_wenober=wxid_lohgmuo9i3a012

接收返回结果

{
    "errmsg": 20000,
    "succeed": true,
    "msgTime": "2020-06-19T18:27:36.6541257+08:00",
    "values": [
        {
            "ad_wechat_nick": "P10",
            "ad_wechat_id": 3526,
            "ad_wechat_nober": "yg181112",
            "ad_friend_wenober": "wxid_lohgmuo9i3a012",
            "ad_friend_uwenober": "soso7657",
            "ad_expand": "MetalHeart",
             "ad_relation_time": "2022-11-16T14:22:12"
        },
        {
            "ad_wechat_nick": "P11",
            "ad_wechat_id": 3527,
            "ad_wechat_nober": "yg1811121",
            "ad_friend_wenober": "wxid_lohgmuo9i3a012",
            "ad_friend_uwenober": "soso7657",
            "ad_expand": "b08",
            "ad_relation_time": "2022-03-23T21:04:06"
        },
        {
            "ad_wechat_nick": "P13",
            "ad_wechat_id": 3520,
            "ad_wechat_nober": "cs88ag",
            "ad_friend_wenober": "wxid_lohgmuo9i3a012",
            "ad_friend_uwenober": "soso7657",
            "ad_expand": "MetalHeart",
            "ad_relation_time": "2020-08-07T10:41:59"

        }
    ],
    "errdesc": null
}

返回结果说明

参数名数据类型说明
ad_wechat_nickstring运营号机号
ad_wechat_idint运营机编号
ad_wechat_noberstring运营机微信号
ad_friend_wenoberstring好友原始微信号
ad_friend_uwenoberstring好友修改后微信号
ad_expandstring归属员工(对应聚合聊天员工)
ad_relation_timeDateTime添加时间

群资料

接口URL: friend/Getchatroom

请求方式:Get 

Headers:
access_token:token
Content-type: text/json

###### 其他参数参考Headers说明

请求参数

参数名数据类型是否必须说明
ad_wechat_idint是运营号编号
ad_chatroom_namestring是群号

请求示例

http://《你服务器IP》:5003/v1/friend/Getchatroom?ad_chatroom_name=2315551176@chatroom&ad_wechat_id=3533

接收返回结果

{
    "errmsg": 20000,
    "succeed": true,
    "msgTime": "2019-12-12T17:22:06.2327781+08:00",
    "values": {
        "ad_chatroom_name": "22315551176@chatroom",
        "ad_chatroom_memberlist": "wxid_w4ebc6txje6622;wxid_3qh9x1bq12je22;wxid_sm1x4gk37ten22",
        "ad_wechat_id": 3533,
        "ad_chatroom_real_displayname": "[\"嘿撒丽娜\", \"自动测试196\", \"WatsonLiufu\"]",
        "exist_frend": "[\"wxid_3qh9x1bq12je22\",\"wxid_sm1x4gk37ten22\",\"wxid_w4ebc6txje6622\"]",
        "ad_chatroom_notice": "",
        "ad_wechat_nober": "dong23287",
        "ad_chatroom_qrcode": "wxid_6oygtisfn89122mmqrcode1619330917997.png",
        "ad_chatroom_qrcodedate": 1619330918
    }
}

返回结果说明

参数名数据类型说明
ad_chatroom_namestring群号
ad_chatroom_memberliststring群成员原始微信号
ad_wechat_idint运营号编号
ad_chatroom_real_displaynamestring群显示名字(数组,与ad_chatroom_memberlist一对一对应)
exist_frendstring运营号已存在群好友的原始微信号
ad_chatroom_noticestring群公告
ad_wechat_noberstring运营号
ad_chatroom_qrcodestring群二维码(url地址:http://ttimg.agsoft.net/商家编号/other/群二维码key)
ad_chatroom_qrcodedatestring群二维码获取时间(群二维码获取时间,群二维码获取之后7天内有效)

好友申请通知

接口URL:NotificAtion

请求方式:Get

Headers:
access_token:token
Content-type: text/json

请求参数

参数名数据类型是否必须说明
startDatestring否最后修改开始时间(格式:2018-10-10 12:00:00)
endDatestring否最后修改结束时间(格式:2018-10-10 12:00:00)
qStartDatestring否好友申请开始时间(格式:2018-10-10 12:00:00)
qEndDatestring否好友申请结束时间(格式:2018-10-10 12:00:00)
wechat_nostring否运营号微信号
notification_deviceidstring否运营号机号
notification_stteint否状态(默认-1全部,0未通过,1已通过)
pageint否页数(默认第1页)
pagesizeint否每页多少个(默认20)

请求示例

http://《你服务器IP》:5003/v1/NotificAtion?startDate=2020-01-01

接收返回结果

{
    "errmsg": 20000,
    "succeed": true,
    "msgTime": "2018-05-11T15:40:14.1523923+08:00",
    "values": [
    {
      "notification_upid": 135389,
      "notification_title": null,
      "notification_instructions": null,
      "notification_deviceId": null,
      "notification_datetime": 1523359156496,
      "notification_extend": "{\"sex\": 0, \"city\": \"\", \"sign\": \"\", \"alias\": \"\", \"sayHi\": \"我是夏日星\", \"scene\": 3, \"status\": 1, \"deviceId\": \"测试1278\", \"nickname\": \"夏日星座\", \"province\": \"\", \"username\": \"wxid_d9oq2mmvro9h22\", \"requestTime\": 1523360512075, \"smallheadimgurl\": \"\", \"lastModifiedTime\": 1523360512075}",
      "notification_accept": "[\"10000\", \"10005\", \"MetalHeart\"]",
      "notification_deal_saffcode": null,
      "notification_dealtime": "2018-04-10T19:19:17+08:00",
      "notification_id": "3602ab822cfa00fc3ca01ed6f93a11c1",
      "notification_type": 0,
      "notification_stte": 1,
      "notification_updatedatetime": 1523360512075,
      "notification_deviceid": "测试1278",
      "merchantid": "333513091",
      "ad_wechat_id": "wxid_banxmzfo0z6c51"
    },
    {
      "notification_upid": 135389,
      "notification_title": null,
      "notification_instructions": null,
      "notification_deviceId": null,
      "notification_datetime": 1523359156496,
      "notification_extend": "{\"sex\": 0, \"city\": \"\", \"sign\": \"\", \"alias\": \"\", \"sayHi\": \"我是夏日星\", \"scene\": 3, \"status\": 1, \"deviceId\": \"测试1278\", \"nickname\": \"夏日星座\", \"province\": \"\", \"username\": \"wxid_d9oq2mmvro9h22\", \"requestTime\": 1523360512075, \"smallheadimgurl\": \"\", \"lastModifiedTime\": 1523360512075}",
      "notification_accept": "[\"10000\", \"10005\", \"MetalHeart\"]",
      "notification_deal_saffcode": null,
      "notification_dealtime": "2018-04-10T19:19:17+08:00",
      "notification_id": "3602ab822cfa00fc3ca01ed6f93a11c1",
      "notification_type": 0,
      "notification_stte": 1,
      "notification_updatedatetime": 1523360512075,
      "notification_deviceid": "测试1278",
      "merchantid": "333513091",
      "ad_wechat_id": "wxid_banxmzfo0z6c51"
    }]
}

返回结果说明

参数名数据类型说明
notification_upidlongID
notification_titlestring好友标题
notification_extendobject好友申请参数
notification_acceptobject申请通知员工
notification_deal_saffcodestring最后操作员工号
notification_dealtimestring员工操作时间
notification_stteint申请状态(0未通过,1已通过)
notification_updatedatetimelong记录最后更新时间(精确到毫秒)
notification_deviceidstring运营机号
ad_wechat_idstring运营号原始微信号

notification_extend 说明

参数名说明
sex性别
city城市
alias地区
sayHi打招呼语
scene好友申请来源
nickname好友昵称
requestTime申请时间(精确到毫秒)

好友朋友圈

接口URL: Circle

请求方式:Get

Headers:
access_token:token
Content-type: text/json

###### 其他参数参考Headers说明

请求参数

参数名数据类型是否必须说明
pageint是页数
pagesizeint是每页多少条
ad_friend_wenoberstring否好友微信号(如果不传即所有好友朋友圈)
ad_friend_leiint是(0运营号朋友圈,1客户朋友圈)
ad_original_noberstring否运营机原始微信号(如果选择查看运营号朋友圈,运营机原始微信号必填)
ad_snsidstring否朋友圈编号

请求示例

http://《你服务器IP》:5003/v1/Circle?page=1&pagesize=100&ad_friend_lei=1

接收返回结果

{
    "errmsg": 20000,
    "succeed": true,
    "msgTime": "2020-06-22T21:05:18.8942876+08:00",
    "values": [
        {
            "ad_snsid": "-5085121991862439777",
            "ad_friend_wenober": "wxid_dzeql6nahq7l22",
            "ad_client_content": "{\"url\": \"http://www.bdrfqs.cn/QTpC/tykkebtucfgeurihxzl.html?from=groupmessage&from=groupmessage#\", \"title\": \"奇闻:这是中国最邪门的18个神秘事件,至今无法解释,看过都不敢相信!\", \"imgUrl\": [], \"content\": \"三个头乌龟🐢 乌龟王八蛋谁见过!马上开开眼界吧[强][强][强][强][强][强]\"}",
            "ad_type": 3,
            "ad_createtime": 1592829475,
            "ad_comment": "[]",
            "ad_friend_photo": "http://wx.qlogo.cn/mmhead/ver_1/iaueg1bHsibfln5yUVGAG7nE47iawu4KoA8lMUQicttrGOfdlwJAbJGehUvyFqprmnZB8aFkJyBMwbQufJBbiadUTicXCS3VqaCBM3B4FzmOtXUac/96",
            "ad_friend_name": "何润发",
            "ad_friend_lei": 1,
            "ad_wechat_id": 34780,
            "ad_wechat_nick": "P05",
            "ad_wechat_nober": "dong23287",
            "ad_original_nober": "wxid_w4ebc6txje6622",
            "ad_relation_remark": "",
            "ad_friend_id": 2723890
        },
        {
            "ad_snsid": "-5085127561539407700",
            "ad_friend_wenober": "wxid_y3048qbey11921",
            "ad_client_content": "{\"imgUrl\": [\"13361616512538980545\", \"13361616512573976739\"], \"content\": \"村里有个姑娘叫小莉,长得不好看却善良😂\\n开播💗\"}",
            "ad_type": 1,
            "ad_createtime": 1592828811,
            "ad_comment": "[]",
            "ad_friend_photo": "http://wx.qlogo.cn/mmhead/ver_1/cv5xnaWCLf3ib8R28kfO0uXrC0OsKcry2oPHkIxIIuI674HjXztopN1PewYuYDuv30ePibhTCLwJ6dBvum1ia2rc3MDVXgFvZS4LtvgkpoCBZ8/96",
            "ad_friend_name": "宝藏莉妹",
            "ad_friend_lei": 1,
            "ad_wechat_id": 34780,
            "ad_wechat_nick": "P05",
            "ad_wechat_nober": "dong23287",
            "ad_original_nober": "wxid_w4ebc6txje6622",
            "ad_relation_remark": "A🌸小莉",
            "ad_friend_id": 2724832
        }]
}

返回结果说明

参数名数据类型说明
ad_snsidstring朋友圈编号
ad_friend_wenoberstring朋友圈好友微信号
ad_client_contentstring朋友圈内容,
ad_typeint朋友圈类型(1: 图片,2: 文字,3: 链接,4: 音乐,15:视频)
ad_createtimeint朋友圈发布时间(精确到秒的时间戳)
ad_commentobject朋友圈评论和点赞,朋友圈回复他人评论
ad_friend_photostring朋友圈好友头像
ad_friend_namestring朋友圈好友昵称
ad_friend_leiint0运营号朋友圈,1客户朋友圈
ad_wechat_idint运营号编号
ad_wechat_nickstring运营号机号
ad_wechat_nickstring运营号微信号
ad_original_noberstring运营号原始微信号
ad_relation_remarkstring朋友圈好友备注
ad_friend_idint朋友圈好友编号

投放组新增的客户总数

请求url:AdManage/GetFanTotalBybrand
请求方式:post  FromBody提交
Headers:
access_token:token
Content-type: text/json

###### 其他参数参考Headers说明

请求参数

参数名数据类型是否必须说明
ad_brand_idint是投放组编号
notinvalidint否是否忽略归属给无效工号的客户。0否,1是。默认值0
requeststarttimeint否客户申请开始时间,时间戳精确到秒(不传时间会是该投放组投放广告相应状态的开始时间)
requestendtimeint否客户申请结束时间,时间戳精确到秒(不传时间会是该投放组投放广告相应状态的结束时间)
ad_wechat_idjson数组否该投放组的微信号唯一标识集合
ad_wechat_nickjson数组否该投放组的机号集合
ad_wechat_noberjson数组否该投放组的微信号集合
ad_manage_sateint否广告状态(0只查上线状态的新增客户数,1只查下线状态的新增客户数,2所有)

请求示例

{
    "ad_brand_id": 145,
    "notinvalid": 0,
    "requeststarttime": "1554048000",
    "requestendtime":1569759391,
    "ad_wechat_id": [
        "3430",
        "3350"],
    "ad_wechat_nick":[
        "P06",
        "P07"],
    "ad_wechat_nober":[
        "kkk368555",
        "yg1811261"],
    "ad_manage_sate":0
}

接收返回结果

{
    "errmsg": 20000,
    "succeed": true,
    "msgTime": "2019-09-30T09:24:27.3668159+08:00",
    "values": 123
}

返回结果说明

参数名数据类型说明
valuesint总数

转账/红包列表

接口URL:ChatMess/TransferList

请求方式:Get

Headers:
access_token:token
Content-type: text/json

###### 其他参数参考Headers说明

请求参数

以下参数均是可选参数,当不传任何参数情况下,系统会默认返回前20个好友!

参数名数据类型是否必须说明
typeint是类型,0:收款列表,1:收红包列表,2:转账列表,3:发红包列表
startDatestring否开始日期,默认当天日期
endDatestring否结束日期,默认当天日期
pageint否页码,默认1
pageSizeint否页面大小,默认20
handledstring否是否处理,-1:全部,true:已处理,false:未处理,默认-1(注意是字符串类型)
weChatstring否收/付款方微信
friendNamestring否客户昵称
friendRemarksring否客户备注
handledRemarkstring否处理备注
stateint否处理状态 -1:全部, 0:未收, 1:已收, 2:过期,3:已退

请求示例

{
	"type": 0,
	"startDate": "2021-03-15",
	"endDate": "2021-03-15",
	"page": 1,
	"pageSize": 20,
	"handled": "-1",
	"weChat": "微信号",
	"friendName": "昵称",
	"friendRemark": "备注",
	"handledRemark"L "处理备注",
	"state": -1
}

接收返回结果

[{
	"ad_we_transfer_id": 719130,
	"ad_wechat_id": 34783,
	"ad_wechat_talter": "Zhangzhongren814",
	"ad_wechat_money": 0.00,
    "ad_wechat_type":0,
	"ad_wechat_operationtime": "2020-07-22T15:48:23+08:00",
    "ad_wechat_time":"2020-07-22T15:48:23+08:00",
	"ad_wechat_view": true,
    "ad_wechat_text":"100",
	"ad_wechat_nober": "zvzv9223",
	"ad_wechat_nick": "P01",
	"ad_friend_name": "xiaorenzi",
	"ad_friend_uwenober": "",
	"ad_wechat_remark": "163233",
	"ad_wechat_state": 2,
	"ad_relation_remark": "xiaorenziu"
}]

返回结果说明

参数名数据类型说明
ad_we_transfer_idint
ad_wechat_idint微信表id
ad_wechat_talterstring客户微信号
ad_wechat_moneydouble金额
ad_wechat_typeint0:收款列表,1:收红包列表,2:转账列表,3:发红包列表类)
ad_wechat_operationtimestring聊天时间
ad_wechat_timestring入库时间
ad_wechat_viewbool是否处理
ad_wechat_textstring记录备注
ad_wechat_noberstring运营机微信号
ad_wechat_nickstring所属机号
ad_friend_namestring客户昵称
ad_friend_uwenoberstring好友微信更改后微信号
ad_wechat_remarkstring客户备注
ad_wechat_stateint转账/红包状态,0:未收,1:已收,2:过期,3:已退
ad_relation_remarkstring处理状态

获取设备设置

接口URL: Helper/GetHelperSetUp

请求方式:get
Headers:
access_token:token
Content-type: text/json

###### 其他参数参考Headers说明

请求参数

参数名数据类型是否必须说明
pageint否默认为1
pagesizeint否默认为10
orderbystring否需要排序的字段,默认为settingtime
sortstring否排序类型,asc:升序,desc:降序,默认为desc
ad_original_noberstring否原始微信号

请求示例

http://《你服务器IP》:5003/v1/Helper/GetHelperSetUp?page=1&pagesize=10&ad_original_nober=wxid_1uj53oslpos422

接收返回结果

{
    "errmsg": 20000,
    "succeed": true,
    "msgTime": "2020-09-08T20:54:47.6687419+08:00",
    "values": "操作成功",
    "errdesc": null
}

返回结果说明

参数名数据类型说明
succeedbooltrue成功,false失败
msgTimeDateTime信息返回时间
valuesobject返回的数据

values字段说明

参数名数据类型说明
ad_original_noberstring原始微信号
ad_upgrade_timeDateTime助手升级时间
merchantidstring商家编号
ad_submit_timeDateTime提交升级时间
settingbeanJsonObject好友设置详情
accessibilitystatusint任务状态
settingtimeDateTime最后获取设置时间
balancetimeDateTime获取余额时间
wxpluginversioncodeint拓展功能插件版本号
wxpluginversionnamestring拓展功能插件版本名称
manufacturerstring手机生产 商
remainingEnergyint电量 -1:未知
remainingTelChargeint手机余额 -2:未知,-1:获取失败
remainingChatRecordint待上传数据 -1:未知
wxStateint微信状态 -1:未知,0:未安装,1:未登录,2:未授权,3:数据解析错误,4:已授权
accServiceStateint行为服务状态 -1:未知,0:不支持,1:未开启,2:异常,3:暂停,4:正常
dataServiceStateint数据服务状态 -1:未知,0:异常,1:正常
versionNamestring微助手版本名称
versionCodeint微助手版本号 -1:未知
wxVersionNamestring微信版本名称
wxVersionCodeint微信版本号 -1:未知
deviceModelstring设备型号
deviceManufacturerstring设备制造商
deviceImeistring设备唯一码
enterpriseModeint企业模式 -1:未知,0:不支持,1:未激活,2:已激活

settingbeanJson 字段说明

参数名数据类型说明 1:是,0:否
friendRequestint自动通过好友申请设置
gatheringint是否打开红包/转账
autoCutVideoint自动挂断语音和视频会话
autoAccint自动开启行为服务
autoOpenImgint自动查看原图/视频
autoRebootPhoneint自动重启手机
frsBeanobject好友设置详情
masRateBeanobject群发频率
momentsBeanobject朋友圈设置
autoUpgradeBeanobject自动升级
autoRemarkBeanobject通过好友后自动备注
addContactsBeanobject通讯录加好友
adminSettingsBeanobject管理员设置
runPatternBeanobject运行模式
operationBeanobject操作设置
autoReplyCollectionBeanobject自动整理好友申请记录(开启可提高通过好友的频率)
chatRoomBeanobject群聊相关
activeWxBeanobject活跃微信号

frsBean 好友设置详情字段说明

参数名数据类型说明 1:是,0:否
autoReplyint通过后自动回复
autoReplyContentstring自动回复详情/转账
datestring自动回复的日期(周一至周日)
trimRequestRecordint整理好友记录
passFansMaxFailureCountint好友申请允许最大连续失败
useAutoReplyInitiativeContentint使用主动通过好友的自动回复内容
passRateBeanobject好友通过频率

passRateBean 好友通过频率详情字段说明

参数名数据类型说明
dayMaxint一天最多通过多少个好友
hourMaxint一小时最多通过多少个好友
minMaxint一分钟最多通过多少个好友

masRateBean 群发频率详情字段说明

参数名数据类型说明
dayMaxint一天最多群发多少条
hourMaxint一小时最多群发多少条
minMaxint一分钟最多群发多少条

momentsBean 朋友圈设置详情字段说明

参数名数据类型说明 1:是,0:否
refreshMomentint自动刷新朋友圈
refreshMomentsImgint自动获取朋友圈图片
refreshMomentsSingleint自动刷新新进好友朋友圈
uploadMomentsint上传朋友圈数据

autoUpgradeBean 自动升级详情字段说明

参数名数据类型说明 1:是,0:否
autoReplyint是否自动升级
autoUpgradeTimeBlockstring自动升级时间段,此字段为JSON数组的字符串形式,其中元素为对象,包含以下字段:startTime: 整型,开始时间,时间戳剥离日期部分,endTime: 整型,结束时间,为时间戳剥离日期部分
autoUpgradeWxint微信自动升级

autoRemarkBean 通过好友后自动备注详情字段说明

参数名数据类型说明 1:是,0:否
autoRemarkint自动添加备注是否打开
definedRemarkPart1string自定义内容1
definedRemarkPart2string自定义内容2
definedRemarkPart3string分隔符
autoRemarkOrderstring自动添加备注排序数组

addContactsBean 通讯录加好友详情字段说明

参数名数据类型说明 1:是,0:否
addContactsint通讯录加好友
startTimelong通讯录加好友开始时间(时间)
endTimelong通讯录加好友结束时间(时间)
maxCountint每天最多执行
onceCountint每次执行最多添加
remarkPhoneNumint使用手机号码备注
autoReplyInitiativeint好友通过后自动回复
useAutoReplyContentint使用好友申请的自动回复内容
autoReplyInitiativeContentstring主动加好友后通过后自动回复详情

adminSettingsBean 管理员设置详情字段说明

参数名数据类型说明 1:是,0:否
adminCipherstirng管理员密码
deniedUninstallint微助手防卸载
settingsLockint微助手设置锁定
callRecordint强制通话录音
deniedSendKeywordint拦截含有监控关键字的任务
inspectSensitiveBothwayint双向监控聊天关键字
deniedDeleteChatRecordint是否允许删除消息

runPatternBean 运行模式详情字段说明

参数名数据类型说明
runPatternint运行模式,0数据分析,1聚合聊天,2快速通过好友
resetSettingsint初始化设置为默认设置

operationBean 操作设置详情字段说明

参数名数据类型说明 1:是,0:否
operationDelayint页面切换延时(毫秒)
autoBackWechatxint任务结束后返回助手
operationTimeoutint基础操作超时 5-10s
coreServiceRunModeint数据服务运行速率
accPauseModeint行为服务暂停后重新启动

autoReplyCollectionBean 自动整理好友申请记录(开启可提高通过好友的频率)详情字段说明

参数名数据类型说明 1:是,0:否
autoReplyCollectionint通过好友后自动回复收藏内容(只在【快速通过好友】模式下生效)

chatRoomBean 群聊相关详情字段说明

参数名数据类型说明 1:是,0:否
uploadChatRoomResint上传群聊图片和视频

activeWxBean 活跃微信号详情字段说明

参数名数据类型说明 1:是,0:否
activeWxint自动活跃微信号 0开启,1不开启
rRefreshFansMomentsint自动浏览好友朋友圈
rChatWithFansint自动与好友聊天
randomFansstring自动与好友聊天列表
rReadNewsint自动浏览腾讯新闻
rSendMomentsint自动发送朋友圈
rReadFansListint自动浏览好友列表
rClickUnreadint自动查看未读消息
timeBlockstring操作时间段
datestring操作日期
randomFansNickstring自动好友列表的昵称

读取员工激活客户数排行榜

接口URL: staff/GetActivationListByStaff

请求方式:Post

Headers:
access_token:token
Content-type: text/json

###### 其他参数参考Headers说明

请求参数

参数名数据类型是否必须说明
timeint是取当天零点时间戳(精确到秒)
wechat_leiint否0=个微、3=企微
ad_staff_codestring否员工工号

请求示例

http://《你服务器IP》:5003/v1/staff/GetActivationListByStaff

{
    "time": 1706112000
}

接收返回结果

{
    "errmsg": 20000,
    "succeed": true,
    "msgTime": "2020-06-22T21:05:18.8942876+08:00",
    "values": [
        {
            "activationnum": 1,
            "ad_staff_code": "zhiyi",
            "ad_staff_name": "志艺",
            "depart_name": "技术部",
            "depart_group_name": "技术部一组"
        }
      ]
}

返回结果说明

参数名数据类型说明
activationnumint激活客户数
ad_staff_codestring员工工号
ad_staff_namestring员工名称
depart_namestring部门名称
depart_group_namestring分组名称

读取员工行为记录

接口URL: staff/GetStaffBehaviorLog

请求方式:Post

Headers:
access_token:token
Content-type: text/json

###### 其他参数参考Headers说明

请求参数

参数名数据类型是否必须说明
pageint是页数
pagesizeint是每页多少条
ad_staff_behavior_typeint否行为类型:发朋友圈=1、点赞朋友圈=2、评论朋友圈=3、完成待办=4、群发任务=5
ad_staff_behavior_resultint否行为结果:待执行=0、执行成功=1、执行失败=2
start_timeint否行为开始时间
end_timeint否行为结束时间
ad_staff_codestring否行为执行员工

请求示例

http://《你服务器IP》:5003/v1/staff/GetStaffBehaviorLog

{
    "page": 1,
    "pagesize": 10,
    "ad_staff_behavior_type": 1
}

接收返回结果

{
    "errmsg": 20000,
    "succeed": true,
    "msgTime": "2020-06-22T21:05:18.8942876+08:00",
    "values": [
        {
            "ad_staff_behavior_type": 1,
            "ad_staff_behavior_addtime": 1592829475,
            "ad_staff_behavior_updatetime": 1592829475,
            "ad_staff_behavior_result": 1,
            "ad_staff_behavior_content": "",
            "ad_staff_code": "P05",
            "merchantid": "111111"
        }
      ]
}

返回结果说明

参数名数据类型说明
ad_staff_behavior_typeint行为类型:发朋友圈=1、点赞朋友圈=2、评论朋友圈=3、完成待办=4、群发任务=5
ad_staff_behavior_addtimeint记录时间
ad_staff_behavior_updatetimeint完成时间
ad_staff_behavior_resultint行为结果:待执行=0、执行成功=1、执行失败=2
ad_staff_behavior_contentstring行为内容
ad_staff_codestring所属员工
merchantidstring商户号

读取员工行为记录总数

接口URL: staff/GetStaffBehaviorLogCount

请求方式:Post

Headers:
access_token:token
Content-type: text/json

###### 其他参数参考Headers说明

请求参数

参数名数据类型是否必须说明
ad_staff_behavior_typeint否行为类型:发朋友圈=1、点赞朋友圈=2、评论朋友圈=3、完成待办=4、群发任务=5
ad_staff_behavior_resultint否行为结果:待处理=0、已处理=1
start_timeint否行为开始时间
end_timeint否行为结束时间
ad_staff_codestring否行为执行员工

请求示例

http://《你服务器IP》:5003/v1/staff/GetStaffBehaviorLogCount

{
    "page": 1,
    "pagesize": 10,
    "ad_staff_behavior_type": 1
}

接收返回结果

{
    "errmsg": 20000,
    "succeed": true,
    "msgTime": "2020-06-22T21:05:18.8942876+08:00",
    "values": 100
}

返回结果说明

参数名数据类型说明
valuesint记录总数

运营机电话监控通话列表

接口URL:CallRecord

请求方式:Post

Headers:
access_token:token
Content-type: text/json

###### 其他参数参考Headers说明

请求参数

以下参数均是可选参数

参数名数据类型是否必须说明
CallTimelong否开始通话的时间,精确到毫秒的时间戳,默认为0,传0查询所有通话记录
ad_wechat_noberstring否微信号,支持模糊查询
ad_wechat_nickstring否机号,支持模糊查询
Pageint否页码,默认1
PageSizeint否页面大小,默认100

请求示例

{
	"CallTime": 1638201600000,
	"ad_wechat_nober": "yg1811264",
	"ad_wechat_nick": "P07",
	"Page": 1,
	"PageSize": 100
}

接收返回结果

{
    "list": [
        {
            "callrecord_id": 559,
            "imei": "862519046602583",
            "callnumber": "13751821837",
            "selfnumber": null,
            "calltype": 2,
            "callstate": 1,
            "calltypename": "未接",
            "calltime": 1559808798489,
            "callduration": 0,
            "recorddownloadkey": null,
            "ad_wechat_nober": "yg1811121",
            "ad_wechat_nick": "P11",
            "ad_create_time": 1577674563,
        }
    ],
    "ad_update_time": 1571906687156
}

返回结果说明

参数名数据类型说明
callrecord_idint自动增长编号
imeistring手机唯一码
callnumberstring客户号码
selfnumberstring自己手机号码(为空时未绑定手机号码)
calltypeint1呼入,2呼出
callstateint电话状态(1未接,2已接,3黑名单,4语音信箱,5呼叫转移)
calltypenamestring电话状态对应的文本类型
calltimelong开始通话的时间,精确到毫秒的时间戳
calldurationint通话时长(秒)
recorddownloadkeystring录音文件key,只有有通话时长的才有录音文件,链接为 http://ttimg.agsoft.net/商家编号/callRecord/对应的key
ad_wechat_noberstring所属微信号
ad_wechat_nickstring所属机号
ad_create_timelong入库时间,精确到毫秒的时间戳
上一页
基础数据类接口
下一页
行为操作类接口
Built with