概述
该接口用于获取企业账户下所有工作手机上的微信聊天记录
请求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:普通消息
43:视频文件
50:视频音频通话
50:视频音频通话
49: 模板消息
|
conRemark
|
好友(客户)的名称备注 |
图片处理
当 audioFileName
参数值为空,如contents
参数值以.jpg或.png结尾,则该消息为图片消息,图片可通过以下URL进行获取。
{StorageUrl}axw_{contents}
{StorageUrl}可通过
getRawStorageConfig接口获得
短音频处理
当 audioFileName
参数值不为空,则该消息为短语音消息,语音文件可通过以下URL进行获取
https://scrm.mobilegate.cn/SharedUserControl/GoToVoice.aspx?s={audioFileName}
模板消息处理
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"}