回调数据
接口URL: 由商户在后台设置
请求方式:Post
Headers:
Content-type: text/json
回调请求参数
参 数名 | 数据类型 | 说明 |
---|---|---|
Type | int | 操作类型 |
MerchantId | string | 商户ID |
MsgTime | long | 信息产生时间(时间戳:秒) |
Values | Object | 附带数据 |
请求示例
{
"Type": 0,
"MerchantId": 9527,
"MsgTime": 1600239001,
"Values": {
"ad_friend_id": 1153549,
"ad_friend_uwenober": "www_7182453",
"ad_friend_wenober": "wxid_167px6des5ie22",
}
}
预期返回格式
参数名 | 数据类型 | 说明 |
---|---|---|
Result | bool | 结果 |
ReturnCode | int | 响应编码 |
Message | string | 响应信息 |
返回示例
{
"Result": true,
"ReturnCode": 200,
"Message": "操作完成"
}
操作类型说明
数值 | 操作类型 |
---|---|
0 | 标签、备注保存操作 |
1 | 发送消息 |
2 | 修改 客户资料 |
3 | 群操作 |
4 | 获取聊天消息 |
5 | 获取好友列表 |
6 | 设备异常 |
7 | 评论/点赞朋友圈 |
8 | 回复自己朋友圈的评论 |
各操作类型具体请求说明
标签、备注保存操作
Values说明
参数名 | 数据类型 | 说明 |
---|---|---|
labeltype | int | 操作类型,0新增标签,1移除标签,3修改备注,5同步修改标签和备注,6修改标签 |
ad_relation_remark | string | 备注信息 |
chooselabel | string | 修改或删除的标签 |
friendIds | string | 客户微信ID+机号微信ID,格式为"客户微信ID |
{
"Type": 0,
"MerchantId": 9527,
"MsgTime": 1600239001,
"Values": {
"labeltype": 0,
"ad_relation_remark": "备注",
"chooselabel": "["123","456"]",
"friendIds": "0769|9527"
}
}
发送消息
Values说明
参数名 | 数据类型 | 说明 |
---|---|---|
ad_original_nober | int | 原始微信号 |
taskState | string | 任务状态 0收到 1成功 2失败 3撤回 |
taskResult | int | 任务执行结果 |
taskId | string | 任务id |
taskTime | string | 预计任务执行结束是在多少毫秒之后 |
sendUserId | string | 发送该任务的账号 |
extend | string | 内容 |
taskType | string | 任务类型 |
{
"Type": 1,
"MerchantId": 9527,
"MsgTime": 1600239001,
"Values": {
"ad_original_nober": "2020",
"taskState": "0",
"taskResult":"任务完成",
"taskId": "1234",
"taskTime": 1600239001,
"takeType": 1,
"sendUserId": "9527",
"extend": "内容",
}
}
修改客户资料
Values说明
参数名 | 数据类型 | 说明 |
---|---|---|
labeltype | int | 操作类型,0新增标签,1移除标签,2修改备注 |
ad_original_nober | string | 原始微信号 |
taskState | int | 任务状态 0收到 1成功 2失败 3撤回 |
taskResult | string | 任务执行结果 |
taskId | string | 任务id |
taskTime | string | 预计任务执行结束是在多少毫秒之后 |
Accounts | string | 账号 |
Birthday | string | 生日 |
ChenWei | string | 称谓 |
ExtendJson | string | 自定义字段json |
Moble | string | 手机号 |
Name | string | 真实姓名 |
Nick | string | 昵称 |
Sex | string | 性别 |
UserId | string | 用户id |
Hidefriend | int | 是否隐藏信息,等于1则隐藏 |
Address | string | 地址 |
ProvinceCode | string | 省份code |
CityCode | string | 城市code |
AreaCode | string | 区域code |
StreetCode | string | 街道code |
MobleTwo | string | 手机号2 |
MobleThree | string | 手机号3 |
MerchantId | string | 商户ID |
{
"Type": 1,
"MerchantId": 9527,
"MsgTime": 1600239001,
"Values": {
"Accounts": "账号",
"Birthday": "生日",
"ChenWei":"称谓",
"ExtendJson": "自定义字段json",
"Moble": "手机号",
"Name": "真实姓名",
"Nick": "昵称",
"Sex": "性别",
"UserId": "用户id",
"Hidefriend": 1,
"Address":"地址",
"ProvinceCode": "省份code",
"CityCode": "城市code",
"AreaCode": "区域code",
"StreetCode": "街道code",
"MobleTwo": "手机号2",
"MobleThree": "手机号3",
"MerchantId": "商户ID"
}
}
群操作
Values说明
参数名 | 数据类型 | 说明 |
---|---|---|
ad_original_nober | string | 原始微信号 |
taskState | int | 任务状态 0收到 1成功 2失败 3撤回 |
taskResult | string | 任务执行结果 |
taskId | string | 任务id |
taskTime | string | 预计任务执行结束是在多少毫秒之后 |
sendUserId | string | 发送该任务的账号 |
takeType | string | 任务类型 |
extend | string | 内容 |
{
"Type": 1,
"MerchantId": 9527,
"MsgTime": 1600239001,
"Values": {
"ad_original_nober": "2020",
"taskState": "0",
"taskResult":"任务完成",
"taskId": "1234",
"taskTime": 1600239001,
"takeType": 1,
"sendUserId": "9527",
"extend": "内容",
}
}
获取聊天消息
Values说明
参数名 | 数据类型 | 说明 |
---|---|---|
ad_chatting_id | long | 记录ID |
ad_chatting_talter | string | 接收人ID(接收者微信号) |
ad_chatting_content | string | 聊天内容 |
ad_chatting_issend | int | 发送类型 |
ad_chatting_resvred | string | 内容格式 |
ad_wechat_id | string | 所属微信号 |
merchantid | string | 所属商户 |
ad_chatting_updatetime | DateTime | 最新上传时间 |
ad_chatting_sate | int | 内容状态 |
ad_staff_code | string | 员工号 |
ad_staff_name | string | 员工姓名 |
ad_expand | string | 是否已读(0已读,1未读,主要针对语音) |
isRecall | int | 是否为撤回消息(0否,1是) |
ad_voice_txt | string | 语音转文本内容 |
[{
"ad_chatting_id": 0,
"ad_chatting_talter": "wxid_2everm6btnvp22",
"ad_chatting_content": "987",
"ad_chatting_issend": 1,
"ad_chatting_time": "1614050169",
"ad_chatting_resvred": null,
"ad_wechat_id": "yg1811123",
"merchantid": null,
"ad_chatting_updatetime": "0001-01-01T00:00:00",
"ad_chatting_sate": 1,
"ad_staff_code": null,
"ad_expand": null,
"ad_staff_name": null,
"isRecall": 0,
"ad_voice_txt": null
}]
获取好友列表
Values说明
参数名 | 数据类型 | 说明 |
---|---|---|
ad_friend_photo | string | 头像 |
wenober | string | 微信号 |
ad_friend_wenober | string | 好友微信号 |
ad_relation_type | int | 关系类型 |
ad_isdel | int | 是否删除 |
ad_label | string | 标签 |
details | string | 好友详情 |
ad_request_time | long | 好友申请时间 |
chatroomflag | int | 是否群主(0 不是群主 1 是群主) |
describe | string | 助手标识符 |
addedMode | int | (加好友方式:-1未知 0你添加对方 1对方添加你) |
province | string | 地区 |
scene | int | 来源(见下表) |
sex | 性别 | |
sign | string | 个人签名 |
ad_friend_name | string | 好友昵称(有修改则上上传) |
ad_relation_remark | string | 好友备注(有修改则上上传) |
ad_wechat_id | int | 运营号微信ID |
ad_original_nober | string | 运营号原始微信号 |
* 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:对方通过搜索手机号添加
{
"list": [
{
"ad_friend_photo": "https://wx.qlogo.cn/mmhead/ver_1/0awanSz1GI06D1icGSOnc9coRDDEICckfFbPDU6gia42iazLFpCt7UEticalMe2qPTvNb2Bc0ibUb1WQVAU648td1L4yU9lK8iaBF9OTWpDOJQicn4/96",
"ad_friend_wenober": "wxid_9527xp921",
"ad_isdel": 0,
"ad_label": "[\"标签1\", \"标签2\"]",
"ad_relation_type": 3,
"ad_request_time": 0,
"chatroomFlag": 0,
"describe": "lhvlq",
"details": {
"addedMode": 1,
"province": "中国大陆",
"scene": 94,
"sex": 2,
"sign": "暮年仍应咆哮"
},
"ad_friend_name": "粽子"
}
],
"wenober": "ytk5194",
"ad_wechat_id":3231,
"ad_original_nober":"wxid_w4ebc6txje6622"
}
设备异常通知
Values说明
参数名 | 数据类型 | 说明 |
---|---|---|
merchantid | string | 商家编号 |
build_staff | string | 创建员工 |
remind_content | string | 提醒内容 |
remind_type | int | 提醒类型,设备异常默认为1 |
remind_other | string | 备注说明 |
remind_title | string | 提醒标题 |
remind_machine_no | string | 提醒机号 |
ad_original_nober | string | 提醒的原始微信号 |
{
"merchantid": "163856712",
"build_staff": "b9527",
"remind_content": "设备异常",
"remind_type": 1,
"remind_other": "设备异常说明",
"remind_title": "标题",
"remind_machine_no": "b14",
"ad_original_nober": "wx_489f6sdf1w83egf"
}
评论/点赞朋友圈 && 回复自己朋友圈的评论
Values说明
参数名 | 数据类型 | 说明 |
---|---|---|
ad_original_nober | string | 原始微信号 |
taskState | int | 任务状态 0收到 1成功 2失败 3撤回 |
taskResult | string | 任务执行结果 |
taskId | string | 任务id |
taskTime | string | 预计任务执行结束是在多少毫秒之后 |
sendUserId | string | 发送该任务的账号 |
takeType | string | 任务类型 |
extend | string | 内容json字符串,content: 评论内容(为“”或null则为点赞), snsId: 朋友圈ID |
{
"Type": 1,
"MerchantId": 9527,
"MsgTime": 1600239001,
"Values": {
"ad_original_nober": "2020",
"taskState": "0",
"taskResult":"任务完成",
"taskId": "1234",
"taskTime": 1600239001,
"takeType": 1,
"sendUserId": "9527",
"extend": "{\"content\":\"评论内容\",\"snsId\":\"30624700\"}",
}
}