文档

VoiceReport

更新时间:

通过HTTP批量推送方式订阅呼叫记录消息(VoiceReport),可以在呼叫结束后获取呼叫的记录信息,包括通话类型、通话的开始及结束时间、通话时长、结束原因等。

请求说明

请求内容为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": "PROD#2021042810271227129999192500610008S#new#MYBK****",
        "dtmf": "1",
        "toll_type": "LOCAL"
      }
    ]
  • 字段说明
    名称类型示例描述
    status_codeString200003呼叫结果状态码。状态码说明,请参见呼叫状态码
    calleeString130****0000被叫号码。
    ring_timeString2021-04-28 10:02:40被叫响铃时间,即发起外呼后被叫收到请求开始响铃的时间。
    说明 若被叫未响铃,则该字段为空。
    durationString10秒通话时长,单位为秒,未接通为0秒。
    voice_typeStringvoice话单类型。
    • voice:普通话单。
    • asr:asr话单。
    • smart_transfer:智能外呼转接话单。
    originate_timeString2021-04-28 10:02:34呼叫发起时间,即通话由云通信侧向运营商发起时间。
    b_start_timeString2021-04-28 10:03:40通话接通时间,即被叫接起电话时间,未接通则为空。
    end_timeString2021-04-28 10:03:40通话结束时间。
    call_idString122628733198^10942206****呼叫ID。
    callerString0571****0000主叫号码。
    status_msgString执行完成结果描述。
    out_idStringPROD#2021042810271227129999192500610008S#new#MYBK****扩展字段回传,将调用API时传入的字段返回。
    说明 智能外呼SaaS助手相关API的out_id内容为ALICOM_SMART_SAAS^111111^2222222,其中的111111为批次任务ID。
    dtmfString1DTMF按键。
    toll_typeStringLOCAL通话类型。
    • LOCAL:市话。
    • PROVINCE:省内长途。
    • DOMESTIC:国内长途。
    • INTERNATIONAL:国际长途。

响应说明

  • 响应样例
    {
     "code": 0,
     "msg": "接收成功"
    }
  • 字段说明
    名称类型是否必选示例值描述
    codeNumber0应答编码。
    msgString接收成功描述信息。
说明
  • 系统仅校验返回值的code是否为数字,不校验内容。若HTTP状态码为200,请求成功。HTTP状态码非200或响应超时情况下,系统会进行重试推送。
  • 若出现系统异常、消费失败等情况,建议HTTP响应码返回50X。

重新推送

第一次推送失败后,间隔1分钟、5分钟、10分钟后会进行重推,直至推送成功为止。如果推送3次后仍失败,不再重试。

  • 本页导读