概述
该接口用于获取企业账户下所有工作手机上的微信聊天记录
请求URL
https://api-hub.mobilegate.net/getWechatChatConversation
请求方式
POST
请求参数
参数名 |
备注 |
enterpriseId
|
企业账号ID(详见管理控制台->开发信息) |
queryIndicator
|
代表员工的微信账号 |
begindate
|
查询开始日 格式 2020-06-01 00:00:00.000 |
enddate
|
查询结束日 格式 2020-06-01 00:00:00.000 |
requestToken
|
签名(详见 参数签名) |
返回结果
参数名 |
备注 |
createTime
|
会话时间 |
talker
|
对方微信账号 |
nickname
|
对方微信昵称 |
contents
|
聊天内容 |
audioFileName
|
短音频文件名 |
status
|
发送/接收标记 0:接收 / 1:发送 |
type
|
消息类型
1:普通消息
3:图片
34:语音条消息
43:视频文件
50:视频音频通话
50:视频音频通话
49: 模板消息
|
conRemark
|
好友(客户)的名称备注 |
图片处理
当消息类型为 3 代表微信图片,可将 contents
值内容作为文件ID,通过 getSignedResUrl接口 获得经过鉴权签名的URL地址。
短音频处理
当消息类型为 34 代表微信语音条,可将 audiofilename
值内容作为文件ID,
通过 getSignedResUrl接口 获得经过鉴权签名的URL地址。
模板消息处理
contents
参数中如出现 <des>类标记,则说明是消息模板,可配合type
参数,及正则表达式匹配消息中的特征字,从而判定红包、转账、好友邀请、资源转发、文件传输等消息类型。
返回格式
JSON
返回示例
{"Result":[{"createTime":"2020-06-25 15:21:00.000","talker":"wxid_5226adg4552a","nickname":"MoJiQo","contents":"你好呀~~","audioFileName":"","status":"0","type":"1","conRemark":"13800138001"},{"createTime":"2020-06-25 15:29:05.000","talker":"wxid_5226adg4552a","nickname":"MoJiQo","contents":"你在吗?","audioFileName":"","status":"0","type":"1","conRemark":"13800138001"}]}
异常返回
无数据返回
{"Result": "0"}
输入参数错误
{"Result": "-1"}
参数含有非法字符
{"Result": "-2"}
enterpriseID未提供
{"Result": "-3"}
begindate或enddate时间格式错误
{"Result": "-4"}
enddate需晚于begindate
{"Result": "-5"}
enddate与begindate的查询时差不能超过30天
{"Result": "-6"}
参数签名错误
{"Result": "-99"}