通知发送记录的作用

通知发送记录主要用于确认向谁发送了通知、发送了什么内容、使用了哪个发送渠道、在什么时间发送、是否发送成功、是否被第三方服务接受、是否发生发送失败，以及失败原因是什么。

通过这些记录，机构可以更加清楚地了解通知任务的实际执行情况。

支持的通知类型

根据机构启用的功能，发送记录可以覆盖站内通知、App Push、Apple APNs、Google FCM、短信 SMS、邮件 Email、系统消息、用户定向通知、用户分组通知、定时通知、业务触发通知及其他自定义消息。

具体可记录的渠道，以机构当前配置及启用的通知服务为准。

记录内容

一条通知发送记录通常可包含发送时间、Notification ID、Organization ID、通知类型、发送渠道、接收用户、User ID、用户分组、通知标题、内容摘要、发送状态、第三方服务状态、Message ID、Error Code、Error Message、重试次数、创建人员及其他相关信息。

对于批量发送任务，也可以查看整体任务状态与单个用户的发送结果。

发送状态

通知记录可以包含 Pending、Processing、Sent、Delivered、Failed、Rejected、Expired、Cancelled 等不同状态。

不同通知渠道所提供的状态可能不同。

例如，某些第三方服务只能确认消息已经成功提交，但无法保证最终设备或用户已经实际查看。因此，“发送成功”与“用户已阅读”应作为不同概念处理。

Push 推送记录

对于 App Push，系统可以记录通过 Apple APNs 或 Google FCM 发出的推送请求。

例如 Channel：Push，Provider：Apple APNs，User：User 10284，Status：Sent，Message ID：push_8F291C。

如果发送失败，也可以记录 Invalid Device Token、Device Token Expired、Provider Authentication Failed、Push Service Unavailable 等错误原因，帮助技术人员快速确认 Push 无法送达的原因。

短信发送记录

如果机构启用了短信服务，可以查看短信发送情况。

例如 Channel：SMS，Recipient：+81******1234，Provider：机构配置的短信服务商，Status：Delivered。

对于使用 Finger Manager 提供的短信运营商服务，以及机构自行配置的短信服务商账户，均可根据实际集成情况记录对应发送状态。

邮件发送记录

邮件通知可以记录收件人、邮件标题、发送时间、SMTP 或邮件服务商、发送结果、Message ID 和失败原因。

如果机构配置了自己的 SMTP 或邮件服务商账户，则相关消息将通过机构配置的发送渠道执行。

批量通知

对于用户分组或批量发送的通知，可以记录任务整体执行情况。

例如目标用户 10,000，发送成功 9,832，发送失败 168，正在处理 0。

管理员可以进一步查看具体失败用户及失败原因。这种记录适合用于活动通知、系统公告、市场通知、用户分组运营、批量风险提示等场景。

定时通知

如果消息通过定时任务发送，通知记录可以同时保留计划发送时间、实际发送时间、创建人员、执行状态和发送结果。

例如 Scheduled Time：2026-08-29 09:00，Actual Send Time：2026-08-29 09:00:03，Status：Completed。

这样可以帮助机构确认定时任务是否按照计划执行。

失败排查

当通知发送失败时，可以优先检查用户联系方式是否有效、Device Token 是否有效、Apple / Google 推送凭证是否正确、SMTP 设置是否正确、短信服务商账户是否正常、第三方服务余额或额度是否充足、API Key 是否有效、消息内容是否符合服务商规则、第三方服务是否出现异常，以及网络连接是否正常。

通知发送记录中的 Error Code 与 Error Message 可以作为问题排查的重要依据。

日志查询

机构可以根据不同条件查询发送记录，例如时间范围、User ID、Notification ID、通知渠道、发送状态、用户分组、创建人员、Message ID 和 Error Code。

例如，可以查询过去 24 小时所有 Push 发送失败记录，或者查询某个用户最近 30 天收到的全部系统通知。

与通知功能的关系

通知模块用于创建和发送通知；通知发送记录用于查看这些通知实际是如何被执行的。

例如创建通知、选择用户分组、选择 Push + Email 后，系统开始发送并生成发送记录，管理员可以查看每个渠道及用户的发送结果。

这样可以形成完整的通知管理流程。

第三方发送服务

部分通知需要依赖第三方服务完成实际发送，例如 Apple APNs、Google FCM、短信服务商、邮件服务商、机构自己的 SMTP、机构自己的第三方消息服务。

Finger Manager 可以记录向这些服务提交消息的过程及返回结果。

最终送达状态可能受到用户设备状态、网络状态、第三方服务规则、邮箱服务器、手机运营商、用户系统设置等因素影响。

使用示例

例如，机构向 5,000 名用户发送一条系统维护通知。

通知名称：System Maintenance Notice；渠道：Push + Email；目标用户：5,000；Push：4,891 Sent，109 Failed；Email：4,972 Sent，28 Failed。

管理员可以继续查看失败记录，确认具体用户及错误原因。

说明

通知发送记录主要用于追踪 Finger Manager 中消息任务的执行情况。

机构可以通过发送记录了解不同通知渠道的运行状态，并结合第三方服务返回结果进行问题排查。

发送记录显示的状态应以对应通知渠道实际提供的回执能力为准。