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_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

    0571****0000

    主叫号码。

    status_msg

    String

    执行完成

    结果描述。

    out_id

    String

    PROD#2021042810271227129999192500610008S#new#MYBK****

    扩展字段回传,将调用API时传入的字段返回。

    说明

    智能外呼SaaS助手相关API的out_id内容为ALICOM_SMART_SAAS^111111^2222222,其中的111111为批次任务ID。

    dtmf

    String

    1

    DTMF按键。

    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次后仍失败,不再重试。