话单回调
xunzhong.cdrCallback
此接口为发送话单回调消息。将充值结果异步发送到用户在平台所创建应用的启用回调地址,未启用则视为不接收回调信息。
请求类型:POST 请求流用UTF-8解析。
请求参数:
语音通知/语音通知任务参数
功能 | 参数名称 | 描述 |
语音通知 | requestid | 当前话单编号,唯一标识 |
appid | 所属应用的id | |
fid | 功能id,语音通知fid为8 | |
tel | 电话号码 | |
stime | 开始接听时间 | |
etime | 结束接听时间 | |
duration | 通话时长(单位:秒) | |
oriamount | 费用(单位:元) | |
stateDesc | 通话结果识别 |
双向呼叫参数
功能 | 参数名称 | 描述 |
双向呼叫 | requestid | 当前话单编号,唯一标识 |
appid | 所属应用的id | |
fid | 功能id,双向呼叫fid为4 | |
caller | 主叫号码 | |
called | 被叫号码 | |
callerstime | 主叫接听时间 | |
calleretime | 主叫挂机时间 | |
calledstime | 被叫接听时间 | |
calledetime | 被叫挂机时间 | |
tapesurl | 录音文件下载地址(http://...111.mp3) (非正常通话或没开通录音返NoTapes) | |
duration | 通话时长(单位:秒) | |
oriamount | 费用(单位:元) | |
stateDesc | 通话结果识别 | |
customParm | 用户自定义参数(可以为用户传给平台的订单编号) |
stateDesc结果识别类型
类型名称 |
正常 |
正在处理中 |
振铃 |
未应答 |
应答 |
关机 |
空号 |
停机 |
正在通话中 |
用户拒接 |
无法拨通 |
暂停服务 |
用户正忙 |
双向呼叫
(状态推送)
功能 | 参数名称 | 描述 |
状态推送 | requestid | 当前话单编号,唯一标识 |
src | 主叫 | |
dst | 被叫 | |
timestamp | 状态时间 | |
state | 状态(callout:呼出, alerting:振铃,answer:接听, disconnect:结束) |
语音通知
(按键推送)
功能 | 参数名称 | 描述 |
推送按键回调 | requestid | 当前话单编号,唯一标识 |
dst | 接收语音通知的手机号 | |
dstclid | 被叫收到的来显号码 | |
presskey | 按键 |
电话会议参数
功能 | 参数名称 | 描述 |
电话会议 | requestid | 当前话单编号,唯一标识 |
appid | 所属应用的id | |
fid | 功能id,电话会议fid为5 | |
tel | 参与会议的电话号码 | |
stime | 开始接听时间 | |
etime | 结束接听时间 | |
confid | 当前会议编号 | |
duration | 费用(单位:元 | |
customParm | 用户自定义参数(可以为用户传给平台的订单编号) | |
tapesurl | 录音文件下载地址(http://...111.mp3) (非正常通话或没开通录音返NoTapes) |
响应参数:
名称 | 类型 | 示例值 | 描述 |
statusCode | string | 0 | 发送结果错误码 |
statusMsg | string | 提交成功 | 发送结果状态描述 |
requestId | string | 2016010000000219 | 为验证码发送成功后返回的requestId唯一标识 |
报文示例:
JSON提示:
1 | HTTP/1.1 200 OK |
语音通知 |
{"cdr":[{"requestid":"2016010000000205", "appid":"ff8080813fc70a7b013fc72312324213","fid":"8","tel":"2016010000000213"," stime":"2016-02-02 11:19:36.000","etime":"2016-02-02 11:19:58.000", "duration":"10","oriamount":"0.06","stateDesc":""}]} |
双向呼叫 |
{"cdr":[{"requestid":"2016010000000206","appid":"ff8080813fc70a7b013fc72312324213", "fid":"4","caller":"13810603954","called":"18810207016", "callerstime":"2016-02-02 11:19:36.000","calleretime":"2016-02-02 11:20:36.000", "calledstime":"2016-02-02 11:19:40.000","calledetime":"2016-02-0211:20:40.000", "tapesurl":"http://.....", "duration":"60","oriamount":"2.94","customParm":"123456",stateDesc ":"应答|正常"}]} |
电话会议 |
{"cdr":[{"requestid":"2016010000000207","appid":"ff8080813fc70a7b013fc72312324213", "fid":"5","tel":"15801445465","stime":"2016-03-14 10:43:42.000", "etime":"2016-03-14 10:44:13.000","confid":"516152","duration":"31", "singleoriamount":"0.044","customParm":"123456","tapesurl":"http://....."}]} |