通知發送記錄的作用

通知發送記錄主要用於確認向誰發送了通知、發送了什麼內容、使用了哪個發送渠道、在什麼時間發送、是否發送成功、是否被第三方服務接受、是否發生發送失敗，以及失敗原因是什麼。

透過這些記錄，機構可以更加清楚地了解通知任務的實際執行情況。

支援的通知類型

根據機構啟用的功能，發送記錄可以覆蓋站內通知、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 中消息任務的執行情況。

機構可以透過發送記錄了解不同通知渠道的運行狀態，並結合第三方服務返回結果進行問題排查。

發送記錄顯示的狀態應以對應通知渠道實際提供的回執能力為準。