调用ModifyJobGroup修改作业组信息_智能外呼机器人(Outbound Bot)-阿里云帮助中心

调试

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

调试

请求参数

名称	类型	是否必选	示例值	描述

名称	类型	是否必选	示例值	描述
Action	String	是	ModifyJobGroup	系统规定参数。取值：ModifyJobGroup。
InstanceId	String	是	174952ab-9825-4cc9-a5e2-de82d7fa4cdd	实例ID。
JobGroupId	String	是	3edc0260-6f7c-4de4-8535-09372240618b	任务ID。
Name	String	是	修改后的作业组	任务名字。
ScenarioId	String	是	c6a668d1-3145-4048-9101-cb3678bb8884	场景ID。（历史参数，后续使用ScriptId）
Description	String	否	修改后的作业组	任务描述。
StrategyJson	String	否	{\"maxAttemptsPerDay\":\"0\",\"minAttemptInterval\":\"5\",\"Id\":\"689fc584-7f9f-4dc2-933d-8711beef7b15\"}	作业组执行策略 name：策略名称 maxAttemptsPerDay：号码每天最大呼叫次数 minAttemptInterval：未接通情况下的重试时间间隔，单位为分钟 startTime：开始时间戳 endTime：结束时间戳 workingTime：可呼出的时间窗口，24小时制 id：策略ID，对于该接口为必填
RecallStrategyJson	String	否	{\"emptyNumberIgnore\":false,\"inArrearsIgnore\":false,\"outOfServiceIgnore\":false}	重拨策略JSON
ScriptId	String	否	5a3940ce-a12f-4222-9f0f-605a9b89ea7c	场景话术ID。
CallingNumber.N	String	否	["4008013260"]	主叫号码。
JobGroupStatus	String	否	Draft	任务状态，取值范围： Draft：草稿。 Scheduling：调度中。 Executing：执行中。 Completed：已完成。 Paused：挂起。 Failed：失败。 Cancelled：已取消。 Initializing：初始化。
RingingDuration	Long	否	25	最优振铃时长。
MinConcurrency	Long	否	1	并发保障值任务启动时，最低保障N个并发；同一优先级的任务并发保障值加和不能大于实例并发；若配置并发保障值为0，则依赖系统内空闲并发进行智能分配。
Priority	String	否	Daily	作业组优先级，取值范围 Urgent：紧急任务。 Daily：日常任务。
FlashSmsExtras	String	否	{"templateId":"10471","configId":"8037f524-6ff2-4dbe-bb28-f59234ea7a64"}	闪信推送的配置参数，JSON格式，包含第三方闪信的配置信息。 templateId：闪信模板ID。 configId：闪信配置ID。
RecallCallingNumber.N	String	否	["4008013260"]	重呼主叫号码列表

返回数据

名称	类型	示例值	描述

名称	类型	示例值	描述
HttpStatusCode	Integer	200	HTTP状态码。
Code	String	OK	接口状态码。
Message	String	Success	接口提示消息。
RequestId	String	254EB995-DEDF-48A4-9101-9CA5B72FFBCC	请求ID。
Success	Boolean	true	是否成功。
JobGroup	Object		任务信息。
Status	String	Scheduling	状态。
ScenarioId	String	6cea9bed-63e6-439e-ae4c-b3333efff53d	场景ID。
JobGroupId	String	c62e6789-28a8-41db-941e-171a01d3b3b9	任务ID。
CreationTime	Long	1578550074361	创建时间。
JobGroupName	String	第一个催收	任务名字。
JobFilePath	String	UPLOADED/JOB/d481cebe-0bb6-4d13-9649-42ce5074fb75/6c7d9132-98e1-4f08-8a76-8a266c7532fd_job_template - 副本.xlsx	任务文件OSS存储路径。
JobGroupDescription	String	催收的作业组	任务描述。
JobDataParsingTaskId	String	e37d28cb-0413-4816-85ed-fd354d025ea3	解析外呼任务文件对应的解析任务ID。
ScriptName	String	话术	话术名称。
ScriptVersion	String	1628425608429	话术版本。
ModifyTime	String	1628425608429	修改时间。
CallingNumbers	Array of String	["4008013260"]	主叫号码列表。
ExportProgress	Object		导出信息（历史参数，不再使用）。
Status	String	FINISHED	状态
FileHttpUrl	String	https://***.oss-cn-shanghai.aliyuncs.com/sample	文件地址
Progress	String	1	进度
Strategy	Object		外呼策略。
Type	String	Repeatable	策略类型。
StrategyName	String	催收策略	策略名称。
MaxAttemptsPerDay	Integer	3	最大尝试次数。
FollowUpStrategy	String	CONTINUE	执行周期结束后的处理方式（历史参数，不再使用）。
EndTime	Long	2209702074000	结束时间。
Customized	String	{}	自定义策略数据（历史参数，不再使用）。
IsTemplate	Boolean	false	是否是模板（历史参数，不再使用）。
StartTime	Long	1578550074000	开始时间。
StrategyId	String	f718798d-96be-40e4-bef6-317b54855708	策略ID。
RoutingStrategy	String	LocalFirst	号码路由策略。
MinAttemptInterval	Integer	10	失败后重复拨打的间隔时间。
StrategyDescription	String	催收作业执行策略	策略描述。
RepeatBy	String	Once	重复执行方式，Once 不重复，Day 每天重复，Week 每周重复，Month 每月重复。
WorkingTime	Array of TimeFrame		允许外呼的时间段。
EndTime	String	12:00:00	结束时间。
BeginTime	String	09:00:00	开始时间。
RepeatDays	Array of String	[1,2,3,4,5]	重复执行的天。
RecallStrategy	Object		重呼策略
EmptyNumberIgnore	Boolean	false	空号不再外呼。
InArrearsIgnore	Boolean	false	欠费不再外呼。
OutOfServiceIgnore	Boolean	false	停机不再外呼。
RingingDuration	Long	25	振铃时长。
Priority	String	Daily	作业组优先级，取值范围 Urgent：紧急任务。 Daily：日常任务。
MinConcurrency	Long	1	并发保障值任务启动时，最低保障N个并发；同一优先级的任务并发保障值加和不能大于实例并发；若配置并发保障值为0，则依赖系统内空闲并发进行智能分配。
FlashSmsExtras	String	{"configId":"3157b3c8-3a3e-4ea9-894b-9c8a6", "templateId":"1234"}	闪信推送的配置参数，JSON格式，包含第三方闪信的配置信息。 templateId: 闪信模板ID。 configId: 闪信配置ID。

示例

请求示例

http(s)://[Endpoint]/?Action=ModifyJobGroup
&InstanceId=174952ab-9825-4cc9-a5e2-de82d7fa4cdd
&JobGroupId=3edc0260-6f7c-4de4-8535-09372240618b
&Name=修改后的作业组
&ScenarioId=c6a668d1-3145-4048-9101-cb3678bb8884
&Description=修改后的作业组
&StrategyJson={\"maxAttemptsPerDay\":\"0\",\"minAttemptInterval\":\"5\",\"Id\":\"689fc584-7f9f-4dc2-933d-8711beef7b15\"}
&RecallStrategyJson={\"emptyNumberIgnore\":false,\"inArrearsIgnore\":false,\"outOfServiceIgnore\":false}
&ScriptId=5a3940ce-a12f-4222-9f0f-605a9b89ea7c
&CallingNumber=["[\"4008013260\"]"]
&JobGroupStatus=Draft
&RingingDuration=25
&MinConcurrency=1
&Priority=Daily
&FlashSmsExtras={"templateId":"10471","configId":"8037f524-6ff2-4dbe-bb28-f59234ea7a64"}

&RecallCallingNumber=["[\"4008013260\"]"]
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

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

JSON格式

HTTP/1.1 200 OK
Content-Type:application/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\"}"
  }
}

错误码

HttpCode	错误码	错误信息	描述

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

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