自动助理和呼叫队列历史报告
重要
GCC High 和 DoD 客户需要使用 自动助理并调用 GCC High 和 DoD 的队列历史报告。
此 Power BI 模板提供三个报表,使组织能够报告自动助理和呼叫队列处理的呼叫数。 它还提供代理性能见解。
V3.1.8 已发布于 2024 年 8 月 12 日
Teams 自动助理 & 呼叫队列历史报告 Power BI 模板提供以下三个报表:
这些报表使用语音应用程序分析收集器 (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 管理中心运行其他使用情况报告的访问权限,请为用户分配一个 CQD 访问角色,同时将 “查看报告 ”和“ 查看 EUII”字段 设置为 “是”。
有关详细信息,请参阅 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应启动。选择 “数据源”、“ 报表级别”和 “UTC 偏移量”。
-
DataSource:选择条目
api.interfaces.records.teams.microsoft.com
。 -
报表级别:
- 选择
Per Call
(默认) 以检索所有单独的呼叫记录。 - 选择此选项
Per Day
可检索每天的聚合总计。
- 选择
-
UTC 偏移量:选择表示报表显示的时区的 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 | 细目显示通过自动助理的呼叫方路径和最终呼叫结果。 列定义:
提示:将鼠标悬停在本部分中的任何指标上可显示工具提示,其中包含构成总数的单个调用。 |
已知问题
- 仅报告应答呼叫的第一个自动助理中的呼叫和呼叫者操作。 当一个自动助理转移到另一个自动助理) 未报告时,链接的自动助理中的呼叫和调用方操作 (。
- 将显示自动助理资源帐户 ID 的名称,而不是自动助理名称。 若要显示自动助理的所有流量,必须选择分配给自动助理的所有资源帐户。
- 只有 28 天的通话历史记录可用。 自动助理数据被视为个人数据,受数据隐私保留策略的约束。
- 日期选择器有时会显示超出可用数据范围的日期,从而生成空白报表。 将日期更改为在过去 28 天内,以解决此问题。
云呼叫队列分析报告
解释报告
标注 | 标题 | 描述 |
---|---|---|
1 | 日期 | 报表的开始和结束日期。 使用此滑块选择要报告的日期范围。 请参阅已知问题 |
2 | 时间范围 | 报表的开始和结束小时。 报表涵盖从开始日期/开始小时到结束日期/结束小时的所有日期/时间。 使用此滑块选择要报告的时间范围。 |
3 | 呼叫队列资源帐户 | 要报告的资源帐户。 若要查看特定呼叫队列的调用,请选择分配给该呼叫队列的所有资源帐户。 如果完整的资源帐户名称为 cq_test@microsoft.com,则此值为: cq_test 默认值:全部 |
4 | 快速统计信息 -> 传入呼叫 | 细目显示开始日期/开始小时和结束日期/结束小时之间收到的呼叫总数。 提示:将鼠标悬停在本部分中的任何指标上可显示工具提示,其中包含构成总数的单个调用。 |
5 | 快速统计信息 -> 平均等待时间 (秒) | 细目显示呼叫者应答或放弃之前呼叫队列中的平均呼叫持续时间。 |
6 | 调用结果 | 细目显示呼叫者收到的呼叫处理。 调用结果图例定义:
提示:将鼠标悬停在本部分中的任何指标上可显示工具提示,其中包含构成总数的单个调用。 |
7 | 呼叫量、放弃呼叫数、代理选择加入计数 | 细目显示每小时接听和放弃的呼叫数,以及当时选择加入呼叫队列的最大代理数 |
8 | 平均会话长度 (秒) | 细目显示调用在每次调用结果之前等待的时间。
|
9 | 呼叫溢出/超时/无代理目标 | 细目显示接收呼叫溢出、呼叫超时或无代理异常处理处理的呼叫的发送位置。
|
已知问题
- 仅报告第一个呼叫队列中应答呼叫的呼叫和调用方操作。 当一个呼叫队列转移到另一个呼叫队列时,链接呼叫队列中的呼叫 () 未报告。
- 将显示呼叫队列资源帐户 ID 的名称,而不是呼叫队列名称。 若要显示呼叫队列的所有流量,必须选择分配给呼叫队列的所有资源帐户。
- 只有 28 天的通话历史记录可用。 呼叫队列数据被视为个人数据,受数据隐私保留策略的约束。
- 日期选择器有时会显示超出可用数据范围的日期,从而生成空白报表。 将日期更改为在过去 28 天内,以解决此问题。
云呼叫队列代理时间线报告
解释报告
标注 | 标题 | 描述 |
---|---|---|
1 | 日期 | 报表的开始和结束日期。 使用此滑块选择要报告的日期范围。 请参阅已知问题 |
2 | 代理用户名 | 要报告的代理。 如果完整用户名为 user@microsoft.com,则此值为: user 默认值:全部 |
3 | 呼叫队列资源帐户 | 要报告的资源帐户。 若要查看特定呼叫队列的调用,请选择分配给该呼叫队列的所有资源帐户。 默认值:全部 |
4 | 快速统计信息 -> 传入呼叫 | 细目显示已应答的呼叫总数、每个代理接听的平均呼叫数以及处理的平均应答呼叫长度。 提示:将鼠标悬停在本部分中的任何指标上可显示工具提示,其中包含构成总数的单个调用。 |
5 | 按日期) 应答 (呼叫 | 细目显示按日期划分的代理应答呼叫数 |
6 | 细目显示队列中每个代理接听的呼叫数以及这些呼叫的平均呼叫持续时间。 | |
7 | 按小时) (应答的呼叫 | 细目显示按小时划分的代理应答呼叫数 |
8 | 细目显示代理按呼叫队列应答的呼叫数。 列定义:
|
已知问题
- 只有 28 天的通话历史记录可用。 呼叫队列和代理数据被视为个人数据,并受数据隐私保留策略的约束。
- 将显示呼叫队列资源帐户 ID 的名称,而不是呼叫队列名称。 若要显示呼叫队列的所有流量,必须选择分配给呼叫队列的所有资源帐户。
- 将显示代理的 UPN 名称,而不是其名称。
- 日期选择器有时会显示超出可用数据范围的日期,从而生成空白报表。 将日期更改为在过去 28 天内,以解决此问题。
- 在某些情况下,代理应答的呼叫计数可能与 Teams 客户端呼叫历史记录中显示的呼叫数不同。 Teams 客户端呼叫历史记录正确。 支持人员正在调查,但目前估计没有可用的修复时间。
- 当代理因通过呼叫溢出异常处理重定向而在不同的呼叫队列中应答呼叫时,该调用将计入发生异常的原始呼叫队列中,而不是他们接听呼叫的原始呼叫队列中。
- 不会捕获代理处理的回调调用,导致呼叫队列报告和代理时间线报表上应答的呼叫数存在差异。
- 显示代理的各个调用的代理工具提示将显示所有调用,而不是仅显示所选日期范围内的调用。
自动助理和呼叫队列历史报告字段定义
fAutoAttendant 表字段说明
名称 | 数据类型 | 说明 |
---|---|---|
AA 名称 | 发短信 | 附加到自动助理的资源帐户的名称 如果完整的资源帐户名称为 aa_test@microsoft.com,则此值为: aa_test |
AA 开始日期本地 | 日期 | 自动助理呼叫开始日期 - 基于所选 UTC 偏移) 的本地 ( |
AA 开始小时数 | 整数 | 自动助理呼叫开始时间 - 基于所选 UTC 偏移量) 的本地 ( |
AA 开始时间本地 | 日期/时间 | 自动助理呼叫开始时间 - 基于所选 UTC 偏移量) 的本地 ( |
AA 开始时间 UTC | 日期/时间 | 自动助理呼叫开始时间 - UTC |
AACallerActionCount | 整数 | 汇总:总和 呼叫期间呼叫者在自动助理中选择的操作计数 |
AACallerActionCountAverage (Measure) | 整数 | AACallerActionCount 的平均值 - 零而不是空白 |
AACallFlow | 发短信 | 请参阅 自动助理维度 -> AutoAttendantCallFlow |
AACallResult | 发短信 | 请参阅 自动助理维度 -> AutoAttendantCallResult |
AACallResultLegend | 发短信 | AACallResult 上的 图例项。 可能的值:
|
AAChainDuration | 十进制数 | 汇总:总和 自动助理中的呼叫持续时间 |
AAChainDurationAverage (Measure) | 十进制数 | AAChainDuration 的平均值 - 零而不是空白 |
AAChainIndex | 整数 | |
AAConnectivityType | 发短信 | 请参阅 常见维度 -> PSTNConnectivityType |
AACount | 整数 | 汇总:总和 呼叫中涉及的自动助理数 |
AADirectorySearchMethod | 发短信 | 请参阅自动 助理维度 -> AutoAttendantDirectorySearchMethod |
AADirectorySearchMethodCountDTMF (Measure) | 整数 | 使用 DTMF 搜索目录的调用计数 - 零而不是空白 |
AADirectorySearchMethodCountVoice (Measure) | 整数 | 使用语音搜索目录的呼叫计数 - 零而不是空白 |
AADirectorySearchMethodLegend | 发短信 | AADirectorySearchMethod 的图例项。 可能的值:
|
AATransferAction | 发短信 | 请参阅 自动助理维度 -> AutoAttendantTransferAction |
调用持续时间秒 | 整数 | 通话持续时间 |
本地呼叫结束时间 | 日期/时间 | 呼叫结束时间 - 基于所选 UTC 偏移量) 的本地 ( |
呼叫结束时间 UTC | 日期/时间 | 呼叫结束时间 - UTC |
本地呼叫开始时间 | 日期/时间 | 呼叫开始时间 - 基于所选 UTC 偏移量) 的本地 ( |
呼叫开始时间 UTC | 日期/时间 | 呼叫开始时间 - UTC |
仅每天) 的 ConferenceID ( | 发短信 | 用于故障排除目的 - 在开票时提供此信息 |
DialogID 每天仅 () | 发短信 | 用于故障排除目的 - 在开票时提供此信息 |
DocumentID 每天仅 () | 发短信 | 用于故障排除目的 - 在开票时提供此信息 |
MM-DD | 发短信 | 自动助理呼叫月-天 |
PSTNMinutes | 整数 | 汇总:总和 总分钟使用量 |
TotalCallCount | 整数 | 汇总:总和 始终 1 - 用于提供所有调用的总和 |
TotalCallCountSum (Measure) | 整数 | TotalCallCount 的总和 |
云呼叫队列分析报告
fCallQueueAnalytics 表字段说明
名称 | 数据类型 | 说明 |
---|---|---|
调用计数 | 整数 | 汇总:总和 通话的数量 |
已放弃的呼叫计数 | 整数 | 汇总:总和 放弃的呼叫数 |
调用计数总和 (度量) | 整数 | 调用计数总和 - 零而不是空白 |
调用计数已放弃 (度量值) | 整数 | 放弃的调用计数 - 零而不是空白 |
调用持续时间秒 | 整数 | 汇总:总和 通话持续时间 |
调用持续时间秒 AVG (度量) | 虽然数字 | 平均调用持续时间秒 |
本地呼叫结束时间 | 日期/时间 | 呼叫结束时间 - 基于所选 UTC 偏移量) 的本地 ( |
呼叫结束时间 UTC | 日期/时间 | 呼叫结束时间 - UTC |
呼叫队列代理计数 | 整数 | 汇总:总和 呼叫队列中配置的代理数 |
呼叫队列代理选择加入计数 | 整数 | 汇总:总和 选择加入呼叫队列的代理数 |
呼叫队列调用结果 | 发短信 | 请参阅 呼叫队列维度 -> CallQueueCallResult |
呼叫队列调用结果图例 | 发短信 | 呼叫队列结果的图例项。 可能的值:
|
呼叫队列目标类型 | 发短信 | 请参阅 呼叫队列维度 -> CallQueueTargetType |
调用队列目标类型图例 | 发短信 | 呼叫队列目标类型的图例项。 可能的值:
|
本地呼叫开始时间 | 日期/时间 | 呼叫开始时间 - 基于所选 UTC 偏移量) 的本地 ( |
呼叫开始时间 UTC | 日期/时间 | 呼叫开始时间 - UTC |
仅每个呼叫的 ConferenceID () | 发短信 | 用于故障排除目的 - 在开票时提供此信息 |
CQ 名称 | 发短信 | 附加到呼叫队列的资源帐户的名称 如果完整的资源帐户名称为 cq_test@microsoft.com,则此值为: cq_test |
CQHour | 整数 | 呼叫队列呼叫开始小时 |
日期 | 日期/时间 | 呼叫队列呼叫开始日期和时间 (小时) |
DateTimeCQName | 发短信 | 用于筛选 fCallQueueFinalStateAction 的唯一键 |
DialogID (仅限每个调用) | 发短信 | 用于故障排除目的 - 在开票时提供此信息 |
DocumentID (仅限每个调用) | 发短信 | 用于故障排除目的 - 在开票时提供此信息 |
PSTN 连接类型 | 发短信 | 请参阅 通用维度 -> PSTNConnectivityType |
PSTN 总分钟数 | 整数 | 汇总:总和 PSTN 呼叫的总分钟数使用情况 |
fCallQueueFinalStateAction 表字段说明
名称 | 数据类型 | 说明 |
---|---|---|
平均调用持续时间 (秒) | 十进制数 | 汇总:总和 已放弃呼叫的平均呼叫持续时间(秒) |
平均调用持续时间 (秒) 平均 (度量值) | 整数 | 平均调用持续时间 (秒) - 零而不是空白 |
平均呼叫队列持续时间 (sec) | 十进制数 | 汇总:总和 应答呼叫的平均等待时间(秒) |
平均调用队列持续时间 (sec) (度量) | 整数 | 平均呼叫队列持续时间 (秒) - 零而不是空白 |
调用计数 | 整数 | 汇总:总和 通话的数量 |
呼叫队列调用结果 | 发短信 | 请参阅 呼叫队列维度 -> CallQueueCallResult |
呼叫队列调用结果图例 | 发短信 | 呼叫队列调用结果的图例项。 可能的值:
|
调用队列最终状态操作 | 发短信 | 请参阅 呼叫队列维度 -> CallQueueFinalStateAction |
CQ 名称 | 发短信 | 附加到呼叫队列的资源帐户的名称 如果完整的资源帐户名称为 cq_test@microsoft.com,则此值为: cq_test |
CQHour | 数字 | 通话发生的小时数 |
日期 | 日期/时间 | 呼叫队列呼叫开始日期和时间 (小时) |
DateTimeCQName | 发短信 | 用于筛选 fCallQueueFinalStateAction 的唯一键 |
IsAbandoned | True/false | 如此 如果调用方在代理应答之前挂断 |
本地日期 | 日期/时间 | 基于所选 UTC 偏移量) 的本地日期/时间 ( |
UTC 日期 | 日期/时间 | UTC 日期/时间 |
云呼叫队列代理时间线报告
fAgentTimelineAnalytics 表字段说明
名称 | 数据类型 | 说明 |
---|---|---|
代理名称 | 发短信 | 用户 UPN 如果完整用户名为 user@microsoft.com,则此值为: user |
AgentTimelineAnalyticsSummaryLink | 发短信 | 用于链接弹出工具提示的 fAgentTimelineAnalyticsSummary |
呼叫持续时间 (HH:MM:SS) | 发短信 | 呼叫持续时间 (分钟) 转换为 HH:MM:SS |
呼叫持续时间 (分钟) | 整数 | 汇总:总和 已应答呼叫队列呼叫的总呼叫持续时间(分钟) |
调用持续时间 (秒) | 整数 | 汇总:总和 已应答呼叫队列呼叫的总呼叫持续时间(秒) |
本地呼叫结束时间 | 日期/时间 | 呼叫结束时间 - 基于所选 UTC 偏移量) 的本地 ( |
呼叫结束时间 UTC | 日期/时间 | 呼叫结束时间 - UTC |
本地呼叫开始时间 | 日期/时间 | 呼叫开始时间 - 基于所选 UTC 偏移量) 的本地 ( |
呼叫开始时间 UTC | 日期/时间 | 呼叫开始时间 - UTC |
ConferenceID | 发短信 | 用于故障排除目的 - 在开票时提供此信息 |
CQ 名称 | 发短信 | 附加到呼叫队列的资源帐户的名称 如果完整的资源帐户名称为 cq_test@microsoft.com,则此值为: cq_test |
DateTime | DateTime | 呼叫日期 |
DialogID | 发短信 | 用于故障排除目的 - 在开票时提供此信息 |
DocumentID | 发短信 | 用于故障排除目的 - 在开票时提供此信息 |
小时 (度量值) | 整数 | 通话时间 |
总调用计数 | 整数 | 汇总:总和 向代理显示的调用数 |
fAgentTimelineAnalyticsSummary 表字段说明
名称 | 数据类型 | 说明 |
---|---|---|
代理名称 | 发短信 | 用户 UPN 如果完整用户名为 user@microsoft.com,则此值为: user |
AgentTimelineAnalyticsLink | 发短信 | 用于链接弹出工具提示的 fAgentTimelineAnalytics |
平均调用持续时间 (秒) | 十进制数 | 汇总:总和 应答呼叫队列呼叫的平均持续时间(秒) |
平均调用持续时间 (秒) - 零而不是空白 (度量值) | 整数 | 平均调用持续时间 (秒) - 零而不是空白 |
CQ 名称 | 发短信 | 附加到呼叫队列的资源帐户的名称 如果完整的资源帐户名称为 cq_test@microsoft.com,则此值为: cq_test |
日期 | 日期 | 呼叫日期 |
Hour | 整数 | 通话时间 |
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) 第一终结点的用户 | |
Hour (文本) |
小时呼叫已启动 (UTC) | |
Minute (文本) |
(UTC) 开始的分钟呼叫 | |
PSTNCallDuration (整数) |
通话持续时间 | |
PSTNCallType (文本) |
||
外部 | 呼叫来自租户外部 | |
内部 | 呼叫来自租户内部 | |
PSTNConnectivityType (文本) |
||
CallingPlan | 呼叫通过通话套餐号码到达 | |
DirectRouting | 呼叫通过直接路由号码到达 | |
ACS 呼叫 | 来自 web 的呼叫 (click2call) | |
第二个 (文本) |
第二次呼叫已 (UTC) 启动 | |
SecondUPN (文本) |
用户主体名称 (UPN) 第二终结点的用户 | |
TenantId (文本) |
租户 ID | |
时间戳 (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 | 回拨呼叫超时 | |
拒绝 | ||
断开 | ||
错误 | ||
失败 | ||
无效 | ||
overflown | 满足溢出条件 | |
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 | 另一个语音应用程序 | |
邮箱 | 共享语音邮件 | |
其他 | 发生了其他一些情况 | |
电话 | 外部传输 | |
用户 | 租户中的用户 | |
HasCQ (布尔) |
呼叫中是否涉及 CQ | |
TransferredFromCQId (文本) |
呼叫队列 GUID 呼叫已从 转移 | |
TransferredFromCallQueueIdentity (文本) |
从中转移呼叫的资源帐户 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 应为受支持的维度之一
- 值应采用正确的格式 (datetime、string、number 等 )
-
操作数:
- 0 - 等于
- 1 - 不等于
- 2 - 包含
- 3 - 开头
- 4 - 大于
- 5 - 大于或等于
- 6 - 小于
- 7 - 小于或等于
- 8 - 不包含
- 9 - 不以 开头
维度:
- DataModelName 应为受支持的维度之一
度量值:
- DataModelName 应该是受支持的度量值之一
参数:目前仅支持 UserAgent。
LimitResultRowsCount:VAAC 返回的最大行数
注意
如果提交按 Date
搜索的查询,并且搜索条件包括日期和时间 (ISO 8601 格式) ,则忽略时间部分。
在 Power BI 外部访问 VAAC
任何可以访问 RESTful Web 服务的应用程序都可以使用 VAAC API 来检索历史数据。 在以下示例中,使用了 Postman 。
制备
- 下载 Postman。
- 将下载的 zip 文件说明中的文件夹
postman
导入 Postman。
使用 Postman 访问 VAAC
在右上角的“无环境”下拉列表中选择“VAAC - msit”。
在左侧栏杆菜单中选择“ 环境 ”。
在“全局”下选择“VAAC - msit”。
将 userName、 password 和 tenantId 替换为适用的凭据。
选择右上角的“ 全部重置 ”。
选择“保存”。
在左侧栏菜单上选择 “集合 ”。
选择 “配置 API 访问令牌 - 生产 ”,然后导航到“ 正文 ”选项卡。
选择“ 发送”。
返回访问令牌。
如果未返回访问令牌,检查凭据,使其具有足够的权限。
选择 “VAAC ConfigAPI Prod ”,然后导航到“ 参数 ”选项卡。
填写 查询 字符串。
选择“ 发送”。
读取结果
提交输入后,可能会产生一些结果:
压缩 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 | “呼叫队列”选项卡上的“日期”切片器的 Bug 修复 |
3.1.7 | 2024 年 7 月 15 日 | 不支持 | Teams 自动助理 & 呼叫队列历史报告 V3.1.7 | 改进了对授权用户的支持,删除了原始报告模板 |
3.1.6 | 2024 年 4 月 15 日 | 否 | Teams 自动助理 & 呼叫队列历史报告 V3.1.6 | 支持 click2call、回调、授权用户和某些因弃用而更改的视觉对象 |
3.1.5 | 2024 年 1 月 29 日 | 否 | Teams 自动助理 & 呼叫队列历史报告 V3.1.5 | 更正了 fAgentTimelineAnalytics 和 fAgentTimelineAnalyticsSummary 的 Per Day 查询逻辑的错误 |
3.1.4 | 2024 年 1 月 24 日 | 否 | Teams 自动助理 & 呼叫队列历史报告 V3.1.4 | 针对大量客户的每日报告,屏幕阅读器的辅助功能改进 |