# 修改外呼活动（v1） #### 场景描述 调用该接口修改外呼活动的配置。 #### 使用说明 - 前提条件 - 已经申请了开发者账号。 - 已经获取到需要修改的外呼活动的ID。 - 外呼活动任务必须存在并且没有结束。 - 使用限制 - 外呼活动创建后，无法修改设备类型。 #### 接口方法 该接口仅支持PUT方法。 #### 接口URL https://ip:port/rest/isales/v1/openapi/campaigns/{vdnId}/{campaignId} 其中，ip为CC-iSales服务器地址，port为CC-iSales服务器的HTTPS端口号。 表1URL中携带的参数说明 | 序号 | 参数名 | 参数类型 | 是否必选 | 说明 | |:---|:---|:---|:---|:---| | 1 | vdnId | int | True | 虚拟呼叫中心ID。 取值的类型为整数，取值范围为1～9999。 | | 2 | campaignId | int | True | 外呼任务的ID。 | #### 请求说明 表2请求消息头参数 | 序号 | 名称 | 参数类型 | 是否必选 | 说明 | |:---|:---|:---|:---|:---| | 1 | Content-Type | String | True | 固定填 application/json;charset=UTF-8。 | | 2 | Authorization | String | True | 生成方式参见[C2 监控/系统外呼/话单/知识库类接口鉴权方式](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0003.html#ZH-CN_TOPIC_0000002481273406)。 | | 3 | locale | String | False | i18n（internationalization，国际语言代码），如zh_CN表示中文、en_US表示英文等，默认zh_CN。 | 表3请求消息体参数说明 | 序号 | 参数名 | 参数类型 | 是否必选 | 说明 | |:---|:---|:---|:---|:---| | 1 | name | String | True | 外呼活动的名称。 不能与其他外呼活动名称重复。 最大长度为100个字符。 | | 2 | description | String | False | 外呼活动的描述。 最大长度为200字符，不含"\[\]=;\<\>特殊字符。 | | 3 | strBeginTime | String | False | 外呼活动开始时间。 格式为yyyy-MM-dd HH:mm:ss，UTC时间，不能早于今天的零点。 | | 4 | strEndTime | String | False | 外呼活动结束时间。 格式为yyyy-MM-ddHH:mm:ss。UTC时间。 | | 5 | deviceType | int | True | 外呼设备类型。 取值范围： - 1：智能外呼的IVR（SaaS环境下且智能化特性开启时可用 ） - 2：预测外呼的技能队列 - 3：自动外呼的IVR - 5：预览外呼的技能队列 - 6：预占外呼的技能队列 该值不能修改，保持和创建时的值一致。 | | 6 | callerNo | String | True | 主叫号码。 呼通客户后，客户的电话终端上显示的号码。 最大长度为24个字符，有效字符为：0\~9、\*、#。 | | 7 | maxAlertingTime | int | True | - 用户不应答最大振铃时长，超过该时长，则释放呼叫。 - 当外呼方式为预览外呼任务时，该字段表示预览超时时长。取值范围：9\~120，单位为秒。 - 其他外呼默认取值范围：5\~60，单位为秒，可通过修改租户级系统参数修改自动外呼最大应答时长，最大时长取值范围\[30,120\]。系统参数id：6006003000022。 | | 8 | scheduleParam | Object | True | 呼出时间段。 该对象的参数说明请参见[表4]。 | | 9 | ivrParam | Object | False | deviceType为1，3（IVR）时为True。 该对象的参数说明请参见[表5]。 | | 10 | skillParam | Object | False | deviceType为2，5，6（技能队列）时为True。 该对象的参数说明请参见[表6]。 | | 11 | callBackUrl | String | False | 外呼结果的回调通知地址，如果不传，则系统不会对该任务下的数据执行外呼时发起回调。 必须以https://或http://开头。 说明： - HTTP协议是不安全协议，可能会对系统带来风险，不推荐使用。建议使用安全的HTTPS协议。 - 请联系华为运维人员使用系统管理员账号登陆客户服务云，进入"呼叫中心管理\>地址白名单管理"添加白名单，白名单地址类型选择外呼结果推送地址。 | | 12 | dataExpireDuration | int | False | 外呼数据过期时长，默认时长为10天，即10天不进行呼叫，数据机会转移到呼叫完成表中，最大支持365天。历史外呼任务值为365天。 | | 13 | blocklistParam | Object | False | 黑名单相关参数，详情见[表13]。 | | 14 | callRuleParam | Array | False | 设置呼叫规则，详情见[表14]。 | ![](https://support.huaweicloud.com/api-ccfs-cec/public_sys-resources/note_3.0-zh-cn.png) 对于外呼活动开始时间和外呼活动结束时间，接口定义为可选字段，但是必须满足以下规则： 1. 如果传入了其中一个，则另外一个也必须传入； 2. 开始时间不能晚于结束时间； 3. 结束时间不能早于当前时间 表4scheduleParam参数说明 | 序号 | 参数名 | 参数类型 | 是否必选 | 说明 | |:---|:---|:---|:---|:---| | 1 | workdayBeginTime1 | String | False | 工作日呼出时间段1开始时间，格式为HH:mm。使用租户对应的时区时间。 | | 2 | workdayEndTime1 | String | False | 工作日呼出时间段1结束时间，格式为HH:mm。使用租户对应的时区时间。 | | 3 | workdayBeginTime2 | String | False | 工作日呼出时间段2开始时间，格式为HH:mm。使用租户对应的时区时间。 | | 4 | workdayEndTime2 | String | False | 工作日呼出时间段2结束时间，格式为HH:mm。使用租户对应的时区时间。 | | 5 | workdayBeginTime3 | String | False | 工作日呼出时间段3开始时间，格式为HH:mm。使用租户对应的时区时间。 | | 6 | workdayEndTime3 | String | False | 工作日呼出时间段3结束时间，格式为HH:mm。使用租户对应的时区时间。 | | 7 | holidayIdList | Array\ | False | 特殊日期id列表， 如果有此值，则不需要调用[新增外呼活动的特殊日期](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0739.html#ZH-CN_TOPIC_0000002481113884)接口，可以直接设置特殊日期列表。 如果不传入此参数只传入holidayBeginTime、holidayEndTime参数则需要调用[新增外呼活动的特殊日期](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0739.html#ZH-CN_TOPIC_0000002481113884)接口新增特殊日期。 | | 8 | holidayBeginTime1 | String | False | 特殊日期呼出时间段1开始时间，格式为HH:mm。使用租户对应的时区时间。 | | 9 | holidayEndTime1 | String | False | 特殊日期呼出时间段1结束时间，格式为HH:mm。使用租户对应的时区时间。 | | 10 | holidayBeginTime2 | String | False | 特殊日期呼出时间段2开始时间，格式为HH:mm。使用租户对应的时区时间。 | | 11 | holidayEndTime2 | String | False | 特殊日期呼出时间段2结束时间，格式为HH:mm。使用租户对应的时区时间。 | | 12 | holidayBeginTime3 | String | False | 特殊日期呼出时间段3开始时间，格式为HH:mm。使用租户对应的时区时间。 | | 13 | holidayEndTime3 | String | False | 特殊日期呼出时间段3结束时间，格式为HH:mm。使用租户对应的时区时间。 | | 14 | specialHolidayList | List | False | 按每个特殊日期设置不同的呼叫时间段列表，一个活动最大支持20个特殊日期。详情见[表15](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0721.html#ZH-CN_TOPIC_0000002513073741__zh-cn_topic_0000002478109824_table129218408593)。 | ![](https://support.huaweicloud.com/api-ccfs-cec/public_sys-resources/note_3.0-zh-cn.png) 1. 工作日呼出时间段1、呼出时间段2、呼出时间段3不能全为空； 2. 开始时间和结束时间需要同时为空或者同时不为空； 3. 时间范围不能重叠冲突。例如 "scheduleParam": { "workdayBeginTime1": "08:00", "workdayEndTime1": "11:30", "workdayBeginTime2": "13:30", "workdayEndTime2": "17:30", "workdayBeginTime3": "19:30", "workdayEndTime3": "24：00", "holidayBeginTime1": "24:00", "holidayEndTime1": "08:00", "holidayBeginTime2": "11:30", "holidayEndTime2": "13:30", "holidayBeginTime3": "17:30", "holidayEndTime3": "19:30" } 4. 开始时间需要小于结束时间； 5. 如果需要删除时间，将目标时间参数值置空即可。 6. 除非指明某天或者周几是特殊日期，否则都按工作日外呼； 7. **当配置特殊日期时间段后，若为了兼容AICC-isales页面，则后续必须调用（[新增外呼活动的特殊日期](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0739.html#ZH-CN_TOPIC_0000002481113884)）接口，指明外呼活动与特殊日期关系** ；**否则会出现接口与页面的不兼容** 表5ivrParam参数说明 | 序号 | 参数名 | 参数类型 | 是否必选 | 说明 | |:---|:---|:---|:---|:---| | 9.1 | deviceSign | String | True | deviceType=1时，传入智能IVR的主流程编码（oifde-flowcode）。该主流程编码可通过租户管理员登录AICC前台，在"配置中心 \> 机器人管理\>流程配置 \> 流程管理 \> 流程编排"查看。 deviceType=3时，传入普通IVR的机器人接入码或者智能IVR的机器人接入码。 普通IVR的机器人接入码可通过租户管理员登录AICC前台，在"配置中心 \> 机器人管理\>流程配置\>普通IVR"查看。 智能IVR的机器人接入码可通过租户管理员登录AICC前台，在"配置中心\>机器人管理\> \> 流程配置 \> 智能 \> 机器人"查看。 | | 9.2 | callCount | int | True | 外呼任务每次呼出的数量。 取值范围：1\~100。 | | 9.3 | callInterval | int | True | 外呼任务的呼出间隔时间。 取值范围：1\~9999，单位秒。 | ![](https://support.huaweicloud.com/api-ccfs-cec/public_sys-resources/note_3.0-zh-cn.png) 例如某外呼任务需要达到1分钟呼出60个呼叫的需求，建议配置成callInterval＝3，callCount＝3。 外呼后使用设备为IVR，外呼数量计算为 (callCount/callInterval)\*3取整（大于1时才会呼出）；呼出间隔大于3时以3秒周期检测计算，小于3时以实际设置检测计算。 表6skillParam参数说明 | 序号 | 参数名 | 参数类型 | 是否必选 | 说明 | |:---|:---|:---|:---|:---| | 10.1 | skillId | int | True | 技能队列的ID。 取值范围：1\~1000。 | | 10.2 | skillName | String | False | 技能队列的名称。 - 最大长度100。 - 不允许填写特殊字符\~!@#$%\&\*()/=+{};:'",\<.\>?\\\[\\\]\^ | | 10.3 | outBoundType | int | True | 呼出方式， 取值范围： - 2：预测外呼 - 5：预览外呼 - 6：预占外呼 | | 10.4 | predictParam | Object | False | outBoundType为2时为True，预测呼出时的参数配置。 该对象的参数说明请参见[表8]。 | | 10.5 | previewParam | Object | False | outBoundType为5时为True，预览呼出时的参数配置。 该对象的参数说明请参见[表7]。 | 表7previewParam参数说明 | 序号 | 参数名 | 参数类型 | 是否必选 | 说明 | |:---|:---|:---|:---|:---| | 1 | failInterval | int | True | 呼出间隔时间，取值范围：3\~60，单位秒。 | | 2 | obCallCount | int | True | 每次呼出数量，取值范围：1\~100。 | | 3 | autoCallTime | int | True | 预览自动呼叫时长，最小值为5，最大值为maxAlertingTime-3，单位秒。 | | 4 | skipMode | Array\ | False | 跳过模式： 0：不允许跳过。 1：临时跳过（只跳过本次呼叫，如果任务设置了重试策略，到重试时间地点之后会再次呼叫）。 2：永久跳过（无论任务是否设置了重试，永久跳过后不会再呼叫此客户），此参数可设置为不允许跳过，不传值时系统默认为不允许跳过，如果允许跳过，可设置两种跳过方式，临时跳过或永久跳过。 | 表8predictParam参数说明 | 序号 | 参数名 | 参数类型 | 是否必选 | 说明 | |:---|:---|:---|:---|:---| | 10.4.1 | predictMethod | int | True | 预测外呼算法。 取值范围： 1：经验预测算法 2：座席利用率预测算法 3：外呼接通率预测算法 5：摘机率预测算法 | | 10.4.2 | expPredictParam | Object | False | 经验预测算法的参数配置，predictMethod为1（经验预测算法）时，为True。 该对象的参数说明请参见[表9]。 | | 10.4.3 | agentPredictParam | Object | False | 座席利用率预测算法的参数配置，predictMethod为2（座席利用率预测算法）时，为True。 该对象的参数说明请参见[表10]。 | | 10.4.4 | connectPredictParam | Object | False | 外呼接通率预测算法的参数配置，predictMethod为3（外呼接通率预测算法）时，为True。 该对象的参数说明请参见[表11]。 | | 10.4.5 | offhookPredictParam | Object | False | 摘机率预测算法的参数配置，predictMethod为5（摘机率预测算法）时，为True。 该对象的参数说明请参见[表12]。 | 表9expPredictParam参数说明 | 序号 | 参数名 | 参数类型 | 是否必选 | 说明 | |:---|:---|:---|:---|:---| | 10.4.2.1 | maxAvgCallTime | int | True | 最大平均通话时长，正整数，单位秒。取值范围：50-200。 | | 10.4.2.2 | minAvgCallTime | int | True | 最小平均通话时长，正整数，单位秒。取值范围：10-200。必须小于等于maxAvgCallTime。 | | 10.4.2.3 | outBoundRate | int | True | 呼出速率。 取值范围：0\~100。缺省值70。 | 表10agentPredictParam参数说明 | 序号 | 参数名 | 参数类型 | 是否必选 | 说明 | |:---|:---|:---|:---|:---| | 10.4.3.1 | maxAvgCallTime | int | True | 最大平均通话时长，正整数，单位秒。取值范围：50-200。 | | 10.4.3.2 | minAvgCallTime | int | True | 最小平均通话时长，正整数，单位秒。取值范围：10-200。必须小于等于maxAvgCallTime。 | | 10.4.3.3 | lossRate | int | False | 最低呼损率。 取值范围：0\~100。缺省值3。 | | 10.4.3.4 | utilRate | int | False | 座席利用率。 取值范围：0\~100。缺省值70。 | | 10.4.3.5 | utilRateMethod | int | True | 座席利用率算法。 取值范围： 1：表示座席利用率＝总的通话时长/总的签入时长 2：表示座席利用率＝(总的通话时长＋工作态时长)/总的签入时长 | 表11connectPredictParam参数说明 | 序号 | 参数名 | 参数类型 | 是否必选 | 说明 | |:---|:---|:---|:---|:---| | 10.4.4.1 | maxAvgCallTime | int | True | 最大平均通话时长，正整数，单位秒。取值范围：50-200。 | | 10.4.4.2 | minAvgCallTime | int | True | 最小平均通话时长，正整数，单位秒。取值范围：10-200。必须小于等于maxAvgCallTime。 | | 10.4.4.3 | lossRate | int | False | 最低呼损率。 取值范围：0\~100。缺省值3。 | | 10.4.4.4 | waitTime | int | False | 用户等待时间。 取值范围：0\~16，单位秒。缺省值5。 | | 10.4.4.5 | connRate | int | True | 外呼接通率。 取值范围：0\~100。 | 表12offhookPredictParam参数说明 | 序号 | 参数名 | 参数类型 | 是否必选 | 说明 | |:---|:---|:---|:---|:---| | 10.4.5.1 | offHookRate | int | True | 计算因子。 取值范围：50\~200。缺省值100。 | 表13blocklistParam参数说明 | 序号 | 参数名 | 参数类型 | 是否必选 | 说明 | |:---|:---|:---|:---|:---| | 1 | useTenantBlocklist | boolean | False | 是否启用租户级黑名单校验，不传值时默认为true | | 2 | useOrgBlocklist | boolean | False | 是否启用组织级黑名单校验，不传值时默认为true，当组织隔离开启时生效 | | 3 | blocklistGroup | List\ | False | 黑名单分组列表 | 表14callRuleParam参数说明 | 序号 | 参数名 | 参数类型 | 是否必选 | 说明 | |:---|:---|:---|:---|:---| | 5.1 | id | String | False | - 外呼规则ID，如果未填写，则默认为租户级异常呼叫规则。 - 不支持手动外呼、人工分配外呼。 | #### 响应说明 表15消息体参数说明 | 序号 | 参数名 | 参数类型 | 说明 | |:---|:---|:---|:---| | 1 | resultCode | String | 原因码。0200000表示成功，其他表示失败。 具体见[表16] | | 2 | resultDesc | String | 描述。 | | 3 | returnCode | String | 原因码。0200000表示成功，其他表示失败。 具体见[表16] | | 4 | returnDesc | String | 描述。 | #### 触发事件 无 #### 错误结果码 表16错误原因码说明 | 序号 | 错误码 | 说明 | |:---|:---|:---| | 1 | 0200001 | 参数异常，异常详情在resultDesc中描述。 | | 2 | 0200002 | 外呼活动的开始时间早于今天凌晨。 | | 3 | 0200005 | 外呼活动名称不能重复。 | | 4 | 0200007 | 外呼活动已经不存在。 | | 5 | 0200016 | 外呼活动已经结束。 | | 6 | 0200017 | 技能队列ID不存在。 | | 7 | 02000001 | 参数值为空 | | 8 | 02000002 | 参数包含非法字符 | | 9 | 02000003 | 参数长度不能大于规定长度 | | 10 | 02000004 | 参数长度不能小于规定长度 | | 11 | 02000005 | 参数长度需要介于规定长度之间 | | 12 | 02000006 | 参数值类型不正确 | | 13 | 02000007 | 参数值大小不正确 | | 14 | 02000008 | 参数转换异常，请检查请求参数 | | 15 | 02000009 | 参数组合不正确，请检查请求参数 | | 16 | 02000010 | hour和minute必须同时存在 | | 17 | 02000011 | 参数个数不能大于规定个数 | | 18 | 0200012 | callBackUrl不在白名单 | #### 报文样例 - 该接口的请求消息体举例如下： ``` { "name": "十一流量包推荐", "description": "十一流量包推荐", "strBeginTime": "2020-09-10 00:00:00", "strEndTime": "2020-10-07 23:59:59", "deviceType": 2, "callerNo": "10085", "maxAlertingTime": 20, "scheduleParam": { "workdayBeginTime1": "08:00", "workdayEndTime1": "11:30", "workdayBeginTime2": "13:00", "workdayEndTime2": "17:30", "workdayBeginTime3": "", "workdayEndTime3": "", "holidayBeginTime1": "10:00", "holidayEndTime1": "11:00", "holidayBeginTime2": "13:00", "holidayEndTime2": "17:30", "holidayBeginTime3": "", "holidayEndTime3": "" }, "skillParam": { "skillId": 5, "skillName": "Voice Skill Queue", "outBoundType": 2, "predictParam": { "predictMethod": 5, "offhookPredictParam": { "offHookRate": 100 } } }, "blocklistParam": { "useTenantBlocklist": true, "useOrgBlocklist": true, "blocklistGroup": ["1320422159"] } "callBackUrl": "https://10.10.10.10/xxx/xxx/xxx" } ``` - 该接口的响应消息体举例如下： ``` { "resultCode": "0200000", "resultDesc": "", "returnCode": "0200000", "returnDesc": "" } ```