QueryConversationDetailInfo

Updated at:

Queries the details of a call.

Operation description

  • You can use this operation to query call details. You can also view call details in the Call Task Management > Details > Execution Records > Completed > Call Details page.

  • Before calling this operation, make sure that you have created a call task and imported callee data.

  • If you do not have a created call task, create a call task and import callee data on the Call Task Management page, or use the CreateAiCallTask and ImportTaskNumberDatas operations to create a call task and import callee data.

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:QueryConversationDetailInfo

get

*All Resource

*

None None

Request parameters

Parameter

Type

Required

Description

Example

TaskId

string

Yes

The task ID. View the task ID on the Call Task Management page or retrieve it by calling the QueryAiCallTaskPage operation.

138************

DetailId

string

Yes

The task detail ID. View the task detail ID in the upper-left corner of the Call Task Management > Details > Execution Records > Completed > Call Details page, or retrieve it by calling the QueryAiCallDetailPage operation.

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

BatchId

string

Yes

The task batch ID. This is the batch ID returned when callee data is imported. View the task batch ID on the Call Task Management > Details > Execution Records page, or use the batch ID returned when importing callee data by calling the ImportTaskNumberDatas operation.

139*********216

Response elements

Element

Type

Description

Example

object

AccessDeniedDetail

string

The access denied details.

None

Message

string

The description of the status code.

OK

RequestId

string

The request ID.

F2051E18-FF3F-5C08-8D24-6F150D2AF757

Data

object

The returned data.

CallerPhone

string

The caller number.

0571*******

CallResult

string

The call result. Valid values:

  • CALL_FORWARDING: Call forwarding.

  • INCOMING_CALL_BARRED: Incoming call barred.

  • CALL_REJECTED: Call rejected.

  • ANSWERED: Answered by user.

  • USER_BUSY: Callee busy.

  • POWERED_OFF: Powered off.

  • NO_USER_RESPONSE: Out of service area.

  • OPERATOR_BLOCK: Blocked by carrier.

  • OTHERS: Other status.

  • SUSPEND: Service suspended.

  • CANCEL: Canceled by caller.

  • INVALID_NUMBER: Invalid number.

  • UNAVAILABLE: Temporarily unavailable.

  • NETWORK_BUSY: Network busy.

  • NO_ANSWER: No answer.

ANSWERED

StatusMsg

string

The call status information returned by the carrier.

Call ended (dual call)

StartCallTime

integer

The time when the call started. This value is a UNIX timestamp in milliseconds.

123123123123123

MajorIntent

string

The major intent.

D

CallId

string

The unique ID of the call.

1231231231213^11231231231

FailedReason

string

The failure reason.

Actively canceled

Duration

integer

The call duration, in seconds. The value is 0 if the call is not connected.

16

HangupDirection

string

The hangup direction. Valid values:

  • 0: User.

  • 1: Robot.

User

StatusCode

string

The call status code. For more information, see Call status codes in Voice Messaging.

200005

CalledPhone

string

The callee number.

186******

Variables

array<object>

The list of call variables. These are the call variables associated with the call task you created.

object

The call variable information.

Required

boolean

Indicates whether the variable is required. Valid values:

  • true: Required.

  • false: Not required.

false

Value

string

The variable value.

John

Id

string

The variable ID.

22

Key

string

The variable key.

name

Source

string

The variable source.

Sample value

Name

string

The variable name.

Name

RecordingFileDownloadUrl

string

The download URL of the recording file. This field is available only after a recording file is generated.

https://********

ReleaseTime

integer

The time when the call ended. This value is a UNIX timestamp in milliseconds.

98

PickUpTime

integer

The time when the call was answered. This value is a UNIX timestamp in milliseconds.

1754617273000

OutId

string

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

bb3bc32d-54b8-49c4-80d3-61583417d22e

ConversationRecord

string

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

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

[ { "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" } ]

OutputTags

array<object>

The list of output tags.

object

The output tag information.

OutputTagDescription

string

The tag description.

Evaluate the customer's interest in the vehicle model and purchase likelihood

OutputTagName

string

The tag name.

Customer intent level

OutputTagValue

string

The tag value.

["High (very positive, high conversion probability)"]

Id

string

The tag ID.

9ca2*****************************

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": "F2051E18-FF3F-5C08-8D24-6F150D2AF757",
  "Data": {
    "CallerPhone": "0571*******",
    "CallResult": "ANSWERED",
    "StatusMsg": "Call ended (dual call)",
    "StartCallTime": 123123123123123,
    "MajorIntent": "D",
    "CallId": "1231231231213^11231231231",
    "FailedReason": "Actively canceled",
    "Duration": 16,
    "HangupDirection": "User",
    "StatusCode": "200005",
    "CalledPhone": "186******",
    "Variables": [
      {
        "Required": false,
        "Value": "John",
        "Id": "22",
        "Key": "name",
        "Source": "Sample value",
        "Name": "Name"
      }
    ],
    "RecordingFileDownloadUrl": "https://********",
    "ReleaseTime": 98,
    "PickUpTime": 1754617273000,
    "OutId": "bb3bc32d-54b8-49c4-80d3-61583417d22e\n",
    "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]",
    "OutputTags": [
      {
        "OutputTagDescription": "Evaluate the customer's interest in the vehicle model and purchase likelihood",
        "OutputTagName": "Customer intent level",
        "OutputTagValue": "[\"High (very positive, high conversion probability)\"]",
        "Id": "9ca2*****************************"
      }
    ]
  },
  "Code": "OK",
  "Success": true
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.