概述
该接口可向合作伙伴预留的回调接口,推送最新的工作手机内容管控稽核信息(包含通话记录、短信记录、微信记录)。
合作伙伴公布的回调接口URL
http(s)://partner_server_url_address
* 该地址可在摩盖管理后台,[系统设置]-[开发相关配置] 中进行填写配置。
回调请求方式
POST
回调策略
当稽核内容同步至摩盖后的1分钟内回调至合作伙伴接口。合作伙伴需回复success
,视为回调内容送达,否则回调接口不会推送后续新信息。
回调请求参数
参数名 |
备注 |
mcm_type
|
稽核内容的类型(枚举值:calllog - 通话记录 / sms - 短信记录 / wechatmsg - 微信记录) |
staffid
|
员工ID |
[+]mcm_content
|
稽核内容结构体 |
[-]callTime
|
通话时间(类型为 calllog 时有效) |
[-]direction
|
通话方向,呼入:inbound 呼出:outbound(类型为 calllog 时有效) |
[-]phoneId
|
对方号码(类型为 calllog、sms 时有效) |
[-]alias
|
对方号码在通讯录中的名称(类型为 calllog、sms 时有效) |
[-]company
|
对方号码在通讯录中的公司名(类型为 calllog 时有效) |
[-]jobtitle
|
对方号码在通讯录中的职位名(类型为 calllog 时有效) |
[-]callStatus
|
通话状态 接通:pickup 未接通:miss(类型为 calllog 时有效) |
[-]stay
|
通话时长(类型为 calllog 时有效) |
[-]recordUrl
|
通话录音地址(类型为 calllog 时有效) 该地址含60分钟有效期的鉴权信息。 |
[-]recordrawencryptname
|
用于鉴权签名的文件ID(类型为 calllog 时有效),携带此参数通过 getSignedResUrl接口 获得经过鉴权签名的URL地址。建议此参数长期保留本地,后期可通过该参数随时换取鉴权签名后的URL。 |
[-]msgTime
|
短信时间(类型为 sms 时有效) |
[-]smsDirection
|
短信发送方向,发出:send 接收:recv(类型为 sms 时有效) |
[-]isTg
|
是否触发违禁字词(类型为 sms 时有效) |
[-]createTime
|
微信消息时间(类型为 wechatmsg 时有效) |
[-]staffwxid
|
员工方微信ID(类型为 wechatmsg 时有效) |
[-]staffwxalias
|
员工方微信昵称(类型为 wechatmsg 时有效) |
[-]staffwxmobile
|
员工方微信预留手机号码(类型为 wechatmsg 时有效) |
[-]talker
|
对方微信账号ID(类型为 wechatmsg 时有效) |
[-]nickname
|
对方微信昵称(类型为 wechatmsg 时有效) |
[-]contents
|
聊天内容(类型为 wechatmsg 时有效) 图片、音频、模版消息处理方式,请参考getWechatChatConversation接口中所述 |
[-]audioFileName
|
短音频文件名(类型为 wechatmsg 时有效),携带此参数通过 getSignedResUrl接口 获得经过鉴权签名的URL地址。 |
[-]status
|
发送/接收标记 0:接收 / 1:发送(类型为 wechatmsg 时有效) |
[-]type
|
消息类型
1:普通消息
43:视频文件
50:视频音频通话
50:视频音频通话
49: 模板消息
(类型为 wechatmsg 时有效) |
[-]conRemark
|
好友(客户)的名称备注(类型为 wechatmsg 时有效) |
回调请求包体格式
JSON
回调请求包体示例
{"mcm_type":"calllog","mcm_content":[{"staffid":"10000000001","staffalias":"员工1","calltime":"2024-05-29 23:24:43","direction":"inbound","phoneid":"13800138000","alias":"万总","callstatus":"pickup","stay":"00:00:15","recordrawencryptname":"ANTYxNw==AG_AGZ7XYXAGZ7XUDh2XzEwMDAwMDAwMDA0XzIwMjRfMDdfMTJfMTdfMzdfMzRfMTU4MzIx=.mp3","recordurl":"https://xxxxx"}]}
* mcm_content 为数组类型,有可能返回多条记录。
* 推荐配合回调日志工具,核实接口返回情况。该工具可在摩盖管理后台,[系统设置]-[开发相关配置]-[回调日志]中使用。