CloudCreateTask - 新增呼叫任务

呼叫中心 id。

任务名称；需进行 UTF-8 格式的 URLEncode 编码，长度小于 50 字

任务描述；需进行 UTF-8 格式的 URLEncode 编码，长度小于 200 字

外呼任务创建后任务类型不支持修改。

• 1：预测外呼任务。

• 2：自动外呼任务。

任务模板名称。

1. 通过任务模板可以实现对任务参数的统一管理以及简化接口传参，多个任务可以使用同一个模板管理参数，接口只需要传入任务间有差异的参数。

2. 参数生效规则：接口传入的参数优先。

3. 示例说明：如果接口传了参数 autoStart=1 和参数 templateName=testTemplate，接口传入的参数 autoStart 生效。如果接口未传入 autoStart 参数或者传入的 autoStart 参数是空值，那么模版中的参数生效。

定时开始，默认关闭。

• 0：关闭

• 1：开启

定时开始日期；autoStart=1 时生效。参数不传入时默认在当天的 autoStartTime 定时启动。格式：yyyy-MM-dd，如：2017-01-01

定时开始时间；autoStart=1 时生效。参数不传入时默认在 autoStartDay 的 00:00:00 定时启动。格式：HH:mm:ss，如：08:00:00

定时完成，默认关闭。

• 0：关闭；

• 1：开启

定时完成日期；autoStop=1 时生效。参数不传入时默认在当天的 autoStopTime 定时完成。格式：yyyy-MM-dd，如：2017-01-01

定时完成时间；autoStop=1 时生效。参数不传入时默认在 autoStopDay 的 23:59:59 定时完成。格式：HH:mm:ss，如：17:00:00

定时完成时强制结束任务；autoStop=1 时生效。0.关闭 1.开启，默认关闭。开启配置后，当任务到定时完成时间时无论任务中的号码是否已经呼完，均将任务状态设置为结束。适用于对数据有呼叫时间限制的场景。注：任务在结束状态时无法再次启动。

配合定时开始（autoStart）和定时结束（autoStop）参数使用，如任务需要在每天的特定时间段内呼叫则开启间隔呼叫方式。默认连续呼叫。

• 0：连续呼叫

• 1：间隔呼叫

间隔呼叫时间段；autoTaskType=1 时必填。呼叫的时间段配置。参数格式：时间条件编号。支持多个，多个使用英文","逗号隔开，如：9,22。

默认开启。

• 1：开启；任务中的号码呼叫完后，任务自动完成，状态设置为结束。

• 0：关闭；任务中的号码呼叫完后，任务自动暂停，状态设置为暂停。

重试策略；

1. 【基础模式】：

   • 数据结构为 Json 格式：{"retry":2,"strategy":[{"round":1,"time":"1-1-1"},{"round":2,"time":"2-2-2"}]}

   • 格式说明：retry 是重试次数，round 是第几次重试，time 是第几次重试间隔的时间：1-1-1，第一个 1 是天，第二个 1 是小时，第三个 1 是分钟。

2. 【高级模式】：

   • 高级模式需要开启「号码状态识别」服务数据结构 JsonArray 格式 ：[{"condition":{"sipCause":[710,719]},"retry":1,"sort":1,"strategy":[{"round":1,"time":"0-0-10"}]},{"condition":{"sipCause":[800]},"retry":1,"sort":2,"strategy":[{"round":2,"time":"0-0-10"}]}]

   • 格式说明：condition 是重试条件，sort 是重试条件的顺序，其余字段与基础模式一致。

重试策略时间类型；配置重试策略时生效。

• 1：基于首次呼叫时间

• 2：基于上次呼叫时间，默认基于首次呼叫时间。

任务仅当天生效；

• 0：关闭

• 1：开启，删除待重试的数据和待呼叫的数据

• 2：开启，删除待重试的数据

• 3：开启，删除待呼叫的数据，默认关闭

• 数据结构为 Json 格式{"strategy":[{"sort":1,"type":"retryCall", "desc":0},{"sort":2,"type":"firstCall","orderType":0}]}

• 格式说明：

  • sort：是重试号码和未呼叫号码的呼叫顺序；

  • type：retryCall 重试号码、firstCall 未呼叫号码当 type=retryCall；

  • desc：

    • 0 优先呼叫待重呼轮次数值较小的号码，即轮次靠前（如第 1 轮、第 2 轮）的号码先被呼叫；

    • 1 优先呼叫待重呼轮次数值较大的号码，即轮次靠后（如第 5 轮、第 4 轮）的号码先被呼叫当 type=firstCall 时，orderType：随机呼叫，0 顺序(优先级) ；1 随机；2 顺序(导入时间)。

客户侧外显号码类型；

• 1：外显固话

• 2：外显手机号

• 4：外显号码池

• 5：外显导航

客户侧外显号码列表；customerClidsCategory=1 或 2 时必填。支持多个，多个直接使用英文逗号','分隔。不建议使用

客户侧外显规则；customerClidsCategory=1 或 2 时生效。默认随机。不建议使用

• 1：随机

• 2：按区号

外显规则；customerClidType=2 时生效。Json 格式，外显号码选择规则：默认区号，是否匹配省会等；如：{"defaultAreaCode":"010", "isMatchCapital":"1"}。不建议使用

外显号码比例配置开关；customerClidsCategory=1 时生效。默认关闭。不建议使用。

• 0：关闭

• 1：开启

外显号码比例配置内容；customerClidsCategory=1 且 customerClidWeightFlag=1 时生效。JsonArray 格式 [{"number":"123,345","weight":"5"}, {"number":"567,789","weight":"5"}]，不建议使用

客户侧外显号码池名称或外显导航标识；customerClidsCategory=4 或 5 时必填。customerClidsCategory=4 时 customerClidsGroup 传号码池名称。customerClidsCategory=5 时 customerClidsGroup 传外显导航标识

客户超时时间；单位秒数，默认 30 秒，取值范围 5 ~ 60

• 1：直连座席。直连座席模式：客户接听后直接分配座席，无空闲座席可溢出语音导航（需配置语音导航），保障高优先级客户直连体验。

• 2：AI 转人工。AI 转人工模式：客户接入后，优先进入语音导航中配置的智能体机器人，按交互结果决定是否转接座席，提升自动化覆盖率，降低人工成本。

语音导航 Id；参数 ivrId 和 ivrName 二选一，同时传入时 ivrId 生效，在创建自动外呼任务时 ivrId 或 ivrName 必选其一。预测外呼使用场景：如果客户接听后未在特定时间内（默认 2 秒）找到可用座席，通话将溢出到语音导航继续排队找座席。同时支持在呼转座席，座席未接听时也溢出到语音导航，需要开启企业配置生效自动外呼使用场景：客户接听后，转到的语音导航

语音导航名称；参数 ivrId 和 ivrName 二选一，同时传入时 ivrId 生效，在创建自动外呼任务时 ivrId 或 ivrName 必选其一。

任务维度限制最大并发数，实际并发不会超过最大并发限制。type=1 时，配置成 0 表示不限制，座席数量少于 10 时建议配置该参数

任务自定义字段。JsonArray 格式；数组的每个元素只支持传递一组键值对，传递多组只取第一组，如 {"key", "value"}。 默认空值，示例：[{"name":"1234"},{"name1":"12345"}] 注：单个字段值的长度不能超过 1000 个字符

座席通道变量。JsonArray 格式；最大支持 5 个变量。默认空值， 示例：[{"name":"abcdefg","value":"${cdr_enterprise_id}"}] 注：单个字段值的长度不能超过 1000 个字符。变量会以 SIP_HEADER 的形式设置到座席侧通道

禁呼时间；在特定的时间段内禁止呼叫。参数格式：时间条件编号。支持多个，多个使用英文","逗号隔开，如：9,22。注：时间条件列表可通过查询时间条件设置列表接口获取

任务数超出最大任务数限制时，是否自动删除已完成的最早创建的任务，值为 1 代表自动删除。注：autoDelete 不是任务属性，只在接口调用时生效

• 0：关闭

• 1：自动删除

指定座席方式；

• 1：座席工号列表

• 2：外呼组，默认座席工号列表

座席工号列表；callGroupType=1 时必填。支持多个座席工号，多个之间使用英文逗号','分隔注：一个座席只能在一个运行中的任务中

外呼组号；callGroupType=2 时必填。注：一个外呼组可以绑定到多个任务，但只能同时运行一个任务中

座席分配规则；默认随机。

• 1：随机

• 2：顺序

• 3.座席未进线最大时（从上一次呼叫结束到当前的总时长）

• 4.座席状态[空闲]最长时长（座席最近一次切换为空闲状态的持续时长）

座席超时时间；单位秒数，默认 10 秒，取值范围 5 ~ 60

座席整理时间；默认 30 秒，取值范围 1～10800，整理时间会影响每次呼叫的个数，值越大，呼叫号码个数会减小

座席最长等待时间；默认 40 秒，最小 10，最大 600，允许座席空闲的最大时间。任务执行过程中，如果座席平均空闲时间大于 maxWaitTime，每次呼叫个数会增加

最小可用座席数；默认为 10，取值范围 1 ~ 10。任务内可用座席数小于当前值时，任务自动暂停，避免骚扰

骚扰率；默认值为 1，取值范围为大于 0，小于等于 20，支持小数，精确到小数点两位。值越小呼叫的号码越少，值越大呼叫的号码越多，座席利用率越高

超呼率；默认值为 100，取值范围 50～400

座席当日接听的通话个数上限，使用方式详见下方说明；JsonArray 格式 [{"cnos":["2000","2001"],"limit":"5"}注：使用座席当日接听数限制功能需开启企业配置，功能开启并且配置上限后系统才开始统计当日接听数

客户侧等待音；客户接听后呼叫座席，等待座席接听时播放的语音，默认为空白音。支持公共语音和企业语音，值为语音文件的 path。

客户侧提示音；客户接听后呼转座席前播放的语音，提示音播放完成后再找座席，默认无提示音。支持公共语音和企业语音，值为语音文件的 path。

初始化预计客户接通率；默认 50，取值范围 1～100，预热阶段的呼叫，按照此接通率计算呼叫频率

任务预热时间；默认 300 秒, 取值范围 60 ～ 600

暂停后重新预热；默认开启，任务暂停后是否需要重新预热。

• 0：关闭

• 1：开启