您可以通过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次后仍失败,不再重试。