UGOMK 操作手冊
第 16 章 / 共 72 章

會員管理

會員列表

左側選單「會員管理 → 會員列表」，可以看到所有加入官方帳號（或被臨櫃建檔）的會員。

主要操作

  • 搜尋：頂端搜尋框可依「姓名（真名）/ LINE 暱稱 / 電話 / UID」過濾。搜尋同時涵蓋真名與 LINE 暱稱兩個欄位，例如顧客真名是「陳淑貞」、LINE 暱稱是「賴名字」，搜「賴名字」也能找到。

- 手機搜尋規則（2026-06-30 調整）：輸入 ≤ 3 碼純數字 → 只比對手機後綴（不順便撈 姓名 / LINE 暱稱 / UID，避免「678」誤撈到名字含 678 或 UID 含 678 的會員）；輸入 ≥ 4 碼純數字 → 手機任意位置比對，並同時 OR 比對姓名 / LINE 暱稱 / UID；輸入含中英文 → 走多欄位 OR（姓名、LINE 暱稱、電話、UID）。輸入會自動過濾空白與連字號再判斷。 - UID 是什麼：是 LINE Messaging API 的 userId（U + 32 字 hex，例如 U1234abcd...），由顧客加入官方帳號為好友時系統自動取得；不是顧客 LINE app 設定的「LINE ID」（@xxxxxxxx 形式）。老闆可在會員詳情頁複製此 UID 用於推播 / 派工 / 圖文選單個人化。

  • 新增會員（右上角）：給臨櫃 / 沒法加 LINE 的客人建檔，必填姓名 + 電話。客人未來真的加 LINE 時，系統會用電話自動合併。
  • CSV 匯入（右上角）：批次匯入會員，詳見「會員匯入」說明。
  • 點進會員：開啟會員詳情頁，可調整等級 / 群組 / 備註、貼/移除標籤、手動加扣點、贈送票券、查看最近點數紀錄與擁有的票券（2026-06-27 起：列出該會員所有 active / used / expired 票券，已使用的票券會顯示是哪個「核銷碼 / 店家」核銷的，若無核銷碼則顯示「後台手動」；對應多店多員工核銷對帳爭議追溯）。
  • 三點選單操作：對該會員執行「設為管理員 / 取消管理員」、「加入黑名單 / 移出黑名單」。

列表欄位（2026-06-30 更新「姓名 / LINE 暱稱」雙行欄位）

桌機版表格預設顯示順序：

  1. 頭像
  2. 姓名 / LINE 暱稱（雙行欄位）

- 主行（大字）：真名（members.name，admin 改 / 會員在 LIFF 自填） - 副行（小字灰）：LINE：xxx（members.display_name，LIFF/webhook 自動 sync LINE 暱稱） - 真名跟 LINE 暱稱一樣 → 只顯示主行不重複

  1. 電話
  2. 等級（含顏色標籤）
  3. 群組
  4. 標籤（chip 列表）
  5. 點數
  6. 累積消費
  7. 成長值（settings.growth_value_config 啟用時才顯示）
  8. 最後消費日
  9. 推薦人數
  10. 註冊時間 / 操作
欄位排序、頁面尺寸記憶等可在頂端「列表設定」調整。手機版自動摺成卡片格式。

狀態 badge

會員列表上會顯示這些 badge：

  • 啟用 / 封鎖 / 停用
  • 管理員
  • 黑名單
  • 已填資料 / 未填資料（依「會員資料填寫設定」判定）

會員等級

「會員管理 → 會員等級」可建立分級制度，每個等級可設最低點數、最低消費、折扣率、成長值（升等門檻）、排序、顏色、以及對應的圖文選單。

詳見「會員等級」說明（含 2026-06-24 新加的成長值自動累計 + 自動升等規則）。

會員群組

「會員管理 → 會員群組」可建立水平分類（例如「企業客戶」「員工」）。每組可指定一個對應圖文選單，會員加入該群組後即套用。

詳見「會員群組」說明。

會員標籤

「會員管理 → 會員標籤」可建立屬性標記（例如「VIP」「新客」）。標籤本身只記錄名稱與顏色，於會員詳情頁手動貼上、或由自動行銷劇本自動貼上。

詳見「會員標籤」說明。

自動行銷劇本

「會員管理 → 自動行銷劇本」是行銷自動化的中樞，會員相關的觸發（生日、消費達標、貼標、加入群組、票券核銷⋯共 16 種）都集中在這裡設定。

例外：新會員入會禮不在這裡設，請到「會員管理 → 推薦好友設定 → 新好友加入好禮」（2026-06-22 起集中管理）。
註：舊版的「週期任務 / 觸發任務」已於 2026-06-05 統一升級為「自動行銷劇本」，詳見「自動行銷劇本」說明。

其他問題協助

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

會員資料編輯（後台幫顧客改）

「會員 → 點任一會員」進詳情頁，「會員資料」區塊可直接編輯：

  • 真名（name，可空白；空白＝會員列表/詳情頁顯示 LINE 暱稱）
  • LINE 暱稱（display_name，唯讀灰底欄位，由 LIFF/webhook 自動同步 LINE 最新值，admin 不能改）
  • 手機
  • Email
  • 性別
  • 生日
  • 等級
  • 群組
  • 備註（店家內部，會員看不到）
  • 會員填寫的資料（2026-06-18 起）— 顯示「會員管理 → 會員設定 →『會員資料填寫』分頁」設定的所有自訂欄位（含「喜好項目」「公司名稱」等）。後台可代填或修改；type=select/multi_select 渲染對應選單；label 含「喜好」的欄位儲存後會自動貼「喜好_<value>」標籤（詳見 會員資料填寫）

按「儲存變更」一鍵更新。會員下次進 LIFF 預約也會自動帶你改的新值。

姓名欄位邏輯（2026-06-30 起：真名 vs LINE 暱稱拆雙欄）

過去 members.name 同時兼任「真名」與「LINE 暱稱」雙重身分，2026-06-16 ~ 06-30 中間有 LIFF 觸發時會用 LINE displayName 把 admin 改的真名覆寫掉的 bug（已於 87f91ba 修復）。

2026-06-30 起拆成兩欄分開儲存：

欄位來源誰能改顯示位置
name（真名）admin 直接改 / 會員 LIFF 自填admin + 會員自己列表主行、詳情頁標題
display_name（LINE 暱稱）LIFF 開啟 / webhook follow 時 LINE 自動推系統自動（admin 改不到）列表副行「LINE：xxx」、詳情頁 LINE 暱稱欄

修正受影響的會員：

87f91ba 之前曾被 LINE 暱稱覆寫真名的會員，super_admin 可用「系統管理 → 會員批次改名」工具上傳 CSV 一鍵修復（兩欄 member_id,real_name，內建 Dry-run 試跑 + audit_logs 紀錄）。

搜尋行為：

頂端搜尋框會同時比對 name 跟 display_name，例如顧客真名是「陳淑貞」、LINE 暱稱是「賴名字」 → 搜「賴」或「陳」都找得到。

會員詳情頁的「預約 / 消費 / 儲值」紀錄可見範圍（2026-09-07 起）

會員詳情頁下半部有三個區塊，資料來自各營運模組：

  • 預約紀錄（美業預約 / 餐飲訂位 / 場館訂位 / 旅館訂房，各取最近 30 筆）
  • 消費紀錄（POS 訂單，含區塊標題旁的「累積消費」小計）
  • 儲值金紀錄（美業儲值餘額 + 異動明細）

會員本身仍然是全租戶共用的 —— 每家分店都找得到、看得到同一位會員的基本資料、點數、標籤、票券。改變的只有上面這三個區塊：

登入身分看得到的預約 / 消費 / 儲值
總部管理員（總後台登入）全部分店，與先前相同
分店店長 / 店員只有自己被指派的分店
從分店後台入口登入的管理員只有該分店

在此之前，任何一位店長打開任何一位會員，看到的都是全部分店的消費與訂位明細（含金額、服務人員）。

店長會感覺到「以前看得到的紀錄不見了」

這是預期中的改變，不是資料遺失。同一筆消費在總後台仍然查得到，也仍然算在會員的點數與等級裡（點數、累積消費、成長值都是租戶層級，不分店）。 若店長需要調閱跨店紀錄以處理客訴，請由總部管理員從總後台查詢後提供。

沒有分店歸屬的舊紀錄，各分店都看得到

早期寫入時沒有記錄分店的預約 / 訂房 / 儲值異動，會在每一家分店都顯示。這是刻意的：某些模組（例如旅館訂房）的舊資料完全沒有分店，若嚴格過濾，店長會看到一片空白而以為系統壞了。 因此三個區塊都可能出現少數看起來不屬於本店的舊紀錄，愈新的資料愈不會有這個情形。

這三個區塊不受左上角「當前門市」切換器影響

分店範圍是由登入帳號決定的，不是由門市切換器決定。總部管理員即使把當前門市切到某一家店，這三個區塊仍然顯示全部分店的紀錄。要以單店視角檢視，請改從該分店的登入入口（分店後台網址的登入頁）登入。

散客自動合併（2026-06-16 起）

情境：店員之前「手動建散客」（會員 → 新增 → 填名字 + 電話，沒 LINE 綁定）→ 顧客之後加 LINE OA → 顧客 LIFF 預約 / 填會員資料時帶手機。

自動行為：後端比對手機，把散客所有預約 / 訂單 / 標籤 / 票券 / 集點等 28 個關聯表自動接到 LINE 會員上，散客 row 刪除。

2026-09-03 起：帶資產的散客不再自動合併

顧客在 LIFF 自己輸入的電話，系統無法驗證那支號碼真的是他的。若被比對到的散客身上有點數、累計消費、美業儲值金或未核銷票券任一項大於 0，系統不會自動合併，改為：

  • 這次不動任何資料（散客資料留在原處，LINE 會員照常存檔電話）
  • 在「系統管理 → 操作紀錄」寫一筆 member.auto_merge_blocked，帶被擋下的散客 id、點數 / 消費 / 儲值 / 票券數與電話末 4 碼
  • 需要合併時，由系統管理員確認後手動觸發批次合併

空殼散客（四項全為 0，也就是只有名字 + 電話那種）維持自動合併，店家無感。

2026-09-18 起：餐飲訂位也會收斂空殼散客

先前只有「LIFF 會員資料頁」與「美業線上預約」會做上面的自動合併，餐飲訂位沒有。常見情形是：店員先在後台用客人電話建訂位（系統自動建出一筆只有姓名 + 電話的散客），客人隨後加 LINE 並用線上訂位填同一支電話，結果兩筆會員並存。

現在以下三個入口也會自動合併，條件與上面相同，另外再加兩條：

  • 入口：線上訂位（LIFF）、後台新增訂位、後台修改訂位的姓名或電話
  • 對到的會員必須已綁 LINE；兩筆都沒綁 LINE 的不會合併
  • 該 LINE 會員原本的電話必須是空的或與這次相同；若他原本登記的是另一支電話（例如幫朋友訂位），不會合併

兩筆都綁了 LINE、或散客身上有點數 / 消費 / 儲值 / 票券時，一樣不會自動合併。已經存在的重複資料不會回頭處理，要等該客人下一次訂位才會觸發，或由系統管理員手動合併。

實際合併發生時（自動或手動）都會另外寫一筆 member.merged 稽核，記下合併前散客身上的點數與累計消費金額 —— 合併後散客資料已刪除，事後查不到搬走了什麼。

注意：加會員必填欄位時的副作用

「系統 → 會員資料填寫設定」可以勾選哪些欄位為「必填」。

注意：若把新欄位（特別是「自訂欄位 custom_1 / custom_2」）加進必填，所有舊會員會立即被打上「未填資料」badge（因為他們沒填過該欄位）。

建議：

  • 新欄位先用「enforce_mode = 建議填寫（suggest）」觀察填寫率
  • 必要時請開發協助 backfill 舊資料
  • 不要為了一個新需求把所有舊會員都打成「未填」（會員數據儀表板會誤判）