LINE Messaging API 設定教學:從零開始串接 LINE 官方帳號
完整圖文步驟,新手也能 5 分鐘搞定
完整圖文步驟,新手也能 5 分鐘搞定
LINE Messaging API 是串接 LINE 官方帳號與外部系統(例如預約系統、CRM、自動回覆機器人)的核心橋樑。無論你是店家想要讓顧客在 LINE 上預約,還是開發者想打造自動化聊天機器人,都必須先完成 Messaging API 的設定。
這篇教學會一步一步帶你走完整個流程:從建立 LINE 官方帳號、進入 LINE Developers Console、取得 Channel Token,到設定 Webhook URL 並測試連線。全程不需要寫一行程式碼,搭配 VibeAI 預約系統只需要 5 分鐘即可完成串接。
LINE Messaging API 是 LINE 開放的程式介面,讓外部應用程式能夠透過 LINE 官方帳號發送與接收訊息。簡單來說,它就是一座橋——把你的預約系統、客服系統、行銷工具與 LINE 聊天室連結起來。
透過 Messaging API,你可以做到以下事情:
對服務業店家來說,最實用的功能就是讓顧客直接在 LINE 聊天室裡完成預約、查詢預約、領取票券。這些全部都建立在 Messaging API 之上。
在開始設定之前,先了解整個串接的架構,會幫助你理解每個步驟的目的。
| 元件 | 角色 | 說明 |
|---|---|---|
| LINE 官方帳號 | 門面 | 顧客加入好友、互動的帳號 |
| Messaging API Channel | 橋樑 | LINE 平台與你的系統之間的通道 |
| Channel Access Token | 鑰匙 | 你的系統用來「代表」官方帳號發送訊息的憑證 |
| Webhook URL | 收件地址 | LINE 把顧客訊息「轉寄」到你系統的網址 |
| 預約系統(VibeAI) | 大腦 | 接收訊息、處理邏輯、回覆顧客 |
顧客傳訊息 → LINE 平台 → Webhook 轉發 → VibeAI 接收處理 → 透過 Channel Token 回覆 → 顧客收到回覆。整個過程在毫秒之內完成。
如果你已經有 LINE 官方帳號,可以跳到 Step 2。如果還沒有,按照以下步驟建立一個全新的官方帳號。
打開瀏覽器,進入 manager.line.biz。這是 LINE 官方帳號的管理後台。使用你的個人 LINE 帳號登入(LINE 帳號需要先綁定 Email)。
登入後,點選「建立」按鈕。填寫以下資訊:
填寫完成後,選擇「稍後進行認證」(免費帳號即可使用 Messaging API),送出即完成建立。
建立完成後,你會看到 LINE Official Account Manager 的主畫面,上方顯示你的帳號名稱和基本資訊。記下你的帳號 ID(格式為 @xxx),之後分享給顧客加入好友時會用到。
有了 LINE 官方帳號後,下一步是啟用 Messaging API。這個步驟會在 LINE Developers Console 建立一個 Channel,讓你的系統能夠與 LINE 平台溝通。
在 LINE Official Account Manager 的主畫面,點選右上角「設定」。在左側選單中找到「Messaging API」,點擊進入。
點選「啟用 Messaging API」按鈕。系統會要求你選擇或建立一個「Provider(服務提供者)」:
按「同意」完成啟用。
啟用後,同一頁面會顯示兩組重要資訊:
分別點選「複製」按鈕,將這兩組值記下來備用。
Channel Access Token 是讓你的系統「代表」LINE 官方帳號發送訊息的憑證。沒有它,你的系統就無法透過 LINE 回覆顧客。
在 Messaging API 設定頁面最下方,點擊「LINE Developers Console」連結。或者直接前往 developers.line.biz,用同一個 LINE 帳號登入。
在 Console 首頁,點選你剛才建立的 Provider,然後點選你的店家帳號 Channel(類型為 Messaging API)。
切換到「Messaging API」分頁,拉到頁面最下方,找到「Channel access token (long-lived)」區塊。點選「Issue」按鈕,系統會產生一組長字串,這就是你的 Channel Access Token。點「複製」備用。
Webhook 是 LINE 平台把顧客訊息「推送」到你系統的機制。當顧客傳訊息給你的官方帳號,LINE 會把這個事件以 HTTP POST 的方式發送到你指定的 Webhook URL。
前往 vibeaico.com/tenant/login,登入你的店家帳號。如果還沒有帳號,可以前往 vibeaico.com/tenant/register 免費註冊。
在左側選單中找到「LINE 設定」,點擊進入。你會看到三個輸入欄位。
把前面取得的 Channel ID、Channel Secret、Channel Access Token 分別填入對應欄位,點選「儲存設定」。系統會自動完成以下動作:
https://vibeaico.com/api/line/webhook/{你的店家代碼})儲存完成後,頁面會顯示連線狀態為「運作中 (ACTIVE)」,代表你的 LINE Messaging API 已經成功串接。
如果你使用的是其他系統,或想要手動設定 Webhook,步驟如下:
這是整個設定過程中最容易被遺忘但最重要的步驟。如果不關閉 LINE 預設的自動回應功能,你的 Bot 將完全無法正常運作。
LINE 官方帳號預設會開啟「自動回應訊息」功能。當這個功能開啟時,LINE 平台會「攔截」顧客的訊息,用內建的自動回應來回覆,而不會把訊息轉發到你的 Webhook URL。結果就是:你的 Bot 根本收不到訊息,自然也無法回覆。
在 VibeAI 的 LINE 設定頁面,連線成功後會顯示「一鍵前往關閉自動回應」直達連結。點擊後會跳轉到 LINE Official Account Manager 的回應設定頁面。
或者,在 LINE Official Account Manager 中手動前往:設定 → 回應設定。
在回應設定頁面中:
儲存設定。
所有設定完成後,用以下步驟確認 Messaging API 串接成功。
在 LINE Developers Console 的 Messaging API 分頁,找到你的 Bot 的 QR Code。用手機掃描 QR Code,加入你的 LINE 官方帳號為好友。
在 LINE 聊天室裡輸入任意文字,例如「你好」。如果 Messaging API 設定正確,你的系統應該會自動回覆(VibeAI 會回覆主選單 Flex Message)。
登入 VibeAI 後台,查看 LINE 設定頁面的連線狀態是否為「運作中 (ACTIVE)」。如果有新的顧客加入好友,顧客管理頁面也會自動出現這位顧客的紀錄。
了解以下幾個 Messaging API 的重要設定,會幫助你更好地管理 LINE 官方帳號。
| 設定項目 | 建議值 | 說明 |
|---|---|---|
| Auto-reply messages | 關閉 | 讓 Webhook(Bot)處理所有訊息 |
| Greeting messages | 關閉 | 由 Bot 發送自訂歡迎訊息 |
| Use webhook | 開啟 | 啟用 Webhook 接收訊息 |
| Allow bot to join groups | 依需求 | 是否允許加入群組(預約系統通常不需要) |
| Channel access token | Long-lived | 有效期長,不需頻繁更換 |
LINE Messaging API 的憑證攸關你的官方帳號安全,請務必注意以下幾點:
| 症狀 | 可能原因 | 解決方法 |
|---|---|---|
| Bot 完全沒回應 | LINE 自動回應未關閉 | 前往回應設定,關閉自動回應訊息 |
| Webhook 驗證失敗 | URL 不正確或伺服器未啟動 | 確認 URL 為 HTTPS、伺服器正常運作 |
| Token 無效 | Token 已過期或複製不完整 | 重新 Issue 一組新的 Token |
| 只收到預設回覆 | 自動回應優先於 Webhook | 確認回應方式為「手動聊天」 |
| 訊息延遲嚴重 | 伺服器回應過慢 | Webhook 應在 1 秒內回應 200 |
| Rich Menu 不顯示 | 只在手機版 LINE 顯示 | 用手機測試,非電腦版 |
LINE 官方帳號的方案決定了你每月能免費發送多少則推播訊息。這裡指的是「主動推播」(Push Message),不包含 Webhook 回覆訊息(Reply Message,免費無上限)。
| 方案 | 月費 | 免費訊息 | 加購訊息 |
|---|---|---|---|
| 免費 | NT$0 | 200 則/月 | 不可加購 |
| 輕用量 | NT$800 | 3,000 則/月 | 不可加購 |
| 中用量 | NT$4,000 | 25,000 則/月 | 可加購 |
LINE Messaging API 串接完成後,搭配 VibeAI 你可以立即啟用以下功能:
更多 LINE Bot 設定的細節,可以參考我們的 LINE Bot 預約系統設定教學。
是的,LINE Messaging API 本身完全免費。你不需要支付任何費用就能建立 Channel、設定 Webhook、接收和回覆訊息。唯一需要注意的是每月推播訊息的免費額度(免費方案 200 則/月),超過需要升級 LINE 官方帳號方案。
不行。一個 LINE 官方帳號在同一時間只能設定一個 Webhook URL。如果你同時需要連接預約系統和客服系統,建議選擇一個已經整合多項功能的平台(例如 VibeAI),或者使用中間層做訊息分流。
Long-lived Channel Access Token 不會自動過期,但如果你在 LINE Developers Console 重新 Issue 一組新 Token,舊的就會失效。建議在安全無虞的情況下不要頻繁更換,避免造成系統連線中斷。
是的,LINE 強制要求 Webhook URL 必須使用 HTTPS。這是為了確保資料傳輸的安全性。如果你在本地開發測試,可以使用 ngrok 等工具提供臨時的 HTTPS URL。使用 VibeAI 則不需要擔心這個問題,所有連線都已經是 HTTPS。
如果你使用 VibeAI,完全不需要寫任何程式。只要在後台填入 Channel ID、Channel Secret、Channel Access Token 三組值,系統就會自動完成所有串接。如果你是自行開發系統,則需要撰寫接收 Webhook 事件和回覆訊息的程式碼。
可以。一個 Provider 可以包含多個 Channel,適合有多個品牌或店面的情況。每個 Channel 對應一個 LINE 官方帳號,各自獨立運作。