您可以通过HTTP批量推送方式订阅通信智能体呼叫记录消息(AlicomAgentCallReport),在通话结束后,可以获取到本次通话的主被叫号码、通话开始时间、通话结束时间、通话持续时间、语音实时ASR时长等信息。
协议说明
类别 | 说明 |
协议 | HTTP + JSON |
编码 | UTF-8 |
请求说明
请求内容为JSON Array格式。
请求样例
{ "taskId": "1181**************", "detailId": "9662*************", "batchId": "B202******", "callId": "10000161****^1000018****", "outId": "123456", "startTime": "2025-06-01 10:00:00", "endTime": "2025-06-01 10:05:30", "duration": 330, "statusCode": "200010", "smartStatusCode": "ANSWERED", "statusMsg": "通话正常结束", "caller": "138********", "callee": "139********", "hangupDirection": "用户", "originateTime": "2025-06-01 09:59:45", "ringTime": "2025-06-01 09:59:50", "bRingTime": "2025-06-01 09:59:52", "bStartTime": "2025-06-01 09:59:55", "bEndTime": "2025-06-01 10:05:25", "bDuration": 320, "bOriginateTime": "2025-06-01 09:59:48" }
字段说明
名称
类型
示例
描述
taskId
String
1181**************
任务ID。
detailId
String
9662*************
任务明细ID。
batchId
String
B202******
任务批次ID。
callId
String
10000161****^1000018****
呼叫ID。
outId
String
123456
如果客户有传入outId,则从该字段带回。
startTime
String
2025-06-01 10:00:00
通话接通时间,即被叫接起电话时间,未接通时该字段则为空,格式为yyyy-MM-dd HH:mm:ss。
endTime
String
2025-06-01 10:05:30
通话结束时间,未接通时该字段则为空,格式为yyyy-MM-dd HH:mm:ss。
duration
Integer
330
通话时长,单位:秒,未接通时为0秒。
statusCode
String
200010
呼叫结果状态码,状态码说明请参见呼叫状态码。
smartStatusCode
String
ANSWERED
智能通话结果状态码,状态码说明请参见智能状态码。
statusMsg
String
通话正常结束
结果描述。
caller
String
138********
主叫号码。
callee
String
139********
被叫号码。
hangupDirection
String
用户
挂断方向。取值:
用户。
机器。
originateTime
String
2025-06-01 09:59:45
主叫方呼叫发起时间,即通话由语音服务向运营商发起的时间,格式为yyyy-MM-dd HH:mm:ss。
ringTime
String
2025-06-01 09:59:50
主叫方接收的被叫响铃时间,即发起后被叫收到请求开始响铃的时间,若被叫未响铃,则该字段为空,格式为yyyy-MM-dd HH:mm:ss。
bRingTime
String
2025-06-01 09:59:52
被叫方响铃时间,若被叫未响铃,则该字段为空,格式为yyyy-MM-dd HH:mm:ss。
bStartTime
String
2025-06-01 09:59:55
被叫方接听时间。格式为yyyy-MM-dd HH:mm:ss。
bEndTime
String
2025-06-01 10:05:25
被叫方通话结束时间。格式为yyyy-MM-dd HH:mm:ss。
bDuration
Integer
320
被叫方接通到结束的通话时长,单位:秒,未接通时为0秒。
bOriginateTime
String
2025-06-01 09:59:48
系统收到主叫方的呼叫请求后,向被叫方发起呼叫的时间。格式为yyyy-MM-dd HH:mm:ss。
响应说明
响应样例
{ "code": 0, "msg": "接收成功" }
字段说明
名称
类型
是否必须
说明
示例值
code
Number
是
应答编码。
0
msg
String
否
描述信息。
接收成功
系统仅校验返回值的code是否为数字,不校验内容。若HTTP状态码为200,请求成功。HTTP状态码非200或响应超时情况下,系统会进行重试推送。
若出现系统异常、消费失败等情况,建议HTTP响应码返回50X。
重新推送
第一次推送失败后,间隔1分钟、5分钟、10分钟后会进行重推,直至推送成功为止。如果推送3次后仍失败,不再重试。