创建双呼呼叫 (V3.0.0) (createCall)
场景描述
创建双呼呼叫。
双呼呼叫接口支持云客服系统的双呼呼叫和ITA双呼呼叫，具体是哪种双呼呼叫由租户管理员登录客户服务云系统前台界面，进入，进行选择。
接口方法
POST
接口URI
https://域名/apiaccess/CC-Management/v3/mobileAgent/createCall，例如域名是service.besclouds.com
请求说明
序号 |
名称 |
参数类型 |
是否必选 |
说明 |
|---|---|---|---|---|
1 |
X-APP-Key |
string |
False |
appKey字段，用户标识 |
2 |
Authorization |
string |
True |
鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） |
序号 |
名称 |
参数类型 |
是否必选 |
说明 |
|---|---|---|---|---|
1.1 |
caller |
string |
False |
主叫号码，客户经理手机号码，或是软电话号码 长度限制：string（32） |
1.2 |
softPhone |
string |
True |
软电话号码（座席对应） 长度限制：string（32） |
1.3 |
called |
string |
True |
被叫号码 长度限制：string（32） |
1.4 |
callData |
string |
False |
呼叫数据 长度限制：string（1024）
说明：
ITA双呼不支持callData字段。 |
1.5 |
callerPresent |
string |
False |
用户侧主叫显示号码，用户看到的主叫号码，不携带的情况下默认采用租间的接入码，携带的情况下该号码必须传接入码。如果需要传非接入码号码，请联系运维人员开通主叫透显特性，该特性开通后号码校验规则为：接入码或者11-14位的数字。
说明：
ITA双呼不支持callerPresent字段。 |
响应说明
- 响应状态码: 200
序号 |
名称 |
参数类型 |
是否必选 |
说明 |
|---|---|---|---|---|
1.1 |
retCode |
string |
False |
0：成功，其他为失败 1 ：添加外呼任务失败，外呼数据库中可能已存在相同外呼任务 2 ：呼叫数据信息 3 ：未查询出呼叫流水号字段 5 ：主被叫或外显号码格式不符 6 ：VDN不可用 8 ：主叫号码不在租户所分配的移动座席使用的软电话号码范围内 16 ：试用租户的座席侧号码未在白名单内 21 ：试用租户一键双呼超过每天10次限制 针对ITA双呼还有一些retCode，请参见表4 |
1.2 |
retMsg |
string |
False |
失败原因的描述 |
1.3 |
result |
object |
False |
返回结果 |
1.3.1 |
callSerialNo |
string |
False |
呼叫流水号 |
retcode |
retMsg |
说明 |
|---|---|---|
90100100 |
Invalid Input Parameter |
请求报文不正确。如缺少参数或者不支持的参数 |
90100200 |
Auth Failed |
请求的来源或者请求的签名未通过校验 |
90100300 |
Bad Request |
错误请求 |
90100400 |
Not found |
请求资源不存在 |
90100600 |
Internal Server Error |
系统内部错误 |
90102001 |
Insufficient Balance |
额度不足 |
90102002 |
Request Restriction |
请求限制 |
90104001 |
Insufficient Permission |
权限不足 |
90104003 |
Request Forbidden |
请求被禁止 |
90104004 |
Service Unavailable |
不支持的业务功能或者未实现 |
90104008 |
Service Process Failure |
业务处理超时或者处理失败 |
90104029 |
Too Many Requests |
请求过多 |
90106001 |
Binding relationship already exists |
小号绑定关系已存在 |
90106002 |
Binding relationship not exists |
小号绑定关系不存在 |
90106003 |
Insufficient Number resources |
小号号码池资源不足 |
90106004 |
No corresponding number found |
未找到可用小号 |
90106005 |
Inconsistent binding data |
小号绑定数据不一致 |
90106006 |
Other Error |
小号其他原因导致错误 |
90106010 |
Policy Forbid |
策略禁止 |
90106011 |
Caller Forbid |
主叫限制 |
90106012 |
Callee forbid |
被叫限制 |
- 响应状态码: 400
错误的请求：请检查请求路径及参数。
- 响应状态码: 401
未授权：1.请确认是否购买了相关服务。2.请联系客服人员检查您账号的当前状态。
- 响应状态码: 404
请求的内容未找到：请检查请求的路径。
- 响应状态码: 500
业务失败：请依次确认您请求中各参数的取值。
错误码
无。
报文样例
请求头:
x-app-key:9******************************3 Authorization:Bearer 9******************************7 Content-Type:application/json
{
"caller": 8888888,
"softPhone": 66666666,
"called": 6666614
}
响应参数:
{
"retMsg": "Called is not configured",
"retCode": "5"
}
