推送状态报告

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

获取方式：

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

功能:

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

请求参数:

注意！该推送方式:提交为x-www-form-urlencoded,key为voicereport其中value如下
推送数据格式:
{
    "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",
        "params":{"param1":"value1","param2":"value2"}
        },{
        "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 约束 说明
result 必须（String） 请求结果
desc 可选（String） 描述
下列为具体状态报告内容参数（1-200条）：
msgid 必须（String） 消息ID
callid 必须（String） 隐号通话，话单唯一ID
callee 必须（String） 被叫号码（如果是隐号通话此处为2个号码，以英文逗号分隔，例：A,B）
status 必须（String） 外呼状态码；说明请参照：呼叫状态码
duration 可选（String） 通话时长。单位为秒
phoneX 可选（String） 小号号码
phoneXx 可选（String） AXxYB模式下的小号分机号
calltype 可选（String） 呼叫类型： 10：通话主叫 11：通话被叫 12：XYB-短信发送；AXxYB-收号呼叫 13：短信接收 20：呼叫不允许 21: 未开户不允许 30：短信不允许 31：转接短信 126: 双呼
calledtimes 可选（int） 最终实际呼叫总次数。如果没有失败重呼，则值为1，表示只呼叫了一次
releasedir 可选（String） 释放方向: 0 表示平台释放，1 表示主叫释放，2 表示被叫释放
presskeys 可选（String） 用户的按键信息
starttime 可选（String） 发起呼叫时间。一般指实际呼叫发起的时间。"yyyy-MM-ddHH:mm:ss"
answertime 可选（String） 通话开始时间。一般指实际通话开始的时间。"yyyy-MM-ddHH:mm:ss"
reporttime 可选（String） 状态报告时间。一般指实际呼叫结束的时间。"yyyy-MM-ddHH:mm:ss"
ringingtimeLong 可选（int） 振铃时长(秒)
recordurl 可选（String） 隐号通话录音文件下载路径，路径有效时间72小时
params 可选（Map对象） 终端客户自定义参数params（总长度限制为1000）

响应数据格式:

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

返回参数说明:

参数名 说明
status 状态报告处理结果。成功时status的值返回success，其他值均认为推送失败，系统会尝试重推
文档更新时间: 2022-09-28 16:30   作者：夏亮