Microsoft Teams PSTN 使用情况报告

Microsoft Teams 管理中心的 Teams PSTN (公用电话交换网) 和短信使用情况报告概述了组织中的通话和音频会议活动。 如果使用 Microsoft 作为电话运营商,则可以查看通话套餐的详细呼叫活动;如果使用自己的电话运营商,可以查看直接路由的详细呼叫活动。

通话套餐 ”选项卡显示信息,包括用户在入站和出站 PSTN 呼叫中花费的分钟数以及这些呼叫的费用。 “ 直接路由 ”选项卡显示信息,包括 SIP 地址以及呼叫开始和结束时间。 使用此报表中的信息深入了解组织中的 PSTN 使用情况,并帮助你调查、规划和制定业务决策。

注意

如果你有 Telstra 或 Softbank 呼叫计划,则不会在 PSTN 使用情况报告中看到任何呼叫详细信息记录。 请联系 Telstra 或 Softbank 了解报告需求。

查看 PSTN 使用情况报告

  1. 在 Microsoft Teams 管理中心的左侧导航栏中,单击“ 分析”& 报告>使用情况报告。 在“ 查看报表 ”选项卡上的“ 报表”下,选择“ PSTN 和短信 (预览) 使用情况”。
  2. “日期范围”下,选择预定义的 7 天或 28 天范围,或设置自定义范围,然后选择“ 运行报表”。

解释报告

通话套餐

管理中心“通话套餐 PSTN 使用情况报告”报表的屏幕截图。Microsoft Teams 管理中心的 PSTN 使用情况报告的屏幕截图,其中包含编号标注。

标注 说明
1 可以查看过去 7 天、28 天或你设置的自定义日期范围的趋势报表。
2 每个报表都有生成日期。 报表通常反映活动时间的 24 至 48 小时延迟。
3 X 轴是特定报表的选定日期范围。 Y 轴是所选时间段内的调用总数。
将鼠标悬停在给定日期的点上可查看该日期的总调用数。
4 下表提供了每个呼叫的 PSTN 使用情况的细目。
  • 时间戳 (UTC) 是呼叫开始的时间。
  • 显示名称 是用户的显示名称。 可以单击显示名称转到 Microsoft Teams 管理中心中的用户设置页。
  • 用户名 是用户的登录名。
  • 电话号码 是接收呼入呼叫的号码或为出站呼叫拨打的号码。
  • 呼叫类型 是呼叫是 PSTN 出站呼叫还是入站呼叫,以及呼叫类型(例如用户发出的呼叫或音频会议)。 你可能会看到的调用类型包括:

    Teams 用户呼叫类型
    • user_in - 用户收到入站 PSTN 呼叫
    • user_out - 用户发出出站 PSTN 呼叫
    • user_out_conf - 用户向呼叫添加了两个或更多 PSTN 参与者,例如三向电话会议
    • user_out_transfer - 用户已将呼叫转接到 PSTN 号码
    • user_out_forwarding - 用户将呼叫转接到 PSTN 号码
    • conf_in - 对音频会议网桥的入站呼叫
    • conf_out - 音频会议网桥的出站呼叫通常用于向会议添加 PSTN 号码
    • unassigned_in - 通过呼叫计划对未分配号码进行入站 PSTN 呼叫

    Teams 机器人调用类型
    • ucap_in - 对 Teams 机器人的入站 PSTN 呼叫,例如自动助理或呼叫队列
    • ucap_out - 来自 Teams 机器人的出站 PSTN 呼叫,例如自动助理或呼叫队列

  • 调用 的 是拨打的号码。
  • “国家或地区 ”是拨打的国家或地区。
  • 呼叫自 是发出呼叫的号码。
  • 发件人国家或地区 是发出呼叫的国家或地区。
  • 费用 是向帐户收取的通话费用或费用。
  • 货币 是用于计算调用成本的货币类型。
  • " 持续时间"是接听呼叫的时间。
  • “国内/国际 ”会根据用户的位置告知呼叫是国家或地区) 国内 (,还是某个国家或地区以外的国际 () 。
  • 呼叫 ID 是呼叫的呼叫 ID。 它是调用Microsoft 支持部门时可以使用的呼叫的标识符。
  • 号码类型 是用户的电话号码类型,例如免费号码服务。
  • 国家或地区 是使用位置。
  • 会议 ID 是音频会议的会议 ID。
  • 功能 是用于调用的许可证。 你可能会看到的许可证类型包括:
    • MCOEV、MCOEV_VIRTUALUSER或MCOEV_VIRTUALUSER_GOV - 自动助理或呼叫队列等语音应用程序
    • FREECALL - 如果出现技术问题,导致无法为呼叫定价,呼叫将免费提供,并且将随此功能一起显示
    • MCOPSTN1 - 国内通话套餐 (3000 分钟美国/1200 分钟欧盟计划)
    • MCOPSTN2 - 国际通话套餐
    • MCOPSTN5 - 国内通话套餐 (120 分钟通话套餐)
    • MCOPSTN6 - 国内通话套餐 (240 分钟通话套餐)
    • MCOPSTN8 - 国内通话套餐每个用户 120 分钟 (不会像其他通话套餐一样跨用户共用)
    • MCOPSTN9 - 国际通话套餐
    • MCOPSTNCAP - 公用区域电话
    • MCOPSTNPP - 通信额度
    • MCOMEETADD - 音频会议
    • MCOMEETADD_DIALOUT_US - 音频会议美国和加拿大拨出计划
    • MCOMEETADD_CN_GLOBAL - 非中国用户的音频会议
    • MCOMEETADD_TATA - 塔塔通信Connections
    • MCOMEETACPEA - 音频会议按分钟付费
    • MCOMEETACPEA_GOV - 政府音频会议按分钟付费
要查看希望在表格中显示的信息,请确保向表格添加了相关列。
5 选择“编辑列”可在表格中添加或删除列。
6 选择“ 筛选 ”,按用户名或呼叫类型筛选报表。
7 选择“ 全屏 ”以全屏模式查看报表。
8 可以将报表导出到 CSV 文件以供脱机分析。 单击“ 导出到 Excel”,然后在“ 下载 ”选项卡上,单击“ 下载 ”以在报表准备就绪时下载报表。

直接路由

管理中心中直接路由 PSTN 使用情况报告报告的屏幕截图 Microsoft Teams 管理中心中带有编号标注的直接路由 PSTN 使用情况报告的屏幕截图

标注 说明
1 可以查看过去 7 天或 28 天的趋势报表。
2 每个报表都有生成日期。 报表通常反映活动时间的 24 至 48 小时延迟。
3 X 轴是特定报表的选定日期范围。 Y 轴是所选时间段内的调用总数。
将鼠标悬停在给定日期的点上可查看该日期的总调用数。
4 下表提供了每个呼叫的 PSTN 使用情况的细目。
  • 时间戳 (UTC) 是呼叫开始的时间。
  • 显示名称 是用户的显示名称。 可以单击显示名称转到 Microsoft Teams 管理中心中的用户设置页。 该名称也可以是机器人的名称,例如呼叫队列或云自动助理。
  • SIP 地址 是接收或发出呼叫的用户或机器人的 SIP 地址。
  • 呼叫者号码 是发出呼叫的用户或机器人的号码。
  • 被调用方号码 是接收呼叫的用户或机器人的号码。 在对 Teams 用户的入站呼叫中,它将是 Teams 用户,在 Teams 用户的出站呼叫中,它将是 PSTN 用户。
  • 呼叫类型 是呼叫是 PSTN 出站呼叫还是入站呼叫,以及呼叫类型(例如用户发出的呼叫或音频会议)。 你可能会看到的呼叫类型包括:

    Teams 用户呼叫类型
    • dr_in - 用户收到了 PSTN 入站呼叫
    • dr_out - 用户发出出站 PSTN 呼叫
    • dr_out_user_conf - 用户向呼叫添加了 PSTN 参与者
    • dr_out_user_forwarding - 用户将呼叫转接到 PSTN 号码
    • dr_out_user_transfer - 用户已将呼叫转接到 PSTN 号码
    • dr_emergency_out - 用户发出紧急呼叫
    • dr_unassigned_in - 通过直接路由到未分配号码的入站 PSTN 呼叫

    Teams 机器人调用类型
    • dr_in_bot - 对 Teams 机器人(如自动助理或呼叫队列)的入站 PSTN 呼叫
    • dr_out_bot - 来自 Teams 机器人的出站 PSTN 呼叫,例如自动助理或呼叫队列

  • 调用 的 是接收呼叫的用户的号码。
  • 开始时间 (UTC) 是 SIP 代理在向 PSTN 用户) (Teams/机器人发出出站呼叫时从 SBC 收到最终应答 (SIP 消息“200 正常”) ,或者 SIP 代理在入站呼叫 (PSTN 用户向 Teams/机器人) 发送 Teams 后端中的下一跃点邀请的时间。
  • 邀请时间 (UTC) 是在从 Teams 用户或机器人呼叫到 SBC 的出站呼叫上发送初始邀请的时间,或者从 SBC 直接路由的 SIP 代理组件在对 Teams 或机器人呼叫的入站呼叫上接收的时间。
  • 失败时间 (UTC) 是调用失败的时间。 仅适用于失败的调用。 最终 SIP 代码、最终 Microsoft 子代码和最终 SIP 短语提供了呼叫失败的原因,并有助于进行故障排除。
  • UTC) (结束 时间是呼叫结束 (,仅) 成功调用的时间。
  • 持续时间 是呼叫连接的时长,从邀请到呼叫结束或失败。 对于呼叫转接,持续时间包括呼叫队列中的响铃。
  • 号码类型 是用户的电话号码类型,例如免费号码服务。
  • 媒体旁路 指示是否为中继启用了媒体旁路。
  • SBC FQDN 是会话边界控制器 (FQDN) (SBC) 的完全限定域名。
  • Azure 媒体区域 是在非旁路调用中用作媒体路径的数据中心。
  • 用于信号的 Azure 区域 是用于对旁路和非旁路呼叫发出信号的数据中心。
  • 事件类型 是调用的事件类型。 你将看到成功调用的成功和失败调用的尝试。
  • 最终 SIP 代码 是结束调用的代码。
  • 最终 Microsoft 子代码 是指示发生的特定操作的代码。
  • 最后一个 SIP 短语 是 SIP 代码和 Microsoft 子代码的说明。
  • 关联 ID 是调用Microsoft 支持部门时可以使用的调用的唯一标识符。
  • 共享关联 ID 仅在可下载的 CSV 文件中可见,在门户中不存在。 共享关联 ID 至少存在于两个相关的调用中。 请参阅下面的详细说明。
要查看希望在表格中显示的信息,请确保向表格添加了相关列。
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。

  1. PSTN 用户 1 在 Teams 客户端上名为 Teams 用户 1 的 PSTN 终结点上,呼叫类型Dr_In,关联 ID 57f28917-42k5-4c0c-9433-79734873f2ac,无共享关联 ID。
  2. Teams 客户端上的 Teams 用户 1 在 PSTN 终结点上称为 PSTN 用户 1,呼叫类型Dr_Out 2c12b8ca-62eb-4c48-b68d-e451f518ff4,无共享关联 ID。
  3. PSTN 用户 1 在 Teams 客户端上名为 Teams 用户 2 的 PSTN 终结点上,呼叫类型Dr_In f45e9a25-9f94-46e7-a457-84f5940efde9,共享相关 ID f45e9a25-9f94-46e7-a457-84f5940efde9。
  4. 具有相关 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