自動語音應答和通話佇列歷史報告
重要
GCC High 和 DoD 客戶需要針對 GCC High 和 DoD 使用自動語音應答和通話佇列歷史報告。
此 Power BI 範本提供三個報告,可讓組織報告自動語音應答和通話佇列處理的通話數目。 它也會提供代理程式效能深入解析。
2024 年 8 月 12 日發布的 V3.1.8
Teams 自動語音應答 & 通話佇列歷史報告 Power BI 範本提供下列三個報告:
這些報告會使用來自 Voice Applications Analytics Collector (VAAC) 服務的數據。
V3.x.x 必要條件
Power BI Desktop
您必須安裝 Power BI Desktop。 您可以從 windows 市集 Microsoft安裝和使用免費版本。
重要
Power BI Desktop 會每月更新並發行,並結合客戶意見反應和新功能。 僅支援最新版本的 Power BI Desktop。 連絡支援服務 Power BI Desktop 要求客戶升級至最新版本。 您可以從 Windows 市集取得最新版本的 Power BI Desktop,或是單一可執行檔,其中包含您在計算機上下載並安裝的所有支持語言。
Power BI 服務
這些報告可以發佈到 Power BI 服務。
報告發佈後:
- 移至數據集 設定。
- 展開 [ 數據源認證 ] 區段。
- 選取 [編輯認證]。
- 將 驗證方法 設為
OAuth2
。 - 確定 跳過測試連線 已啟用。
- 選 取 [登入 ] 並提供您的認證。
完成後,您可以 設定排定的 重新整理數據集。
存取許可權
使用下列其中一種方法來控制歷史報告的存取權:
語音應用程式原則
若要控制哪些自動語音應答、通話佇列和代理程式使用者可以在不提供 Teams 系統管理中心存取權的情況下進行報告,請建立語音應用程式原則,授予他們歷史報告的存取權,並將他們指派為已授權的使用者給適當的自動語音應答和通話佇列。 身為系統管理員,您可以在小組系統管理中心或使用PowerShell建立語音應用程式原則。
如需建立語音應用程式原則的詳細資訊,請參閱 在 Microsoft Teams 中管理語音應用程式原則。
提示
建議您使用語音應用程式原則來控制存取。 透過語音應用程式原則和授權使用者,您可以控制使用者可以報告的自動語音應答、通話佇列和代理程式。 如有必要,原則仍可讓用戶報告所有自動語音應答、通話佇列和代理程式,而不提供Teams系統管理中心的存取權。
呼叫品質儀錶板 (CQD) 管線 [舊版]
如果您希望使用者報告租使用者中 的所有 自動語音應答、通話佇列和代理程式,而且您想要將使用者存取權授與 Teams 系統管理中心以執行其他使用方式報告,請將 [ 檢視報告 ] 和 [ 檢視 EUII ] 欄位設為 [ 是],將 CQD 存取角色指派給使用者。
如需詳細資訊,請參閱 CQD 存取角色。
注意事項
如果用戶獲指派 CQD 存取角色和語音應用程式原則,則 CQD 角色會優先使用,且使用者可以看到租使用者中所有的自動語音應答、通話佇列和代理程式。
V3.x.x 桌面安裝
下列步驟假設 Power BI Desktop 用戶端已安裝在您的電腦上,而且您的帳戶具有存取 CQD 資料管線的必要許可權。
執行下列步驟:
下載並將 Teams 自動語音應答 & 通話佇列歷程記錄報告 V3.1.8.zip 檔案儲存在您的電腦上。
開啟 zip 檔案。
開啟
Teams Auto Attendant & Call Queue Historical Reports V3.1.8.pbit
範本檔案。 Power BI Desktop 應該會啟動。選取 [DataSource]、 [報表層級] 和 [UTC 位移]。
-
DataSource:選取專案
api.interfaces.records.teams.microsoft.com
。 -
報表層級:
- 選
Per Call
取 [ (預設) 以擷取所有個別通話記錄。 - 選
Per Day
取以擷取每天的匯總總計。
- 選
-
UTC Offset:選取代表報告呈現時區的 UTC 位移。 只有在 [報表層級 ] 設定為
Per Call
每天與每次通話
每個通話 報告會擷取每個自動語音應答的個別通話記錄、通話佇列,以及授權使用者的代理人,並在Power BI用戶端中取得這些記錄。 每個通話報告也可讓通話記錄顯示在用戶選取的本機時區。 對於某些客戶,尤其是使用 CQD 存取角色來控制存取的客戶,每個通話報告可能會達到 90,000 個預設值或每個查詢記錄的 200,000 個上限。 在此情況下,應該選取 [每天報告] 選項。
每天 報告會為每個自動語音應答、通話佇列和專員擷取一筆每日摘要記錄。 這會導致傳回客戶端的記錄較少,降低每筆查詢記錄達到 90,000 個預設值或 200,000 筆的可能性。 每天報告是以 UTC-00:00 天 (00:00:00-23:59:59 UTC) 為基礎,且會忽略使用者提供的任何 UTC 位移。
-
DataSource:選取專案
使用您的 Teams 帳戶登入。
- 依序選取 [檔案]、[ 選項與設定],以及 [ 數據源設定]。
- 選取 [編輯許可權],然後選取 [ 編輯]。
- 選 取 [組織帳戶],然後 [登入]。
- 依序選 取 [儲存]、[ 確定],然後 [ 關閉]。
選 取功能區列中的 [重新整理],然後重新整理數據。
自動語音應答和通話佇列分析的數據延遲
數據通常會在通話完成後的 30 分鐘內取得,但在某些情況下,可能需要幾個小時才會顯示數據。
您必須重新整理報表,才能查看任何新數據。
自動語音應答和通話佇列歷史報告
雲端自動語音應答分析報告
解讀報表
標註 | 標題 | 描述 |
---|---|---|
1 | 日期 | 報表的開始和結束日期。 使用此滑桿選取要報告的日期範圍。 查看已知問題 |
2 | 時間範圍 | 報表的開始和結束時間。 報告涵蓋從開始日期/開始時間到結束日期/結束時間的所有日期/時間。 使用此滑桿選取要報告的時間範圍。 |
3 | 自動語音應答資源帳戶 | 要回報的資源帳戶。 若要查看特定自動語音應答的通話,請選取指派給該自動語音應答的所有資源帳戶。 如果完整資源帳戶名稱是 aa_test@microsoft.com,則此值為: aa_test 預設:全部 |
4 | 快速統計數據 -> 來電 | 明細顯示開始日期/開始時間和結束日期/結束時間之間的來電總數。 提示:將游標停留在此區段中的任何公製指標上,以顯示包含組成總計之個別通話的工具提示。 |
5a | 快速統計數據 -> 使用統計數據 | 明細會顯示自動語音應答的平均通話持續時間,以及來電者動作的平均次數。 |
5b | 來電者動作計數 | 按 (鍵的來電動作數目明細、語音命令) |
6 | 快速統計數據 -> 目錄搜尋方法 | 明細顯示來電者如何使用目錄搜尋選項。 如果未為此服務設定自動語音應答,或是來電者未使用,報表的這個區段會是空白的。 目錄搜尋方法圖例定義:
|
7 | 通話結果 | 明細顯示來電者接聽的通話處理方式。 通話結果圖例定義:
提示:將游標停留在此區段中的任何公製指標上,以顯示包含組成總計之個別通話的工具提示。 |
8 | 明細會顯示來電者透過自動語音應答的路徑,以及最終的通話結果。 欄定義:
提示:將游標停留在此區段中的任何公製指標上,以顯示包含組成總計之個別通話的工具提示。 |
已知的問題
- 系統只會回報第一個自動語音應答中接聽來電的來電和來電者動作。 當一個自動語音應答轉接至另一個自動語音應答) 時,系統會 (自動語音應答中的來電和來電動作。
- 系統會顯示自動語音應答資源帳戶標識碼的名稱,而非自動語音應答名稱。 若要顯示自動語音應答的所有流量,您必須選取指派給自動語音應答的所有資源帳戶。
- 只有 28 天的通話記錄可供使用。 自動語音應答數據被視為個人資料,並受限於數據隱私權保留原則。
- [日期] 選取器有時會顯示可用資料範圍外的日期,併產生空白報表。 將日期變更為過去 28 天內以解決問題。
雲端通話佇列分析報告
解讀報表
標註 | 標題 | 描述 |
---|---|---|
1 | 日期 | 報表的開始和結束日期。 使用此滑桿選取要報告的日期範圍。 查看已知問題 |
2 | 時間範圍 | 報表的開始和結束時間。 報告涵蓋從開始日期/開始時間到結束日期/結束時間的所有日期/時間。 使用此滑桿選取要報告的時間範圍。 |
3 | 呼叫佇列資源帳戶 | 要回報的資源帳戶。 若要查看特定通話佇列的通話,請選取指派給該通話佇列的所有資源帳戶。 如果完整資源帳戶名稱為 cq_test@microsoft.com,則此值為: cq_test 預設:全部 |
4 | 快速統計數據 -> 來電 | 明細顯示開始日期/開始時間和結束日期/結束時間之間的來電總數。 提示:將游標停留在此區段中的任何公製指標上,以顯示包含組成總計之個別通話的工具提示。 |
5 | 快速統計數據 -> 平均等待時間 (秒) | 明細顯示來電者接聽或取消通話之前,通話佇列中的平均通話持續時間。 |
6 | 通話結果 | 明細顯示來電者接聽的通話處理方式。 通話結果圖例定義:
提示:將游標停留在此區段中的任何公製指標上,以顯示包含組成總計之個別通話的工具提示。 |
7 | 通話量、已放棄的通話、專員加入計數 | 明細顯示每小時接到和放棄的來電數目,以及當時選擇加入通話佇列的代理商數目上限。 |
8 | 平均會話長度 (秒) | 明細顯示每一個通話結果之前,通話等待的時間長短。
|
9 | 呼叫溢出/逾時/無代理程式目的地 | 明細顯示收到「通話溢位」、「通話逾時」或「無專員」例外處理處理的來電傳送至何處。
|
已知的問題
- 只有在第一個接聽來電的通話佇列中,會報告來電和來電者的動作。 當一個通話佇列移轉到另一個通話佇列時,會 (串聯的通話佇列) 未回報。
- 顯示 [通話佇列] 資源帳戶標識碼的名稱,而不是 [通話佇列名稱]。 若要顯示 [通話] 佇列的所有流量,您必須選取指派給 [通話] 佇列的所有資源帳戶。
- 只有 28 天的通話記錄可供使用。 通話佇列數據被視為個人資料,並受限於數據隱私權保留原則。
- [日期] 選取器有時會顯示可用資料範圍外的日期,併產生空白報表。 將日期變更為過去 28 天內以解決問題。
雲端通話佇列代理時間軸報告
解讀報表
標註 | 標題 | 描述 |
---|---|---|
1 | 日期 | 報表的開始和結束日期。 使用此滑桿選取要報告的日期範圍。 查看已知問題 |
2 | 專員用戶名稱 | 要回報的代理程式。 如果完整使用者名稱為 user@microsoft.com,則此值為: 使用者 預設:全部 |
3 | 呼叫佇列資源帳戶 | 要回報的資源帳戶。 若要查看特定通話佇列的通話,請選取指派給該通話佇列的所有資源帳戶。 預設:全部 |
4 | 快速統計數據 -> 來電 | 明細顯示接聽的電話總數、每個代理人接聽的電話平均數目,以及接聽來電的平均通話長度。 提示:將游標停留在此區段中的任何公製指標上,以顯示包含組成總計之個別通話的工具提示。 |
5 | 依日期) (接聽的電話 | 明細顯示依日期接聽代理人的來電數 |
6 | 明細顯示佇列中每個代理人接聽的電話數目,以及這些通話的平均通話持續時間。 | |
7 | 依小時 (接聽的電話) | 明細顯示每小時接聽專員接聽的電話數 |
8 | 明細會顯示由專員依 [通話佇列] 接聽的電話數目。 欄定義:
|
已知的問題
- 只有 28 天的通話記錄可供使用。 通話佇列和專員數據被視為個人資料,並受限於數據隱私權保留原則。
- 顯示 [通話佇列] 資源帳戶標識碼的名稱,而不是 [通話佇列名稱]。 若要顯示 [通話] 佇列的所有流量,您必須選取指派給 [通話] 佇列的所有資源帳戶。
- 顯示專員的 UPN 名稱,而非其名稱。
- [日期] 選取器有時會顯示可用資料範圍外的日期,併產生空白報表。 將日期變更為過去 28 天內以解決問題。
- 在某些情況下,代理人的接聽來電計數可能與Teams用戶端通話記錄中顯示的通話數目不同。 Teams 用戶端通話記錄正確無誤。 支援正在調查中,但目前沒有可供修復的估計時間。
- 當代理人因透過通話溢出例外處理重新導向,在不同的通話佇列中接聽電話時,該通話會計入發生例外的原始通話佇列,而不是他們接聽來電的佇列。
- 專員接聽的回撥電話不會擷取,導致通話佇列報告中接聽的通話數目與專員時程表報告之間有差異。
- 顯示專員個別通話的代理程式工具提示會顯示所有通話,而非只顯示所選日期範圍內的通話。
自動語音應答和通話佇列歷史報告欄位定義
fAutoAttendant 數據表欄位描述
名稱 | 數據類型 | 描述 |
---|---|---|
AA 名稱 | 發簡訊 | 附加至自動語音應答的資源帳戶名稱 如果完整資源帳戶名稱是 aa_test@microsoft.com,則此值為: aa_test |
AA 開始日期本機 | 日期 | 自動語音應答通話開始日期 - 根據選取的 UTC Offset) ,本機 ( |
AA 開始時間 | 整數 | 自動語音應答通話開始時間 - 根據選取的 UTC Offset) ,本機 ( |
AA 開始時間:當地時間 | 日期/時間 | 自動語音應答通話開始時間 - 根據選取的 UTC Offset) ,本機 ( |
AA 開始時間 UTC | 日期/時間 | 自動語音應答通話開始時間 - UTC |
AACallerActionCount | 整數 | 摘要:加總 來電者在通話期間在自動語音應答中選取的動作數目 |
AACallerActionCountAverage (量) | 整數 | AACallerActionCount的平均值 - 零而非空白 |
AACallFlow | 發簡訊 | 請參閱 自動語音應答尺寸 -> AutoAttendantCallFlow |
AACallResult | 發簡訊 | 請參閱 自動語音應答尺寸 -> AutoAttendantCallResult |
AACallResultLegend | 發簡訊 | AACallResult 上的圖例專案。 可能的值為:
|
AAChainDuration | 小數 | 摘要:加總 自動語音應答中的通話持續時間 |
AAChainDurationAverage (量) | 小數 | AAChainDuration 的平均值 - 零而非空白 |
AAChainIndex | 整數 | |
AAConnectivityType | 發簡訊 | 請參閱 通用維度 -> PSTNConnectivityType |
AACount | 整數 | 摘要:加總 參與通話的自動語音應答數目 |
AADirectorySearchMethod | 發簡訊 | 請參閱自動 語音應答尺寸 -> AutoAttendantDirectorySearchMethod |
AADirectorySearchMethodCountDTMF (測量) | 整數 | 使用 DTMF 搜尋目錄的通話次數 - 零而非空白 |
AADirectorySearchMethodCountVoice (Measure) | 整數 | 使用語音搜尋目錄的通話次數 - 零而非空白 |
AADirectorySearchMethodLegend | 發簡訊 | AADirectorySearchMethod 的圖例專案。 可能的值為:
|
AATransferAction | 發簡訊 | 請參閱 自動語音應答維度 -> AutoAttendantTransferAction |
通話持續時間秒數 | 整數 | 通話持續時間 |
通話結束時間:當地時間 | 日期/時間 | 通話結束時間 - 根據選取的 UTC Offset) ,本機 ( |
通話結束時間 UTC | 日期/時間 | 通話結束時間 - UTC |
通話開始時間:本機時間 | 日期/時間 | 通話開始時間 - 根據選取的 UTC Offset) ,本機 ( |
通話開始時間UTC | 日期/時間 | 通話開始時間 - UTC |
每天 (會議標識碼) | 發簡訊 | 用於疑難解答目的 - 開啟票證時提供此資訊 |
每天 (對話框標識碼僅) | 發簡訊 | 用於疑難解答目的 - 開啟票證時提供此資訊 |
每天的 DocumentID (僅) | 發簡訊 | 用於疑難解答目的 - 開啟票證時提供此資訊 |
MM-DD | 發簡訊 | 自動語音應答每月通話 |
PSTNMinutes | 整數 | 摘要:加總 分鐘總使用量 |
TotalCallCount | 整數 | 摘要:加總 一律 1 - 用來提供所有通話的總和 |
TotalCallCountSum (量) | 整數 | TotalCallCount 的總和 |
雲端通話佇列分析報告
fCallQueueAnalytics 數據表欄位描述
名稱 | 數據類型 | 描述 |
---|---|---|
通話數 | 整數 | 摘要:加總 通話數目 |
已放棄通話數 | 整數 | 摘要:加總 已放棄的通話數目 |
通話次數加總 (量) | 整數 | 通話計數加總 - 零而非空白 |
呼叫計數已放棄 (量) | 整數 | 通話數已放棄 - 零而非空白 |
通話持續時間秒數 | 整數 | 摘要:加總 通話持續時間 |
通話持續時間秒數 AVG (量) | Number | 平均通話持續時間秒數 |
通話結束時間:當地時間 | 日期/時間 | 通話結束時間 - 根據選取的 UTC Offset) ,本機 ( |
通話結束時間 UTC | 日期/時間 | 通話結束時間 - UTC |
通話佇列代理人計數 | 整數 | 摘要:加總 在 [通話] 佇列中設定的代理程式數目 |
通話佇列代理人選擇加入計數 | 整數 | 摘要:加總 加入加入 [通話] 佇列的代理程式數目 |
通話佇列通話結果 | 發簡訊 | 請參閱 通話佇列維度 -> CallQueueCallResult |
通話佇列通話結果圖例 | 發簡訊 | 通話佇列結果的圖例專案。 可能的值:
|
通話佇列目標類型 | 發簡訊 | 請參閱 通話佇列維度 -> CallQueueTargetType |
通話佇列目標類型圖例 | 發簡訊 | 通話佇列目標類型的圖例專案。 可能的值:
|
通話開始時間:本機時間 | 日期/時間 | 通話開始時間 - 根據選取的 UTC Offset) ,本機 ( |
通話開始時間UTC | 日期/時間 | 通話開始時間 - UTC |
每次通話 (ConferenceID) | 發簡訊 | 用於疑難解答目的 - 開啟票證時提供此資訊 |
CQ 名稱 | 發簡訊 | 附加至通話佇列的資源帳戶名稱 如果完整資源帳戶名稱為 cq_test@microsoft.com,則此值為: cq_test |
CQHour | 整數 | 通話佇列通話開始時間 |
日期 | 日期/時間 | 通話佇列通話開始日期和時間 (小時) |
DateTimeCQName | 發簡訊 | 在 fCallQueueFinalStateAction 上篩選的唯一密鑰 |
每個通話僅 (對話框標識子) | 發簡訊 | 用於疑難解答目的 - 開啟票證時提供此資訊 |
每個通話僅 (DocumentID) | 發簡訊 | 用於疑難解答目的 - 開啟票證時提供此資訊 |
PSTN 連線類型 | 發簡訊 | 請參閱 通用維度 -> PSTNConnectivityType |
PSTN 總分鐘數 | 整數 | 摘要:加總 PSTN 通話的總分鐘數使用量 |
fCallQueueFinalStateAction 數據表字段描述
名稱 | 數據類型 | 描述 |
---|---|---|
平均通話持續時間 (秒) | 小數 | 摘要:加總 已放棄通話的平均通話持續時間為秒內 |
平均通話持續時間 (秒) 平均 (量) | 整數 | 平均通話持續時間 (秒) - 零而非空白 |
平均通話佇列持續時間 (秒) | 小數 | 摘要:加總 以秒為平均等待時間以內接聽來電 |
平均通話佇列持續時間 (秒) (量) | 整數 | 平均通話佇列持續時間 (秒) - 零而非空白 |
通話數 | 整數 | 摘要:加總 通話數目 |
通話佇列通話結果 | 發簡訊 | 請參閱 通話佇列維度 -> CallQueueCallResult |
通話佇列通話結果圖例 | 發簡訊 | 通話佇列通話結果的圖例專案。 可能的值:
|
通話佇列最終狀態動作 | 發簡訊 | 請參閱 通話佇列維度 -> CallQueueFinalStateAction |
CQ 名稱 | 發簡訊 | 附加至通話佇列的資源帳戶名稱 如果完整資源帳戶名稱為 cq_test@microsoft.com,則此值為: cq_test |
CQHour | 數 | 通話在一小時內進行 |
日期 | 日期/時間 | 通話佇列通話開始日期和時間 (小時) |
DateTimeCQName | 發簡訊 | 在 fCallQueueFinalStateAction 上篩選的唯一密鑰 |
IsAbandoned | True/false | 如果來電者在專員回答之前掛斷電話,則為 True |
當地日期 | 日期/時間 | 根據選取的 UTC Offset) (當地日期/時間 |
UTC 日期 | 日期/時間 | UTC 日期/時間 |
雲端通話佇列代理時間軸報告
fAgentTimelineAnalytics 數據表字段描述
名稱 | 數據類型 | 描述 |
---|---|---|
專員名稱 | 發簡訊 | 使用者UPN 如果完整使用者名稱為 user@microsoft.com,則此值為: 使用者 |
AgentTimelineAnalyticsSummaryLink | 發簡訊 | 用來連結快顯工具提示的 fAgentTimelineAnalyticsSummary |
通話持續時間 (HH:MM:SS) | 發簡訊 | 通話持續時間 (分鐘) 轉換為 HH:MM:SS |
通話持續時間 (分鐘) | 整數 | 摘要:加總 已接聽的通話佇列通話總通話持續時間以分鐘為單位 |
第二) (通話持續時間 | 整數 | 摘要:加總 已接聽的通話佇列通話總通話持續時間以秒為內 |
通話結束時間:當地時間 | 日期/時間 | 通話結束時間 - 根據選取的 UTC Offset) ,本機 ( |
通話結束時間 UTC | 日期/時間 | 通話結束時間 - UTC |
通話開始時間:本機時間 | 日期/時間 | 通話開始時間 - 根據選取的 UTC Offset) ,本機 ( |
通話開始時間UTC | 日期/時間 | 通話開始時間 - UTC |
ConferenceID | 發簡訊 | 用於疑難解答目的 - 開啟票證時提供此資訊 |
CQ 名稱 | 發簡訊 | 附加至通話佇列的資源帳戶名稱 如果完整資源帳戶名稱為 cq_test@microsoft.com,則此值為: cq_test |
DateTime | DateTime | 通話日期 |
DialogID | 發簡訊 | 用於疑難解答目的 - 開啟票證時提供此資訊 |
DocumentID | 發簡訊 | 用於疑難解答目的 - 開啟票證時提供此資訊 |
小時 (測量) | 整數 | 通話時間 |
通話總數 | 整數 | 摘要:加總 撥打給專員的電話數 |
fAgentTimelineAnalyticsSummary 數據表字段描述
名稱 | 數據類型 | 描述 |
---|---|---|
專員名稱 | 發簡訊 | 使用者UPN 如果完整使用者名稱為 user@microsoft.com,則此值為: 使用者 |
AgentTimelineAnalyticsLink | 發簡訊 | 用來連結 fAgentTimelineAnalytics 的快顯工具提示 |
平均通話持續時間 (秒) | 小數 | 摘要:加總 在幾秒鐘內接聽來電佇列通話的平均持續時間 |
平均通話持續時間 (秒) - 零而不是空白 (測量) | 整數 | 平均通話持續時間 (秒) - 零而非空白 |
CQ 名稱 | 發簡訊 | 附加至通話佇列的資源帳戶名稱 如果完整資源帳戶名稱為 cq_test@microsoft.com,則此值為: cq_test |
日期 | 日期 | 通話日期 |
小時 | 整數 | 通話時間 |
MM-DD | 發簡訊 | 月與日通話 |
通話總數 | 整數 | 摘要:加總 撥打給專員的電話數 |
通話總數除以專員名稱計數 (量 | 整數 | 每位專員的平均通話數 |
總通話數總和 (量) | 整數 | 總通話數的總和 - 零而非空白 |
總通話持續時間 (HH:MM:SS) | 發簡訊 | 通話持續時間 (分鐘) 轉換為 HH:MM:SS |
通話總 (分鐘) | 整數 | 摘要:加總 已接聽的通話佇列通話總通話持續時間以分鐘為單位 |
數據限制
每個報告索引標籤會擷取所有自動語音應答、通話佇列或代理程式的數據,使用者在所選日期範圍的租使用者中已獲得授權。 無論報告中選取的特定資源帳戶或代理程序為何,都會進行這項數據擷取。 篩選以僅顯示要求的資訊會在本機進行。
每個報表索引標籤只能擷取 90,000 列。
如果每天處理大量電話,報告可能不會在所選日期範圍內顯示所有天數的所有通話。 發生此排除專案時,不會有任何通知。 請嘗試縮短日期範圍以避免此問題。
如果縮短日期範圍不夠,修改報表可能會增加可擷取的列數,如下所示:
- 選取功能區列中的 [轉換數據] 以開啟 Power Query 編輯器。
- 選取左側的 LimitResultRowsCount 。
- 將欄位右側的值變更為較大的數位。
- 關閉 Power Query 編輯器 視窗。
- 出現立即套用變更的提示時,選取 [是 ]。 報告應該會自動重新整理。
- 儲存報表。
可傳回的列數上限為 200,000。
將值設定為高於 200,000 的數位並沒有任何作用,因為此值是伺服器上的硬編碼限制。
增加限制會導致較長的執行和回應時間。
報告執行時間限制
增加可傳回的列數上限會導致執行時間和回應時間較長,這表示報告可能會在傳回數據之前逾時。 修改報表可增加報表執行時間,如下所示:
- 選取功能區列中的 [轉換數據] 以開啟 Power Query 編輯器。
- 在左側的 ReportExecutionMinutes 上選取。
- 將欄位右側的值變更為較大的數位。
- 關閉 Power Query 編輯器 視窗。
- 出現立即套用變更的提示時,選取 [是 ]。 報告應該會自動重新整理。
- 儲存報表。
自訂
您可以自定義報表的特定視覺效果層面,例如新增或移除要顯示在各種視覺效果中的欄位、變更圖表類型等等。
變更色彩架構
下列步驟假設您已完成安裝步驟。
執行下列步驟:
選取功能區上的 [ 檢視 ] 索引標籤。
從下拉式清單中選取色彩架構。
維度和度量單位
您可以使用下列維度和度量單位。
一般維度
自動語音應答和通話佇列都有這些維度:
名稱 (類型) | 可能的值 | 描述 |
---|---|---|
ConferenceId (文字) |
GUID | 通話標識碼 |
日期 (DateTime) |
(UTC) 通話日期 | |
DialogId (文字) |
GUID | 通話標識碼 |
DocumentId (文字) |
GUID | 通話標識碼 |
期間 (整數) |
通話持續時間,以秒為內 | |
EndTime (DateTime) |
時間通話 (UTC) | |
FirstIsCaller (布爾值) |
第一個和第二個端點分類 | |
FirstUPN (文字) |
第一個端點使用者的UPN) (用戶主體名稱 | |
小時 (文字) |
在UTC) (啟動小時通話 | |
分鐘 (文字) |
(UTC) 啟動的分鐘通話 | |
PSTNCallDuration (整數) |
通話持續時間 | |
PSTNCallType (文字) |
||
外部 | 來電來自租使用者外部 | |
內部 | 來電來自租用戶內部 | |
PSTNConnectivityType (文字) |
||
CallingPlan | 來電是以通話方案號碼接聽 | |
DirectRouting | 來電是以直接路由號碼接聽 | |
ACS 通話 | 從網路撥打電話 (按兩下 [2call) | |
第二 (文字) |
第二次通話 (UTC) | |
SecondUPN (文字) |
第二個端點使用者的UPN) (用戶主體名稱 | |
TenantId (文字) |
租用戶識別碼 | |
時間戳 (DateTime) |
時間記錄是 (UTC) 撰寫 | |
UserStartTimeUTC (DateTime) |
UTC) (啟動時間通話 |
自動語音應答尺寸
名稱 (類型) | 可能的值 | 描述 |
---|---|---|
AutoAttendantCallFlow (文字) |
封裝式顯示自動語音應答通話的不同狀態 | |
abs_search | 發生依名稱撥號搜尋 | |
公告 | 已播放公告 | |
automatic_menu | 默認通話路由 | |
call_termination | 通話已結束,請參閱 AutoAttendantCallResult | |
call_transfer | 呼叫已轉移,請參閱 AutoAttendantCallResult | |
first_level_menu | 轉換狀態 - 可以忽略 | |
main_menu | 已播放問候語訊息 | |
speech_input_confirmation | 來電者使用語音輸入 | |
user_selection | 來電者使用觸控式按鍵輸入 | |
AutoAttendantCallResult (文字) |
最終通話結果 | |
failed_to_establish_media | 無法建立通話的媒體部分 | |
failover_to_operator | 呼叫轉移給電信業者通常是因為系統錯誤 | |
oaa_chain_too_long | AA 中的雙腳太多 | |
oaa_session_too_long | AA 會話持續太久 | |
service_declined | AA 未接受通話 | |
service_terminated | AA 設定會中斷通話或掛斷通話 | |
terminated_automatic_selection | AA 設定會中斷通話 | |
terminated_no_operator | 全部因未定義運算子的錯誤而終止 | |
terminated_transfer_failed | 呼叫因轉接失敗而終止 - 通常是外部號碼 | |
transfer_in_progress | AA-AA> 傳輸 | |
transferred_to_operator | 電話已轉接給電信業者 | |
transferred_to_cq | 已將通話轉移至 [通話] 佇列 | |
transferred_to_receptionist | 與 transferred_to_operator 相同 | |
transferred_to_self | 通話已傳回至AA的開頭 | |
transferred_to_shared_voicemail | 通話已轉接至共用語音信箱 | |
transferred_to_user | 通話已轉接給使用者 | |
未知 | 發生未知狀況 | |
user_terminated | 來電者掛斷 | |
AutoAttendantCallerActionCounts (整數) |
執行來電) (觸控鍵或語音輸入的動作數目 | |
AutoAttendantChainDurationInSecs (實數) |
通話在通話流程的這個部分中仍保留的秒數 | |
AutoAttendantChainIndex (整數) |
||
AutoAttendantChainStartTime (DateTime) |
此部分通話流程的開始時間 | |
AutoAttendantCount (整數) |
呼叫轉換完成的自動語音應答數目 | |
AutoAttendantDirectorySearchMethod (文字) |
目錄搜尋方法 | |
abs_search_dtmf | 觸控色調 | |
abs_search_voice | 語音 | |
AutoAttendantId (文字) |
自動語音應答 GUID | |
AutoAttendantIdentity (文字) |
來電傳送到的資源帳戶 URI | |
AutoAttendantTransferAction (文字) |
呼叫轉移目標類型 | |
機 管 局 | 已移轉至 AA | |
重慶 | 已移轉至 CQ | |
external_pstn | 移轉到外部號碼 | |
共用語音信箱 | 已移轉至共享語音信箱 | |
未知 | 未知的動作 | |
HasAA (布爾值) |
通話中是否包含 AA |
通話佇列維度
名稱 (類型) | 可能的值 | 描述 |
---|---|---|
CallQueueAgentCount (整數) |
通話佇列中的代理程式數目 | |
CallQueueAgentOptInCount (整數) |
加入加入通話佇列的代理程式數目 | |
CallQueueCallResult (文字) |
通話佇列通話最終狀態 | |
agent_joined_conference | 電話接聽 - 會議模式 CQ | |
callback_call_timed_out | 回電逾時 | |
拒絕 | ||
斷開 | ||
error | ||
失敗 | ||
無效 | ||
溢位 | 符合溢位狀況 | |
timed_out | 符合逾時條件 | |
no_agent | 未符合代理程序條件 | |
transferred_to_agent | 接聽來電 - 轉接模式 CQ | |
transferred_to_callback_caller | 由專員接聽的回電 | |
CallQueueDurationSeconds (實數) |
通話佇列中的通話持續時間 | |
CallQueueFinalStateAction (文字) |
通話佇列最終動作 | |
斷開 | time_out通話 | |
disconnect_with_busy | 溢位通話 | |
failed_to_accept_call | 通話佇列無法接受通話 | |
向前 | 呼叫已轉接給組織或外部人員 | |
shared_voicemail | 通話已傳送至共用語音信箱 | |
其他 | 發生其他一些情況 | |
語音信箱 | 通話已傳送至個人語音信箱 | |
CallQueueId (文字) |
通話佇列 GUID | |
CallQueueIdentity (文字) |
來電傳送到的資源帳戶 URI | |
CallQueueTargetType (文字) |
呼叫重新導向目標 | |
ApplicationEndpoint | 其他語音應用程式 | |
郵箱 | 共用語音信箱 | |
Other | 發生其他一些情況 | |
電話 | 外部傳輸 | |
使用者 | 租使用者中的使用者 | |
HasCQ (布爾值) |
通話中是否包含 CQ | |
轉移FromCQId (文字) |
呼叫佇列 GUID 通話已從 | |
轉移FromCallQueueIdentity (文字) |
呼叫轉移來源的資源帳戶 URI |
測量
名稱 (類型) | 可能的值 | 描述 |
---|---|---|
AvgAutoAttendantChainDurationSeconds (實數) |
自動語音應答通話流程中每個部分的平均通話持續時間 | |
AvgCallDuration (實數) |
以秒為內的平均通話持續時間 | |
AvgCallQueueDurationSeconds (實數) |
以秒為內的平均通話佇列持續時間 | |
PSTNTotalMinutes (實數) |
通話持續時間總計以分鐘為單位 | |
TotalAudioStreamDuration (實數) |
||
TotalCallCount (整數) |
通話總數 |
建構有效的查詢
有效的查詢包含 JSON 物件中的數個屬性:
{
"Filters":[
{
"DataModelName":"Date",
"Value":"2022-04-01",
"Operand":4
},
{
"DataModelName":"Date",
"Value":"2022-04-30",
"Operand":6
}
],
"Dimensions":[
{
"DataModelName":"AutoAttendantIdentity"
},
{
"DataModelName":"AutoAttendantDirectorySearchMethod"
}
],
"Measurements":[
{
"DataModelName":"PSTNTotalMinutes"
},
{
"DataModelName":"TotalCallCount"
}
],
"Parameters":{
"UserAgent":"Power BI Desktop"
},
"LimitResultRowsCount":100000
}
必要欄位
篩選:用來篩選由 VAAC 傳回的數據
- DataModelName 應該是其中一個支持的維度
- 值的格式 (日期時間、字串、數位等應為正確格式 )
-
操作數:
- 0 - 等於
- 1 - 不等於
- 2 - 包含
- 3 - 從
- 4 - 大於
- 5 - 大於或等於
- 6 - 小於
- 7 - 小於或等於
- 8 - 不包含
- 9 - 開頭不是
維度:
- DataModelName 應該是其中一個支持的維度
度量:
- DataModelName 應為支援的度量值之一
參數:目前僅支援UserAgent。
LimitResultRowsCount:VAAC 傳回的列數上限
注意事項
當您提交依 , 搜尋準則同時包含日期和時間 (ISO 8601 格式) 的查詢 Date
時,會忽略時間部分。
在 Power BI 外部存取 VAAC
任何可存取 RESTful Web 服務的應用程式都可以使用 VAAC API 來擷取歷史數據。 在下列範例中,使用 Postman 。
製備
- 下載 「郵遞員」。
- 將下載的 zip 檔案指示中的資料夾
postman
匯入郵遞員。
使用郵遞員存取 VAAC
選取右上角 [無環境] 下拉式清單上的 [VAAC - msit]。
選 取 左側軌軌功能表上的 [環境]。
選取 [全域] 底下的 [VAAC - msit]。
使用適用的認證取代 userName、 password 和 tenantId 。
選取右上角的 [ 全部重設 ]。
選取 [儲存]。
選取左側軌軌功能表上的 [集錦 ]。
選 取 [設定 API 存取令牌 - Prod ],然後流覽至 [ 本文] 索引標籤。
選 取 [傳送]。
系統會傳回存取令牌。
如果沒有傳回存取令牌,請檢查您的認證,使其 有足夠的許可權。
選 取 [VAAC ConfigAPI Prod] 並流覽至 [ Params] 索 引標籤。
填入 查詢 字串。
選 取 [傳送]。
朗讀結果
提交輸入后,有幾個可能的結果:
壓縮 JSON 查詢
VAAC API 只接受 GZip 壓縮或 Base64 編碼字串作為輸入。
尋找任何使用 GZIP 或 Base64 壓縮 JSON blob 的網站。
GZIP 輸出看起來應該像這樣:
H4sIAAAAAAAACq2SQWsCMRCF7/6KkLNC3EoPe9u6FISuFbW9lB4GM9TQbEaSCSLif+9mV4uCBwXnMkze5L0vkH1PCCFfjWX0QeZfaWxqf+xJLIGhIo12CjXKPM0o+2cLn2BjEjKVZQM1Gqjhhfy+QQ9Oy3x0PDz0H5HypK6nPJ9SUv9uV2RpanTBkLvxiUVkKpjRaXA80ejY8E7eg3/hUBqPKya/WyD41bpCXpP+tzvjrBBC9NjA8o2ks8VyuiQGWxkXGcNdkO3FMVg7puj4GtAMfLPa/Y2Tk/wI6IufhjHl0xa9eJmIEsMv06Y16cLlm6kNzzFEy3Pahi4kH6pUvcMfrAhUU3oCAAA=
Base64 輸出看起來應該像這樣:
ew==
IkZpbHRlcnMiOls=
ew==
IkRhdGFNb2RlbE5hbWUiOiJEYXRlIiw=
IlZhbHVlIjoiMjAyMi0wNC0wMSIs
Ik9wZXJhbmQiOjQ=
fSw=
ew==
IkRhdGFNb2RlbE5hbWUiOiJEYXRlIiw=
IlZhbHVlIjoiMjAyMi0wNC0zMCIs
Ik9wZXJhbmQiOjY=
fQ==
XSw=
IkRpbWVuc2lvbnMiOls=
ew==
IkRhdGFNb2RlbE5hbWUiOiJBdXRvQXR0ZW5kYW50SWRlbnRpdHki
fSw=
ew==
IkRhdGFNb2RlbE5hbWUiOiJBdXRvQXR0ZW5kYW50RGlyZWN0b3J5U2VhcmNoTWV0aG9kIg==
fQ==
XSw=
Ik1lYXN1cmVtZW50cyI6Ww==
ew==
IkRhdGFNb2RlbE5hbWUiOiJQU1ROVG90YWxNaW51dGVzIg==
fSw=
ew==
IkRhdGFNb2RlbE5hbWUiOiJUb3RhbENhbGxDb3VudCI=
fQ==
XSw=
IlBhcmFtZXRlcnMiOns=
IlVzZXJBZ2VudCI6IlBvd2VyIEJJIERlc2t0b3Ai
fSw=
IkxpbWl0UmVzdWx0Um93c0NvdW50IjoxMDAwMDA=
fQ==
URL-Encode 壓縮的 JSON 查詢
GZIP 或 Base64 壓縮的 JSON 查詢必須 以 URL 編碼。
GZIP URL 編碼輸出看起來像這樣:
H4sIAAAAAAAACq2SQWsCMRCF7%2F6KkLNC3EoPe9u6FISuFbW9lB4GM9TQbEaSCSLif%2B9mV4uCBwXnMkze5L0vkH1PCCFfjWX0QeZfaWxqf%2BxJLIGhIo12CjXKPM0o%2B2cLn2BjEjKVZQM1Gqjhhfy%2BQQ9Oy3x0PDz0H5HypK6nPJ9SUv9uV2RpanTBkLvxiUVkKpjRaXA80ejY8E7eg3%2FhUBqPKya%2FWyD41bpCXpP%2BtzvjrBBC9NjA8o2ks8VyuiQGWxkXGcNdkO3FMVg7puj4GtAMfLPa%2FY2Tk%2FwI6IufhjHl0xa9eJmIEsMv06Y16cLlm6kNzzFEy3Pahi4kH6pUvcMfrAhUU3oCAAA%3D
Base64 URL 編碼輸出看起來像這樣:
%0Aew%3D%3D%0AIkZpbHRlcnMiOls%3D%0Aew%3D%3D%0AIkRhdGFNb2RlbE5hbWUiOiJEYXRlIiw%3D%0AIlZhbHVlIjoiMjAyMi0wNC0wMSIs%0AIk9wZXJhbmQiOjQ%3D%0AfSw%3D%0Aew%3D%3D%0AIkRhdGFNb2RlbE5hbWUiOiJEYXRlIiw%3D%0AIlZhbHVlIjoiMjAyMi0wNC0zMCIs%0AIk9wZXJhbmQiOjY%3D%0AfQ%3D%3D%0AXSw%3D%0AIkRpbWVuc2lvbnMiOls%3D%0Aew%3D%3D%0AIkRhdGFNb2RlbE5hbWUiOiJBdXRvQXR0ZW5kYW50SWRlbnRpdHki%0AfSw%3D%0Aew%3D%3D%0AIkRhdGFNb2RlbE5hbWUiOiJBdXRvQXR0ZW5kYW50RGlyZWN0b3J5U2VhcmNoTWV0aG9kIg%3D%3D%0AfQ%3D%3D%0AXSw%3D%0AIk1lYXN1cmVtZW50cyI6Ww%3D%3D%0Aew%3D%3D%0AIkRhdGFNb2RlbE5hbWUiOiJQU1ROVG90YWxNaW51dGVzIg%3D%3D%0AfSw%3D%0Aew%3D%3D%0AIkRhdGFNb2RlbE5hbWUiOiJUb3RhbENhbGxDb3VudCI%3D%0AfQ%3D%3D%0AXSw%3D%0AIlBhcmFtZXRlcnMiOns%3D%0AIlVzZXJBZ2VudCI6IlBvd2VyIEJJIERlc2t0b3Ai%0AfSw%3D%0AIkxpbWl0UmVzdWx0Um93c0NvdW50IjoxMDAwMDA%3D%0AfQ%3D%3D
重要
VAAC API 只能傳回每個查詢最多 200,000 列。
系統內的要求會根據撥打電話的IP位址、驗證標頭中已辨識的租使用者身分識別,以及通話服務來進行節流處理,以防止單一用戶端、租用戶或服務獨獨一無二的資源。
版本3.x.x歷程記錄和支持狀態
參考:Teams 自動語音應答 & 通話佇列歷程記錄報告 - 變更已下載 zip 檔案中的 Log.docx,以取得詳細的變更清單。
版本 | 發佈日期 | 支援 | 檔名 | 描述 |
---|---|---|---|---|
3.1.8 | 2024 年 8 月 12 日 | 是 | Teams 自動語音應答 & 通話佇列歷史報告 V3.1.7 | [通話佇列] 索引標籤上 [日期] 交叉分析篩選器的錯誤修正 |
3.1.7 | 2024 年 7 月 15 日 | 否 | Teams 自動語音應答 & 通話佇列歷史報告 V3.1.7 | 已改善對授權用戶的支援,已移除原始報告範本 |
3.1.6 | 2024年4月15日 | 否 | Teams 自動語音應答 & 通話佇列歷史報告 V3.1.6 | 支援點選2call、回撥、授權使用者,以及一些因淘汰而變更的視覺效果 |
3.1.5 | 2024年1月29日 | 否 | Teams 自動語音應答 & 通話佇列歷史報告 V3.1.5 | 已修正 fAgentTimelineAnalytics 和 fAgentTimelineAnalyticsSummary 的 [每天] 查詢邏輯錯誤 |
3.1.4 | 2024年1月24日 | 否 | Teams 自動語音應答 & 通話佇列歷史報告 V3.1.4 | 針對大量客戶的日常報告、螢幕助讀程序的輔助功能改良功能 |