群發訊息

群發訊息為對指定範圍會員一次性發送的功能。一般訊息可組合文字 / 圖片 / 影片 / 圖卡 / 多頁圖卡最多 5 則同時發送；也可切換為贈送票券 / 贈送點數，並可選擇立即送出或排程未來時間送出。

進入路徑

後台左側 訊息發送 → 群發訊息。頁面分為兩個區塊：左側「推播給單一會員」、右側「群發訊息」。本說明聚焦右側「群發訊息」區塊。

群發欄位

發送對象：會員 vs LINE 群組

先選「發送對象」再選範圍：

• 會員：發給會員本人的一對一私訊，可再用下方的會員範圍縮小。
• LINE 群組：發進官方帳號所在的群組 / 多人聊天室，**群組裡每個人都會收到通知，

包含還不是會員的人**。群組不是會員，沒有分群 / 標籤 / 等級 / 分店， 也沒有可以掛票券或加點的對象，所以選了群組之後那些選項會關閉，只能發一般訊息。 一般訊息可以立即發送，也可以排程。

發送範圍（發送對象為「會員」時）

可從會員範圍下拉選擇四種：

• 全部會員：所有有 LINE 綁定、未封鎖的會員。
• 按群組：選一個會員群組，僅該群組成員會收到。
• 按標籤：選一個會員標籤，僅持有該標籤者會收到。
• 按等級：選一個會員等級，僅該等級會員會收到。

群發不分店：不論從哪個分店入口、用哪個分店帳號發送，收件對象都是整個品牌符合範圍的會員。預估人數旁會標示「全品牌會員，不分店」；群發紀錄裡的「發送者所屬分店」只記錄是哪家店發的，不代表只發給該店顧客。

選擇後系統在送出時於後端依條件 SQL 過濾出有 line_id 的會員，每批 500 人呼叫 LINE multicast 送出。

發送內容三大模式

「發送內容」按鈕組決定下方輸入欄位：

一般訊息（可組合 1-5 則）

點下「+ 文字 / + 圖片 / + 圖卡 / + 多頁圖卡」加入下一則訊息，順序可用「↑ / ↓」箭頭調整、「✕」刪除。

加進來之後，每一則左上角都有一個類型下拉可以改，下拉裡有 文字 / 圖片 / 影片 / 圖卡 / 多頁圖卡 五種。 影片沒有對應的「+」按鈕：要發影片請先用任一顆「+」加一則，再把那一則的類型改成「影片」。

每則訊息類型：

• 文字：純文字（LINE text 訊息），單則上限 5000 字。
• 圖片：貼 https:// 圖片 URL 或點「上傳圖片」按鈕從電腦選圖（自動上傳到 R2 存放）。單張建議 1024x1024 內；LINE 上限原圖 10MB。必須是 https URL（LINE 規範）。
• 影片：填影片網址與封面圖網址，兩個都必填、且都必須是 https://。封面圖是 LINE 對影片訊息的硬性規定，沒填會在送出前被擋下（圖片則不會，圖片沒填封面會自動用原圖）。
• 圖卡：從下拉選單挑一張已在「內容管理 → 系統圖卡」建立的單頁 Flex 範本（bubble）。可填「替代文字 altText」在 LINE 通知列顯示。若下拉是空的，代表尚無已啟用範本，請先建立。
• 多頁圖卡：與「圖卡」相同機制，但範本是多頁 carousel（可左右滑動）。

一次群發最多 5 則（LINE multicast API 單次上限）。

贈送票券

選一張已建立的票券（vouchers），群發後每位收件會員自動領取一張該票券 + 系統圖卡通知（走 voucher 模組既有推播卡）。

贈送點數

輸入正整數點數，群發後每位收件會員自動加點 + 寫 points_log + 系統推播加點通知。

預估人數（即時顯示）

選好會員範圍後，表單下方會即時顯示預估人數，方便群發前確認觸及規模：

• 選擇會員範圍後將顯示預估人數：尚未選範圍時的預設提示。
• 預計發送 N 人：篩出的 line_id 有效會員總數。若其中有已解除追蹤的人，會再以括號標示「X 位未偵測到解除追蹤 / Y 位已解除追蹤，LINE 會回報成功但訊息不會送達」。「未偵測到解除追蹤」只代表系統沒有收到那個人的解除追蹤事件，不等於確認他是好友。
• 若 X > 500，會提示「LINE multicast 每批 500 人，將分 N 批送出」（對齊 LINE multicast 單批 500 人上限）。
• 追蹤狀態最後對帳：人數下方固定多一行，顯示這個帳號上一次執行「好友對帳」的時間（三種顯示見下一節）。即使已解除追蹤是 0 位也會顯示，因為從未對帳的帳號那個 0 永遠是 0。

filter 條件變動 debounce 300ms 後自動重算，不需按送出前試算按鈕。

好友對帳日期（追蹤狀態的可信度）

會員的追蹤狀態有兩個來源：LINE 即時送來的解除追蹤事件，以及後台 系統設定 → 基本資料設定 → LINE 好友狀態同步 執行的好友對帳（手動或排程）。事件只涵蓋接上系統之後發生的事，接上系統之前就退追蹤的人不會被偵測到。所以從未對帳的帳號，「已解除追蹤」永遠是 0 位，「未偵測到解除追蹤」也就不能當成好友人數。

因此群發訊息的預估人數下方、以及群發紀錄收件明細「送出當時」欄的說明旁，各有一行對帳日期，三種顯示：

時間以台北時區顯示。

收件明細的參考點是「送出當時」：那裡顯示的是「送出前最後一次好友對帳：2026-09-01 03:12（送出時已 2 天未對帳）」，只算這筆群發送出之前的對帳。送出之後才執行的對帳對那次送出沒有幫助，所以不會讓這筆舊紀錄看起來比較新。

排程發送

開啟「排程發送」開關，會顯示日期 + 時間兩個輸入框。設定後送出時，系統將排程儲存，到時間自動執行。若關閉開關，即為立即送出。

操作流程

1. 設定標題（選填）。
2. 切換是否排程發送、若是請填日期與時間。
3. 選擇會員範圍與子選項。
4. 選擇訊息類型 + 填寫對應內容（文字 / 票券 / 點數）。
5. 點下方「群發訊息」（排程模式則顯示「設定排程」）。
6. 成功時跳 Toast 「群發成功」或「排程設定成功」，表單會自動清空。

推播額度提醒

LINE 官方帳號對「群發 / 多目標 multicast」會計入月推播額度，依方案不同（200 / 5,000 / 30,000 / 自訂）。建議：

• 群發前確認 LINE OA Manager 後台尚有額度；超額會送不出去。
• 同一會員每週主動推播建議不超過 2 至 3 次，避免封鎖。
• 沉睡會員推播間隔拉長，避免反向加速流失。

常見問題

Q1　群發後部分會員沒收到

可能原因：

第一　會員 line_id 為空（未綁定 LINE，會被自動跳過）。

第二　會員已封鎖（is_blocked = true 或 LINE 端封鎖）。

第三　LINE 推播額度已用完，後續會員 LINE API 會回失敗。

第四　票券 / 點數類群發若會員資料異常（例：點數欄位限制）可能個別失敗。

第五　該會員已解除追蹤或封鎖官方帳號。這一種最不容易發現：LINE 的推播 API 對這種對象一樣回報成功，訊息卻不會送達。所以後台顯示「回報成功」不等於對方看到了。

要查個別對象的結果，請點開該筆群發的詳情，看下方的「收件明細」（見 Q5-1）。

Q2　可以撤回已發送的訊息嗎

無法。LINE 官方規定發出後即無法收回，請發送前再次檢查收件範圍與訊息內容。

Q3　可以群發 Flex 圖卡 / 圖片 / 影片嗎

圖片、圖卡（單頁）、多頁圖卡：一般訊息模式下已支援，最多 5 則可混合組合。

影片：一般訊息模式下也已支援，在該則訊息的類型下拉選 影片。兩個網址是一組，都要填：

• 影片網址　必須是 https:// 開頭（LINE 規範，http 會被擋下）。
• 封面圖網址　LINE 規定影片訊息的封面圖必填，沒填會在送出前被擋下並提示。這一點和圖片不同（圖片沒填封面會自動用原圖）。

Q4　排程能修改或取消嗎

可以。到後台 訊息發送 → 排程清單，找到要取消的排程列，點右側「取消」按鈕，確認後該筆排程的狀態會變成「已取消」，cron 不會再觸發。

排程「不能修改」（避免改錯時間 / 內容造成誤發），如需調整請先取消、再到「群發訊息」重新建立一筆新排程。

已送出（status = sent / cancelled / failed）的排程無法再取消。

Q5　如何看歷史群發紀錄

到後台 訊息發送 → 群發紀錄，可以看到所有立即發送 / 排程觸發的群發歷史，欄位包含：

• 時間
• 標題
• 訊息類型（文字 / 票券 / 點數）
• 發送對象（全部會員 / 會員分群 / 標籤 / 等級 / LINE 群組）
• 觸達數 / 對象數
• 失敗數
• API 呼叫（M 次皆回報成功 / 回報失敗 N／M 次 / －）
• 狀態（已送出 / 部分成功 / 失敗）

「對象數」的單位會跟著發送對象變：發給會員時是人數，發進 LINE 群組時是群組數 （例如「3 個群組」代表送進三個群組，實際看到訊息的人數會多於 3）。

「API 呼叫」欄的數字是這筆群發呼叫 LINE API 的次數，不是人數：發給會員時每 500 人一批算一次，發進 LINE 群組時每個群組算一次。三種顯示：

• M 次皆回報成功：M 次呼叫 LINE 都受理了。
• 回報失敗 N／M 次：M 次呼叫裡有 N 次 LINE API 回報失敗。點這一格會直接打開這筆的收件明細，並自動套上「僅 API 回報失敗」篩選，一眼看到是哪一個群組 / 哪一批失敗。
• －：沒有逐次呼叫紀錄，不是 0 次。滑鼠停在上面會顯示原因，兩種：「這筆群發沒有逐次呼叫紀錄（通常是在收件明細功能上線前送出）」或「此帳號的逐次呼叫紀錄尚未啟用（系統升級中）」。

可以用「日期區間」、「狀態」、「分店」（多店租戶才有）做篩選；點任一列開詳情可看完整的 messages JSON 與失敗錯誤訊息。

Q5-1　怎麼查「這一筆到底送到了誰」

點開群發紀錄的詳情，往下捲到「收件明細」。這一段列出這次群發逐筆的送出對象與 LINE 回報結果：

• 對象：群組名稱或會員姓名（LINE ID 只顯示頭尾，例如 U***1234）
• 類型：LINE 群組 / 會員
• LINE API 回報：回報成功 / 回報失敗。失敗會一併顯示 LINE 回的錯誤原文，預設只顯示前 120 字，點「展開全文」可看完整內容
• 送出當時（發給會員時才有）：送出當時的追蹤狀態，分「已解除追蹤」（訊息不會送達）/「未偵測到解除追蹤」/「無此資料」。「未偵測到解除追蹤」只代表系統沒收到他的解除追蹤事件，不等於確認是好友
• 結果範圍：這一列的成敗涵蓋幾個人（見下方說明）
• 時間

「LINE API 回報」下拉可切換「僅 API 回報成功」/「僅 API 回報失敗」，也可以用會員姓名 / 電話 / 群組名稱搜尋「某個人在不在這次的收件名單裡」。從群發紀錄列表的「回報失敗 N／M 次」點進來時，會自動套上「僅 API 回報失敗」。

「送出當時」欄的說明旁會多一行「送出前最後一次好友對帳：……」，那是判斷這一欄可不可信的依據；若顯示「從未執行好友對帳」，整欄「未偵測到解除追蹤」只代表沒收到事件（見上方「好友對帳日期」一節）。

為什麼「結果範圍」有兩種

• 發進 LINE 群組：一個群組送一次，所以每一列都是該群組自己的結果 ——「哪一個群組沒送成功、為什麼」查得到。
• 發給會員：LINE 規定一次最多 500 人一批，而它只回報整批的結果。所以同一批的每一位都會顯示相同的結果，那是這一批的結果，不是這一位的個別結果。

什麼情況下這裡會是空的

• 票券 / 點數型群發：這兩種是逐位發券 / 加點，收件結果請看該會員的票券紀錄或點數紀錄。
• 本功能上線前送出的舊群發：當時沒有留下逐筆紀錄，請改看上方的「觸達 / 對象」與錯誤訊息。

兩種情況畫面上都會直接寫明是哪一種 —— 查不到紀錄不等於沒有發給他。

Q6　群發失敗怎麼辦

到「群發紀錄」頁，狀態為「失敗」的列右側會出現「重發」按鈕。點下去確認後，系統會用原本的標題 / 範圍 / 訊息內容重新發送一筆（原失敗紀錄保留不變），新紀錄會出現在列表最上方。

注意：

• 重發會重新計算對象與扣 LINE 推播額度，請先確認 LINE 額度足夠。
• 同一筆失敗紀錄「重發」操作每分鐘最多 3 次，避免連續誤點重複發送。
• 如果連續重發都失敗，請先查詳情頁的「錯誤訊息」確認原因（多為 LINE 配額或 channel access token 失效），排除後再重試。