• 售前顾问:400-618-6615


  • 销售顾问

  • 申请试用

销售服务热线: 400-618-6615   在线微信客服

接口文档

开发平台首页>

工作手机系统 稽核内容回调接口 V2

  • 上线时间 2024-7-14

概述

该接口可向合作伙伴预留的回调接口,推送最新的工作手机内容管控稽核信息(包含通话记录、短信记录、微信记录)。

合作伙伴公布的回调接口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 为数组类型,有可能返回多条记录。

* 推荐配合回调日志工具,核实接口返回情况。该工具可在摩盖管理后台,[系统设置]-[开发相关配置]-[回调日志]中使用。