AI 助理
文档备案控制台
官方文档
首页

ListJobs - 查询多个作业

更新时间：
复制 MD 格式
产品详情
我的收藏

查询多个作业。

调试

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

调试

授权信息

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

请求参数

名称

类型

必填

描述

示例值
InstanceId

string

是

实例 ID

af81a389-91f0-4157-8d82-720edd02b66a
JobId

array

是

作业 ID 列表，注：子级条数 <= 99。

24fb9a8d-f20e-4ee2-a11c-094dda68c5cc

string

否

作业 ID

24fb9a8d-f20e-4ee2-a11c-094dda68c5cc

返回参数

名称

类型

描述

示例值

object

HttpStatusCode

integer

HTTP 状态码

200
Code

string

接口状态码

OK
Message

string

接口提示消息

Success
RequestId

string

请求 ID

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

boolean

是否成功

true
Jobs

array<object>

作业数组

array<object>

Status

string

作业状态，取值范围

  • Scheduling：调度中。

  • Executing：执行中。

  • Succeeded：成功。

  • Paused：挂起。

  • Failed：失败。

  • Cancelled：已取消。

  • Drafted：草稿态。

Succeeded
ScenarioId

string

业务 ID

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

string

作业组 ID

fce6c599-8ede-40e3-9f78-0928eda7b4e8
StrategyId

string

策略 ID

c8a2b7f2-ad1a-4865-b872-d0080d9802d9
JobId

string

作业 ID

b72425bd-7871-4050-838e-033d80d754b7
Priority

integer

作业优先级

5
SystemPriority

integer

系统优先级

1
FailureReason

string

作业失败原因

NoAnswer
ReferenceId

string

作业的业务 ID，有业务方自定义。

说明

为上传的 ContactIdID 值。

d5971d98-7312-4f0e-a918-a17d67133e28
Contacts

array<object>

联系人列表

object

PhoneNumber

string

电话号码

135****8888
State

string

状态【已废弃】

Available
ContactId

string

联系人 ID。系统自动生成

db3db762-e421-44c9-9a01-cb423470757c
Honorific

string

尊称。与联系人名字相同

张先生
JobId

string

作业 ID【已废弃】

72dcd26b-f12d-4c27-b3af-18f6aed5b160
ContactName

string

联系人名字

张三
Role

string

联系人角色【废弃】

*
ReferenceId

string

联系人第三方系统 ID

2fa6bac3-06da-4315-82ab-72d6fd3a6f34
Extras

array<object>

业务参数列表。

说明

说明 TenantId、ServiceId 为系统生成，其余参数为自定义参考传入的

object

Key

string

业务参数 Key

name
Value

string

业务参数 Value

张三
Summary

array<object>

对话业务标签数据：

大模型场景中：对话完结后的标签命中数据。

小模型场景中：对话完结后的变量值数据

object

SummaryName

string

标签名字。

score
Category

string

对话摘要类别

{}
Content

string

标签值

5
Tasks

array<object>

任务列表

array<object>

Status

string

任务状态，取值范围 （注：Succeeded 状态已细分原因，不会展示 Succeeded：1（已接通）状态，之后返回均为具体细分原因类型。）

  • Executing：0（正在拨打）。

  • Succeeded：1（已接通）。

  • NoAnswer：2（未接通-无人接听）。

  • NotExist：3（未接通-空号）。

  • Busy：4（未接通-占线）。

  • Cancelled：5（未呼出-任务停止）。

  • Failed：6（失败）。

  • NotConnected：7（未接通-无法接通）。

  • PoweredOff：8（未接通-关机）。

  • OutOfService：9（未接通-被叫停机）。

  • InArrears：10（未接通-被叫欠费）。

  • EmptyNumber：11（未呼出-空号不外呼）。

  • PerDayCallCountLimit：12（未呼出-超出每日上限）。

  • ContactBlockList：13（未呼出-黑名单）。

  • CallerNotRegistered：14（未呼出-主叫号码未注册）。

  • Terminated：15（未呼出-被终止）。

  • VerificationCancelled：16（未呼出-呼叫前验证不通过取消）。

  • OutOfServiceNoCall：17（未呼出-被叫停机不外呼）。

  • InArrearsNoCall：18（未呼出-被叫欠费不外呼）。

  • CallingNumberNotExist：19（未呼出-主叫号码不存在）。

  • SucceededFinish：20（已接通-正常完结）。

  • SucceededChatbotHangUpAfterNoAnswer：21（已接通-拒识后机器人挂机）。

  • SucceededChatbotHangUpAfterSilence：22（已接通-静默超时挂机）。

  • SucceededClientHangUpAfterNoAnswer：23（已接通-拒识后用户挂机）。

  • SucceededClientHangUp：24（已接通-用户无理由挂机）。

  • SucceededTransferByIntent：25（已接通-命中意图转人工）。

  • SucceededTransferAfterNoAnswer：26（已接通-拒识转人工）。

  • SucceededInoInterAction：27（已接通-用户侧无交互）。

  • SucceededError：28（已接通-系统异常中断）。

  • SucceededSpecialInterceptVoiceAssistant：29（已接通-特殊情况拦截-语音助手）。

  • SucceededSpecialInterceptExtensionNumberTransfer：30（已接通-特殊情况拦截-分机号转接）。

  • SucceededSpecialInterceptCustomSpecialIntercept：31（已接通-特殊情况拦截-自定义拦截）。

  • HighRiskSipCode：32（未呼出-高风险不外呼）。

Succeeded
PlanedTime

integer

任务计划执行时间

1579068424883
ChatbotId

string

对话机器人 id

1234
ActualTime

integer

实际执行时间

1579068424883
CalledNumber

string

被叫号码

135****8888
ScenarioId

string

场景 ID。历史参数。【已废弃】

ade80092-03d9-4f4d-ad4f-ab8a247d3150
JobId

string

作业 ID

b72425bd-7871-4050-838e-033d80d754b7
CallId

string

呼叫 ID

1528189846043
CallingNumber

string

主叫号码

0571****3106
Brief

string

业务结果。历史参数【已废弃】

1
Duration

integer

持续时间。

120
TaskId

string

任务 ID

ff44709e-39a6-43ba-959b-20fcabe3e496
Conversation

array<object>

对话列表

array<object>

Speaker

string

是谁说的话，Robot 机器人， Contact 联系人

Robot
Timestamp

integer

对话文本入库时间戳

1579068424883
Script

string

对话文本

你好，我是**客服
Summary

array<object>

摘要信息，【已废弃】

object

SummaryName

string

摘要名称

是本人
Category

string

类目

标签
Content

string

摘要内容

是
Contact

object

任务的联系人

PhoneNumber

string

电话号码

135****8888
State

string

状态。

Available
ContactId

string

联系人 ID

db3db762-e421-44c9-9a01-cb423470757c
Honorific

string

联系人尊称。不填入则与联系人名称相同

张先生
JobId

string

作业 ID。已废弃

b72425bd-7871-4050-838e-033d80d754b7
ContactName

string

联系人名字

张三
Role

string

角色。

*
ReferenceId

string

联系人第三方系统 ID

2fa6bac3-06da-4315-82ab-72d6fd3a6f34
CallingNumbers

array

主叫号码列表

string

主叫号码列表

["0571****3106"]

示例

正常返回示例

JSON格式

{
  "HttpStatusCode": 200,
  "Code": "OK",
  "Message": "Success",
  "RequestId": "254EB995-DEDF-48A4-9101-9CA5B72FFBCC",
  "Success": true,
  "Jobs": [
    {
      "Status": "Succeeded",
      "ScenarioId": "254EB995-DEDF-48A4-9101-9CA5B72FFBCC",
      "JobGroupId": "fce6c599-8ede-40e3-9f78-0928eda7b4e8",
      "StrategyId": "c8a2b7f2-ad1a-4865-b872-d0080d9802d9",
      "JobId": "b72425bd-7871-4050-838e-033d80d754b7",
      "Priority": 5,
      "SystemPriority": 1,
      "FailureReason": "NoAnswer",
      "ReferenceId": "d5971d98-7312-4f0e-a918-a17d67133e28",
      "Contacts": [
        {
          "PhoneNumber": "135****8888",
          "State": "Available",
          "ContactId": "db3db762-e421-44c9-9a01-cb423470757c",
          "Honorific": "张先生",
          "JobId": "72dcd26b-f12d-4c27-b3af-18f6aed5b160",
          "ContactName": "张三",
          "Role": "*",
          "ReferenceId": "2fa6bac3-06da-4315-82ab-72d6fd3a6f34"
        }
      ],
      "Extras": [
        {
          "Key": "name",
          "Value": "张三"
        }
      ],
      "Summary": [
        {
          "SummaryName": "score",
          "Category": "\t{}",
          "Content": "5"
        }
      ],
      "Tasks": [
        {
          "Status": "Succeeded",
          "PlanedTime": 1579068424883,
          "ChatbotId": "\t1234",
          "ActualTime": 1579068424883,
          "CalledNumber": "135****8888",
          "ScenarioId": "ade80092-03d9-4f4d-ad4f-ab8a247d3150",
          "JobId": "b72425bd-7871-4050-838e-033d80d754b7",
          "CallId": "1528189846043",
          "CallingNumber": "0571****3106",
          "Brief": "1",
          "Duration": 120,
          "TaskId": "ff44709e-39a6-43ba-959b-20fcabe3e496",
          "Conversation": [
            {
              "Speaker": "Robot",
              "Timestamp": 1579068424883,
              "Script": "你好，我是**客服",
              "Summary": [
                {
                  "SummaryName": "是本人",
                  "Category": "标签",
                  "Content": "是"
                }
              ]
            }
          ],
          "Contact": {
            "PhoneNumber": "135****8888",
            "State": "Available",
            "ContactId": "db3db762-e421-44c9-9a01-cb423470757c",
            "Honorific": "张先生",
            "JobId": "b72425bd-7871-4050-838e-033d80d754b7",
            "ContactName": "张三",
            "Role": "*",
            "ReferenceId": "2fa6bac3-06da-4315-82ab-72d6fd3a6f34"
          }
        }
      ],
      "CallingNumbers": [
        "[\"0571****3106\"]"
      ]
    }
  ]
}

错误码

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

变更历史

更多信息，参考变更详情。

上一篇：QueryJobs - 查询作业列表下一篇：DescribeJobDataParsingTaskProgress - 返回一个作业的进度信息