新增外呼活动的特殊日期
前置条件
- 已经申请了开发者账号。
- 已经获取到需要的外呼活动的ID。
- 外呼活动已创建的特殊日期数目小于20个。
场景描述
调用该接口为指定外呼活动新增特殊日期。
接口方法
该接口仅支持POST方法。
接口URI
https://ip:port/rest/isales/v1/openapi/campaigns/{vdnId}/holiday/{campaignId}
其中，ip为CC-iSales服务器地址，port为CC-iSales服务器的HTTPS端口号。
|
序号 |
参数名 |
参数类型 |
是否必选 |
说明 |
|---|---|---|---|---|
|
1 |
vdnId |
int |
True |
虚拟呼叫中心ID。 取值的类型为整数，取值范围为1～9999。 |
|
2 |
campaignId |
int |
True |
外呼活动的ID。 |
请求说明
|
序号 |
名称 |
参数类型 |
是否必选 |
说明 |
|---|---|---|---|---|
|
1 |
Content-Type |
String |
True |
固定填 application/json; charset=UTF-8。 |
|
2 |
Authorization |
String |
True |
生成方式参见C2 监控/系统外呼/话单/知识库类接口鉴权方式。 |
|
序号 |
参数名 |
参数类型 |
是否必选 |
说明 |
|---|---|---|---|---|
|
1 |
name |
String |
True |
特殊日期名称。 名称不能重复，最大长度为30个字符。 |
|
2 |
type |
int |
True |
特殊日期的类型。 取值范围： 1：按周设置 2：按日期设置 3：按日期重复 |
|
3 |
week |
String |
False |
星期，特殊日期的类型为按周设置时为True。 取值范围： 1：星期一 2：星期二 3：星期三 4：星期四 5：星期五 6：星期六 7：星期天 同时选择多天时以逗号分隔，例如“6,7”表示星期六、星期天 |
|
4 |
beginTime |
String |
False |
开始时间，特殊日期的类型为按日期设置或按日期重复时为True。
|
|
5 |
endTime |
String |
False |
结束时间，特殊日期的类型为按日期设置或按日期重复时为True。
|
响应说明
触发事件
无
错误结果码
|
序号 |
错误码 |
说明 |
|---|---|---|
|
1 |
0200001 |
参数异常，异常详情在resultDesc中描述。 |
|
2 |
0200007 |
外呼活动不存在。 |
|
3 |
0200013 |
特殊日期名称已存在。 |
|
4 |
0200015 |
外呼活动的特殊日期数量已达上限。 |
|
5 |
0200030 |
时间格式不正确。 |
|
6 |
02000001 |
参数值为空 |
|
7 |
02000002 |
参数包含非法字符 |
|
8 |
02000003 |
参数长度不能大于规定长度 |
|
9 |
02000004 |
参数长度不能小于规定长度 |
|
10 |
02000005 |
参数长度需要介于规定长度之间 |
|
11 |
02000006 |
参数值类型不正确 |
|
12 |
02000007 |
参数值大小不正确 |
|
13 |
02000008 |
参数转换异常，请检查请求参数 |
|
14 |
02000009 |
参数组合不正确，请检查请求参数 |
|
15 |
02000010 |
hour和minute必须同时存在 |
|
16 |
02000011 |
参数个数不能大于规定个数 |
报文样例
- 该接口的请求消息体举例如下：
{ "name": "中秋节", "type": 2, "week": null, "beginTime": "2018-09-22", "endTime": "2018-09-24" } - 该接口的响应消息体举例如下：
{ "resultCode": "0200000", "resultDesc": "", "returnCode": "0200000", "returnDesc": "", "returnObject": { "id": 1318795089 } }
