ModifyJobGroup - 修改任务数据

修改智能外呼任务。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
InstanceIdstring

实例 ID。

174952ab-9825-4cc9-a5e2-de82d7fa4cdd
JobGroupIdstring

任务 ID。

3edc0260-6f7c-4de4-8535-09372240618b
Namestring

任务名字。

修改后的作业组
ScenarioIdstring

场景 ID。(历史参数,后续使用 ScriptId)

c6a668d1-3145-4048-9101-cb3678bb8884
Descriptionstring

任务描述。

修改后的作业组
StrategyJsonstring

作业组执行策略 name:策略名称 maxAttemptsPerDay:号码每天最大呼叫次数 minAttemptInterval:未接通情况下的重试时间间隔,单位为分钟 startTime:开始时间戳 endTime:结束时间戳 workingTime:可呼出的时间窗口,24 小时制 id:策略 id,对于该接口为必填

{\"maxAttemptsPerDay\":\"0\",\"minAttemptInterval\":\"5\",\"Id\":\"689fc584-7f9f-4dc2-933d-8711beef7b15\"}
RecallStrategyJsonstring

重拨策略 JSON

{\"emptyNumberIgnore\":false,\"inArrearsIgnore\":false,\"outOfServiceIgnore\":false}
ScriptIdstring

场景话术 ID。

5a3940ce-a12f-4222-9f0f-605a9b89ea7c
CallingNumberarray

主叫号码。

string

主叫号码。

["4008013260"]
JobGroupStatusstring

任务状态,取值范围:

  • Draft:草稿。
  • Scheduling:调度中。
  • Executing:执行中。
  • Completed:已完成。
  • Paused:挂起。
  • Failed:失败。
  • Cancelled:已取消。
  • Initializing:初始化。
Draft
RingingDurationlong

最优振铃时长。

25
MinConcurrencylong

并发保障值 任务启动时,最低保障 N 个并发; 同一优先级的任务并发保障值加和不能大于实例并发; 若配置并发保障值为 0,则依赖系统内空闲并发进行智能分配。

1
Prioritystring

作业组优先级,取值范围

  • Urgent:紧急任务。
  • Daily:日常任务。
Daily
FlashSmsExtrasstring

闪信推送的配置参数,JSON 格式,包含第三方闪信的配置信息。

templateId:闪信模板 ID。
configId:闪信配置 ID。

{"templateId":"10471","configId":"8037f524-6ff2-4dbe-bb28-f59234ea7a64"}
RecallCallingNumberarray
string

重呼主叫号码列表

["4008013260"]

返回参数

名称类型描述示例值
object
HttpStatusCodeinteger

HTTP 状态码。

200
Codestring

接口状态码。

OK
Messagestring

接口提示消息。

Success
RequestIdstring

请求 ID。

254EB995-DEDF-48A4-9101-9CA5B72FFBCC
Successboolean

是否成功。

true
JobGroupobject

任务信息。

Statusstring

状态。

Scheduling
ScenarioIdstring

场景 ID。

6cea9bed-63e6-439e-ae4c-b3333efff53d
JobGroupIdstring

任务 ID。

c62e6789-28a8-41db-941e-171a01d3b3b9
CreationTimelong

创建时间。

1578550074361
JobGroupNamestring

任务名字。

第一个催收
JobFilePathstring

任务文件 OSS 存储路径。

UPLOADED/JOB/d481cebe-0bb6-4d13-9649-42ce5074fb75/6c7d9132-98e1-4f08-8a76-8a266c7532fd_job_template - 副本.xlsx
JobGroupDescriptionstring

任务描述。

催收的作业组
JobDataParsingTaskIdstring

解析外呼任务文件对应的解析任务 ID。

e37d28cb-0413-4816-85ed-fd354d025ea3
ScriptNamestring

话术名称。

话术
ScriptVersionstring

话术版本。

1628425608429
ModifyTimestring

修改时间。

1628425608429
CallingNumbersarray

主叫号码列表。

string

主叫号码列表。

["4008013260"]
ExportProgressobject

导出信息(历史参数,不再使用)。

Statusstring

状态

FINISHED
FileHttpUrlstring

文件地址

https://***.oss-cn-shanghai.aliyuncs.com/sample
Progressstring

进度

1
Strategyobject

外呼策略。

Typestring

策略类型。

Repeatable
StrategyNamestring

策略名称。

催收策略
MaxAttemptsPerDayinteger

最大尝试次数。

3
FollowUpStrategystring

执行周期结束后的处理方式(历史参数,不再使用);

CONTINUE
EndTimelong

结束时间。

2209702074000
Customizedstring

自定义策略数据(历史参数,不再使用)。

{}
IsTemplateboolean

是否是模板(历史参数,不再使用)。

false
StartTimelong

开始时间。

1578550074000
StrategyIdstring

策略 ID。

f718798d-96be-40e4-bef6-317b54855708
RoutingStrategystring

号码路由策略。

LocalFirst
MinAttemptIntervalinteger

失败后重复拨打的间隔时间。

10
StrategyDescriptionstring

策略描述。

催收作业执行策略
RepeatBystring

重复执行方式,Once 不重复,Day 每天重复,Week 每周重复,Month 每月重复。

Once
WorkingTimearray<object>

允许外呼的时间段。

object

工作时间段。

EndTimestring

结束时间。

12:00:00
BeginTimestring

开始时间。

09:00:00
RepeatDaysarray

重复的执行天。

若重复周期 RepeatBy 为周,0 表示周日,1-6 分别表示周一至周六 若重复周期 RepeatBy 为月,1-31 分别表示 1 至 31 日,没有该指定日期的月份不执行,如:若选定 30 日,二月份不执行

string

重复执行的天。

[1,2,3,4,5]
RecallStrategyobject

重呼策略

EmptyNumberIgnoreboolean

空号不再外呼。

false
InArrearsIgnoreboolean

欠费不再外呼。

false
OutOfServiceIgnoreboolean

停机不再外呼。

false
RingingDurationlong

振铃时长。

25
Prioritystring

作业组优先级,取值范围

Urgent:紧急任务。 Daily:日常任务。

Daily
MinConcurrencylong

并发保障值 任务启动时,最低保障 N 个并发; 同一优先级的任务并发保障值加和不能大于实例并发; 若配置并发保障值为 0,则依赖系统内空闲并发进行智能分配。

1
FlashSmsExtrasstring

闪信推送的配置参数,JSON 格式,包含第三方闪信的配置信息。

templateId: 闪信模板 ID。 configId: 闪信配置 ID。

{"configId":"3157b3c8-3a3e-4ea9-894b-9c8a6", "templateId":"1234"}

示例

正常返回示例

JSON格式

{
  "HttpStatusCode": 200,
  "Code": "OK",
  "Message": "Success",
  "RequestId": "254EB995-DEDF-48A4-9101-9CA5B72FFBCC",
  "Success": true,
  "JobGroup": {
    "Status": "Scheduling",
    "ScenarioId": "6cea9bed-63e6-439e-ae4c-b3333efff53d",
    "JobGroupId": "c62e6789-28a8-41db-941e-171a01d3b3b9",
    "CreationTime": 1578550074361,
    "JobGroupName": "第一个催收",
    "JobFilePath": "UPLOADED/JOB/d481cebe-0bb6-4d13-9649-42ce5074fb75/6c7d9132-98e1-4f08-8a76-8a266c7532fd_job_template - 副本.xlsx",
    "JobGroupDescription": "催收的作业组",
    "JobDataParsingTaskId": "e37d28cb-0413-4816-85ed-fd354d025ea3",
    "ScriptName": "话术",
    "ScriptVersion": "1628425608429",
    "ModifyTime": "1628425608429",
    "CallingNumbers": [
      "[\"4008013260\"]"
    ],
    "ExportProgress": {
      "Status": "FINISHED",
      "FileHttpUrl": "https://***.oss-cn-shanghai.aliyuncs.com/sample",
      "Progress": "1"
    },
    "Strategy": {
      "Type": "Repeatable",
      "StrategyName": "催收策略",
      "MaxAttemptsPerDay": 3,
      "FollowUpStrategy": "CONTINUE",
      "EndTime": 2209702074000,
      "Customized": "{}",
      "IsTemplate": false,
      "StartTime": 1578550074000,
      "StrategyId": "f718798d-96be-40e4-bef6-317b54855708",
      "RoutingStrategy": "LocalFirst",
      "MinAttemptInterval": 10,
      "StrategyDescription": "催收作业执行策略",
      "RepeatBy": "Once",
      "WorkingTime": [
        {
          "EndTime": "12:00:00",
          "BeginTime": "09:00:00"
        }
      ],
      "RepeatDays": [
        "[1,2,3,4,5]"
      ]
    },
    "RecallStrategy": {
      "EmptyNumberIgnore": false,
      "InArrearsIgnore": false,
      "OutOfServiceIgnore": false
    },
    "RingingDuration": 25,
    "Priority": "Daily",
    "MinConcurrency": 1,
    "FlashSmsExtras": "{\"configId\":\"3157b3c8-3a3e-4ea9-894b-9c8a6\", \"templateId\":\"1234\"}"
  }
}

错误码

HTTP status code错误码错误信息描述
404NotExist.InstanceThe specified Instance does not exist.指定的实例不存在。
500InternalErrorAn error occurred while processing your request. Please try again later. Submit a ticket if the error still exists.内部错误。建议重试,如果多次重试报错请提交工单。

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2024-06-24OpenAPI 错误码发生变更、OpenAPI 入参发生变更查看变更详情
2024-01-04OpenAPI 错误码发生变更、OpenAPI 入参发生变更、OpenAPI 返回结构发生变更查看变更详情