黑名單模式

黑名單模式決定「被列為黑名單的會員」到底被擋到什麼程度：僅擋主動推播，或完全禁止進入系統。此設定位於「系統設定」頁面的下半部區塊，預設「僅擋廣播」以維持既有行為。

進入路徑

後台左側 系統設定 → 基本資料設定 頁面下半部的「黑名單模式」區塊（非獨立頁面）。

兩種擋法

「完全禁止進入系統」實際覆蓋範圍

開啟後，黑名單會員的所有互動途徑會被守住（2026-07-06 sprint 落地 38 支公開端 API + webhook 3 事件）：

LINE 訊息相關（webhook 層擋）

• 送文字訊息 → 系統不觸發關鍵字自動回覆（silent break）
• 點圖文選單按鈕、Flex 按鈕、Quick Reply → postback 事件被 silent break
• 加好友（follow event）→ 不觸發加入禮、不寫 followed_at

LIFF 端 30+ 支公開端 API

• 兌換 / 送禮 / 票券核銷
• 訂位 / 桌邊下單 / KDS
• 課程報名 / 場地預約 / 旅宿預訂
• 抽獎 / 問卷 / 光明燈申請
• 聚會加入 / 市集集點 / 活動 RSVP
• 推薦碼綁定 / 積分轉贈

自動任務（ma-engine 層擋）

• 所有 ma_rules 自動行銷任務（生日推播、休眠喚回、消費後推薦）遇到黑名單會員自動 skip

開啟步驟

1. 到 系統設定 → 黑名單模式
2. 選「完全禁止進入系統」
3. optional 填「封鎖訊息」黑名單會員打開 LIFF 時看到的自訂文案（未填則用預設「此帳號已被封鎖，如有疑問請聯繫店家」）
4. 按 儲存 → 10 秒內生效（in-process cache TTL）
5. 儲存後上方會看到「黑名單會員數：N 位」

如何加入 / 移除黑名單

加入：會員列表 → 找到該會員 → 三點選單 → 加入黑名單。系統會將 members.is_blocked = true。

移除：會員列表 → 該會員 → 三點選單 → 移出黑名單。

只有 is_blocked = true 的會員會被擋。舊資料中 status = 'blocked' 的紀錄（早期代表「已 unfollow OA」）不會被此模式擋，避免歷史誤記造成合法會員誤鎖。

稽核紀錄

每次擋掉會寫 audit_logs，action = blocklist.access_denied，內容包含：

• endpoint（哪支 API 擋的）
• reason（is_blocked）
• IP / User-Agent（用於客訴排查）
• 時間戳

super_admin 遇客訴時可用 audit_logs action filter 搜「blocklist.access_denied」快速定位被擋的操作。

客訴排查建議

若客人反應「打開 LIFF 就跳封鎖畫面」：

1. 先到 會員列表 用該會員 UID / 電話搜尋
2. 確認 狀態欄位 是否有黑名單標記
3. 若是誤操作 → 立即「移出黑名單」→ 請客人重新打開 LIFF（10 秒內自動生效）
4. 若確定要維持封鎖 → 可 optional 客製「封鎖訊息」告知聯絡管道

常見問題

Q1　開啟「完全禁止進入系統」後既有客戶會受影響嗎

不會。只有已加入黑名單的會員（is_blocked = true）會被擋。此設定預設是「僅擋廣播」，若未主動切換，所有現存客戶與新加好友者都不受影響。

Q2　黑名單會員能加好友嗎

在「完全禁止進入系統」模式下，加好友事件會被 silent break：系統不會寫 followed_at、不觸發加入禮、不推歡迎訊息。從 LINE 用戶端角度看只是「加了但什麼都沒發生」。

Q3　同一個 LINE UID 在多個 OA 分別加為黑名單，會怎樣

黑名單是每個租戶獨立設定。A 租戶封鎖不會影響 B 租戶。若同一 LINE UID 在多家分別加了黑名單，各自獨立擋。

Q4　會員自己看得到「他被封鎖」嗎

打開 LIFF 會被 redirect 到 /m/blocked 頁面，顯示店家設定的封鎖訊息（或預設訊息）。送 LINE 訊息不會被顯示「已被封鎖」，只是收不到系統回覆。

Q5　誤加入黑名單能救回來嗎

可以。移出黑名單後 10 秒內全部功能自動恢復。稽核紀錄仍會保留該會員曾被擋的歷史，供未來查詢。