QueryConversationDetailInfo

更新时间:
复制 MD 格式

Gets call details.

Operation description

  • This API retrieves call details. You can also view these details on the call task management > details > execution history > completed > call details page.

  • Before calling this API, make sure you have created a call task and imported called number data.

  • You can create a call task and import called number data either on the call task management page or by using the CreateAiCallTask and ImportTaskNumberDatas APIs.

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. You can find this ID on the call task management page or get it by calling the QueryAiCallTaskPage operation.

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

DetailId

string

Yes

The detail ID. You can find this ID in the upper-left corner of the page by navigating to call task management > details > execution history > completed > call details, or get it by calling the QueryAiCallDetailPage operation.

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

BatchId

string

Yes

The batch ID. This ID is returned by the ImportTaskNumberDatas operation when you import callee data. You can view this ID on the execution history page by navigating to call task management > details.

139*********216

Response elements

Element

Type

Description

Example

object

AccessDeniedDetail

string

The details of the access denial.

None

Message

string

The status code message.

成功

RequestId

string

The request ID.

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

Data

object

The response 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: Called party busy.

  • POWERED_OFF: Powered off.

  • NO_USER_RESPONSE: Out of service area.

  • OPERATOR_BLOCK: Blocked by carrier.

  • OTHERS: Other.

  • SUSPEND: Suspended.

  • CANCEL: Canceled by caller.

  • INVALID_NUMBER: Invalid number.

  • UNAVAILABLE: Temporarily unavailable.

  • NETWORK_BUSY: Network busy.

  • NO_ANSWER: No answer.

ANSWERED

StatusMsg

string

The status message returned by the carrier.

呼叫结束(双呼)

StartCallTime

integer

The timestamp when the call was initiated, in milliseconds.

123123123123123

MajorIntent

string

The primary intent.

D

CallId

string

The unique call ID.

1231231231213^11231231231

FailedReason

string

The failure reason.

主动取消

Duration

integer

The duration of the call, in seconds. If the call was not connected, the value is 0.

16

HangupDirection

string

The party that hung up. Valid values:

  • 0: user.

  • 1: assistant.

用户

StatusCode

string

The call status code. For more information, see Call status codes for the voice service.

200005

CalledPhone

string

The called number.

186******

Variables

array<object>

A list of variables associated with the call task.

object

A variable from the call task.

Required

boolean

Indicates whether the variable is required. Valid values:

  • true: The variable is required.

  • false: The variable is optional.

false

Value

string

The variable value.

张三

Id

string

The variable ID.

22

Key

string

The variable key.

name

Source

string

示例值

Name

string

The variable name.

姓名

RecordingFileDownloadUrl

string

The download URL for the recording file. This parameter is returned only after the recording file is generated.

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

ReleaseTime

integer

The timestamp when the call ended, in milliseconds.

98

PickUpTime

integer

The timestamp when the call was answered, in milliseconds.

1754617273000

OutId

string

The business-specific ID that is passed in. You can use this unique ID to associate the call with your business.

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

ConversationRecord

string

The conversation record. The structure is a JSON array in which entries are sorted by time. Example:

[
    {
        "content":"Conversation content",
        "role":"Role", // Valid values: user, assistant
    }
]

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

A list of output tags.

object

A single output tag.

OutputTagDescription

string

The tag description.

评估客户对车型的兴趣和购买可能性

OutputTagName

string

The tag name.

客户意向度

OutputTagValue

string

The tag value.

["高(非常积极,大概率转化)"]

Id

string

The tag ID.

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

Code

string

The status code.

OK

Success

boolean

Indicates whether the request was successful. Valid values:

  • true: The request was successful.

  • false: The request failed.

true

Examples

Success response

JSON format

{
  "AccessDeniedDetail": "None",
  "Message": "成功",
  "RequestId": "F2051E18-FF3F-5C08-8D24-6F150D2AF757",
  "Data": {
    "CallerPhone": "0571*******",
    "CallResult": "ANSWERED",
    "StatusMsg": "呼叫结束(双呼)",
    "StartCallTime": 123123123123123,
    "MajorIntent": "D",
    "CallId": "1231231231213^11231231231",
    "FailedReason": "主动取消",
    "Duration": 16,
    "HangupDirection": "用户",
    "StatusCode": "200005",
    "CalledPhone": "186******",
    "Variables": [
      {
        "Required": false,
        "Value": "张三",
        "Id": "22",
        "Key": "name",
        "Source": "示例值",
        "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": "评估客户对车型的兴趣和购买可能性",
        "OutputTagName": "客户意向度",
        "OutputTagValue": "[\"高(非常积极,大概率转化)\"]",
        "Id": "9ca2*****************************"
      }
    ]
  },
  "Code": "OK",
  "Success": true
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.