您可以通过HTTP批量推送方式订阅通信引擎呼叫记录消息(LlmSmartCall),在呼叫结束后获取呼叫的记录信息。
协议说明
类别 | 说明 |
协议 | HTTP + JSON |
编码 | UTF-8 |
请求说明
请求内容为JSON Array格式。
请求样例:
[ { "call_id": "147797******^134543******", "start_time": "2025-01-06 17:33:37", "end_time": "2025-01-06 17:36:45", "duration": 189, "status_code": "200000", "status_msg": "用户听完语音", "out_id": "65178442", "caller": "020*****843", "callee": "15*****0614", "hangup_direction": "用户", "toll_type": "PROVINCE", "originate_time": "2025-01-06 17:33:05", "ring_time": "2025-01-06 17:33:15", "smart_status_code": "ANSWERED" } ]
字段说明:
名称
类型
描述
call_id
String
呼叫ID。
start_time
String
通话接通时间,即被叫接起电话时间,未接通时该字段则为空。
end_time
String
通话结束时间,未接通时该字段则为空。
duration
Integer
通话时长,单位:秒,未接通时为0秒。
status_code
String
呼叫结果状态码,状态码说明请参见呼叫状态码。
status_msg
String
结果描述。
out_id
String
扩展字段回传。将调用API时传入的字段返回。
caller
String
主叫号码。
callee
String
被叫号码。
hangup_direction
String
挂断方向。取值:
用户。
机器。
toll_type
String
通话类型。取值:
LOCAL:市话。
PROVINCE:省内长途。
DOMESTIC:国内长途。
INTERNATIONAL:国际长途。
UNKNOWN:未知。
originate_time
String
呼叫发起时间,即通话由语音服务向运营商发起时间。
ring_time
String
被叫响铃时间,即发起外呼后被叫收到请求开始响铃的时间,若被叫未响铃,则该字段为空。
smart_status_code
String
智能通话结果状态码,状态码说明请参见智能状态码。
响应说明
响应样例:
{ "code": 0, "msg": "接收成功" }
字段说明:
名称
类型
是否必须
说明
示例值
code
Number
是
应答编码。
0
msg
String
否
描述信息。
接收成功
系统仅校验返回值的code是否为数字,不校验内容。若HTTP状态码为200,请求成功。HTTP状态码非200或响应超时情况下,系统会进行重试推送。
若出现系统异常、消费失败等情况,建议HTTP响应码返回50X。
重新推送
第一次推送失败后,间隔1分钟、5分钟、10分钟后会进行重推,直至推送成功为止。如果推送3次后仍失败,不再重试。