您可以通过HTTP批量推送方式订阅呼叫结束后话单报告消息（SecretReport），可以在呼叫结束后获取通话记录信息，包括通话开始时间、通话结束时间、主被叫号码等，便于平台进行管理。

协议说明

参数说明
协议HTTP + JSON
编码UTF-8

请求说明

请求内容为JSON Array格式，单次请求可能会包含多个通话记录。
  • 请求样例：
    [{
    "phone_no": "171****3225",
    "city": "北京",
    "call_out_time": "2021-08-25 20:11:30",
    "ring_time": "2021-08-25 20:11:35",
    "record_url": "https://*****.oss-cn-shanghai.aliyuncs.com",
    "ring_record_url": "https://****.oss-cn-shanghai.aliyuncs.com",
    "free_ring_time": "2021-08-25 20:11:35",
    "control_msg": "OK",
    "id": 101456851****,
    "secret_no": "186****7614",
    "call_type": 1,
    "control_type": "CONTINUE",
    "release_time": "2021-08-25 20:11:41",
    "pool_key": "FC10000009708****",
    "sub_id": 100004306803****,
    "unconnected_cause": 0,
    "call_time": "2021-08-25 20:11:29",
    "peer_no": "152****1504",
    "called_display_no": "158****0000",
    "release_dir": 1,
    "call_id": "43612633712c****",
    "start_time": "2021-08-25 20:11:38",
    "partner_key": "FC10000009708****",
    "out_id": "7368136812621****",
    "release_cause": 31
}]
  • 字段说明：
    名称类型是否必选示例描述
    phone_noString是171****3225AXB中的A号码。
    cityString否北京X号码归属地。
    call_out_timeString是2021-08-25 20:11:30隐私号码转接到真实号码的时间。
    ring_timeString是2021-08-25 20:11:35响铃时间。
    record_urlString否https://*****.oss-cn-shanghai.aliyuncs.com录音下载URL。
    ring_record_urlString否https://****.oss-cn-shanghai.aliyuncs.com放音录音URL。
    free_ring_timeString是2021-08-25 20:11:35被叫手机真实的振铃时间。
    • free_ring_time大于call_out_time表示被叫真实发生了振铃事件。
    • free_ring_time和call_out_time相等表示未振铃。
    control_msgString否OK延续信息。
    • OK：正常。
    • NO_SUBS_EXIST：无绑定关系时。
    idString是101456851****主键。
    secret_noString是186****7614AXB中的X号码。
    call_typeInterger是1呼叫类型。取值：
    • 0：主叫，即phone_no打给peer_no。
    • 1：被叫，即peer_no打给phone_no。
    • 4：呼叫拦截。
    control_typeString否CONTINUE当前接续阶段。取值：
    • IVR
    • CONTINUE
    • REJECT
    release_timeString是2021-08-25 20:11:41被叫挂断时间。
    说明 release_time和start_time之差表示通话时长，如果结果为0，说明呼叫未接通。
    pool_keyString是FC10000009708****对应的号池Key。
    sub_idLong是100004306803****绑定关系ID。
    unconnected_causeInterger否0未接通通话的原因。
    • 0：正常通话。
    • 1：黑名单拦截。
    • 2：无绑定关系。
    • 3：呼叫限制。
    • 4：其他。
    call_timeString是2021-08-25 20:11:29主叫拨打时间。
    peer_noString是152****1504AXB中的B号码或者N号码。
    called_display_noString是158****0000被叫显号。
    release_dirInterger是1通话释放方向。
    • 0：平台释放。
    • 1：主叫挂断。
    • 2：被叫挂断
    call_idString是43612633712c****通话记录的ID。
    说明 call_id长度限制在100个字符以内。
    start_timeString是2021-08-10 15:46:16被叫接听时间。
    partner_keyString是FC10000013150****商户Key。
    out_idString否7368136812621****外部业务ID。
    release_causeInterger否31释放原因。请根据编号在释放原因中查看。
    释放原因：
    编号说明
    1未分配的号码。
    2无路由到指定的转接网。
    3无路由到目的地。
    4发送专用信息音。
    16正常的呼叫拆线（正常挂断）。
    17用户忙。
    18用户未响应（被叫网络、信号异常导致）。
    19用户未应答（被叫未接听）。
    20用户缺席。
    21呼叫拒收。
    22号码改变。
    27目的地不可达。
    28无效的号码格式（地址不全）。
    29性能拒绝。
    31正常，未指定。
    34无电路或通路可用。
    42交换设备拥塞。
    50所请求的性能未预定。
    53CUG中限制去呼叫。
    55CUG中限制来呼叫。
    57承载能力无权。
    58承载能力目前不可用。
    65承载能力未实现。
    69所请求的性能未实现。
    87被叫用户不是CUG的成员。
    88不兼容的目的地。
    90不存在的CUG。
    91无效的转接网选择。
    95无效的消息，未指定。
    97消息类型不存在或未实现。
    99参数不存在或未实现。
    102定时器终了时恢复。
    103参数不存在或未实现—传递。
    110消息带有未被识别的参数—舍弃。
    111协议错误，未指定。
    127互通，未指定。

响应说明

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

重新推送

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