语音通知话单通知API
接口功能
用户通话结束后，语音通话平台通过此接口向SP推送通话的话单信息。短时间内有多个通话结束时语音通话平台会将话单合并推送，每条消息最多携带50个话单。
请求方向
语音通话平台（客户端） → 客户服务器（服务端）
使用说明
- 前提条件
- SP在开发应用时，若需订阅话单通知，必须要提供话单接收URL（feeUrl），并且确保URL能够正常处理语音通话平台发送的通知信息。
- 提供话单接收URL有以下两种方式：
- 提前通过应用管理向语音通话平台提交话单接收URL。
- SP应用调用场景API时，填写feeUrl参数。
- 注意事项
- 若平台给SP推送话单后未收到成功响应，视为推送失败，会重新推送话单，直至客户返回成功响应。平台最多重推6次，每次时间间隔1小时。
- 单个用户（一路呼叫）的话单通知是根据呼叫状态顺序推送的，一通通话会推送一条话单。但同一个应用下，如果多个用户（多路呼叫）的通话结束时间（callEndTime）相同，话单会合并在一起发送，最多不超过50条。
接口类型
|
请求方法 |
POST |
|---|---|
|
访问URI |
开发者应用接收话单通知的URL |
|
通信协议 |
HTTPS/HTTP |
|
参数名称 |
是否必选 |
参数类型 |
说明 |
|---|---|---|---|
|
Content-Type |
是 |
String |
固定填写为application/json;charset=UTF-8。 |
|
Authorization |
是 |
String |
固定填写为AKSK realm="SDP",profile="UsernameToken",type="Appkey"。 |
|
X-AKSK |
是 |
String |
取值为UsernameToken Username="APP_Key的值", PasswordDigest="PasswordDigest的值", Nonce="随机数", Created="随机数生成时间"。
|
|
编程语言 |
时间格式 |
|---|---|
|
Java |
yyyy-MM-dd'T'HH:mm:ss'Z' |
|
PHP |
Y-m-d\TH:i:s\Z |
|
Python |
%Y-%m-%dT%H:%M:%SZ |
|
C# |
yyyy-MM-ddTHH:mm:ssZ |
|
Node.js |
toISOString().replace(/.[0-9]+\Z/, 'Z') 注：Node.js中，使用toISOString()转换后的时间格式去除毫秒后即为本接口要求的时间格式。 |
|
参数名称 |
是否必选 |
参数类型 |
说明 |
|---|---|---|---|
|
eventType |
是 |
String(枚举) |
该参数标识API事件通知的类型。取值范围如下： |
|
feeLst |
否 |
FeeInfo[1-50] |
呼叫话单事件的信息，参数取值为列表，最大50条。 当eventType参数为fee时携带。 |
FeeInfo
|
参数名称 |
是否必须 |
参数类型 |
描述 |
|---|---|---|---|
|
direction |
是 |
Integer (0-1) |
通话的呼叫方向，以语音通话平台为基准。
|
|
spId |
是 |
String(1-32) |
客户的云服务账号。 |
|
appKey |
是 |
String(1-32) |
应用的app_key。 |
|
icid |
否 |
String(1-64) |
呼叫记录的唯一标识。 |
|
bindNum |
是 |
String(1-32) |
发起此次呼叫的固话号码。 号码仅支持全局号码格式（包含国家码），比如+8675528****02。 |
|
sessionId |
是 |
String(1-256) |
通话链路的唯一标识。 |
|
callerNum |
是 |
String(1-32) |
主叫号码，号码为全局号码格式（包含国家码），比如+86138****0021。 注：callerNum为SP设置的来电显示号码（displayNbr）。 |
|
calleeNum |
是 |
String(1-128) |
被叫号码，号码为全局号码格式（包含国家码），比如+86138****0021。 注：calleeNum为A号码。 |
|
callEndTime |
否 |
String(1-128) |
呼叫结束时间。 该参数为UTC时间（+8小时为北京时间），时间格式为“yyyy-MM-dd HH:mm:ss”。 |
|
fwdUnaswRsn |
否 |
Integer |
转接呼叫操作失败的Q850原因值。详细说明参见附录1-Q850原因值说明。 |
|
failTime |
否 |
String(1-128) |
呼入、呼出的失败时间。 该参数为UTC时间（+8小时为北京时间），时间格式为“yyyy-MM-dd HH:mm:ss”。 |
|
ulFailReason |
否 |
Integer |
通话失败的拆线点。详细说明参见附录2-呼叫拆线点说明。 |
|
sipStatusCode |
否 |
Integer |
呼入、呼出的失败SIP状态码。 |
|
callOutStartTime |
否 |
String(1-128) |
Initcall的呼出开始时间 该参数为UTC时间（+8小时为北京时间），时间格式为“yyyy-MM-dd HH:mm:ss”。 |
|
callOutAlertingTime |
否 |
String(1-128) |
Initcall的呼出振铃时间 该参数为UTC时间（+8小时为北京时间），时间格式为“yyyy-MM-dd HH:mm:ss”。 |
|
callOutAnswerTime |
否 |
String(1-128) |
Initcall的呼出应答时间 该参数为UTC时间（+8小时为北京时间），时间格式为“yyyy-MM-dd HH:mm:ss”。 |
|
callOutUnaswRsn |
否 |
Integer |
Initcall的呼出失败的Q850原因值。 详细说明参见附录1-Q850原因值说明。 |
|
dynIVRStartTime |
否 |
String(1-128) |
自定义动态IVR开始时间。 该参数为UTC时间（+8小时为北京时间），时间格式为“yyyy-MM-dd HH:mm:ss”。 |
|
dynIVRPath |
否 |
String(1-256) |
自定义动态IVR按键路径。 用户每次的按键之间使用“-”链接，形式如下： 0-2-3． |
|
recordFlag |
否 |
Integer (0-1) |
该字段用于录音标识，参数值范围如：
|
|
ttsPlayTimes |
否 |
integer |
应用TTS功能时，使用TTS的总次数。 |
|
ttsTransDuration |
否 |
integer |
应用TTS功能时，TTS Server进行TTS转换的总时长。单位为秒。 |
|
serviceType |
否 |
String(1-32) |
携带呼叫的业务类型信息，取值范围： 001：语音播放 |
|
hostName |
否 |
String(1-128) |
该参数用于标识话单生成的服务器设备对应的主机名。 |
|
userData |
否 |
String(0-256) |
用户附属信息，此参数的值与“语音通知API”中的"userData"参数值一致。 |
响应示例
POST /status HTTP/1.1
Content-Length: xx
{"eventType":"fee","feeLst":[{"direction":0,"spId":"CaaS_Test_01","appKey":"x0GexpPpyRKhbA7ZC7kXBN8uX8vl","icid":"CAE-20190124104846-12028700","bindNum":"+8675528****02","sessionId":"1202_14260_4294967295_20190124024846@callenabler245.huaweicaas.com","callerNum":"+86138****0022","calleeNum":"+86138****0021","callEndTime":"2019-01-24 02:49:23","fwdUnaswRsn":0,"ulFailReason":0,"sipStatusCode":0,"callOutStartTime":"2019-01-24 02:48:46","callOutAlertingTime":"2019-01-24 02:48:51","callOutAnswerTime":"2019-01-24 02:49:12","callOutUnaswRsn":0,"recordFlag":0,"ttsPlayTimes":1,"ttsTransDuration":1,"serviceType":"001","hostName":"callenabler245.huaweicaas.com"}]}
响应参数
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{"resultcode":"0","resultdesc":"Success"}
代码样例
前往代码样例查看。
