QueryAiCallTaskDetail

Updated at:

Queries the basic information of a voice call task.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

TaskId

string

Yes

The task ID.

1187**************

Response elements

Element

Type

Description

Example

object

AccessDeniedDetail

string

The details about the access denial. This parameter is returned only when the RAM permission verification fails.

None

Message

string

The error message. This parameter is not returned if the call is successful.

Invalid parameter

RequestId

string

The request ID.

23822ECB-8CAA-5C52-9C9E-807FD82A5A7F

Data

object

The returned data.

TaskId

string

The task ID.

1187**************

ApplicationName

string

The application name.

Sample value

RetryEnable

boolean

Indicates whether call retry is enabled. Valid values:

  • true: Enabled.

  • false: Not enabled.

true

StartTime

integer

The scheduled start time of the task. This value is a timestamp in milliseconds.

1748932499000

RealStartTime

integer

The actual start time of the task. This value is a timestamp in milliseconds.

1748932499000

LinePhoneNum

string

The phone number of the custom line.

Sample value

ApplicationCode

string

The application code.

Sample value

CallerNumber

string

The caller number.

05370124****

CallTimes

array<object>

The allowed call time periods.

object

The configuration of an allowed call time period.

EndTime

string

The end time in the format of HH:mm:ss.

09:00:00

StartTime

string

The start time in the format of HH:mm:ss.

12:00:00

RetryReasons

array

The list of failure reasons that allow retry.

string

The specific retry reason. Valid values:

  • CALL_REJECTED: The call is rejected.

  • USER_BUSY: The callee is busy.

  • SUSPEND: The number is suspended.

  • INVALID_NUMBER: The number is invalid.

  • POWERED_OFF: The phone is powered off.

  • NETWORK_BUSY: The network is busy.

  • NO_ANSWER: No answer.

CALL_REJECTED

RetryCount

integer

The number of retry attempts.

2

PhoneType

integer

The phone number type. Valid values: 0 indicates an Alibaba Cloud number. 1 indicates a custom line provided by the customer.

17

TaskName

string

The task name.

Test task

LineEncoding

string

The line encoding.

Sample value

StartType

string

The start mode. Valid values:

  • IMMEDIATE: Start immediately.

  • SCHEDULE: Start at a scheduled time.

IMMEDIATE

AgentName

string

The agent name.

Test agent

AgentId

string

The code of the published agent.

1180**************

RetryInterval

integer

The retry interval. Unit: minutes.

1

CallDays

array

The list of callable days.

string

The callable day. Valid values:

  • MONDAY: Monday.

  • TUESDAY: Tuesday.

  • WEDNESDAY: Wednesday.

  • THURSDAY: Thursday.

  • FRIDAY: Friday.

  • SATURDAY: Saturday.

  • SUNDAY: Sunday.

MONDAY

ConcurrentCount

integer

The task concurrency.

10

CallExpireMinutes

integer

The expiration duration of outbound call details. Unit: minutes.

20

CallExpireDate

string

The expiration date of outbound call details (specific deadline) in the format of YYYY-MM-DD HH:mm:ss.

2026-07-30 20:00:20

CallExpireType

integer

The expiration type of outbound calls. Valid values:

0: permanently valid. 1: valid for a period of time after import. 2: valid until a specified time.

0

CallableTimes

array<object>

The callable time periods of the current outbound call instance.

object

The callable time periods of the current outbound call instance.

EndTime

string

The end time in the format of HH:mm:ss.

18:00:00

StartTime

string

The start time in the format of HH:mm:ss.

10:00:00

Code

string

The error code.

OK

Success

boolean

Indicates whether the call was successful. Valid values:

  • true: Successful.

  • false: Failed.

false

Examples

Success response

JSON format

{
  "AccessDeniedDetail": "None",
  "Message": "Invalid parameter",
  "RequestId": "23822ECB-8CAA-5C52-9C9E-807FD82A5A7F",
  "Data": {
    "TaskId": "1187**************\n",
    "ApplicationName": "SampleValue",
    "RetryEnable": true,
    "StartTime": 1748932499000,
    "RealStartTime": 1748932499000,
    "LinePhoneNum": "SampleValue",
    "ApplicationCode": "SampleValue",
    "CallerNumber": "05370124****",
    "CallTimes": [
      {
        "EndTime": "09:00:00",
        "StartTime": "12:00:00"
      }
    ],
    "RetryReasons": [
      "CALL_REJECTED"
    ],
    "RetryCount": 2,
    "PhoneType": 17,
    "TaskName": "TestTask",
    "LineEncoding": "SampleValue",
    "StartType": "IMMEDIATE",
    "AgentName": "TestAgent",
    "AgentId": "1180**************\n",
    "RetryInterval": 1,
    "CallDays": [
      "MONDAY"
    ],
    "ConcurrentCount": 10,
    "CallExpireMinutes": 20,
    "CallExpireDate": "2026-07-30 20:00:20",
    "CallExpireType": 0,
    "CallableTimes": [
      {
        "EndTime": "18:00:00",
        "StartTime": "10:00:00"
      }
    ]
  },
  "Code": "OK",
  "Success": false
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.