列舉類型說明
概述
本文檔定義了 CDR 推送中使用的所有列舉類型及其對應的值和說明。理解這些列舉類型對於正確解析和處理 CDR 數據至關重要。
callType - 通話類型
通話類型表示通話的性質和方向。
| 代碼 | 名稱 | 說明 |
|---|---|---|
| 1 | INBOUND_CALL | 入站通話 (客戶主動撥入) |
| 2 | OUTBOUND_CALL | 出站通話 (座席主動撥出) |
| 3 | AUTO_OUTBOUND_CALL | 自動外撥 (系統自動撥出) |
| 4 | IVR_OUT_CALL | IVR 外撥 (IVR 系統發起的通話) |
使用說明
- INBOUND_CALL (1)：通常來自客戶的傳入呼叫，路由到座席隊列或 IVR
- OUTBOUND_CALL (2)：座席使用系統撥出的電話，通常用於主動聯繫客戶
- AUTO_OUTBOUND_CALL (3)：系統根據任務配置自動撥出，用於外撥任務
- IVR_OUT_CALL (4)：IVR 語音導航系統發起的通話，通常用於自動催收或通知
deviceType - 設備類型
設備類型表示參與通話的各方設備身份。
| 代碼 | 名稱 | 說明 |
|---|---|---|
| 1 | AGENT | 座席設備 (座席端電話或軟電話) |
| 2 | CUSTOMER | 客戶設備 (客戶的終端電話) |
| 3 | PSTN | PSTN 外線 (公網電話線路) |
使用說明
- AGENT (1)：座席使用的設備，可以是 IP 電話、軟電話或移動設備
- CUSTOMER (2)：客戶側設備，通常是普通電話或手機
- PSTN (3)：公網側的設備，用於標記外線或中繼線
cdrType - CDR 類型
CDR 類型表示通話的業務分類。
| 代碼 | 名稱 | 說明 |
|---|---|---|
| 1 | 被轉接 | 通話被轉接 |
| 2 | 外撥 | 外撥任務通話 |
| 3 | 內線通話 | 內部分機間通話 |
| 4 | 轉接 | 轉接操作 |
| 5 | 諮詢 | 諮詢操作 |
| 6 | 監聽 | 監督者監聽 |
| 7 | 強制插話 | 監督者強制插話 |
| 8 | 耳語 | 監督者耳語指導 |
使用說明
- 被轉接 (1)：通話被其他座席轉接
- 外撥 (2)：通過外撥任務系統發起的通話
- 內線通話 (3)：企業內部分機間的通話
- 轉接 (4)：座席主動進行的轉接操作
- 諮詢 (5)：座席在通話中進行的諮詢操作
- 監聽 (6)：監督者監聽座席通話
- 強制插話 (7)：監督者打斷並參與通話
- 耳語 (8)：監督者向座席進行無客戶聲音的指導
hangupCode - 掛機代碼
掛機代碼表示通話結束的原因。
| 代碼 | 說明 | 詳細說明 |
|---|---|---|
| 0 | 正常結束 | 通話正常完成，任一方正常掛機 |
| 1 | 客戶掛機 | 客戶主動掛斷通話 |
| 2 | 座席掛機 | 座席主動掛斷通話 |
| 3 | 無應答 | 客戶未應答 |
| 4 | 忙線 | 客戶線路忙 |
| 5 | 拒接 | 客戶拒接來電 |
| 6 | 空號 | 撥打號碼不存在 |
| 7 | 停機 | 客戶號碼已停機 |
| 8 | 呼出失敗 | 系統撥出失敗 |
| 9 | 超時掛機 | 通話超時自動掛機 |
| 10 | 網絡失敗 | 網絡連接失敗 |
| 11 | 轉接掛機 | 通話轉接過程中掛機 |
| 12 | 異常掛機 | 異常掛機 |
| 13 | 監督者掛機 | 監督者掛斷通話 |
| 14 | 被轉接掛機 | 被轉接的通話掛機 |
| 15 | 系統掛機 | 系統因故掛機 |
使用說明
- 0-2：正常的通話結束情況
- 3-7：客戶側的問題或無法接通的情況
- 8-10：系統或網絡方面的問題
- 11-15：特殊場景下的掛機原因
state - 通話狀態
通話狀態表示通話當前所處的階段。
| 代碼 | 名稱 | 說明 |
|---|---|---|
| 0 | INIT | 初始狀態 |
| 1 | DIALING | 正在撥號 |
| 2 | CONNECTING | 連接中 (振鈴) |
| 3 | CONNECTED | 已連接 (通話中) |
| 4 | HOLDING | 保持中 |
| 5 | TRANSFER | 轉接中 |
| 6 | CONSULT | 諮詢中 |
| 7 | CONFERENCE | 會議中 |
狀態轉移說明
INIT → DIALING → CONNECTING → CONNECTED
↓
HOLDING ↔ CONSULT → TRANSFER
↓
CONFERENCEonlineState - 在線狀態
在線狀態表示座席或設備是否在線。
| 代碼 | 名稱 | 說明 |
|---|---|---|
| 0 | OFFLINE | 離線 |
| 1 | ONLINE | 在線 |
muted - 靜音狀態
靜音狀態表示設備是否已靜音。
| 代碼 | 名稱 | 說明 |
|---|---|---|
| 0 | NOT_MUTED | 未靜音 |
| 1 | MUTED | 已靜音 |
language - 語言代碼
語言代碼表示語音識別或轉錄的語言。
| 代碼 | 說明 |
|---|---|
zh-TW | 繁體中文 (台灣) |
zh-CN | 簡體中文 (中國大陸) |
en | 英文 |
en-US | 美式英文 |
en-GB | 英式英文 |
ja | 日文 |
ko | 韓文 |
ivr - IVR 標誌
IVR 標誌表示通話是否經過 IVR 處理。
| 代碼 | 名稱 | 說明 |
|---|---|---|
| 0 | NO_IVR | 未經過 IVR |
| 1 | WITH_IVR | 經過 IVR 處理 |
eventType - 事件類型
事件類型表示通話過程中發生的各類事件。
| 代碼 | 名稱 | 說明 |
|---|---|---|
| 1 | CALL_START | 通話開始 |
| 2 | CALL_END | 通話結束 |
| 3 | HOLD | 通話保持 |
| 4 | RESUME | 通話恢復 |
| 5 | IVR_TRANSFER | IVR 轉接 |
| 6 | TRANSFER | 轉接 |
| 7 | CONSULT | 諮詢 |
| 8 | CONFERENCE | 會議 |
| 9 | RECORDING_START | 錄音開始 |
| 10 | RECORDING_STOP | 錄音停止 |
| 11 | MONITOR_START | 監聽開始 |
| 12 | BARGE_START | 強制插話開始 |
| 13 | WHISPER_START | 耳語開始 |
priority - 優先級
優先級用於外撥任務中，表示重撥或聯絡的優先順序。
| 代碼 | 說明 |
|---|---|
| 1 | 最高優先級 |
| 2 | 高優先級 |
| 3 | 中等優先級 (預設) |
| 4 | 低優先級 |
| 5 | 最低優先級 |
taskStatus - 任務狀態
任務狀態表示外撥任務的生命週期狀態。
| 代碼 | 名稱 | 說明 |
|---|---|---|
| 0 | DRAFT | 草稿 |
| 1 | RUNNING | 運行中 |
| 2 | PAUSED | 已暫停 |
| 3 | STOPPED | 已停止 |
| 4 | COMPLETED | 已完成 |
| 5 | FAILED | 失敗 |
| 6 | CLOSED | 已關閉 |
常見組合範例
典型的入站通話
json
{
"callType": 1,
"state": 3,
"hangupCode": 1,
"cdrType": 1,
"ivr": 1
}說明：客戶撥入 (INBOUND_CALL)，通話已連接，經過 IVR，客戶掛機結束。
典型的外撥通話
json
{
"callType": 2,
"state": 3,
"hangupCode": 2,
"cdrType": 2,
"ivr": 0
}說明：座席外撥 (OUTBOUND_CALL)，通話已連接，座席掛機結束，無 IVR 參與。
典型的自動外撥
json
{
"callType": 3,
"state": 3,
"hangupCode": 1,
"cdrType": 2,
"ivr": 0
}說明：自動外撥 (AUTO_OUTBOUND_CALL)，通話已連接，客戶掛機結束。
注意事項
- 版本相容性：列舉值可能隨系統版本升級而變更，建議使用代碼而非名稱
- 擴展性：新的列舉值可能會被添加，業務系統應預留擴展空間
- 組合檢查：某些列舉值的組合可能無法出現，例如不可能同時有多個 hangupCode
- 本地化：說明文本可根據系統語言設定進行本地化