QueryConversationDetailInfoNew-Artificial Intelligence Cloud Call Service(AICCS)-阿里云帮助中心

Queries the details of a call task and call conversation information.

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 console.
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 in the Call Task Management console, 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:QueryConversationDetailInfoNew

get

*All Resource

*

None

Request parameters

Parameter	Type	Required	Description	Example
TaskId	string	Yes	The task ID. View the task ID in the Call Task Management console or retrieve it by calling the QueryAiCallTaskPage operation.	138************
DetailId	string	No	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 console, or retrieve it by calling the QueryAiCallDetailPage operation.	9662*************
CallId	string	No	The unique ID of the call.	1552******^1420******
OutId	string	No	The external business serial number reserved for external input. You can use a unique ID for business association.	123******

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.	D9CB3933-9FE3-4870-BA8E-2BEE91B69D23
Data	object	The returned data.
CallerPhone	string	The caller number.	0571*******
Options	string	The variable information used at runtime, stored in key-value format in this field.	{ "date": "666", "phoneNumber": "777", "distance": "555", "mendian": "444", "sex": "Male", "name": "111", "age": "222" }
CallResult	string	The call result. Valid values: CALL_FORWARDING: Call forwarding. INCOMING_CALL_BARRED: Incoming call barred. CALL_REJECTED: Call rejected. ANSWERED: Answered by the user. USER_BUSY: Callee busy. POWERED_OFF: Powered off. NO_USER_RESPONSE: Out of service area. OPERATOR_BLOCK: Blocked by the carrier. OTHERS: Other status. SUSPEND: Service suspended. CANCEL: Canceled by the 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)
ConversationTurnCount	integer	The number of conversation turns.	23
TaskId	string	The task ID.	138************
StartCallTime	integer	The time when the call started. This value is a UNIX timestamp in milliseconds.	1286987391
StatusCode	string	The call status code. For more information, see Call status codes in Voice Messaging.	200005
CalledPhone	string	The callee number.	130********
Variables	array<object>	The call variable information.
	object	The call variable information.
Required	boolean	Indicates whether the variable is required.	false
Value	string	The variable value.	mike
Id	string	The variable ID.	123
Key	string	The variable key.	name
Source	string	The source.	source
Name	string	The variable name.	user name
RecordingFileDownloadUrl	string	The download URL of the recording file. This field is available only after a recording file is generated.	recording.oss.file
PickUpTime	integer	The time when the call was answered. This value is a UNIX timestamp in milliseconds.	12349732441
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": "111Hello, age 222, gender male, I am the official consultant of Auto. We have a new model called ; is now available, starting at RMB. It sold * units in ** minutes. Would you like to learn more?", "role": "assistant" }, { "content": " Hey, who are you?", "role": "user" }, { "content": " Say that again.", "role": "user" }]
Status	integer	The agent status.	72
ImportedTime	integer	The import time. This value is a UNIX timestamp in milliseconds.	43
EncryptionType	integer		28
MajorIntent	string	The major intent.	A
CallId	string	The unique ID of the call.	123*****^213****
BatchId	string	The batch ID.	1234******
FailedReason	string	The failure reason.	Actively canceled
Duration	integer	The call duration. The value is 0 if the call is not connected. Unit: seconds.	30
HangupDirection	string	The hangup direction. Valid values: 0: User. 1: Robot.	0
DetailId	string	The task detail ID.	1234*******
ReleaseTime	integer	The time when the call ended. This value is a UNIX timestamp in milliseconds.	7
OutId	string	The external business serial number. You can use a unique ID for business association.	123***
OutputTags	array<object>	The output tag information.
	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.	12
BranchId	integer	The branch ID.	68
Code	string	The status code.	OK
Success	boolean	Indicates whether the operation was successful. Valid values: true: Successful. false: Failed.	false

Examples

Success response

JSON format

{
  "AccessDeniedDetail": "None",
  "Message": "success",
  "RequestId": "D9CB3933-9FE3-4870-BA8E-2BEE91B69D23",
  "Data": {
    "CallerPhone": "0571*******",
    "Options": "{\n  \"date\": \"666\",\n  \"phoneNumber\": \"777\",\n  \"distance\": \"555\",\n  \"mendian\": \"444\",\n  \"sex\": \"male\",\n  \"name\": \"111\",\n  \"age\": \"222\"\n}",
    "CallResult": "ANSWERED",
    "StatusMsg": "Call ended (dual call)",
    "ConversationTurnCount": 23,
    "TaskId": "138************",
    "StartCallTime": 1286987391,
    "StatusCode": "200005",
    "CalledPhone": "130********",
    "Variables": [
      {
        "Required": false,
        "Value": "mike",
        "Id": "123",
        "Key": "name",
        "Source": "source",
        "Name": "user name"
      }
    ],
    "RecordingFileDownloadUrl": "recording.oss.file",
    "PickUpTime": 12349732441,
    "ConversationRecord": "[\n  {\n    \"content\": \"111Hello, age 222, gender male, I am the official consultant of ** Auto, we have a new model **; ** is now available, starting at ** yuan, ** minutes to break * units, would you like to learn more?\",\n    \"role\": \"assistant\"\n  },\n  {\n    \"content\": \" Hey, who are you?\",\n    \"role\": \"user\"\n  },\n  {\n    \"content\": \" Say that again.\",\n    \"role\": \"user\"\n  }]",
    "Status": 72,
    "ImportedTime": 43,
    "EncryptionType": 28,
    "MajorIntent": "A",
    "CallId": "123*******^213******",
    "BatchId": "1234******",
    "FailedReason": "Actively canceled.",
    "Duration": 30,
    "HangupDirection": "0",
    "DetailId": "1234*******",
    "ReleaseTime": 7,
    "OutId": "123***",
    "OutputTags": [
      {
        "OutputTagDescription": "Evaluate the customer's interest in the model and purchase likelihood.",
        "OutputTagName": "Customer intent level.",
        "OutputTagValue": "[\"High (very positive, high probability of conversion)\"]",
        "Id": "12"
      }
    ],
    "BranchId": 68
  },
  "Code": "OK",
  "Success": false
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.