Microsoft Teams PSTN 使用情况报告
Microsoft Teams 管理中心的 Teams PSTN (公用电话交换网) 和短信使用情况报告概述了组织中的通话和音频会议活动。 如果使用 Microsoft 作为电话运营商，则可以查看通话套餐的详细呼叫活动;如果使用自己的电话运营商，可以查看直接路由的详细呼叫活动。
“ 通话套餐 ”选项卡显示信息，包括用户在入站和出站 PSTN 呼叫中花费的分钟数以及这些呼叫的费用。 “ 直接路由 ”选项卡显示信息，包括 SIP 地址以及呼叫开始和结束时间。 使用此报表中的信息深入了解组织中的 PSTN 使用情况，并帮助你调查、规划和制定业务决策。
注意
如果你有 Telstra 或 Softbank 呼叫计划，则不会在 PSTN 使用情况报告中看到任何呼叫详细信息记录。 请联系 Telstra 或 Softbank 了解报告需求。
查看 PSTN 使用情况报告
- 在 Microsoft Teams 管理中心的左侧导航栏中，单击“ 分析”& 报告>使用情况报告。 在“ 查看报表 ”选项卡上的“ 报表”下，选择“ PSTN 和短信 (预览) 使用情况”。
- 在 “日期范围”下，选择预定义的 7 天或 28 天范围，或设置自定义范围，然后选择“ 运行报表”。
解释报告
通话套餐
| 标注 | 说明 |
|---|---|
| 1 | 可以查看过去 7 天、28 天或你设置的自定义日期范围的趋势报表。 |
| 2 | 每个报表都有生成日期。 报表通常反映活动时间的 24 至 48 小时延迟。 |
| 3 | X 轴是特定报表的选定日期范围。 Y 轴是所选时间段内的调用总数。 将鼠标悬停在给定日期的点上可查看该日期的总调用数。 |
| 4 | 下表提供了每个呼叫的 PSTN 使用情况的细目。
|
| 5 | 选择“编辑列”可在表格中添加或删除列。 |
| 6 | 选择“ 筛选 ”，按用户名或呼叫类型筛选报表。 |
| 7 | 选择“ 全屏 ”以全屏模式查看报表。 |
| 8 | 可以将报表导出到 CSV 文件以供脱机分析。 单击“ 导出到 Excel”，然后在“ 下载 ”选项卡上，单击“ 下载 ”以在报表准备就绪时下载报表。 |
直接路由
| 标注 | 说明 |
|---|---|
| 1 | 可以查看过去 7 天或 28 天的趋势报表。 |
| 2 | 每个报表都有生成日期。 报表通常反映活动时间的 24 至 48 小时延迟。 |
| 3 | X 轴是特定报表的选定日期范围。 Y 轴是所选时间段内的调用总数。 将鼠标悬停在给定日期的点上可查看该日期的总调用数。 |
| 4 | 下表提供了每个呼叫的 PSTN 使用情况的细目。
|
| 5 | 选择“编辑列”可在表格中添加或删除列。 |
| 6 | 选择“ 全屏 ”以全屏模式查看报表。 |
| 7 | 选择“ 导出到 Excel ”，将数据下载到逗号分隔文件中， (CSV) 进行脱机分析，或将其用作计费系统的输入。 |
调用方/被调用方字段注意事项
根据呼叫方向，调用方或被调用方姓名可以包含非 E164 号码。
这些字段可以来自客户 SBC () 。 SBC 可以向直接路由发送三种格式：E.164 数字、非 E.164 数字和字符串。
- E.164 电话号码从具有 E.164 号码的用户到同样具有 E.164 号码的用户。
- 从非 E.164 号码呼叫。 来自与直接路由互连的第三方 PBX 的用户向 Teams 用户发出呼叫。 在这种情况下，调用方号码可以是任何非 E.164 号码，例如 +1001。
- 垃圾邮件发送者呼叫，但不会显示数字，仅显示名称，例如“国税局”。 此字符串将显示在报表中。
电话号码模糊处理
每个国家/地区的隐私要求包括对客户) 电话号码拥有的外部 (进行模糊处理。 电话号码的最后三位或四位数字将替换为星号 (+123 456789***) 。
对于传入呼叫，呼叫方号码被模糊处理，对于传出呼叫，被呼叫方号码被模糊处理。 请注意，这些规则适用于租户管理员中心的 PSTN 和直接路由报表、数据导出以及通过 Microsoft Graph 提供的 PSTN 呼叫日志。 其他报表（如通话分析和通话质量仪表板）中的电话号码模糊处理规则可能有所不同。
模糊处理基于组织的位置 (国家/地区) 。 下表中未列出的国家/地区显示完整的电话号码：
| 国家/地区 | 模糊处理数字数 |
|---|---|
| BE - 比利时 | 3 |
| CH - 瑞士 | 4 |
| DE - 德国 | 3 |
| DK - 丹麦 | 3 |
| ES - 西班牙 | 3 |
| FI - 芬兰 | 3 |
| FR - 法国 | 4 |
| IT - 意大利 | 3 |
| NL - 荷兰 | 3 |
| NO - 挪威 | 3 |
| SE - 瑞典 | 3 |
关于共享关联 ID
共享关联 ID 仅存在于您下载的导出 Excel 文件中，并指示两个或更多调用相关。 下面介绍了不同的方案，以及何时存在共享关联 ID。
- PSTN 用户 1 在 Teams 客户端上名为 Teams 用户 1 的 PSTN 终结点上，呼叫类型Dr_In，关联 ID 57f28917-42k5-4c0c-9433-79734873f2ac，无共享关联 ID。
- Teams 客户端上的 Teams 用户 1 在 PSTN 终结点上称为 PSTN 用户 1，呼叫类型Dr_Out 2c12b8ca-62eb-4c48-b68d-e451f518ff4，无共享关联 ID。
- PSTN 用户 1 在 Teams 客户端上名为 Teams 用户 2 的 PSTN 终结点上，呼叫类型Dr_In f45e9a25-9f94-46e7-a457-84f5940efde9，共享相关 ID f45e9a25-9f94-46e7-a457-84f5940efde9。
- 具有相关 ID“f45e9a25-9f94-46e7-a457-84f5940efde9”的现有调用 3。 与 Teams 用户 2 通话中的 PSTN 用户 1。 Teams 用户 2 转接 (盲人或咨询) 呼叫 Teams 或 PSTN 用户， 调用类型 Dr_Out_User_Transfer 45a1da7c-9e97-481a-8a05-3fe19a9a77e0，共享相关 ID f45e9a25-9f94-46e7-a457-84f5940efde9。
数据保留
每个国家/地区法规要求指定详细通话记录的数据保留。 下表以天为单位列出了每个国家/地区的保留期：
| 国家 | PSTN 呼叫计划 | 直接路由 |
|---|---|---|
| CA - 加拿大 | 150 | 150 |
| CH - 瑞士 | 365 | 365 |
| DK - 丹麦 | 365 | 365 |
| FI - 芬兰 | 365 | 365 |
| FR - 法国 | 365 | 365 |
| IT - 意大利 | 730 | 730 |
| KR - 韩国 | 365 | 365 |
| MX - 墨西哥 | 720 | 730 |
| NL - 荷兰 | 180 | 180 |
| NO - 挪威 | 150 | 150 |
| SE - 瑞典 | 180 | 180 |
| GB – 英国 | 450 | 450 |
| 所有其他国家/地区 | 365 | 150 |
请注意，这些规则适用于租户管理员中心的 PSTN 和直接路由报告、数据导出以及通过 Microsoft Graph 提供的 PSTN 和直接路由呼叫日志。 其他报表（例如通话分析和通话质量仪表板）中的数据保留率可能有所不同。
保留期基于用户的位置 (国家/地区) 。 如果租户管理员未设置用户的位置，则用户位置的默认值为租户的位置。
导出报表
单击“ 导出到 Excel”，然后在“ 下载 ”选项卡上，单击“ 下载 ”以在报表准备就绪时下载报表。 导出过程可能需要几秒钟到几分钟才能完成，具体取决于数据的数量。
此操作会导出所有用户数据并允许你执行简单的排序和筛选以进行更详细的分析。 导出的文件包含联机报表中不可用的其他字段。 这些可用于故障排除和自动化工作流。
你将收到名为“Calls.Export”的 zip 文件。[identifier].zip“，标识符是可用于故障排除的导出的唯一 ID。
如果同时具有通话套餐和直接路由，则导出的文件可能包含这两种产品的数据。 PSTN 使用情况报告文件将具有文件名“PSTN.calls”。[UTC date].csv“和直接路由”DirectRouting.calls”。[UTC date].csv”。
除了 PSTN 和直接路由文件，存档还包含文件“parameters.json”，其中包含所选的导出时间范围和功能。
导出的文件采用逗号分隔值 (CSV) 格式，符合 RFC 4180 标准。 无需任何转换即可在 Excel 或任何其他符合标准的编辑器中打开这些文件。
CSV 的第一行包含列名。 所有日期均为 UTC，采用 ISO 8601 格式。
导出的 PSTN 使用情况报告
除非国家/地区特定法规禁止将数据保留 12 个月，否则可以从当前日期开始最多一年导出数据。
| # | 名称 | 数据类型 (SQL Server) | 说明 |
|---|---|---|---|
| 0 | UsageId | uniqueidentifier |
唯一呼叫标识符 |
| 1 | 呼叫 ID | nvarchar(64) |
呼叫标识符。 不保证是唯一的 |
| 2 | 会议 ID | nvarchar(64) |
音频会议的 ID |
| 3 | 用户位置 | nvarchar(2) |
用户的国家/地区代码 ，ISO 3166-1 alpha-2 |
| 4 | Microsoft Entra ObjectId | uniqueidentifier |
在 Microsoft Entra ID 中调用用户的 ID。 对于机器人调用类型，此和其他用户信息将为 null/空， (ucap_in，ucap_out) |
| 5 | Upn | nvarchar(128) |
UserPrincipalName (Microsoft Entra ID 中的登录名称) 。 这通常与用户的 SIP 地址相同，并且可以与用户的电子邮件地址相同 |
| 6 | 用户显示名称 | nvarchar(128) |
用户的显示名称 |
| 7 | 来电显示 | nvarchar(128) |
接收呼入呼叫的号码或为出站呼叫拨打的号码。 E.164 格式 |
| 8 | 呼叫类型 | nvarchar(32) |
呼叫是 PSTN 出站呼叫还是入站呼叫，以及呼叫类型（例如用户发出的呼叫或音频会议） |
| 9 | 呼叫方向 | nvarchar(32) |
呼叫是 PSTN 出站呼叫还是入站呼叫 |
| 10 | 数字类型 | nvarchar(16) |
用户的电话号码类型，例如免费号码服务 |
| 11 | 国内/国际 | nvarchar(16) |
呼叫是国家或地区的国内 () 还是国家或地区以外的国际 (，) 基于用户的位置 |
| 12 | 已拨打目标 | nvarchar(64) |
已拨打的国家或地区 |
| 13 | 目标编号 | nvarchar(32) |
以 E.164 格式拨打的号码 |
| 14 | 外部国家/地区 | nvarchar(16) |
拨打了两位数的国家/地区代码 |
| 15 | 开始时间 | datetimeoffset |
呼叫开始时间 |
| 16 | 结束时间 | datetimeoffset |
呼叫结束时间 |
| 17 | 持续时间秒 | int |
呼叫连接了多长时间 |
| 18 | 连接费 | numeric(16, 2) |
连接费价格 |
| 19 | 负责 | numeric(16, 2) |
向帐户收取的通话费用或费用 |
| 20 | 货币 | nvarchar(3) |
用于计算呼叫成本的货币类型 (ISO 4217) |
| 21 | 功能 | nvarchar(32) |
用于呼叫的许可证 |
| 22 | 接线员 | nvarchar(32) |
Microsoft |
| 23 | 呼叫持续时间的来源 | nvarchar(32) |
Microsoft |
| 24 | 管理单元 | uniqueidentifier |
与调用关联的管理单元的集合。 |
导出的直接路由使用情况报告
从当前日期) ，最多可以导出 5 个月 (150 天的数据，除非特定于国家/地区的法规禁止在该时间段内保留数据。
| # | 名称 | 数据类型 (SQL Server) | 说明 |
|---|---|---|---|
| 0 | CorrelationId | uniqueidentifier |
呼叫标识符。 同一调用的多个腿可以共享同一个 CorrelationId |
| 1 | Microsoft Entra ObjectId | uniqueidentifier |
在 Microsoft Entra ID 中调用用户的 ID。 对于机器人调用类型，此信息和其他用户信息可以为 null/空 |
| 2 | Upn | nvarchar(128) |
UserPrincipalName (登录名，Microsoft Entra ID) 发出或接听呼叫的用户或机器人。 这通常与用户的 SIP 地址相同，并且可以与用户的电子邮件地址相同 |
| 3 | 显示名称 | nvarchar(128) |
用户或呼叫机器人的名称 (例如，呼叫队列或自动助理) Microsoft 365 管理中心 |
| 4 | 用户国家/地区 | nvarchar(2) |
用户的国家/地区代码 ，ISO 3166-1 alpha-2 |
| 5 | 邀请时间 | datetimeoffset |
当初始邀请从 Teams 用户或机器人出站发送到 SBC 时，或者从 SBC 直接路由的 SIP 代理组件在入站到 Teams 或机器人呼叫时收到时 |
| 6 | 开始时间 | datetimeoffset |
SIP 代理收到最终应答 (SIP 消息“200 正常”) 的时间，从出站 (Teams/机器人上的 SBC 发送给 PSTN 用户) ，或者 SIP 代理在入站呼叫 (PSTN 用户到 Teams/机器人) 时将邀请发送到 Teams 后端中的下一跃点的时间。 对于失败和未接听的调用，这可以等于邀请或失败时间 |
| 7 | 失败时间 | datetimeoffset |
仅存在失败 (未完全建立) 调用 |
| 8 | 结束时间 | datetimeoffset |
仅成功 (完全建立) 调用存在。 通话结束的时间 |
| 9 | 持续时间 (秒) | int |
通话持续时间，从邀请到呼叫结束或失败。 对于呼叫转接，持续时间包括呼叫队列中的响铃。 |
| 10 | 成功 | nvarchar(3) |
是/否。 成功或尝试 |
| 11 | 调用方号码 | nvarchar(32) |
发出呼叫的用户或机器人的编号。 在入站到团队用户呼叫时，它将是 PSTN 用户，在从 Teams 用户呼叫的出站时，它将是 Teams 用户号码 |
| 12 | 被调用方号码 | nvarchar(32) |
接收呼叫的用户或机器人的编号。 在入站到团队用户呼叫时，它将是 Teams 用户，在从 Teams 出站用户呼叫时，它将是 PSTN 用户 |
| 13 | 呼叫类型 | nvarchar(32) |
呼叫类型和方向 |
| 14 | 呼叫方向 | nvarchar(32) |
呼叫是 PSTN 出站呼叫还是入站呼叫 |
| 15 | 适用于媒体的 Azure 区域 | nvarchar(8) |
用于非旁路呼叫中的媒体路径的数据中心 |
| 16 | 用于信号的 Azure 区域 | nvarchar(8) |
用于对旁路和非旁路呼叫发出信号的数据中心 |
| 17 | 最终 SIP 代码 | int |
调用结束的代码， RFC 3261 |
| 18 | 最终 Microsoft 子代码 | int |
除了 SIP 代码，Microsoft 还有自己的子代码，用于指示特定问题 |
| 19 | 最终 SIP 短语 | nvarchar(256) |
SIP 代码和 Microsoft 子代码的说明 |
| 20 | SBC FQDN | nvarchar(64) |
会话边界控制器的完全限定域名 |
| 21 | 媒体旁路 | nvarchar(3) |
是/否。 指示中继是否启用了媒体旁路 |
| 22 | 共享关联 ID | uniqueidentifier |
指示两个或更多调用相关 |
| 23 | 管理单元 | uniqueidentifier |
与调用关联的管理单元的集合。 |
| 24 | 传输或关联 ID | uniqueidentifier |
指示转接人和转接人之间调用的 CorrelationId |