业务结果回写接口
场景描述
该接口会将业务的结果回写至外呼数据(t_isl_data)及外呼数据结果表(t_isl_data_result)中,用以记录该条外呼数据以及该次外呼的业务结果,如果与业务结果和外呼任务中设置的根据业务结果重呼的策略相匹配,则会进行重呼。
使用说明
- 前提条件
- 有对应的Ak/Sk鉴权权限。
- 外呼活动已经创建,并已添加外呼数据。
- 外呼成功。
- 添加了外呼业务结果。
- 注意事项
- 接收请求后,需服务端返回200的响应,其他响应均认为回写失败;
接口方法
该接口仅支持POST方法。
接口URI
https://ip:port/rest/isales/v1/openapi/campaigns/{vdnId}/callBusiResult/{dataId}
其中,ip为CC-iSales服务器地址,port为CC-iSales服务器的HTTPS端口号。
序号 |
参数名 |
参数类型 |
是否必选 |
说明 |
---|---|---|---|---|
1 |
vdnId |
int |
True |
虚拟呼叫中心ID。 取值的类型为整数,取值范围为1~9999。 |
2 |
dataId |
int |
True |
外呼数据的ID。 |
请求说明
序号 |
名称 |
参数类型 |
是否必选 |
说明 |
---|---|---|---|---|
1 |
Content-Type |
String |
True |
固定填 application/json; charset=UTF-8。 |
2 |
Authorization |
String |
True |
生成方式参见C2 监控/系统外呼/话单/知识库类接口鉴权方式。 |
序号 |
参数名 |
参数类型 |
是否必选 |
说明 |
---|---|---|---|---|
1 |
busiResult |
String |
True |
业务结果编码,最大长度为50个字符。 |
2 |
subStatus |
String |
False |
子业务状态编码,最大长度为50个字符。 |
3 |
busiResultDesc |
String |
False |
业务结果描述。 |
4 |
workNo |
String |
False |
执行呼叫的座席的平台工号。 如果需要同一个外呼数据,始终呼叫到同一个座席,该参数必填,如不填,则会路由至其他座席。 |
响应说明
序号 |
参数名 |
参数类型 |
说明 |
---|---|---|---|
1 |
resultCode |
String |
原因码。0200000表示成功,其他表示失败。 具体见表5。 |
2 |
resultDesc |
String |
描述。 |
触发事件
无
错误结果码
序号 |
错误码 |
说明 |
---|---|---|
1 |
0200001 |
参数异常,异常详情在resultDesc中描述。 |
2 |
0200033 |
外呼数据不存在。 |
3 |
0200034 |
子状态与业务结果不匹配。 |
4 |
0200999 |
业务结果回写失败。 |
5 |
02000001 |
参数值为空 |
6 |
02000002 |
参数包含非法字符 |
7 |
02000003 |
参数长度不能大于规定长度 |
8 |
02000004 |
参数长度不能小于规定长度 |
9 |
02000005 |
参数长度需要介于规定长度之间 |
10 |
02000006 |
参数值类型不正确 |
11 |
02000007 |
参数值大小不正确 |
12 |
02000008 |
参数转换异常,请检查请求参数 |
13 |
02000009 |
参数组合不正确,请检查请求参数 |
14 |
02000010 |
hour和minute必须同时存在 |
15 |
02000011 |
参数个数不能大于规定个数 |
报文样例
- 该接口的请求消息体举例如下:
{ "busiResult": "1621474513", "subStatus": "1048856206", "busiResultDesc": "1", "workNo": "2033" }
- 该接口的响应消息体举例如下:
{ "resultCode": "0200000", "resultDesc": "The business result is written back successfully." }