推播歷史
推播歷史保留所有推播紀錄(含手動推播、自動行銷劇本、各模組觸發等所有來源),以「每位會員一筆」記錄,可查詢送達狀態、錯誤原因與實際渲染內容。
進入路徑
後台左側 LINE 通知中心 → 推播歷史。
主要功能
統計卡片 顯示今日成功、今日失敗、今日總數,以及篩選區間的總數。
多條件篩選 依日期區間、狀態、範本、會員 ID 篩選紀錄。
紀錄列表 顯示每筆推播的建立時間、範本、會員、狀態、通道、送出時間、錯誤訊息。
紀錄詳情 點擊任一筆可開啟 modal 查看 ID、觸發來源、錯誤訊息、渲染後完整內容。
紀錄狀態說明
| 狀態 | 說明 |
|---|---|
| 成功 | LINE 推播 API 回應成功 |
| 失敗 | API 回傳錯誤、會員未綁 LINE、或範本內容異常等 |
| 佇列中 | 已建立但尚未送出 |
通道說明
| 通道 | 說明 |
|---|---|
| LINE | 透過 LINE Messaging API 推播 |
| 透過 Email 寄送(僅特定模組會啟用) | |
| 失敗 | 無可用通道(會員未綁 LINE 也未留 email) |
操作流程
篩選查詢
於上方篩選列調整條件:
起始 / 結束日期 預設為近 7 天,可往前查詢更早紀錄。
狀態 全部 / 成功 / 失敗 / 佇列中。
範本 從下拉選單選擇特定範本,僅顯示由該範本送出的紀錄。
會員 ID 直接輸入會員 ID 查詢該會員收到的所有推播。
查看單筆詳情
點擊列表中任一列開啟詳情 modal,可查看:
紀錄 ID 唯一識別碼,給客服排查用。
建立 / 送出時間 兩個時間戳,可比對是否有送出延遲。
範本 若是自動觸發或手動發純文字會顯示「(直接發送)」。
會員 顯示名 / 姓名 / ID。
狀態、通道、觸發來源 觸發來源 (trigger_source) 可協助判斷是哪個功能觸發(例如 admin_manual 為後台手動、其餘為各模組自動觸發)。
錯誤訊息 失敗時顯示 LINE API 或內部錯誤的原始訊息,用於排查。
渲染後內容 變數套用後實際送出的完整內容(文字或 Flex JSON),可確認內容是否正確。
常見問題
Q1 歷史紀錄保留多久
紀錄保存於資料庫,不會自動刪除。若需要長期清理可由客服協助批次處理。
Q2 為什麼某筆紀錄顯示失敗
點開詳情查看「錯誤訊息」欄位,常見原因包含:
- 會員未綁定 LINE UID(line_id 為空)
- 會員已解除追蹤官方帳號(錯誤訊息「會員已解除追蹤 LINE」):系統在呼叫 LINE API 之前就會先判斷,不會等 LINE 回應。判斷到之後若該會員有留 email 會自動改走 email 通道(此時通道欄會顯示「Email」,不算失敗);沒有 email 才記為失敗。
- 會員已被列入黑名單(錯誤訊息「已列入黑名單,未發送」):此情況連 email 備援都不會送
- Flex Message JSON 格式錯誤
- 範本內容已被刪除或停用
- LINE API 呼叫本身出錯(例如金鑰 / 權限問題),錯誤訊息會顯示 LINE API 回傳的原始內容
Q3 怎麼知道是哪個功能觸發的這筆推播
詳情 modal 中的「觸發來源」欄位(trigger_source)會標示觸發源,例如 admin_manual 表示後台手動發送,其餘字串表示由特定模組或自動行銷劇本觸發。若需要進一步排查,可搭配同會員、同時間的其他紀錄交叉比對。
排查失敗原因 SOP
line_id 是否存在、是否已解除追蹤官方帳號、是否被列入黑名單。其他問題協助