自動行銷劇本

「自動行銷劇本」（ma_rules）取代了原本的「週期任務」與「觸發任務」，讓品牌在無人值守的情況下持續做精準行銷，例如「會員加入官方帳號送 50 點 + 一張 9 折券」「生日當天發 100 點 + 生日卡」「累積消費滿萬升 VIP + 推 LINE 訊息」「票券到期前 3 天自動提醒」。

進入路徑

後台左側 會員管理 → 自動行銷劇本。進去之後上方有兩個頁籤：

2026-08-16 起，原本側欄上並列的「行銷執行紀錄」已整併成本頁的「執行紀錄」頁籤，側欄只保留一個入口。 舊網址 /dashboard/modules/marketing-automation/runs 仍可使用，會自動轉到「執行紀錄」頁籤（書籤不會失效）。 切換頁籤時網址會跟著變成 ?tab=runs，可以直接把「執行紀錄」加進書籤或轉貼給同事。

2026-06-05 起，原「會員管理 → 週期任務 / 觸發任務」已整併到此處。原連結會自動轉址。

劇本分類

每條劇本可以設一個分類，用來在劇本變多時分組查找（例如「生日」「沉睡喚回」「推薦獎勵」）。

• 分類只影響列表的顯示與篩選，不影響劇本何時觸發、發什麼
• 新增 / 編輯劇本時，分類欄位預設是從既有分類挑一個；真的沒有合適的才選「新增分類⋯」自己打

（刻意這樣設計：分類若人人自由打字，很快就會出現「節慶 / 節慶行銷 / 節慶活動」這種同義分類，之後只能一條一條改）

• 沒有設定分類的劇本一律歸到「一般」，包含這個功能上線前就存在的舊劇本
• 劇本列表左上角的「全部分類」下拉可依分類篩選

觸發類型

2026-06-22 變更：以下 2 個觸發類型已搬到「會員管理 → 推薦好友設定」集中管理，本頁「新增劇本」不再列出（既有規則仍可繼續執行、編輯）： - 新會員加入（new_member）→ 改在【推薦好友設定 → 新好友加入好禮】設定 - 推薦達 N 人（member_referral_count_reached）→ 改在【推薦好友設定 → 推薦好友任務】設定階梯獎勵 此舉是為了避免「新會員入會禮」「推薦獎勵」兩處可設、客戶混淆雙入口的問題。建議將既有同性質劇本停用、改在推薦好友設定頁面集中管理。

下表為「自動行銷劇本」目前提供的觸發類型。其中帶有「需 ○○ 模組」標註的幾項只會出現在已開通該模組的租戶，沒開通的租戶在下拉裡看不到（避免設了永遠不會執行的劇本）。

訂位四段與電子簽署：沒有對應到會員的那一筆不會觸發

自動行銷引擎是「對一位會員執行一條劇本」，所以這五個觸發都有同一個前提：那筆訂位 / 那份文件必須對應得到一位 CRM 會員。

• 訂位：客人自己從 LINE 訂位頁送出的訂位一定有會員。但店員在後台 / POS 用電話代訂、又沒有把訂位掛到會員身上時，這筆訂位不屬於任何會員 → 四個訂位觸發都不會發，而且不會有任何錯誤訊息。
• 電子簽署：以文件裡第一位有對應會員的簽署人為對象。整份文件的簽署人都不是會員時不觸發。

因此若您發現「有訂位卻沒收到訊息」，第一件要檢查的是那筆訂位有沒有綁到會員，而不是劇本設定。

訊息內容可以帶哪些變數

在訊息裡用 {{變數名}} 就會被代換。沒有對應值的變數會原樣印出 `{{變數名}}`（不會變空白），所以請只用下表列出的：

「N 天無消費」會不會一直重複發？

不會。同一位會員只提醒一次（2026-08-17 起），與其他掃描型觸發（生日、累積消費、點數達標）一致。

• 這位會員被掃到、發過一次之後，即使他明天、下個月仍然符合「已經 N 天沒消費」，都不會再發第二次
• 只有當你修改這條劇本的天數（例如從 30 改成 90）時，才會被當成另一個里程碑，符合新條件的會員可以再收到一次

2026-08-17 之前的行為：舊版是「每位會員每天一次」——只要仍然符合條件就天天發，一位沉睡會員會每天收到一張券直到他來消費為止。這是缺陷不是設計，已修正。若你在此之前就啟用過這型劇本，改版後的第一次掃描會再發一次（新舊紀錄互不相認），之後就不會再發。

若你希望的是「持續提醒」：目前系統沒有這個選項。請不要期待它會自己反覆發，也不要為了達成這個目的去修改天數。可改用「群發訊息」自行挑時間發送。

「會員完成資料填寫」怎麼判定？

當會員在會員資料頁（LIFF 「我的資料」或 admin 後台改會員）UPDATE 後，後端立刻檢查 settings.member_profile_config.required_fields 內所有必填欄位是否都有值：

• 標準欄位（name / phone / email / gender / birthday）→ 看 members 表該欄位
• 自訂欄位 custom_* → 看 members.extra_fields JSONB
• 全部有值 → fire profile_completed trigger 一次
• 任一空 → 不觸發

dedup 終生機制：fire 成功會寫一筆 audit_logs.action='profile_completed'。同一會員之後即使把資料改回空再改回滿，也不會重 fire（防薅羊毛）。

前提：必須先到「會員管理 → 會員資料設定」設好「必填欄位」，否則沒辦法判斷「完成」。 用途：客戶填完資料送 100 點 + 一張券、貼「資料齊全」標籤分群、寄感謝訊息等。

「首次消費」怎麼判定 —— 跟「訂單付款」差在哪？

• 訂單付款 是「每筆訂單」都觸發（同一個會員每月買 4 次就觸發 4 次，可串「滿額送點」「結帳通知」這類每筆都跑的劇本）。
• 首次消費 是「會員終生第一次」消費才觸發。系統在會員的 first_purchase_at 欄位記錄首購時間，之後再消費都不會再觸發。適合送首購禮、首購回饋券、首購歡迎訊息。
• 觸發時機：所有跨模組的「結帳完成」都會 fire（POS 美業 / 餐飲 / 零售 / 訂房 / 課程報名 / 派案接案 / 場地預約 / 電商訂單 / 發票登錄）。

「被貼上標籤」會在哪些地方觸發？

以下所有貼標籤的途徑都會觸發劇本：

• 後台手動：會員管理 → 會員列表 → 點開會員 → 加標籤
• LINE 自動回覆：客戶傳關鍵字命中自動回覆規則，規則設定有「貼標籤」時
• 微網頁觸發：客戶從 LIFF 微網頁進入、頁面設定有「自動貼標籤」動作時
• 學院官網表單：lineai.ugomk.com 客戶留資料後自動貼 lead-from-academy 標籤
• 發票登錄抽獎：客戶登錄發票、活動有設「自動依品項貼標」時

已存在的標籤再次被貼上不會觸發（避免重複發獎）。如果要「每次都觸發」，請改用「被加入特定群組」或另設規則。

「被加入群組」會在哪些地方觸發？

• 後台手動：會員管理 → 會員列表 → 改變會員的群組
• 微網頁觸發：頁面設定有「設定群組」動作時

從 A 群組改到 B 群組才算「真實變更」會觸發；同群組重新設定不會觸發。每位會員對同一個群組終生只觸發一次。

6 種動作（可串多個組合）

• 發送通知：選一張既有「通知範本」（notification template），自動 push 給該會員（會員需綁定 LINE）；可選填額外變數（JSON）覆寫範本變數
• 發放票券：選一張既有 voucher，自動寫入會員的 member_vouchers。會員會自動收到一張 LINE Flex 圖卡通知（含票券圖、面額、有效期、查看按鈕），版型可在「內容管理 → 系統圖卡 → 票券發放通知卡」編輯。票券有設「商品圖片」時 Flex 會顯示該圖。這個動作只發「票券中心」的優惠券，不含抽獎券，抽獎券請用下方「發放抽獎券／抽獎機會」。
• 加上標籤：自動加上指定的標籤，便於後續分群行銷
• 加贈點數：自動增加點數 + 寫 points_log（可填加點原因）
• 發放抽獎券／抽獎機會：選一檔既有抽獎活動 + 數量（1～50），自動寫入該會員。會員會自動收到一張 LINE Flex 圖卡通知，版型在「內容管理 → 系統圖卡 → 抽獎機會通知卡」。下拉選單會標示每檔活動的開獎方式，選好之後欄位文案會跟著換：

- 摸彩統一開獎的活動 → 欄位是「送幾張券」，會員拿到的是抽獎券，統一開獎時每張券都是一次中獎機會（若該活動有設發券上限，發完就不再發） - 即時抽獎的活動 → 欄位是「送幾次機會」，會員拿到的是可抽次數，自動疊加在原本可抽次數之上

• 移動到指定階段（客戶歷程）（需客戶歷程模組）：把會員移到指定流程的指定階段，並在他的「階段時間軸」留下一筆紀錄（可自填備註，留空記成「自動行銷移動階段」）。只支援「會員」流程；會員本來就在該階段時不重複移動，執行紀錄會顯示「已略過」。

一條劇本可以串多個動作。例如「被貼上『VIP』標籤 → 加 50 點 + 發 9 折券 + 發送通知」一次設好。（入會禮不在這裡設，見下方提醒）

「階段變更」觸發 ＋「移動階段」動作會不會無限連鎖？

不會。這兩個湊在一起時系統會做三件事：

1. 只往下傳一層：由某條劇本的「移動到指定階段」造成的階段變更，不會再去觸發其他「階段變更」劇本。所以不會 A→B→C→D 一路串下去。
2. 沒變就不算變更：把會員移到他本來就在的階段時，不觸發、不推播、也不會在歷程留假紀錄（執行紀錄顯示「已略過」）。
3. 同一階段終生一次：同一位會員重新進入同一個階段，同一條劇本也只會執行一次。

編輯劇本時若把「觸發階段」和「要移動到的階段」設成同一個，畫面上會提醒你這個動作每次都會被略過。

動作對象：發給觸發的會員，還是他的推薦人？（2026-08 新增）

每一個動作都有一個「動作對象」下拉，5 種動作都適用（送點數、貼標籤、發票券、發抽獎券、發通知都可以改發給推薦人）：

同一條劇本裡的每個動作各自設定對象，可以混用。例如「核銷 50 元折價券 → 發 3 張抽獎券給推薦人 + 發一則感謝通知給會員本人」。

沒有推薦人的會員會怎樣？

該動作會被直接跳過，不會發給任何人，也不會算成失敗。 這是最常被問到的一點，請特別留意：

• 不會退而求其次發給觸發的會員本人
• 不會讓整條劇本中斷 —— 同一條劇本裡對象是「觸發的會員」的其他動作照常執行
• 執行紀錄看得到這次觸發，只是該動作沒有產生獎勵

看執行紀錄時請注意（2026-08-17 修正）：這種情況的狀態現在會顯示「全部略過（未發出）」，不再顯示「成功」。 - 「成功」＝這次至少真的做了一個動作 - 「全部略過（未發出）」＝劇本有跑、但所有動作都被跳過，實際上一份獎勵都沒發出去（例如整條劇本的動作都指定發給推薦人，而這位會員沒有推薦人） - 「未設定動作」＝這條劇本根本沒設任何動作，請回劇本設定補上；這與上一種是兩回事，改 filter 條件沒有用 執行紀錄上方的狀態篩選可以單獨挑出「全部略過（未發出）」，用來檢查某條劇本是不是白跑。要看細節仍請看該筆的動作摘要，逐一確認每個動作是「成功」還是「略過」以及略過原因。

所以「客人來核銷券了，但推薦人沒收到抽獎券」最常見的原因是：這位客人當初不是透過推薦連結加入的（系統查不到他的推薦人）。可到 會員管理 → 推薦好友設定 或會員詳情頁確認該會員是否有推薦人。

上線提醒

這是新上線的功能。設好之後建議先用劇本詳情頁的「試跑」挑一位有推薦人的會員預覽一次。若試跑結果顯示獎勵仍發給會員本人，代表系統版本尚未更新到支援此功能的版本，請聯繫客服，先不要正式啟用。

延遲發送（觸發後隔一段時間才執行）

新增 / 編輯劇本時，「觸發條件」區塊下方有一區 「延遲發送（選填）」。設了之後，劇本被觸發的當下不會立刻送出獎勵，而是排進佇列、等指定時間到了才由系統派送。

三欄加總計算（天數 1 + 小時 2 = 26 小時後）。三欄全部留 0（預設）＝ 不延遲，觸發當下立刻執行。最長 90 天，超過會自動壓到 90 天。

常見用法：訂單完成 48 小時後請客人評價、消費後 7 天推回購券、加入好友後分階段培養（設多條劇本各給不同延遲）。

延遲期間發生的事

1. 觸發當下先在執行紀錄寫一筆狀態「已排程」的紀錄，去重也在此刻卡位（同條件重複觸發不會排兩次）
2. 系統每 10 分鐘檢查一次，時間到才真正執行
3. 派送前會重新檢查一次條件：若延遲期間該會員已不符合 filter 條件（例如已升等、預約已取消），該筆標成「排程略過（條件不符）」不發
4. 派送前也會重查黑名單：延遲期間才被封鎖的會員標成「排程略過（會員已封鎖）」；規則已停用、會員已刪除也各有對應的略過狀態

進階：目標過濾（filter_conditions）

每條劇本可選填 filter 條件，命中 trigger 後再過濾：

• member_level_id：只對該等級會員觸發（例如「銀卡以上才送生日禮」）
• has_tag_ids: [...]　必須同時有這些標籤
• exclude_tag_ids: [...]　有這些標籤則跳過

操作流程

建立劇本（以「生日當天發 100 點 + 9 折券」為例）

1. 點右上 新增劇本
2. 觸發類型 選「生日當天」、days_before = 0
3. 動作 1 選「加贈點數」→ 點數 100、原因「生日禮」
4. 動作 2 點新增 → 選「發放票券」→ 挑一張 9 折券
5. 動作 3 再 → 選「發送通知」→ 挑「生日卡」通知範本
6. 設定 啟用，存檔

cron 每 10 分鐘掃一次，當天生日的會員會自動跑這 3 個動作，並寫進本頁的「執行紀錄」頁籤。

若要「新會員加入時送入會禮」，請改到【會員管理 → 推薦好友設定 → 新好友加入好禮】設定（從 2026-06-22 起 ma_rules 不再提供 new_member trigger）。

範例 2：「VIP 標籤迎賓禮」

當客戶被貼上 VIP 標籤時，自動送高價值優惠。

1. 點 新增劇本
2. 觸發類型 選「被貼上特定標籤」
3. 指定標籤 下拉選「VIP」
4. 動作 1 選「發送通知」→ 選「VIP 歡迎卡」通知範本
5. 動作 2選「發放票券」→ 挑一張 VIP 專屬 8 折券
6. 動作 3選「加贈點數」→ 點數 500
7. 啟用，存檔

之後在 後台會員列表 / LINE 自動回覆 / 微網頁 / 發票登錄 等任一處貼上 VIP 標籤，劇本自動觸發。同一位 VIP 終生只發一次（避免重複給高價值獎勵）。

範例 3：「加入新客群組送首購券」

把新註冊的客戶歸到「新客」群組時，送一張首購券引導消費。

1. 觸發類型 選「被加入特定群組」
2. 指定群組 選「新客」
3. 動作 選「發放票券」→ 首購 9 折券
4. 啟用

之後 admin 改任何會員的群組為「新客」，就會收到券。

範例 4：「介紹一個人來消費，推薦人得 3 張抽獎券」（2026-08 新增）

被推薦的新客拿 50 元折價券來店消費，店家核銷後，系統自動發 3 張抽獎券給介紹他來的那位會員。

1. 點 新增劇本
2. 觸發類型 選「票券被核銷」→ 指定票券 選那張「50 元折價券」
3. 勾選 每位被推薦人只發放一次（避免同一位新客之後再核銷其他票券又發一次給推薦人）
4. 動作 1 選「發放抽獎券／抽獎機會」→ 指定抽獎活動、數量填 3
5. 把動作 1 的 動作對象 改成「該會員的推薦人」
6. （選配）動作 2 選「發送通知」、動作對象維持「觸發的會員」→ 感謝新客來店
7. 啟用，存檔

若這位新客沒有推薦人（不是透過推薦連結加入的），動作 1 會自動跳過，動作 2 的感謝通知仍會照常發出。

試跑（不寫資料）

劇本詳情頁有「試跑」按鈕——挑一個會員 id 預覽要執行的動作，不會真的扣點、也不會 LINE push。

立即掃描（不等 cron）

cron 型 觸發（生日、累積消費等）可在劇本列表上方點「立即掃描」，馬上跑一次。

防重複觸發機制

引擎用 ma_rule_runs.period_marker partial UNIQUE 索引做卡位。同一條 (rule, member, marker) 只會執行一次。範例：

• 「被貼上特定標籤」marker = tag-added:{tag_id} → 同會員同標籤終生一次
• 「被加入特定群組」marker = group-assigned:{group_id} → 同會員同群組終生一次
• 「生日當天」marker = birthday:{year} → 同會員今年只觸發一次
• 「訂單付款」marker = source_ref（caller 傳的 order_id） → 同一筆訂單只獎勵一次

如果某條劇本被誤觸發、需重新跑，刪除對應的 ma_rule_runs 紀錄即可。

「每位會員只觸發一次」開關（2026-08 新增）

在「觸發條件」區塊最下方有一個勾選框，預設不勾（＝維持上表的原本去重規則，既有劇本行為不變）。勾了之後，這條劇本對同一位會員終生只觸發一次。

適合用在原本不去重的觸發類型上，最典型的是「票券被核銷」—— 不勾的話，同一位客人每核銷一張票券就觸發一次。

這個勾選框的文字會隨情境改變，兩者是同一個開關、同一個機制：

注意：計算「只發一次」是以觸發的那位會員（也就是被推薦人）為單位，不是以推薦人為單位。所以推薦人介紹了 3 個不同的客人，就會拿到 3 次獎勵；同一個客人來核銷 3 次，只會發 1 次。

常見問題

Q1　劇本啟用後是否對過去符合條件的會員補發

cron 型（生日、累積消費、點數達標等）：啟用後下次 cron tick（最多等 10 分鐘）會把所有已符合條件的會員都掃進來。但每位會員的 marker 各自獨立，所以「曾經符合過但已通知」的不會重發。

trigger 型（被貼上標籤、訂單付款、首次消費等）：只對啟用後新發生的事件有效。

Q2　可以對同一個會員串多條劇本嗎

可以。每條劇本獨立執行、各自有 dedup。例如「VIP 標籤」設兩條（A 發點 + B 發券），各自 INSERT runs row，互不影響。

Q3　行銷活動跨多個模組怎麼設

「自動行銷劇本」針對個別會員觸發。如果要「全店 % 折」「滿千送百碼」這種跨模組行銷活動，使用「會員管理 → 跨模組行銷活動」，已有完整後台頁面可自助設定（詳見跨模組行銷活動）。