本文說明 CCAI Platform 中使用的通話和即時通訊原因代碼和狀態。
承載狀態
| 可用時間 | 服務專員閒置且準備好處理互動的總時間。 |
| 登入時間 | 服務專員登入的總時間。 |
| 通話收尾時間 | 服務專員在結束互動後,處於收尾狀態的總時間。 |
| 休息時間 | 服務專員處於「休息」狀態的總時間。 |
| 閒置時間 | 服務專員處於「閒置」狀態的總時間。 |
| 通話時間 | 服務專員處理通話的總時間。 |
| 即時通訊時間 | 代理處理即時通訊的總時間。 |
| 用餐時間 | 服務專員處於「用餐」狀態的總時間。 |
| 未接來電時間 | 服務專員處於「未接來電」狀態的總時間。 |
| 錯過聊天時間 | 服務專員處於「錯過即時通訊」狀態的總時間。 |
| 離線時間 | 服務專員登出的總時間。 |
| 特殊任務時間 | 服務專員處於「特殊工作」狀態的總時間。 |
| 無法使用的時間 | 服務專員處於「無法提供服務」狀態的總時間。 |
| 無回應時間 | 代理處於「無回應」狀態的時間總和。 |
查看並找出失敗原因代碼
本頁面可協助您找出:
您可以查看下列失敗原因代碼:
在「個別通話記錄」標準報表中。
使用 API。
通話失敗原因
| 程式碼 | 指標名稱 | 說明 |
|---|---|---|
| nothing:0 | 未發生錯誤 - 呼叫 | 未失敗的呼叫總數。 |
| unknown: 10001 | 不明 - 通話 | 因不明原因失敗的呼叫總數。 |
| expired: 11001 | 已過期 - 通話 | 因連線逾時而失敗的呼叫總數。 |
| transfer_expired: 11002 | 轉移作業已過期 | 因轉接連線逾時而失敗的通話總數。 |
| eu_canceled: 20001 | 已取消 | 使用者在與服務專員通話時掛斷的通話總數。 |
| eu_rejected: 20002 | 已遭拒 | 使用者拒接的外撥通話總數。 |
| eu_abandoned: 20003 | 已捨棄 | 使用者在佇列中等待時放棄的通話總數。 |
| eu_in_menu_abandoned: 20004 | 在選單中放棄 | 使用者在互動式語音應答選單中放棄的通話總數。 |
| eu_repeated_voicemail: 20005 | 重複的語音留言 |
使用者已留下待回覆的語音留言,因此失敗的通話總數。 如要進一步瞭解語音留言設定,請參閱「非營業時間的來電和即時通訊轉接」。 |
| eu_repeated_callback: 20006 | 重複回呼 | 使用者已要求回電,因此失敗的通話總數。 |
| eu_busy: 21001 | 忙碌 | 使用者忙線時,外撥通話的總數。 |
| eu_wrong_number: 21002 | 打錯電話 | 撥打至無效電話號碼的外撥通話總數。 |
| eu_no_answer: 21003 | 無人接聽 | 使用者未接聽的外撥通話總數。 |
| eu_noti_failed: 22001 | 通知失敗 | 因服務專員未啟用瀏覽器通知,而未接通服務專員的通話總數。 |
| ag_canceled: 30001 | 已取消代理 | 與服務專員連線時失敗的通話總數。可能原因包括服務專員關閉瀏覽器或發生網路錯誤。 |
| ag_hung_up_to_callback: 30002 | 通話狀態 | 服務專員因音訊品質不佳或網路問題而掛斷電話,並打算回撥。 |
| ag_ignored: 30002 | 已忽略代理 | 服務專員未接聽的來電總數。 |
| ag_mic_no_device: 31001 | Agent No Mic | 因服務專員沒有麥克風而失敗的通話總數。 |
| ag_mic_denied: 31002 | 已拒絕授予代理麥克風權限 | 因服務專員未啟用麥克風存取權而失敗的通話總數。 |
| ag_called_blocked_num 32002 | 代理撥打已封鎖的號碼 | 取用端封鎖呼叫。 |
| 無法撥通 32003 | 代理連線逾時 | 因服務專員的裝置失去網路連線或無法向伺服器註冊,而無法接通的通話總數。 |
| voip_twilio_error: 41001 | VOIP 錯誤 | 因語音供應商問題而失敗的通話總數。 |
| voip_tokbox_error: 42001 | VOIP 錯誤 | 因 Tokbox 語音供應商問題而失敗的通話總數。 |
| voip_invalid_token: 43001 | VOIP 權杖無效 | 因語音服務供應商提供無效權杖而失敗的通話總數。 |
| voip_conn_general: 44001 | VOIP 一般 | 因一般語音供應商問題而失敗的通話總數。 |
| voip_conn_timeout: 44002 | VOIP 逾時 | 因語音服務供應商連線逾時而失敗的通話總數。 |
| voip_conn_signal: 44003 | VOIP 訊號 | 因與語音服務供應商連線不佳而失敗的通話總數。 |
| voip_nexmo_error: 45001 | VOIP 錯誤 | 因 Nexmo 語音供應商問題而失敗的通話總數。 |
| stuck_due_to_api_error: 50001 | 因 API 而卡住 | 因 API 問題而失敗的呼叫總數。 |
| group_deleted_no_substitute: 50002 | Group Deleted - Call | 因串接群組遭刪除且沒有替代方案,導致呼叫失敗的總次數。 |
| menu_deleted: 50003 | 已刪除選單 | 使用者進入佇列後,佇列遭到刪除而導致通話失敗的總數。 |
| direct_pstn_call_to_fallback_number: 60001 | 導向備用廣告 | 轉接至備用號碼的通話總數。 |
對話失敗原因
| 程式碼 | 指標名稱 | 說明 |
| nothing:0 | 沒有錯誤 - Chat | 未失敗的對話總數。 |
| unknown: 1 | 不明 - Chat | 因不明原因失敗的對話總數。 |
| no_response: 2 | 無回覆 | 因使用者未回應而結束的即時通訊總數。 |
| expired: 3 | 已過期 - Chat | 因連線逾時而失敗的對話總數。 |
| after_hours: 4 | 會後活動 | 在非營業時間進入佇列的即時通訊總數。 |
| expired_menu_selection: 31 | 過期菜單 | 使用者選取已不存在的佇列,導致即時通訊無法進行的總次數。 |
| end_user_opt_out: 41 | 已選擇不採用 | 使用者選擇不錄音的即時通訊總數。 |
| over_cap_email: 50001 | Overcapacity Email | 因佇列超出容量,而由使用者傳送電子郵件的即時通訊總數。 |
| group_deleted_no_substitute: 60001 | 群組已刪除 - 即時通訊 | 因串聯群組遭刪除且沒有替代方案,而導致失敗的即時通訊總數。 |
資料字典 - API 和計算指令碼範例
以下是 API 和計算指令碼範例。
API 和計算指令碼範例
您可以執行這個範例指令碼,試用管理員入口網站資訊主頁中的幾項 CCAI Platform 指標。說明如何擷取及計算任何指標。
這個範例會逐步說明變數、函式和計算指令碼的定義,以及如何計算總量和服務水準。
變數
呼叫陣列:新增呼叫陣列,並設為變數 callsArray。
Call types:CCAI 平台中所有通話類型的陣列。
//You can remove elements from this array to test metrics of only a certain type of calls; for example:
總時數:總時數變數。根據要求中的參數計算時差。
SLA:使用管理員入口網站中設定的門檻計算。依設定的金額變更變數。這個範例顯示 60 秒的服務水準協議,例如:
函式
通話記錄函式://checkCallRecord 的設計目的是驗證通話記錄是否處於適當狀態、是否未以特定方式失敗,以及在某些情況下,連線是否為空值;
通話總量函式:getTotalVolumeOfCalls 旨在傳回通話總量,例如:
服務等級函式:getServiceLevel 旨在傳回呼叫類型的服務等級,例如:
計算指令碼
計算指令碼範例。
總聯絡量:
// TOTAL VOLUME SECTION
for(var i = 0; i\<call_type.length;i++){
var vol = getTotalVolumeOfCalls(callsArray,call_type\[i\]);
if(vol \> 0){
var volPerHour = Math.round(vol/total_hours\*10)/10
var stringToPrint = \"the per hour volume of \"+call_type\[i\]+\" is \"+
volPerHour.toString()
console.log(stringToPrint);
};
}
服務水準協議:
// SLA SECTION
for(var i = 0;i\<call_type.length;i++){
var SLACalc =
(getServiceLevel(callsArray,call_type\[i\])/getTotalVolumeOfCalls(callsArray,call_type\[i\],false,\['eu_in_menu_abandoned'\]));
if (isNaN(SLACalc) == false){
var stringToPrint = \"the SLA of \"+call_type\[i\]+\" is \"+
SLACalc.toString();
console.log(stringToPrint);
} else {
var stringToPrint = \"the SLA of \"+call_type\[i\]+\" cannot be
calculated due to lack of volume\";
console.log(stringToPrint);
}
};
即時通訊狀態定義
常見的即時通訊狀態
| Chat 狀態 | 說明 |
| 已排入佇列 | 即時通訊正在等候服務專員 |
| 已指派 | 即時通訊已指派給服務專員 |
| 執行中 | 代理和使用者正在進行即時通訊 |
| 已完成 | 對話已順利結束 (結束原因列於下方) |
| 已捨棄 | 使用者在指派給服務專員前取消即時通訊 |
| 碰到其他球員後轉向 | 即時通訊已取消,並轉為傳送「容量超載」電子郵件 |
| 失敗 | 對話失敗 (失敗原因列於下方) |
對話結束狀態
| 已結束的即時通訊狀態 | 說明 |
|---|---|
| 已完成 | 對話已順利結束,沒有其他資訊 |
| 結束:由服務專員中斷 | 即時通訊已結束,服務專員已中斷連線 |
| 已結束:使用者中斷連線 | 即時通訊已結束,使用者已中斷連線 |
| 完成:沒有訊息 | 對話已結束,沒有回覆 |
| 已完成:沒有因代理程式而中斷連線的訊息 | 即時通訊已結束,沒有回覆,服務專員已中斷連線 |
| 已完成:沒有使用者中斷連線的訊息 | 即時通訊已結束,使用者未回覆且已中斷連線 |
| 逾時:代理未傳送訊息,導致逾時 | 即時通訊逾時,且服務專員在處理即時通訊時未傳送任何訊息。如果是從虛擬服務專員轉接的即時通訊,則只會計算真人服務專員的訊息。 |
| 逾時:使用者逾時,未傳送訊息 | 即時通訊逾時,且使用者在即時通訊期間從未傳送訊息,包括在轉接前傳送給虛擬服務專員的訊息。如果使用者在即時通訊中至少傳送過一則訊息,之後就沒有再傳送訊息,即時通訊會記錄為「逾時:使用者停止回應」。 |
| 逾時:代理停止回應 | 最近一則未回覆的訊息來自使用者,但即時通訊逾時;服務專員先前曾回覆,但後來停止。 |
| 逾時:使用者停止回應 | 使用者停止回應,因此即時通訊已逾時。使用者先前在即時通訊中,至少傳送一則訊息給虛擬服務專員或服務專員,之後就沒有再傳送訊息。 |
Chat 結束原因值 (BigQuery Chat 匯出)
| 值 | 定義 |
|---|---|
| 0 | 沒有特定結束原因。顯示的狀態 (「已結束」/「已結束:由服務專員中斷連線」/「已結束:由使用者中斷連線」) 是由 disconnected_by 欄決定 (0 = 未知、1 = 服務專員、2 = 使用者)。 |
| 1 | 沒有任何回應。對應「已完成:沒有訊息」狀態,並與 disconnected_by 結合,如前所述。 |
| 2 | 逾時:代理未傳送訊息,導致逾時 |
| 3 | 逾時:代理停止回應 |
| 4 | 逾時:代理停止回應 |
| 5 | 逾時:使用者停止回應 |
| 6 | 使用者選擇不採用 (例如回覆「STOP」簡訊) |
| 7 | 消費者簽到逾時 |
| 8 | API 整合結束即時通訊 (直接存取點 end_chat 結果) |
對話失敗原因
| 失敗原因 | 定義 |
|---|---|
| 失敗 | 對話工作階段因不明原因失敗 |
| 已過期 | 在佇列中等待的即時通訊已過期,且沒有服務專員接聽 |
通話狀態定義
通話成效記錄報表可能會顯示下列通話狀態。
| 通話狀態 | 說明 |
|---|---|
| 已捨棄 | 來電在佇列中等待,但來電者在服務專員接聽前就掛斷。不含選單內和短暫放棄。 |
| 忙碌 | 使用者忙線中 |
| 已取消 | 使用者取消通話 |
| Completed | 呼叫成功完成,未發生任何錯誤 |
| Error | 呼叫有誤 |
| 失敗 | 通話因錯誤而結束。包含失敗原因,提供更多背景資訊。 |
| 無人接聽 | 使用者未接聽 |
| Recovered | 回撥失敗的通話。新呼叫是原始呼叫的子項。包括回呼是否順利完成。 |