LINE 通知與推播總覽
你的官方帳號 vs Folio 系統帳號、7 類通知
- LINE 整合設定
- 自動化行銷，活動推播
- 問卷表單，自動發送
功能說明
兩套 LINE 架構，別搞混
| 用途 | 走哪個帳號 |
|---|---|
| 顧客收到的所有通知（預約、券、問卷、行銷） | 你自己的 LINE 官方帳號 |
| 你和員工收到的通知（新預約通知等平台訊息） | Folio 統一官方帳號 |
顧客通知用掉的是你自己官方帳號的 LINE 訊息額度；員工另外可以用後台 App 推播（把商家後台安裝到手機主畫面當 App 用，通知從那邊收，跟 LINE 無關、不耗額度）。
顧客會收到的 LINE 訊息類型（都是好看的卡片訊息，套你店的主題色）
- 預約成功卡（標題「感謝您的預約」）：日期時間、分店、服務人員（沒指定會顯示「不指定」）、服務明細含加購、總額、導航按鈕。
- 預約確認卡：採預約審核制的商家，審核通過時發。
- 行前提醒卡：依「預約通知」頁選的時機發。選「前一天」就在前一天提醒；選「三日確認」會在前三天先問顧客會不會來（按鈕「✅ 會，準時到達」），顧客點了會收到附導航的「感謝您的確認」卡，之後不再重複提醒。
- 優惠券獲獎卡：發券當下（券範本鈴鐺的「獲獎通知」有開時），包含手動發券、生日券（🎂）、新好友禮、行銷活動發券。
- 優惠券到期提醒卡：到期前 N 天（券範本的「到期推播」有開時，預設 7 天，每張券只提醒一次）。
- 行銷活動圖文訊息：自動化行銷活動的推播（同一位會員多個活動會合併成一則可左右滑的卡片）。
- 問卷表單卡：服務前諮詢（跟著預約提醒一起發）與服務後回饋（服務結束後 N 小時自動發，卡片標題「📋 服務前諮詢」/「💬 服務後回饋」，按鈕「到店前填寫諮詢」/「回饋這次的服務」）。
通知要送出的三個前提（系統每次發送前都會檢查）
- 你的「LINE 通知服務」已開通（免費在整合設定完成金鑰串接時系統會自動開通）。
- 「預約通知」頁的提醒模式不是「靜音模式」。
- 那位會員有綁 LINE（加過你的官方帳號好友、並用 LINE 登入過）。
群發 / 批次推播的入口
- 對顧客群發：走「自動化行銷 > 建立活動」的手動發送（一次性）＋圖文訊息，可以分眾、可以附券（見 自動化行銷（建立活動））。系統沒有獨立的「無差別全體廣播」頁面；要發全體，就是活動分眾不設限，或發券視窗選全體會員。
- 問卷批次推播：問卷表單設定「自動發送」並綁定服務後自動觸發；沒綁任何服務就不會自動發。
- 發券推播：見 手動發券與批次發放。
這頁能做什麼（功能總覽）
詳細介紹
- 靜音模式 / 自動提醒選「靜音模式」就完全不發 LINE 給顧客，只寫後台紀錄；選「自動提醒」才會發頁面上方的切換
- 提醒時機「標準通知」只在預約成立當下發一則確認卡；「前一天」預約前一天再提醒一次；「三日確認」前三天先問顧客會不會來，回覆後再發導航（三張選項卡，右邊標著要用幾則訊息）
- 顧客收到的樣子右邊的手機畫面照你選的模式演一次，最下面寫這個模式會用掉幾則 LINE 訊息電腦版右側；手機版點右緣「預覽」
詳細介紹
- 每張券各自設定在優惠券管理列表的「通知」欄點鈴鐺打開，這裡的推播會用掉你官方帳號的訊息額度（鈴鐺亮黃色代表至少開了一個）
- 獲獎通知發券當下推一張券卡給會員，手動發券、生日券、新好友禮、行銷活動發券都走這個開關（視窗第一個開關）
- 到期推播到期前主動提醒會員來用，每張券只提醒一次，預設到期前 7 天（視窗第二個開關）
詳細介紹
- 兩種表單「服務前諮詢」跟著行前提醒一起發；「服務後回饋」在服務結束 N 小時後自動發頁面上方切換
- 自動發送表單設了自動發送才會出現這個標籤（屬性欄）
- 綁定服務只有綁了服務的表單會自動發；沒綁會顯示「未綁服務」，不會發（綁定服務欄，點開看綁了哪些）
- 分眾群發「自動化行銷 > 建立活動」的手動發送，可以分眾、可以附券，訊息內容在活動的第二步「訊息內容」組（見 自動化行銷（建立活動））
- 發券給全體優惠券管理的發送圖示，發券視窗可以一次選全體會員；有開獲獎通知的券就會同時推券卡
操作步驟（你控制通知的地方）
1完成 LINE 整合
在 LINE 整合設定填好 Messaging API 金鑰並按「儲存設定」，系統會自動開通 LINE 通知服務（免費），詳細見 LINE 整合設定。
2選預約提醒模式
到「預約通知」頁，確認上方是「自動提醒」不是「靜音模式」，再選標準通知、前一天或三日確認（見上方「預約通知」分頁的圖）。
3設定推播時段
同一頁切到「設定」分頁，在「推播發送時段」挑每天幾點發（08:00～22:00，預設 20:00）。行前提醒、優惠券到期提醒、自動發券都會集中在這個整點發，不會半夜吵到顧客。改完按右上「儲存設定」。
4開券的通知
優惠券管理列表每張券的鈴鐺，開「獲獎通知」與「到期推播」（見上方「優惠券通知」分頁的圖）。
5行銷與問卷
自動化行銷活動在「訊息內容」加訊息才會推 LINE；問卷表單要設自動發送並綁定服務才會自動發（見上方「問卷表單」分頁的圖）。
前置條件與依賴
- 所有顧客通知的前提LINE 整合完成＋「LINE 通知服務」模組開通＋顧客加好友並綁定。
- 訊息額度LINE 官方帳號免費方案每月能推播的則數有限，額度用完時 LINE 會拒發，系統只會默默記下來，不會另外警告你，要自己留意 LINE 後台的額度。
- 已取消或已刪除的預約不會發行前提醒。
常見問題與排查
Q1：所有顧客突然都收不到通知了？
整批收不到，優先懷疑三個整批性原因：1) 「LINE 通知服務」模組被停用了（通常跟訂閱異動有關，找客服確認）；2) Access Token 失效（你在 LINE 後台重發了 token，忘了回 Folio 整合設定重填）；3) 當月訊息額度用完了（到 LINE 官方帳號後台看）。
Q2：只有某位顧客收不到？
到會員資料看這位顧客有沒有綁 LINE：沒綁 = 收不到是正常的；有綁還收不到 = 多半是顧客封鎖了你的官方帳號（封鎖的人 LINE 不會送達，系統只會默默記下失敗）。
Q3：員工說沒收到新預約通知，跟這裡有關嗎？
無關。員工通知走 Folio 統一官方帳號跟後台 App 推播，不吃你自己的 LINE 設定。請查員工帳號的 LINE 綁定（商家後台員工帳號那邊綁），跟後台 App 有沒有安裝（iPhone 要把後台加到主畫面安裝成 App 才收得到），屬於員工管理領域（跨領域：merchant-staff）。
Q4：預約被取消 / 刪除了還會發提醒嗎？
不會。行前提醒已經排除了已刪除跟非「已確認」狀態的預約。如果顧客反映收到已取消預約的提醒，查那筆預約當時的實際狀態跟刪除時間點（可能是提醒發出之後才取消的）。
Q6：顧客抱怨一天收到好幾則行銷訊息？
自動活動對同一位會員的多個活動已經會合併成一則；如果還是太多，檢查是不是手動發券的推播、活動推播、券到期提醒剛好疊在同一天。建議調整活動的冷卻天數跟到期提醒天數，把時間錯開。
Q7：想在推播前知道會發給幾個人？
活動編輯視窗按「預覽」會顯示「符合共 N 位（LINE 可推 M）」，M 是有綁 LINE 的人，兩者的差 = 收不到推播但還是會拿到券的人數。
通知發送點速查（worker 檔案對照）
| 通知 | 觸發點 | 程式位置 |
|---|---|---|
| 預約成功 / 確認卡 | 預約建立 / 審核通過 | lib/line-bot.ts sendBookingSuccessCard 等，各預約路由呼叫 |
| 行前提醒（T-3 / T-1） | cron booking-reminders（每小時，依商家推播時段） |
handlers/cron-booking-reminders.ts |
| 報到確認回覆卡 | 顧客點按鈕（webhook postback） | routes/public-line-webhook.ts |
| 券獲獎卡 | 發券當下（手動 / 生日 / 活動） | sendCouponIssuedCard(s) |
| 券到期提醒 | cron coupon-expiry-reminder（每小時，quiet 心跳） |
handlers/cron-coupon-expiry-reminder.ts |
| 行銷活動圖文 | cron campaigns + 結帳即時 |
routes/cron-campaigns.ts / lib/campaign-run.ts |
| 問卷卡 | 預約提醒併發（服務前）/ 服務後 N 小時 cron | lib/survey-line-send.ts / handlers/cron-post-service-survey.ts |
所有顧客側發送都經 shouldSendLineNotification / hasLineServiceEnabled（lib/subscription-utils.ts）檢查 line_service 模組。訊息皆為 LINE Flex 卡片，套商家主題色。
給客服的話術重點
- 先分清楚是「顧客通知」（商家自己的 LINE 官方帳號）還是「員工通知」（Folio 官方帳號 / 後台 App），兩邊的排查路徑完全不同。
- 「收不到」三連問模組開了嗎、綁好友了嗎、額度還有嗎。
- 定時發送類的通知照商家的推播時段整點集中發，不是事情發生當下就發；「怎麼中午才收到」多半是時段設定，不是故障。
