云客服-创建双呼呼叫 (V1.0.0) (createCall):请求说明
请求说明
序号 |
名称 |
参数类型 |
是否必选 |
说明 |
---|---|---|---|---|
1 |
X-APP-Key |
string |
False |
appKey字段,用户标识 |
2 |
Authorization |
string |
True |
鉴权字段,内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken(Bearer后有空格) |
序号 |
名称 |
参数类型 |
是否必选 |
说明 |
---|---|---|---|---|
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入参。 |