CRM 再行銷模組操作手冊
CRM 再行銷模組是 LifeERP V3 內建的會員經營與自動行銷能力。它把「會員做了什麼行為 → 該對他做什麼行銷動作」自動化：從會員行為判定、規則觸發、名單圈選、訊息模板、人工審批，一路到透過 LINE 真實發送並回寫發送狀態，全程可追蹤。
本手冊分三部分：
:::note 適合誰讀 本模組是系統內建後台功能，主要使用者是客戶的行銷/營運人員（在 V3 後台操作），而非透過 API 串接的外部開發者。若你要的是對外 API 串接教學，請看 訂單串接教學。 :::
一、模組架構
1.1 一句話說明
會員在系統裡產生行為（例如下單、成為新會員、久未回購）→ 你事先設定好的規則判斷符合條件 → 系統自動挑出名單、套用訊息模板、（可選）經過人工審批 → 透過 LINE 把訊息發到會員手機 → 系統回寫「已送達」狀態，全程留下紀錄。
1.2 六層架構
CRM 模組由六層組成，由下而上：
| 層 | 職責 | 白話 |
|---|---|---|
| 會員資料層 | 會員主檔 + 自定欄位（Customer.profile）+ 即時衍生統計（消費金額、回購週期等） | 「這個會員是誰、買過什麼」 |
| 標籤與分級層 | 標籤（crm_tags）、會員等級（crm_tiers，可自動升降級） | 「幫會員貼標籤、分等級」 |
| 規則引擎層 | 規則（crm_rules）：條件成立就觸發動作（貼標籤 / 發訊息 / 變更等級） | 「符合條件就自動做事」 |
| 名單與抑制層 | 名單管理（crm_segments，用標籤圈人）、抑制清單（crm_suppression，永不發送的黑名單） | 「這次要發給哪些人、哪些人絕不能發」 |
| 模板與審批層 | 訊息模板（crm_templates）、審批佇列（crm_approval_queue） | 「訊息長怎樣、發之前要不要人簽核」 |
| 派送與紀錄層 | 交易紀錄（txn_log）、派送微服務（LINE 發送）、儀表板 | 「實際發送、回寫狀態、看成效」 |
1.3 完整資料流（已端到端實測）
會員行為
→ 規則引擎判定（CrmRuleExecutor）
→ 寫入交易紀錄 txn_log（type=crmTrigger, status=0 待送）
→ 查會員 LINE 綁定 + 推送到訊息佇列（BullMQ）
└ 若佇列暫時不可用 → 自動改走資料庫佇列持續重試（訊息不丟）
→ 派送微服務消費佇列
→ 透過 LINE 官方帳號發送 → 會員手機收到
→ 回寫交易紀錄 status 0→9（已送達）+ 保存平台回應
→ 事件紀錄 / 儀表板 / 審批狀態同步反映
:::tip 這條鏈是真的通的 上述流程已經過端到端真實測試：規則觸發後，訊息真的發到手機、資料庫的發送狀態真的從「待送」變成「已送達」，並保存了 LINE 平台回傳的訊息 ID。不是「程式碼看起來會動」，是「手機真的響了」。 :::
1.4 交易紀錄（txn_log）—— 一切動作的帳本
CRM 的每一個關鍵動作都會在 txn_log 留下一筆獨立紀錄，方便稽核與重試。共 8 種紀錄類型：
| 類型 | 記錄什麼 |
|---|---|
crmTrigger | 規則觸發了一次發送 |
crmTag | 幫會員貼／移除標籤 |
crmBind | 會員綁定 LINE 帳號 |
crmTierChange | 會員等級升降 |
crmSuppressAdd / crmSuppressRemove | 加入／移出抑制清單 |
crmApprovalApprove / crmApprovalReject | 審批通過／退回 |
二、功能導覽
CRM 模組在 V3 後台的頂層選單為「會員行銷」，底下包含以下子功能：
| 子功能 | 用途 |
|---|---|
| 行銷儀表板 | 總覽：觸發次數、發送成效、名單規模等關鍵指標 |
| 會員資料 | 會員主檔管理，含自定欄位與即時衍生統計 |
| 標籤管理 | 建立與維護標籤值域，供圈選名單使用 |
| 會員等級 | 定義等級與門檻（可設定自動升降級規則） |
| 訊息模板 | 建立可重複使用的訊息模板 |
| 再行銷規則 | 核心：設定「什麼條件 → 做什麼動作」 |
| 名單管理 | 用標籤條件圈出目標名單（segment） |
| 抑制清單 | 永不發送的黑名單（退訂、客訴等） |
| 審批佇列 | 高風險發送前的人工簽核關卡 |
| 事件／觸發紀錄 | 每一次觸發與發送的完整歷程（可查狀態、可重試） |
:::note 三種行銷動作 再行銷規則的「動作」目前支援三類：貼標籤、發送訊息、變更會員等級。一條規則可以在條件成立時執行其中一種。 :::
三、操作手冊
以下示範管理員從零設定一條再行銷規則到實際發送的完整流程。以「新會員歡迎訊息」為例。
步驟 0：前置準備
- 確認客戶的 LINE 官方帳號憑證已由 LifeCOM 設定完成（發送需要）。
- 確認要發送的會員已綁定 LINE（未綁定者不會收到，屬正常）。
步驟 1：建立訊息模板
進入 會員行銷 → 訊息模板，新增一則模板：
- 模板名稱：
新會員歡迎 - 內容：撰寫歡迎詞，可帶入會員姓名等變數。
儲存後，模板會取得一個識別碼，供規則引用。
步驟 2：（可選）建立名單與標籤
若這條規則只針對特定族群：
- 到 標籤管理 建立標籤（例如
首購）。 - 到 名單管理 用標籤條件圈出目標名單。
新會員歡迎通常不需要事先圈名單（由規則條件即時判定），可略過此步。
步驟 3：設定再行銷規則
進入 會員行銷 → 再行銷規則，新增規則：
| 欄位 | 填入 |
|---|---|
| 規則名稱 | 新會員歡迎訊息 |
| 觸發條件 | 會員狀態＝新會員（依實際欄位設定） |
| 執行動作 | 發送訊息 |
| 使用模板 | 步驟 1 建立的「新會員歡迎」 |
| 是否需審批 | 視風險決定（見步驟 4） |
儲存並啟用規則。
步驟 4：（可選）設定審批關卡
若這類發送需要人工把關（例如大量發送、促銷優惠），把規則設為「需審批」。之後每次觸發會先進入 審批佇列，由具權限者到 會員行銷 → 審批佇列 點選：
- 通過 → 訊息才會實際發出（紀錄
crmApprovalApprove）。 - 退回 → 該次發送取消（紀錄
crmApprovalReject）。
新會員歡迎這類低風險發送，通常不需審批。
步驟 5：確認抑制清單
到 抑制清單 確認目標會員不在黑名單中。已退訂或明確拒收的會員應在此，系統會自動略過他們。
步驟 6：觸發與發送
規則啟用後即為自動運行：當有會員符合條件（例如新會員註冊），系統會自動：
- 判定規則成立 → 寫入
txn_log（狀態：待送）。 - 查該會員 LINE 綁定 → 推入發送佇列。
- 派送服務消費 → 透過 LINE 發送到會員手機。
- 回寫
txn_log狀態為「已送達」。
步驟 7：查看發送結果
進入 會員行銷 → 事件／觸發紀錄，可看到每一次觸發的完整歷程：
- 觸發時間、命中的規則、目標會員。
- 發送狀態（待送 / 已送達 / 失敗）。
- LINE 平台回傳的訊息 ID。
到 行銷儀表板 可看整體成效彙總。
:::tip 發送失敗會自動重試 若發送當下佇列或 LINE 平台暫時不可用，系統不會丟掉訊息 —— 交易紀錄已先落地為「待送」，並改走資料庫佇列持續重試（指數退避），待服務恢復後自動補送。你不需要手動補發。 :::
常見問題
Q：會員沒收到訊息怎麼辦？ 先確認三件事：①該會員是否已綁定 LINE；②是否在抑制清單中；③到「事件／觸發紀錄」查該筆的狀態與失敗原因。狀態停在「待送」通常代表發送服務或 LINE 平台暫時不可用，系統會自動重試。
Q：規則會不會重複發？ 每次觸發都是一筆獨立的交易紀錄，並有冪等保護避免同一事件重複發送。
Q：可以發 LINE 以外的通路嗎？ 目前發送通路為 LINE。派送層採可擴充設計，未來可加入其他通路。
:::note 名詞對照
- 再行銷（Remarketing）：對既有會員依其行為做的行銷動作。
- 規則（Rule）：「條件成立 → 執行動作」的自動化設定。
- 名單（Segment）：用標籤條件圈出的一群目標會員。
- 抑制清單（Suppression）：永不發送的黑名單。
- 交易紀錄（txn_log）：系統為每個關鍵動作留下的稽核紀錄。 :::