语音通知话单通知API

Content-Type

是

String

参数解释：

消息体的类型（格式）。

约束限制：

不涉及。

取值范围：

固定填写为application/json;charset=UTF-8。

默认取值：

不涉及。

Authorization

是

String

固定填写为AKSK realm="SDP",profile="UsernameToken",type="Appkey"。

X-AKSK

是

String

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(枚举)

参数解释：

通知的事件类型。

约束限制：

不涉及。

取值范围：

fee：话单事件

默认取值：

不涉及。

feeLst

否

FeeInfo[1-50]

呼叫话单事件的信息，参数取值为列表，最大50条。

当eventType参数为fee时携带。

direction

是

Integer (0-1)

通话的呼叫方向，以语音通话平台为基准。

• 0：外呼
• 1：回呼

spId

是

String(1-32)

客户的云服务账号。

appKey

是

String(1-32)

参数解释：

语音通话应用的appKey。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

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)

该字段用于录音标识，参数值范围如：

• 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"参数值一致。