UGOMK 操作手冊
03 章 / 共 4

推播歷史

推播歷史保留所有推播紀錄(含手動推播、自動行銷劇本、各模組觸發等所有來源),以「每位會員一筆」記錄,可查詢送達狀態、錯誤原因與實際渲染內容。

進入路徑

後台左側 LINE 通知中心 → 推播歷史

主要功能

統計卡片 顯示今日成功、今日失敗、今日總數,以及篩選區間的總數。

多條件篩選 依日期區間、狀態、範本、會員 ID 篩選紀錄。

紀錄列表 顯示每筆推播的建立時間、範本、會員、狀態、通道、送出時間、錯誤訊息。

紀錄詳情 點擊任一筆可開啟 modal 查看 ID、觸發來源、錯誤訊息、渲染後完整內容。

紀錄狀態說明

狀態說明
成功LINE 推播 API 回應成功
失敗API 回傳錯誤、會員未綁 LINE、或範本內容異常等
佇列中已建立但尚未送出

通道說明

通道說明
LINE透過 LINE Messaging API 推播
Email透過 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

1. 先看狀態 篩選「失敗」狀態快速找出問題紀錄。 2. 點詳情看錯誤訊息 LINE API 錯誤碼(如 403、400)會直接顯示。 3. 比對渲染後內容 確認變數是否有空值、Flex JSON 是否正確。 4. 確認會員資料 檢查該會員 line_id 是否存在、是否已解除追蹤官方帳號、是否被列入黑名單。

其他問題協助

若遇本說明未涵蓋的問題,請透過後台右下角 LINE 客服 @ugomk 聯繫真人專員協助處理。