QueryAiCallDetailPage

Updated at:

Queries the details of voice call tasks by page.

Operation description

  • Before querying voice call task details, make sure that you have created a voice call task.

  • If you have not created a voice call task, create one on the Call Task Management page or by calling the CreateAiCallTask operation.

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

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

  • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

  • API: The API that you can call to perform the action.

  • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

  • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

    • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

    • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

  • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

  • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

aiccs:QueryAiCallDetailPage

list

*All Resource

*

None None

Request parameters

Parameter

Type

Required

Description

Example

TaskId

string

Yes

The task ID.

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

Status

integer

Yes

The task status. Valid values:

  • 0: Pending.

  • 1: Completed.

  • 2: Failed.

0

BatchId

string

No

The batch ID. On the Call Task Management page, click Details to view the batch ID.

1183**************

CalledNumber

string

No

The called number.

053714454****

EncryptionType

integer

No

The encryption type. Valid values: 0: no encryption. 1: MD5. 2: SHA256. 3: SM3.

1

CallResult

string

No

The call result. Valid values:

  • CALL_FORWARDING: Call forwarding.

  • INCOMING_CALL_BARRED: Incoming call barred.

  • CALL_REJECTED: Call rejected.

  • ANSWERED: Answered.

  • USER_BUSY: User busy.

  • POWERED_OFF: Powered off.

  • NO_USER_RESPONSE: Out of service area.

  • OPERATOR_BLOCK: Blocked by carrier.

  • OTHERS: Other status.

  • SUSPEND: Service suspended.

  • CANCEL: Caller canceled.

  • INVALID_NUMBER: Invalid number.

  • UNAVAILABLE: Temporarily unavailable.

  • NETWORK_BUSY: Network busy.

  • NO_ANSWER: No answer.

ANSWERED

MajorIntent

string

No

The major intent. On the Communication Agent Management page, click the agent details to view the major intent.

A

MinConversationDuration

integer

No

The minimum call duration. Unit: minutes.

0

MaxConversationDuration

integer

No

The maximum call duration. Unit: minutes.

20

StartImportedTime

integer

No

The start import time. This value is a UNIX timestamp. Unit: ms.

1748948749000

EndImportedTime

integer

No

The end import time. This value is a UNIX timestamp. Unit: ms.

1748948749000

StartCallingTime

integer

No

The start calling time. This value is a UNIX timestamp. Unit: ms.

1748948749000

EndCallingTime

integer

No

The end calling time. This value is a UNIX timestamp. Unit: ms.

1748948749000

OutId

string

No

The ID reserved for the caller. This ID is returned to the caller in the receipt message.

94ba739b-c01a-ef91-335d-4be006c34899

DetailIds

array

No

The list of task detail IDs. A maximum of 100 IDs can be specified.

integer

No

The detail ID.

992913231****

PageNo

integer

No

The current page number. The value must be greater than 0. Default value: 1.

1

PageSize

integer

No

The number of entries per page. Default value: 10.

10

Response elements

Element

Type

Description

Example

object

AccessDeniedDetail

string

The detailed reason why access was denied.

None

Message

string

The description of the status code.

Success

RequestId

string

The request ID.

A57441B2-8EB6-5B93-9F37-0A51B8E2C9F5

Data

object

The returned data.

PageSize

integer

The page size.

5

Total

integer

The total number of records.

2

PageNo

integer

The current page number.

60

List

array<object>

The list of task detail data.

object

The task detail data.

ImportedTime

integer

The import time. This value is a UNIX timestamp. Unit: milliseconds.

1748948749000

Status

integer

The task detail status. Valid values:

  • 0: Initialization.

  • 1: Waiting for call.

  • 2: Waiting for retry.

  • 3: Calling.

  • 4: Call ended.

  • 5: Call failed.

Only 4 and 5 are desired states.

4

Options

string

The variable information used at runtime. The information is stored in this field as key-value pairs.

{ "date": "666", "phoneNumber": "777", "distance": "555", "mendian": "444", "sex": "Male", "name": "111", "age": "222" }

EncryptionType

integer

The encryption type. Valid values: 0: no encryption. 1: MD5. 2: SHA256. 3: SM3.

1

CalledNumber

string

The called number.

0537101****

CallResult

string

The call result.

Answered

ConversationTurnCount

integer

The number of conversation turns.

10

TaskId

string

The task ID.

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

BatchId

string

The batch ID.

1183**************

MajorIntent

string

The major intent.

A

FailedReason

string

The reason for the call failure. This field is returned only when the call fails.

Account suspended

BranchId

integer

The branch ID.

49

RecordingFilePath

string

The download path of the recording file. This field is returned only after the recording file is generated.

https://*******

CallingTime

integer

The calling time. This value is a UNIX timestamp. Unit: milliseconds.

1748948749000

DetailId

string

The task detail ID.

9662*************

OutId

string

The external business serial number reserved for external input. You can use a unique ID for business association.

outId

BranchVersionId

integer

The version ID.

9

ConversationRecord

string

The chat record information. The structure is a JSON array, and the chat records are sorted in chronological order. The structure is as follows:

[
    {
        "content":"Chat content",
        "role":"Role",//Valid values: user and assistant (bot).
    }
]

[ { "content": "111您好,年龄222,性别男,我这边是**汽车的官方顾问,我们新出了一款车型为**;**已经上市了,售价**万元起,**分钟破*台,您看要不了解一下?", "role": "assistant" }, { "content": "<客户打断>哎,你是谁?", "role": "user", }, { "content": "<客户打断>你再说一遍。", "role": "user", }, { "content": "哎,我没听清。", "role": "user", }, { "content": "你在说什么?", "role": "user", }, { "content": "您好,", "role": "assistant", }, { "content": "我是**汽车总部销售服务顾问。", "role": "assistant", }, { "content": "我们最近推出了一款新车**,想了解一下您是否对这款车型感兴趣?", "role": "assistant", }, { "content": "<客户打断>哎,那我是谁?", "role": "user", }, { "content": "你在说什么呢?", "role": "user", }, { "content": "抱歉打扰了,111先生。", "role": "assistant", }, { "content": "祝您生活愉快!再见!", "role": "assistant", } ]

ConversationDuration

integer

The call duration. Unit: seconds.

100

VersionNo

integer

The version number.

1

VersionName

string

The version name.

Default version

BranchName

string

The branch name.

Default branch

CallId

string

The call ID.

123*****456^123*****456

CallExpireTime

integer

The expiration time of the outbound call detail. Format: YYYY-MM-DD HH:mm:ss.

2026-07-30 20:00:20

Code

string

The status code.

OK

Success

boolean

Indicates whether the call was successful. Valid values:

  • true: Successful.

  • false: Failed.

true

Examples

Success response

JSON format

{
  "AccessDeniedDetail": "None",
  "Message": "OK",
  "RequestId": "A57441B2-8EB6-5B93-9F37-0A51B8E2C9F5",
  "Data": {
    "PageSize": 5,
    "Total": 2,
    "PageNo": 60,
    "List": [
      {
        "ImportedTime": 1748948749000,
        "Status": 4,
        "Options": "{\n  \"date\": \"666\",\n  \"phoneNumber\": \"777\",\n  \"distance\": \"555\",\n  \"mendian\": \"444\",\n  \"sex\": \"male\",\n  \"name\": \"111\",\n  \"age\": \"222\"\n}",
        "EncryptionType": 1,
        "CalledNumber": "0537101****",
        "CallResult": "Answered",
        "ConversationTurnCount": 10,
        "TaskId": "1187**************",
        "BatchId": "1183**************",
        "MajorIntent": "A",
        "FailedReason": "Account suspended",
        "BranchId": 49,
        "RecordingFilePath": "https://*******",
        "CallingTime": 1748948749000,
        "DetailId": "9662*************",
        "OutId": "outId",
        "BranchVersionId": 9,
        "ConversationRecord": "[\n    {\n        \"content\": \"111您好,年龄222,性别男,我这边是**汽车的官方顾问,我们新出了一款车型为**;**已经上市了,售价**万元起,**分钟破*台,您看要不了解一下?\",\n        \"role\": \"assistant\"\n    },\n    {\n        \"content\": \"哎,你是谁?\",\n        \"role\": \"user\",\n    },\n    {\n        \"content\": \"你再说一遍。\",\n        \"role\": \"user\",\n    },\n    {\n        \"content\": \"哎,我没听清。\",\n        \"role\": \"user\",\n    },\n    {\n        \"content\": \"你在说什么?\",\n        \"role\": \"user\",\n    },\n    {\n        \"content\": \"您好,\",\n        \"role\": \"assistant\",\n    },\n    {\n        \"content\": \"我是**汽车总部销售服务顾问。\",\n        \"role\": \"assistant\",\n    },\n    {\n        \"content\": \"我们最近推出了一款新车**,想了解一下您是否对这款车型感兴趣?\",\n        \"role\": \"assistant\",\n    },\n    {\n        \"content\": \"哎,那我是谁?\",\n        \"role\": \"user\",\n    },\n    {\n        \"content\": \"你在说什么呢?\",\n        \"role\": \"user\",\n    },\n    {\n        \"content\": \"抱歉打扰了,111先生。\",\n        \"role\": \"assistant\",\n    },\n    {\n        \"content\": \"祝您生活愉快!再见!\",\n        \"role\": \"assistant\",\n    }\n]",
        "ConversationDuration": 100,
        "VersionNo": 1,
        "VersionName": "Default version",
        "BranchName": "Default branch",
        "CallId": "123*****456^123*****456",
        "CallExpireTime": 0
      }
    ]
  },
  "Code": "OK",
  "Success": true
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.