黑名單管理

注意：本頁是「訂位模組的 no-show 黑名單」（追蹤放鳥累計次數，只擋訂位）。 若要「完全禁止會員進入系統」（擋 LIFF 登入 / 兌換 / 訊息 / 加好友等所有互動），請看 系統設定 → 黑名單模式（enforce_mode='enforce' 覆蓋 30 支公開端 + webhook 3 事件）。

黑名單管理列出no-show 累計過多或手動加入黑名單的會員，並提供重置次數、移出黑名單與檢視會員詳情的操作，是控管「常常臨時放鳥」顧客的核心工具。

進入路徑

後台左側 餐飲訂位 → 黑名單。

主要功能

自動納入　會員 no_show_count ≥ 阈值（在訂位設定填寫）會自動列入，無需手動操作。

手動加入　可在「會員管理」將任一會員 status 改為 blacklisted，立即出現於此頁。

重置次數　顧客來電解釋 / 證明原因合理 → 一鍵重置 no_show_count 為 0。

移出黑名單　手動加入的顧客可一鍵改回 active。

會員詳情　點「會員詳情」連到完整會員管理頁面，可看消費紀錄、調點數等。

阈值機制

來自 餐飲訂位 → 訂位設定 → 訂位分頁 的「No-show 累計擋訂位次數」欄位：

操作流程

啟用黑名單機制

1. 進 訂位設定「訂位分頁」
2. 填「No-show 累計擋訂位次數」（建議 3）
3. 儲存後即刻生效

顧客來電解釋 → 重置

1. 黑名單頁找到該會員
2. 按 重置次數 → 確認
3. 該會員 no_show_count 立即歸 0，可繼續線上訂位

永久封鎖 / 移出黑名單

• 永久封鎖：進「會員管理」找該會員 → 將 status 改為 blacklisted → 即出現於黑名單頁（不受次數影響）
• 移出：黑名單頁該會員按 移出黑名單 → status 改回 active

no-show 累計來源

no_show_count + 1 觸發點：

1. 手動按「未到」按鈕（訂位列表）
2. cron 自動標記（訂位時間後 no_show_timeout_minutes 分鐘還沒入座）

散客場景（沒有 member_id 的訂位）：cron 會用 customer_phone 對應到會員累計。

電話「未提供」的訂位與黑名單

店員在後台 / POS 建訂位時，可以勾「還不知道」把電話記成未提供（用法見訂位列表 → 電話還不知道）。這類訂位沒有電話可以拿去比對黑名單，所以這一筆查不出對方在不在黑名單裡。

要理解這件事，先分清楚兩條路：

換句話說，擋人是在線上訂位那條路上做的，那裡電話一律必填，所以「未提供」不會變成繞過黑名單的後門。

差別只在店員這一側：電話有填時，系統建單當下會去比對一次黑名單；電話標記「未提供」時，這次比對做不了。因為「查過沒事」和「根本沒得查」在畫面上長得一模一樣，系統會替後者留一筆稽核紀錄（動作 reservation/create_phone_unknown），事後要追「這位常放鳥的客人是怎麼進來的」時，指得出是哪一筆當初沒有電話可查。

常見問題

Q1　如何看某位顧客的 no_show 紀錄

進「會員管理 → 該會員詳情」，no_show 次數會以紅色顯示在會員資料區。

Q2　散客（未加 LINE 好友的客人）的 no-show 也會被計算嗎

會。只要 customer_phone 對應到既有會員，即使該會員 line_id 為空也會累計。但完全沒對應到任何會員的散客（純路人臨時電話訂位）則不會累計。

Q3　可以針對單一店家獨立黑名單嗎（多分店）

目前黑名單以「會員」為單位，跨店共用。多分店場景：若 A 店 no_show，B 店也會擋。這是有意的設計，避免顧客在某店被擋後到別店繼續放鳥。

Q4　黑名單擋顧客時，顧客看到什麼

LIFF 訂位送出時直接擋 403，訊息：「因 no_show 次數累計 N 次（≥ 阈值），暫不開放線上訂位；如有需要請來電」。電話訂位（後台代訂）不會被擋，店家可自行判斷接受與否。