您可以通過(guò)HTTP批量推送方式訂閱呼叫記錄消息（VoiceReportAiccs），可以在呼叫結(jié)束后獲取呼叫的記錄信息，包括通話類型、通話的開(kāi)始及結(jié)束時(shí)間、通話時(shí)長(zhǎng)、結(jié)束原因等。

協(xié)議說(shuō)明

類別 說(shuō)明
協(xié)議 HTTP + JSON
編碼 UTF-8

請(qǐng)求說(shuō)明

請(qǐng)求內(nèi)容為JSON Array格式。
  • 請(qǐng)求樣例：
    [
  {
    "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": "執(zhí)行完成",
    "out_id": "123456",
    "toll_type": "LOCAL"
  }
]
  • 字段說(shuō)明：
    名稱 類型 示例 描述
    status_code String 200003 呼叫結(jié)果狀態(tài)碼，狀態(tài)碼說(shuō)明請(qǐng)參見(jiàn)呼叫狀態(tài)碼。
    callee String 130****0000 被叫號(hào)碼。
    ring_time String 2021-04-28 10:02:40 被叫響鈴時(shí)間，即發(fā)起外呼后被叫收到請(qǐng)求開(kāi)始響鈴的時(shí)間。
    說(shuō)明 若被叫未響鈴，則該字段為空。
    duration String 10 通話時(shí)長(zhǎng)，未接通為0。
    voice_type String voice 話單類型。取值：
    • voice：普通話單。
    • asr：asr話單。
    • smart_transfer：智能外呼轉(zhuǎn)接話單。
    originate_time String 2021-04-28 10:02:34 呼叫發(fā)起時(shí)間，即通話由云通信側(cè)向運(yùn)營(yíng)商發(fā)起時(shí)間。
    b_start_time String 2021-04-28 10:03:40 通話接通時(shí)間，即被叫接起電話時(shí)間，未接通則為空。
    end_time String 2021-04-28 10:03:40 通話結(jié)束時(shí)間。
    call_id String 122628733198^10942206**** 呼叫ID。
    caller String 20200900**** 主叫號(hào)碼。
    status_msg String 執(zhí)行完成 結(jié)果描述。
    out_id String 123456 擴(kuò)展字段回傳，將調(diào)用API時(shí)傳入的字段返回，智能外呼SaaS助手相關(guān)API的out_id內(nèi)容為ALICOM_SMART_SAAS^111111^2222222，其中的111111為批次任務(wù)ID。
    toll_type String LOCAL 通話類型。取值：
    • LOCAL ：市話。
    • PROVINCE：省內(nèi)長(zhǎng)途。
    • DOMESTIC： 國(guó)內(nèi)長(zhǎng)途。
    • INTERNATIONAL：國(guó)際長(zhǎng)途。

響應(yīng)說(shuō)明

  • 響應(yīng)樣例：
    {
  "code": 0,
  "msg": "接收成功"
}
  • 字段說(shuō)明：
    名稱 類型 是否必須 說(shuō)明 示例值
    code Number 是 應(yīng)答編碼。 0
    msg String 否 描述信息。 接收成功
說(shuō)明
  • 系統(tǒng)僅校驗(yàn)返回值的code是否為數(shù)字，不校驗(yàn)內(nèi)容。若HTTP狀態(tài)碼為200，請(qǐng)求成功。HTTP狀態(tài)碼非200或響應(yīng)超時(shí)情況下，系統(tǒng)會(huì)進(jìn)行重試推送。
  • 若出現(xiàn)系統(tǒng)異常、消費(fèi)失敗等情況，建議HTTP響應(yīng)碼返回50X。

重新推送

第一次推送失敗后，間隔1分鐘、5分鐘、10分鐘后會(huì)進(jìn)行重推，直至推送成功為止。如果推送3次后仍失敗，不再重試。