您可以通过HTTP批量推送方式订阅呼叫记录消息(VoiceReportAiccs),可以在呼叫结束后获取呼叫的记录信息,包括通话类型、通话的开始及结束时间、通话时长、结束原因等。
协议说明
类别 | 说明 |
---|---|
协议 | HTTP + JSON |
编码 | UTF-8 |
请求说明
请求内容为JSON Array格式。
- 请求样例:
[ { "status_code": "200003", "callee": "130****0000", "ring_time": "2021-04-28 10:02:40", "duration": "10", "voice_type": "voice", "originate_time": "2021-04-28 10:02:34", "b_start_time": "2021-04-28 10:03:40", "end_time": "2021-04-28 10:03:40", "call_id": "122628733198^10942206****", "caller": "20200900****", "status_msg": "执行完成", "out_id": "123456", "toll_type": "LOCAL" } ]
- 字段说明:
名称 类型 示例 描述 status_code String 200003 呼叫结果状态码,状态码说明请参见呼叫状态码。 callee String 130****0000 被叫号码。 ring_time String 2021-04-28 10:02:40 被叫响铃时间,即发起外呼后被叫收到请求开始响铃的时间。 说明 若被叫未响铃,则该字段为空。duration String 10 通话时长,未接通为0。 voice_type String voice 话单类型。取值: - voice:普通话单。
- asr:asr话单。
- smart_transfer:智能外呼转接话单。
originate_time String 2021-04-28 10:02:34 呼叫发起时间,即通话由云通信侧向运营商发起时间。 b_start_time String 2021-04-28 10:03:40 通话接通时间,即被叫接起电话时间,未接通则为空。 end_time String 2021-04-28 10:03:40 通话结束时间。 call_id String 122628733198^10942206**** 呼叫ID。 caller String 20200900**** 主叫号码。 status_msg String 执行完成 结果描述。 out_id String 123456 扩展字段回传,将调用API时传入的字段返回,智能外呼SaaS助手相关API的out_id内容为ALICOM_SMART_SAAS^111111^2222222,其中的111111为批次任务ID。 toll_type String LOCAL 通话类型。取值: - LOCAL :市话。
- PROVINCE:省内长途。
- DOMESTIC: 国内长途。
- INTERNATIONAL:国际长途。
响应说明
- 响应样例:
{ "code": 0, "msg": "接收成功" }
- 字段说明:
名称 类型 是否必须 说明 示例值 code Number 是 应答编码。 0 msg String 否 描述信息。 接收成功
说明
- 系统仅校验返回值的code是否为数字,不校验内容。若HTTP状态码为200,请求成功。HTTP状态码非200或响应超时情况下,系统会进行重试推送。
- 若出现系统异常、消费失败等情况,建议HTTP响应码返回50X。
重新推送
第一次推送失败后,间隔1分钟、5分钟、10分钟后会进行重推,直至推送成功为止。如果推送3次后仍失败,不再重试。