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

AlicomAgentCallRecord messages are delivered through batch HTTP push notifications. After a call ends, these messages provide information about the call recording, such as the filename and download URL.

Protocol description

Category	Description
Protocol	HTTP + JSON
Encoding	UTF-8

Request description

The request body is a JSON array.

Request sample

[{
  "callId": "10000161****^1000018****",
  "duration": 125,
  "endTime": "2025-05-22 12:31:31",
  "recordFile": "http://alicom-fc-record-biz.cn-hangzhou.oss.aliyuncs.com/**********",
  "startTime": "2025-05-22 12:29:20",
  "taskId": "1181**************",
  "detailId": "9662*************",
  "batchId": "B202******",
  "outId": "123456"
}]

Field descriptions

Name	Type	Example	Description
callId	String	10000161**^1000018**	The call ID.
duration	Integer	125	The call duration in seconds.
endTime	String	2025-05-22 12:31:31	The time when the call ended. The format is yyyy-MM-dd HH:mm:ss.
recordFile	String	http://alicom-fc-record-biz.cn-hangzhou.oss.aliyuncs.com/**********	The URL of the recording file. Note The recording URL is valid for seven days.
startTime	String	2025-05-22 12:29:20	The time when the call started. The format is yyyy-MM-dd HH:mm:ss.
taskId	String	1181**************	The task ID.
detailId	String	9662*************	The detail ID.
batchId	String	B202******	The batch ID.
outId	String	123456	If you pass an outId in your request, this field returns that same ID.

Response description

Response sample

{
  "code": 0,
  "msg": "Received successfully"
}

Field descriptions
Name
Type
Required
Description
Example
code
Number
Yes
The acknowledgement code.
0
msg
String
No
The description.
Received successfully

Note

The system only validates that the `code` in your response is a number. It does not validate other content. If the HTTP status code is 200, the push is considered successful. If the status code is not 200 or a timeout occurs, the system retries the push.
If a system error or processing failure occurs on your server, respond with an HTTP 5xx status code.

Push retries

If a push notification fails, the system retries it. The first retry occurs after 1 minute, the second after 5 minutes, and the third after 10 minutes. If the third attempt fails, the system does not try again.

Name	Type	Required	Description	Example
code	Number	Yes	The acknowledgement code.	0
msg	String	No	The description.	Received successfully