本文件說明如何在 LINE Developers Console 建立 OptibookingPlatform 所需的 Channel 和 LIFF App。
完成本指南後，您將取得設定精靈 Step 4 和 Step 5 所需的所有資訊。
---
目錄
1. 建立 LINE Developers 帳號
1. 前往 [LINE Developers Console] (https://developers.line.biz/console/)
2. 使用您的 LINE 帳號登入
3. 如果是第一次登入，系統會要求您建立開發者資料，依指示填寫即可
---
2. 建立 Provider
Provider 是用來管理 Channel 的組織單位，通常以公司或品牌名稱命名。
1. 登入 LINE Developers Console 後，點擊 「Create a new provider」
2. 輸入 Provider 名稱（例如您的店名）
3. 點擊 「Create」
> 一個 Provider 下可以建立多個 Channel。OptibookingPlatform 需要兩個 Channel：
> - Messaging API Channel（用於發送訊息和接收 Webhook）
> - LINE Login Channel（用於 LIFF 預約頁面）
---
3. 建立 Messaging API Channel
1. 進入您剛建立的 Provider
2. 點擊 「Create a new channel」
3. 選擇 「Messaging API」 類型
4. 填寫以下資訊：
- Channel name：您的 LINE 官方帳號名稱
- Channel description：簡短描述（例如「XX眼鏡行預約系統」）
- Category 和 Subcategory：選擇與您業務最接近的分類
- Email address：您的聯絡信箱
5. 勾選同意條款，點擊 「Create」
---
4. 取得 Messaging API 設定資訊
建立完成後，您需要取得以下資訊（對應設定精靈 Step 4）：
Channel ID 和 Channel Secret
1. 進入 Messaging API Channel
2. 點擊 「Basic settings」 頁籤
3. 記下 Channel ID
4. 記下 Channel secret（點擊 「Issue」如果尚未產生）
Channel Access Token
1. 點擊 「Messaging API」 頁籤
2. 捲到最下方找到 「Channel access token (long-lived)」
3. 點擊 「Issue」 產生 Token
4. 複製並保存這個 Token
注意：Channel Access Token 只會顯示一次，請務必複製保存。如果遺失，可以重新 Issue 一個新的（舊的會失效）。
---
5. 設定 Webhook
完成設定精靈 Step 4 後，系統會產生一個 Webhook URL。請回到 LINE Developers Console 進行以下設定：
1. 進入 Messaging API Channel → 「Messaging API」 頁籤
2. 找到 「Webhook URL」 欄位
3. 點擊 「Edit」，貼上系統產生的 Webhook URL
4. 點擊 「Update」
5. 開啟「Use webhook」 開關（打勾）
6. 點擊 「Verify」 測試 Webhook 連線是否正常
關閉自動回覆
1. 在 Messaging API 頁籤中找到 「Auto-reply messages」
2. 點擊旁邊的 「Edit」 連結（會跳轉到 LINE Official Account Manager）
3. 將 「Auto-reply messages」 設為 關閉（Disabled）
> 關閉自動回覆後，系統才能正確接管所有 LINE 訊息的自動回覆邏輯。
---
6. 建立 LINE Login Channel
1. 回到 Provider 頁面
2. 點擊 「Create a new channel」
3. 選擇 「LINE Login」 類型
4. 填寫以下資訊：
- Channel name：例如「XX眼鏡行 - 預約登入」
- Channel description：簡短描述
- App types：勾選 「Web app」
- Email address：您的聯絡信箱
5. 點擊 「Create」
---
7. 建立 LIFF App
LIFF（LINE Front-end Framework）讓顧客可以在 LINE 內直接開啟預約頁面。
1. 進入剛建立的 LINE Login Channel
2. 點擊 「LIFF」 頁籤
3. 點擊 「Add」 新增 LIFF App
4. 填寫以下設定：
設定項目 | 值 |
|---|---|
LIFF app name | 例如「預約系統」 |
Size | Full（全螢幕） |
Endpoint URL | 從設定精靈 Step 5 複製 |
Scopes | 勾選 openid 和 profile |
Bot link feature | 選擇 On (Normal) |
5. 點擊 「Add」 建立
> 極重要：Scopes 必須同時勾選 openid 和 profile。如果缺少 profile，顧客登入時會失敗。
6. 建立完成後，複製 LIFF ID（格式類似 1234567890-xxxxxxxx）
7. 回到設定精靈 Step 5，將 LIFF ID 貼入
---
8. 取得 Bot Basic ID
Bot Basic ID 是您的 LINE 官方帳號的唯一 ID（格式如 @123abcde）。
1. 前往 [LINE Official Account Manager](https://manager.line.biz/)
2. 選擇您的官方帳號
3. 進入 「設定」
4. 在帳號資訊中找到 Bot Basic ID（以 @ 開頭）
5. 複製並貼到設定精靈 Step 4 的 Bot Basic ID 欄位
---
設定完成後的檢查清單
- [ ] Messaging API Channel 已建立
- [ ] Channel ID、Channel Secret、Channel Access Token 已取得
- [ ] Webhook URL 已設定且開啟 Use webhook
- [ ] Auto-reply messages 已關閉
- [ ] LINE Login Channel 已建立
- [ ] LIFF App 已建立，Size = Full，Scopes = openid + profile
- [ ] LIFF ID 已取得
- [ ] Bot Basic ID 已取得
---
常見問題
Q：Messaging API Channel 和 LINE Login Channel 需要在同一個 Provider 下嗎？
建議是。 放在同一個 Provider 下比較好管理，但技術上不是強制要求。
Q：Channel Access Token 遺失了怎麼辦？
到 Messaging API Channel → Messaging API 頁籤 → 重新點擊 「Issue」即可產生新的 Token。注意：舊的 Token 會立即失效。
Q：Webhook Verify 失敗怎麼辦？
1. 確認 Webhook URL 是否正確（從設定精靈 Step 4 複製）
2. 確認您的系統網址可以從外部存取（不能是 localhost）
3. 確認 Use webhook 開關已開啟
4. 稍等幾秒後再試一次
Q：LIFF App 的 Size 為什麼要選 Full？
選擇 Full（全螢幕）可以讓預約頁面佔滿整個畫面，提供最佳的使用體驗。其他尺寸（Tall、Compact）只佔部分畫面，不適合完整的預約流程。