推送状态报告

推送地址: 用户自定义,登陆3tong.net配置,位置如图:

获取方式:

指大汉三通语音平台向用户系统主动推送语音外呼状态报告。编码统一为UTF-8,采用post方式推送。数据格式为JSON。用户收到Http请求后,使用getParameter(“voicereport”)获取相应内容并处理,最后以JSON形式返回处理结果给大汉平台。

功能:

用户收到的每个推送来的状态报告数据包内,包含不多于200条状态报告内容。数据包由两部分组成,第一部分为数据包整体状态说明(result,desc字段),第二部分为具体外呼状态报告内容。

请求参数:

推送数据格式:
{
    "result":"DH:0000",
    "desc":"成功",
    "data":[{
        "msgid":"99e4d62ca31c4270a920e31d8bf08d20",
        "duration":0,
        "callee":"13056525567",
        "calledtimes":1,
        "status":"DH:0001",
        "desc":"被叫忙【占线或繁忙】",
        "presskeys":"无",
        "reporttime":"2020-09-08 14:17:59",
        "starttime":"2020-09-08 14:17:27",
        "ringingtimelong":"32"
        },{
        "msgid":"ba860dc438cf2c44984ac88e2264a394",
        "duration":123,
        "callee":"19945711234,18601714321",
        "calledtimes":1,
        "status":"DH:0000",
        "desc":"呼叫成功",
        "presskeys":"无",
        "reporttime":"2020-09-08 13:52:57",
        "recordurl":"http://oss-radio.oss-cn-hangzhou.aliyuncs.com/20200908/80fc2fd3411e43cdbe13b417fa2d317e.mp3?Expires\u003d1602136384\u0026OSSAccessKeyId\u003dLTAIWClG7juTTAk5\u0026Signature\u003dN9R32hUji7IKix4u%2FHGSmp%2BsyLU%3D",
        "starttime":"2016-05-11 13:12:11",
        "answertime":"2016-05-11 13:12:11",
        "ringingtimeLong":"10"
        }]
}
参数名 说明
result 请求结果
desc 描述
msgid 消息ID
callee 被叫号码(如果是隐号通话此处为2个号码,以英文逗号分隔,例:A,B)
status 外呼状态码
duration 通话时长。单位为秒
calledtimes 最终实际呼叫总次数。如果没有失败重呼,则值为1,表示只呼叫了一次
presskeys 用户的按键信息,多个按键时用英文逗号隔开
starttime 发起呼叫时间。一般指实际呼叫发起的时间。”yyyy-MM-ddHH:mm:ss”
answertime 通话开始时间。一般指实际通话开始的时间。”yyyy-MM-ddHH:mm:ss”
reporttime 状态报告时间。一般指实际呼叫结束的时间。”yyyy-MM-ddHH:mm:ss”
ringingtimeLong 振铃时长(秒)
recordurl 隐号通话录音文件下载路径,路径有效时间72小时

响应数据格式:

用户处理完上述状态报告数据后,需按情况返回相应响应给大汉平台,响应格式如下:
{
    "status":"success"
}

返回参数说明:

参数名 说明
status 状态报告处理结果。成功时返回success,其他值均认为推送失败,系统会尝试重推
文档更新时间: 2020-10-20 10:11   作者:admin