打开报告选项卡。
上次更新日期：
2026年5月11日
生成计划的 CSV 报告以跟踪短信和 WhatsApp 使用情况、监测配额并按组分析消费情况。
交易使用导出可让您了解帐户中的短信和 WhatsApp 活动，包括购买数量、消费总计和组级使用情况。导出内容包括：
- 短信身份验证
- 短信发送
- WhatsApp 身份验证
- WhatsApp 发送事务。
导出是按计划生成的快照，而不是实时查询。使用计划进行持续监控，或手动准备导出以在需要立即更新数据时重新生成。
数据导出的工作原理
事务数据在定义的日期范围内并使用指定筛选条件导出为 CSV 文件。
- 导出异步生成，并非实时。
- 导出按配置的计划刷新。
- 选择准备可使用最新可用数据重新生成导出。
CSV 中的每一行代表一个协议，包含短信和 WhatsApp 事务使用数据。
创建事务使用情况报告
从报告选项卡创建 CSV 报告。
-
-
选择新建导出。
-
选择事务使用情况。
-
定义导出：
- 选择日期范围。
- 应用筛选条件，包括一个或多个组（如需要）。
-
选择选择列并选择要包含的数据。
对于短信和 WhatsApp 事务使用情况，在“可用列”部分展开附加服务并包含以下内容：
- 消息投递附加服务的购买数量 - 购买的事务总数。
- 消息投递附加服务的开始日期 - 应用事务配额时的年度生效日期。
- 短信 OTP 消耗计数 - 基于短信的身份验证所使用的事务。
- 短信协议投递消耗计数 - 通过短信发送协议链接所使用的事务。
- WhatsApp OTP 消耗计数 - 基于 WhatsApp 的身份验证所使用的事务。
- WhatsApp 协议投递消耗计数 - 通过 WhatsApp 发送协议链接所使用的事务。
要启用组级报告，还需包含发送方组列。
-
选择保存，并为导出内容提供一个名称。
导出以异步方式生成，完成后会显示在最近报告列表中。
配置准确的组级数据
组级使用情况需要筛选和列选择。
- 定义导出时应用一个或多个组筛选条件。
- 在导出中包含发送方组列。
如果不满足任一要求，组级使用情况将无法在导出数据中准确表示。
确保合同使用情况数据准确
要针对正确的合同期间生成报告：
- 使用电话配额生效（开始）日期作为报告开始日期。
- 此值可在以下位置找到：帐户设置 > 发送设置
使用正确的开始日期可确保包含当前合同下的所有事务，并且使用情况总计和组级摘要准确无误。
计划报告
计划报告以自动生成更新的事务数据。
-
创建新导出或编辑现有导出。
-
为要计划的导出选择省略号，然后从下拉菜单中选择计划。
-
通过定义以下内容配置计划：
- 计划频率（每日、每周、每月）
- 要将报告发送到的目标电子邮件
- 可选消息
-
保存计划。
定期报表会自动生成，可从最近报告列表下载或通过电子邮件发送。
使用最新数据更新导出
更新导出：
- 选择准备以立即重新生成导出。
- 或等待下次计划运行。
- 如果需要，您还可以使用相同参数创建新的导出。
使用 API 下载导出
使用 API 检索最新生成的导出。
- 端点：POST /api/rest/v6/reportDownload
- 必需参数：scheduleId
此端点：
- 需要在报告 UI 中创建导出计划。
- 仅返回最新 CSV 文件的下载 URL。
- 不会按需生成新的导出。
如果导出尚未更新，则返回之前生成的 CSV 文件。
下载大型 CSV 文件时，由于必须准备所有记录，处理时间可能会更长。配置至少 5 分钟的客户端超时，以确保成功下载。
导出可用性和保留期
- 导出的 CSV 文件存储 7 天。
- 7 天后，文件过期且不再可供下载。
- 要访问更新的数据，请使用准备重新生成导出或等待下次计划运行。
需要了解的事项
- 必须先创建或计划导出，然后才能通过 API 访问。
- 通过 API 只能获取计划的最新 CSV 文件。
- 组级别报告需要以下两项：
- 组筛选条件
- 发件人组列
- 使用正确的电话配额生效（开始）日期对于准确的合同级别报告至关重要。
- 导出文件将在 7 天后过期，如有需要，必须重新生成。
