LINE 整合設定
串你自己的官方帳號：先 Messaging 後 Login；跟原本預約系統、其他 AI 客服會不會衝突（LINE 登入可並存、Webhook 只能填一個）
- 商家資訊管理 > LINE 整合 > 整合設定
功能說明
把你自己的 LINE 官方帳號串進 Folio 後，顧客可以用 LINE 登入你的預約網站，並從你的官方帳號收到預約 / 優惠券等通知。串接會用到 LINE 的兩種 channel（頻道，可以想成 LINE 發給你的兩組通行證）：LINE Login channel（管「顧客用 LINE 登入」）和 Messaging API channel（管「官方帳號自動發訊息」）。這兩組都是你自己申請、自己所有；跟 Folio 平台自己的官方帳號（只用來通知商家員工）是兩套，見 LINE 通知與推播總覽。
設定入口：「商家資訊」的「LINE 整合」頁籤，裡面有兩個子頁籤：「整合設定」與「圖文選單」。畫面右緣固定有綠色直條「LINE 設定教學」，打開逐步教學（副標「跟著步驟做，大約 15 分鐘完成」，最上方有「設定進度」進度條）。同一份互動教學也內嵌在教學中心的這篇主題頁裡，兩邊進度共用；教學中心「互動建置」的 LINE 整合設定彈窗右上角也有「LINE 設定教學」按鈕可打開。
這頁能做什麼（功能總覽）
詳細介紹
- Messaging API 金鑰填 Messaging Channel Secret 與 Channel Access Token，系統才能用你的官方帳號自動發訊息。欄位順序跟你在 LINE 後台複製的順序一樣，先 Secret 再 Token「LINE Messaging API 設定」區塊
- 機器人編號自動抓按儲存時系統自動去 LINE 抓官方帳號的 Bot User ID，不用自己找（「Bot Destination (User ID)」欄，灰底不能改）
- LINE Login 金鑰填 Login channel 的 Channel ID 與 Channel Secret，顧客才能用 LINE 登入你的預約網站「LINE Login 設定」區塊
- LIFF 入口連結儲存 Login 金鑰時系統自動建好首頁、我的預約、立即預約、會員中心、優惠券等入口，點開這一列就能看清單表單下方的收合列
- 儲存設定按了才會生效；已經填過的金鑰會顯示成一串圓點，下面寫「已儲存，留空不動即可」，不改就別動它表單最下方
詳細介紹
- 重新檢查 / 補建有入口缺漏時按一下全部補齊，已經建好的會直接沿用，不會重複建清單最上方的按鈕；一個都還沒建時叫「一鍵建立全部 LIFF 入口」
- 建立狀態入口名稱前面是綠點、右邊寫「已建立」就是好了，灰點代表還沒建（每張入口卡的標題列）
- 複製網址LIFF URL 右邊的複製鈕，要貼到圖文選單或貼文按鈕時用（每張入口卡的網址列）
詳細介紹
- 整體進度顯示「設定進度」與已完成步數，勾過的會記在這台裝置上，關掉再開還在；教學中心本篇嵌的是同一份，進度共用面板最上方
- 專人協助照圖文把 Folio 專人邀進你的 LINE 後台幫忙。要先做完第一階段才有 Provider 可以邀請面板右上角
- 四個階段先把 Messaging API 做完（第一、二階段），再做 LINE Login（第三階段）與圖文選單（第四階段），點標題展開或收起（階段卡片）
- 做完一步勾一步每一步前面的圓圈點一下就打勾，該階段會顯示「X / Y 步完成」每個步驟的左上角
操作步驟（教學四大階段）
1啟用 Messaging API
在 LINE 官方帳號後台右上角「設定」→「Messaging API」→ 啟用，過程中建立服務提供者（Provider，輸入品牌名即可）。啟用時 LINE 會自動建好 Messaging API channel，不用自己建。確認啟用完成後，前往 LINE Developers Console 並登入（右上方「Log in to Console」，用同一個 LINE 帳號），從左側 Admin 面板點進你的服務提供者（通常是品牌名），再點擊自動建好的 Messaging API 卡片進入。這一段都在 LINE 的後台操作，截圖在右側「LINE 設定教學」的第一階段裡。
2串好 Messaging API
在 Messaging API channel 裡複製兩把金鑰，貼回 Folio 的「LINE Messaging API 設定」區：先貼 Channel Secret，再發行並複製 Channel Access Token (long-lived)（系統代替你官方帳號發訊息用的長效通行證），然後按「儲存設定」。儲存時系統會自動抓 Bot User ID，並自動開通 LINE 通知服務。
接著回 LINE 後台的「Webhook settings」，填入 Webhook URL（LINE 把顧客動作回傳給系統的接收網址）https://api.folio.tw/api/public/line/webhook，這條網址全平台商家都填一樣的，系統會自動分辨是哪家店的訊息。按「Verify」應該顯示 Success，再打開「Use webhook」。做完這步 Messaging API 就全部完成。
官方帳號的「自動回應訊息」不用關：它只在顧客傳訊息進來時觸發，跟系統主動推播的通知卡不衝突，還能搭配圖文選單「傳送文字」做關鍵字自動回覆（見 LINE 圖文選單）。只是 LINE 預設「一律回覆」的罐頭訊息觀感較差，建議改成關鍵字回應或自訂內容。
3建立 LINE Login channel
在同一個 Provider 按「Create a new channel」→ 選 LINE Login（地區選 Taiwan、App types 勾 Web app＋Mobile app）。把 Channel ID（頻道編號）與 Channel Secret（頻道密鑰）貼回 Folio 的「LINE Login 設定」區，再按一次「儲存設定」，儲存成功時系統會自動建立所有 LIFF 入口。
回到 LINE 後台繼續：把 Callback URL（顧客登入完成後要跳回你網站的網址）https://{你的店網址前綴}.folio.tw/auth/line/callback 登記到 Login channel 的「LINE Login」tab；在 Basic settings 的「Add friend option」把官方帳號連結到 Login channel（Linked LINE Official Account，顧客登入時就會自動加你好友）；最後把 channel 狀態從「Developing」切成「Published」，停在 Developing 顧客會登入失敗。
4設定圖文選單
（教學畫面標示「重要！必做！」）： 直接在 Folio 後台切到「圖文選單」子分頁，選版型、挑功能入口、發佈，系統會自動上傳到 LINE 並設為預設，全程不用進 LINE 後台（見 LINE 圖文選單）。LIFF 入口在步驟 3 儲存時已經自動建好：預設 5 組（首頁、我的預約、立即預約、會員中心、優惠券），可選 3 組（計次券、儲值金、集點，集點要先啟用會員集點功能）。
需要我們直接進去幫忙時，用教學面板右上的「專人協助」照圖文把 Folio 專人邀進 Provider 與 Messaging API channel 的 Roles（皆為 Admin）。
前置條件與依賴
- 要用 Owner 等有設定管理權限的帳號才能改這頁。
- 金鑰填好即自動開通：儲存設定時只要 Messaging 金鑰齊全，系統會自動開通「LINE 通知服務」（免費），儲存成功的提示會顯示「LINE 通知服務已自動開通」。早期需要付費開通的規則已取消。
- Messaging Channel Secret 沒填的話，LINE 後台的 Webhook 驗證會失敗（Verify 不會過）。
- LINE 推播訊息用的是你自己官方帳號的訊息額度（LINE 官方的免費額度 / 加購方案）。
常見問題與排查
Q1：Webhook Verify 失敗（不是 Success）？
照這個順序檢查：Webhook URL 是不是一字不差 https://api.folio.tw/api/public/line/webhook；Folio 這邊的「Messaging Channel Secret」是不是有填而且填對（驗證就是靠它）；然後回 Folio 的整合設定重新按一次「儲存設定」（系統會自動補抓 Bot User ID），再回 LINE 後台重按 Verify。
Q2：換了新的 Access Token 要注意什麼？
在整合設定把舊值清除、填入新 token 並儲存即可。Bot User ID 沒變就不用動。已發出去的舊訊息不受影響；已發佈的圖文選單還掛在 LINE 上，也不受 token 更換影響。
Q3：教學做到一半關掉，進度會不見嗎？
不會。教學有進度勾選（最上方的「設定進度」與各階段的「X / Y 步完成」），可以分好幾次做完；表單已儲存的金鑰也不會因為關掉教學而消失。
Q4：設定都填了，顧客還是收不到任何 LINE 通知？
檢查三層：1) 「LINE 通知服務」有沒有開通（正常情況下儲存金鑰時會自動開通；很早期設定過的商家如果沒開通，重新按一次「儲存設定」即可）；2) Access Token 是否還有效（在 LINE 後台重發過 token 就要回 Folio 重填）；3) 顧客是不是封鎖了你的官方帳號、或根本沒加好友（第三階段的「Add friend option 連結官方帳號、登入自動加好友」沒做時最常見）。只有單一顧客收不到的話，再看那位顧客的會員資料有沒有綁 LINE。
Q5：顧客用 LINE 登入時報錯 / 轉圈？
最常見原因：Login channel 的 Callback URL 沒登記或打錯（必須是 https://{你的店網址前綴}.folio.tw/auth/line/callback），或是把 Login 的 Channel ID / Secret 填成 Messaging channel 的。兩個 channel 的金鑰不能互換，到整合設定逐欄核對。
Q6：一個 LINE 官方帳號可以串多家 Folio 商家嗎？
不行。系統靠官方帳號的機器人編號來分辨是哪家店，同一個官方帳號綁兩家會互搶。多分店同一品牌是同一個商家帳號（多個分店），沒有這個問題。
Q6-1：串了 Folio，原本的預約系統或另一套 AI 客服會衝突嗎？
分兩件事看：
- LINE 登入不會衝突：一個官方帳號可以同時有好幾組 LINE Login，原本系統的登入照常用，很多店都是這樣慢慢轉過來的。
- Webhook 只能填一個網址：LINE 官方帳號的「Webhook URL」只能指到一個地方。另一套 AI 客服或聊天機器人通常也要用 Webhook 收客人的訊息，兩邊只能選一邊。
Folio 的預約通知、提醒卡是系統主動發送，不靠 Webhook；Webhook 只用在「三日確認」提醒卡上的「會準時到達」按鈕。所以：
- 沒開「三日確認」Webhook 留給另一套 AI 客服也可以，Folio 的通知照常會發。
- 有開「三日確認」Webhook 要填 Folio 的網址，不然客人按「會準時到達」會沒反應。
- 兩套都要用到 Webhook 的話，常見做法是開兩個官方帳號：一個專門回答諮詢（接 AI 客服），圖文選單放一個按鈕導到另一個專門處理預約的官方帳號（串 Folio）。
另外，Folio 發佈圖文選單時會取代官方帳號原本的預設選單（見 LINE 圖文選單 Q3），原本系統的選單想留著，就先不要在 Folio 按發佈。
Q7：以前在這頁填的 LINE Pay 金鑰跑去哪了？
LINE Pay 收款的金鑰已經統一搬到「定金設定」的「付款方式」，這頁只剩 LINE 登入與通知用的金鑰。跟 LINE 通知無關，屬於金流那一塊（跨領域：payments）。
Q8：在 LINE 官方帳號後台按了 Messaging API，然後呢？金鑰在哪裡？
LINE 官方帳號後台只負責「啟用」Messaging API，Folio 要的金鑰全部在另一個後台 LINE Developers：
- 在官方帳號後台右上角「設定」→ 左側「Messaging API」→ 按「啟用 Messaging API」，過程中建立服務提供者（Provider）。
- 啟用完成後，到 LINE Developers Console，右上方「Log in to Console」，用同一個 LINE 帳號登入。
- 從左側 Admin 面板點進你的服務提供者（通常是品牌名），再點跟你官方帳號同名的「Messaging API」卡片。
- Channel Secret 在「Basic settings」分頁往下找；Channel Access Token 在「Messaging API」分頁捲到最下面「Channel access token (long-lived)」，第一次要按「Issue」才會產生。
兩把都複製貼到 Folio 的「LINE Messaging API 設定」，按「儲存設定」。每一步的截圖在 LINE 整合 右側綠色的「LINE 設定教學」第一、二階段。
Q9：服務提供者（Provider）是什麼？我要建新的，還是選已經有的？
服務提供者可以想成「你這個品牌在 LINE Developers 裡的資料夾」，Messaging API 和 LINE Login 兩個 channel 都放在裡面。
- 第一次啟用 Messaging API建一個新的，名稱打品牌名就好。
- 之前已經建過（例如以前串過別的系統）選原本那個，不要再多建一個。
- LINE Login channel 一定要建在同一個服務提供者底下。放在不同的服務提供者，同一位客人用 LINE 登入時，系統會認不出他是原本那位會員。
Q10：客人加了我的官方帳號好友，為什麼還沒變成會員？加好友、LINE 登入、會員綁定差在哪？
這是三件不同的事：
所以串好 LINE 之後，要等客人真的從圖文選單點「立即預約」或會員中心、用 LINE 登入一次，才會開始有會員、舊資料才會開始綁定。綁定的細節見 顧客自助綁定與資產歸戶。
給客服的話術重點
- 「兩個 channel、四把鑰匙」：Login 的 ID＋Secret 管登入，Messaging 的 Secret＋Token 管通知，交叉填錯是最常見錯誤。
- 「Webhook URL 全平台同一條」，不用改成商家自己的網址。
- 「Verify 失敗先看 Messaging Channel Secret」，「登入壞掉先看 Callback URL」。
- 金鑰欄顯示 ****不是壞掉，是已儲存的遮罩；不想改就別動它。
排查決策樹（LINE 整合異常）
- 金鑰齊全嗎到「整合設定」逐欄看，四把鑰匙（Login 的 Channel ID / Channel Secret、Messaging 的 Channel Secret / Access Token）都要顯示「已設定」，缺哪一個就對照教學的那個階段補齊。
- 症狀是「登入」查 Login channel（Callback URL 有沒有登記對、Channel ID / Secret 有沒有填反、channel 在 LINE 後台是不是已發佈 Published 而不是開發中 Developing）。
- 症狀是「通知」查 Messaging 這邊Access Token 是否還有效、「LINE 通知服務」模組有沒有開通、顧客有沒有加好友、訊息額度還有沒有
- 症狀是顧客點提醒卡的「會，準時到達」沒反應：確認儲存設定時有自動抓到 Bot User ID、Messaging Channel Secret 正確、LINE 後台「Use webhook」有打開。
- 全部正確仍異常請平台方查系統紀錄，並看 LINE 官方帳號後台的錯誤統計。
補充：試用中的商家還沒完成 LINE 設定時，顧客端會員中心（含優惠券頁）會顯示「預覽模式」的示範資料横幅（「以下為展示用假資料，正式上線後會員將可看到自己的優惠券」）；商家反映「會員中心資料是假的」就代表 LINE 登入還沒設定完成，是正常狀態不是故障。
