云客服-创建语音通知(V1.0.0)(createVoiceNotification):请求说明

时间:2023-11-01 16:19:55

请求说明

表1 请求头参数

序号

名称

参数类型

是否必选

说明

1

X-APP-Key

string

True

appKey字段,用户标识,请联系运营人员获取appKey

2

Authorization

string

True

鉴权字段,内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken(Bearer后有空格)

表2 请求体参数

序号

名称

参数类型

是否必选

说明

1

reqBody

object

True

-

1.1

voiceContent

string

True

总长度限制1000字符。

  • 支持传录音id,录音id以"~"分隔,录音id可以通过/rest/voiceNotification/v1/queryVoiceNotificationRecording接口查询。若您是通过客户服务云界面上传的语音文件,录音id即为IVR语音界面的“语音标识”
  • 支持传纯文本,格式为:$文本$,以"~"相连,例如:"$李先生$~$王先生$"。
  • 支持传录音id与文本混合,格式为:录音id~$文本$~录音id,例如:"1133*********999~$李先生$~2225*********149"。

1.2

callerPresent

string

False

用户侧主叫显示号码,用户看到的主叫号码,不携带的情况下默认采用租间的接入码,携带的情况下该号码必须传接入码。如果需要传非接入码号码,请联系运维人员开通主叫透显特性,该特性开通后号码校验规则为:接入码或者11-14位的数字。

1.3

called

string

True

被叫号码

1.4

callBackUrl

string

False

此参数请采用BASE64编码以UTF_8标准字符集进行编码。

此字段用于设置客户接收状态上报的URL。

云客服CEC平台将业务触发过程中通话的状态信息推送至此服务器,客户服务器根据通话状态信息确定用户状态。

URL可填写为https://IP:Port或域名,推荐使用域名,支持http和https。该域名可以对应多个服务器,避免单点故障无法接收通知。

http有安全风险,不推荐使用。

URL只能由大小写字母(a-z、A-Z),数字(0-9), - : . / _ # ? &组成,不支持其它字符。

1.5

priority

string

False

播放语音通知优先级参数。

取值范围1-9,默认值为9。

数字越小优先级越高。

support.huaweicloud.com/api-ccfs-cec/cec_05_7054.html