云客服-创建双呼呼叫 (V1.0.0) (createCall):请求说明

时间:2024-09-24 14:46:25

请求说明

表1 请求头参数

序号

名称

参数类型

是否必选

说明

1

X-APP-Key

string

False

appKey字段,用户标识

2

Authorization

string

True

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

表2 请求体参数

序号

名称

参数类型

是否必选

说明

1

caller

string

True

主叫号码,客户经理手机号码,或是软电话号码

长度限制:string(32)

2

called

string

True

被叫号码

长度限制:string(32)

3

agentWorkNo

decimal

False

发起双呼的座席的工号。

长度限制:decimal(5)

4

callData

string

False

呼叫数据

长度限制:string(1024)

说明:

ITA双呼不支持callData字段。

5

callerPresent

string

False

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

说明:

ITA双呼不支持callerPresent字段。

6

agentPresent

string

False

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

说明:

ITA双呼不支持agentPresent字段。

7

callBackUrl

string

False

此参数请采用BASE64编码进行加密。

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

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

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

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

回调URL的域名或IP端口已通过系统管理员加入手机客服回调的地址白名单中。

须知:

如果入参callBackUrl不生效,可能是因为您所在的云客服环境接口未正常升级,请联系运管理员确认当前的发布态的API名称是否为createCall_kugui,如果不是,则暂时不能使用callBackUrl入参。

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