LINE 官方帳號 API 串接怎麼做？

當你經營 LINE 官方帳號一段時間後，會發現內建的功能雖然夠用，但總有一些「如果能夠自動化就好了」的時刻。例如：用戶輸入「A」就能自動收到最新優惠券，新好友加入時自動發送客製化歡迎訊息，甚至把 LINE 官方帳號串接到自己的購物網站後台，讓訂單通知直接推播給客戶。這些功能的關鍵，就是 LINE 提供的 Messaging API。Messaging API 讓你的官方帳號不再只是一個「手動回覆」的工具，而是一個可以自動化執行各種任務的智慧平台。但很多商家聽到「API」三個字就卻步，認為那是工程師才會的東西。其實，只要跟著教學一步一步做，不需要寫程式也能完成基礎串接。

Messaging API 基礎概念：為什麼你的官方帳號需要它？

Messaging API 是什麼？

Messaging API 是 LINE 官方提供的一組程式介面，讓開發者可以透過程式碼控制官方帳號的各種行為。啟用 Messaging API 後，你可以透過程式自動發送訊息、接收用戶的訊息、管理好友名單、設定圖文選單等。簡單來說，Messaging API 讓你的官方帳號從「手動操作」進階為「自動化系統」。目前市面上許多 LINE 機器人服務（如訂單查詢、天氣查詢、客服機器人），都是基於 Messaging API 開發的。

啟用前需要準備什麼？

在開始串接 Messaging API 之前，你需要準備以下項目：一個已經開通的 LINE 官方帳號（免費版即可，但進階功能可能需要付費方案）；一個 LINE 開發者帳號（可使用同一組 LINE 帳號登入 LINE Developers Console）；一個可以接收 Webhook 的伺服器或服務平台（若無伺服器，可使用免費服務如 Heroku、Google App Engine 或第三方 LINE 機器人平台）；基本的程式概念（如 HTTP 請求、JSON 格式）。

Messaging API 可以做到哪些事？

啟用 Messaging API 後，你的官方帳號將具備以下進階能力：自動回覆可以根據用戶傳送的關鍵字或訊息內容，自動回覆對應的訊息，不需人工介入。客製化歡迎訊息可以針對新加入的好友發送專屬歡迎訊息，還可根據好友加入來源（例如從官網加入、從門市掃描加入）發送不同內容。圖文選單可以設定在聊天室底部顯示一個可點擊的圖文選單，引導用戶快速使用各項功能。推播與分眾可以透過程式自動發送群發訊息，並根據用戶的標籤進行分眾推播。用戶資訊管理可以取得用戶的基本資料（如顯示名稱、大頭貼），並建立客製化的用戶體驗。

Messaging API 與 LIFF 的關係

LIFF（LINE Front-end Framework）是 LINE 提供的另一項開發工具，讓開發者可以在 LINE 應用程式內嵌入網頁應用程式。LIFF 與 Messaging API 可以搭配使用，創造更完整的互動體驗。例如：用戶點擊圖文選單後，開啟一個 LIFF 網頁填寫問卷；填寫完成後，透過 Messaging API 自動回傳確認訊息。若你只需要基本的自動回覆與推播功能，單獨使用 Messaging API 就足夠了。若你需要開發表單填寫、遊戲互動、會員登入等進階功能，則需要一併設定 LIFF。

啟用 Messaging API 完整步驟

第一步：登入 LINE Official Account Manager

開啟瀏覽器，前往 LINE Official Account Manager使用你的 LINE 官方帳號管理者帳號登入。若你尚未擁有官方帳號，請先至 LINE 官方網站免費申請一個。登入後，在頁面右側找到「設定」按鈕，點選後從左側選單選擇「Messaging API」。

第二步：啟用 Messaging API

在 Messaging API 頁面中，點選「啟用 Messaging API」按鈕。系統會要求你建立一個「服務提供者」（Provider），輸入你的公司或品牌名稱，並同意相關條款後點選確定。啟用後，你的官方帳號就會與一組 Messaging API Channel 綁定。

第三步：取得 Channel 憑證

啟用成功後，點選頁面下方的連結前往 LINE Developers Console。在 Provider 列表中找到剛剛建立的 Messaging API Channel，點選進入。在「Basic settings」分頁中，你可以找到「Channel ID」和「Channel secret」，請將這兩組憑證妥善保存。接著點選「Messaging API」分頁，向下滑到「Channel access token」區塊，點選「Issue」產生一組長效 Token，並將其複製保存。

第四步：將官方帳號與 Channel 連結

若你的 Channel 與官方帳號尚未連結，請在「Basic settings」分頁中找到「Linked OA」欄位，點選「Link」並選擇你的官方帳號進行綁定。完成後，你的官方帳號就正式啟用了 Messaging API。

Webhook 設定：讓官方帳號接收用戶訊息

Webhook 是什麼？

Webhook 是 Messaging API 的核心機制之一。簡單來說，當用戶傳送訊息給你的官方帳號時，LINE 會將這則訊息的內容（包含文字、圖片、貼圖等）以 HTTP 請求的方式傳送到你指定的伺服器網址。你的伺服器收到請求後，就可以根據用戶的訊息內容執行對應的動作，例如回覆訊息、查詢訂單、自動標籤等。沒有設定 Webhook，官方帳號就無法接收用戶的訊息，Messaging API 只能「單向」發送訊息。

Webhook URL 的設定步驟

在 Messaging API Channel 的「Messaging API」分頁中，找到「Webhook settings」區塊。在「Webhook URL」欄位中輸入你的伺服器接收端網址。如果你還沒有自己的伺服器，可以先使用 ngrok 等工具建立一個臨時的測試端點。輸入完成後，點選「Verify」按鈕，LINE 會向該網址發送一個驗證請求。若驗證成功，頁面會顯示「Success」。接著將「Use webhook」開關切換為開啟狀態。

關閉 LINE 後台的自動回應

這是一個容易被忽略但非常重要的步驟。在 Messaging API 的「LINE Official Account features」區塊中，點選「Auto-reply messages」旁的「Edit」。這會跳轉到 LINE Official Account Manager 後台，請將「自動回應訊息」設為「停用」。如果不關閉這個設定，LINE 內建的自動回應會與你的 Webhook 伺服器互相衝突，導致用戶收到的回覆可能重複或錯誤。

測試 Webhook 是否正常運作

設定完成後，建議先進行測試。用自己的 LINE 帳號加入你的官方帳號，傳送一則測試訊息。確認你的伺服器是否有收到來自 LINE 的請求，以及是否正確回覆。若沒有收到請求，請檢查 Webhook URL 是否正確、伺服器是否正常運作、防火牆是否開放 LINE 的 IP 範圍。

LIFF 網頁應用開發與整合

LIFF 是什麼？什麼時候需要它？

LIFF（LINE Front-end Framework）是 LINE 提供的網頁應用程式框架，讓開發者可以在 LINE 應用程式內直接開啟網頁，並與 LINE 帳號進行互動。LIFF 與 Messaging API 的關係是：Messaging API 負責「收發訊息」和「控制官方帳號」，LIFF 負責「在 LINE 內呈現互動網頁」。若你的需求只是自動回覆和推播，不需要 LIFF。若你需要開發問卷調查、會員登入、遊戲互動、商品選購等功能，就需要使用 LIFF。

建立 LIFF Channel

在 LINE Developers Console 中，於同一個 Provider 底下點選「Create a new channel」，選擇「LINE Login」類型。填寫基本資料後完成建立。建立完成後，進入 Channel 的「LIFF」分頁，點選「Add」新增一個 LIFF 應用程式。填寫 LIFF 應用程式的名稱、大小、端點網址（你的網頁應用程式的 URL），並選擇需要的權限範圍（例如取得用戶的顯示名稱、電子郵件等）。

LIFF 與官方帳號的整合

完成 LIFF 設定後，你可以將 LIFF 網址放在官方帳號的圖文選單中，或透過 Messaging API 推送給用戶。當用戶點擊連結時，LINE 會直接開啟你的網頁應用程式，並自動帶入用戶的 LINE 存取權杖。透過 LIFF SDK，你的網頁可以取得用戶的 LINE 基本資料（經用戶同意後），實現「一鍵登入」的流暢體驗。

常見的 LIFF 應用場景

LIFF 在台灣的應用場景非常廣泛。零售品牌可以用 LIFF 開發會員卡頁面，用戶在 LINE 內直接顯示會員 QR Code 供門市掃描。餐飲業者可以用 LIFF 開發線上點餐系統，用戶在聊天室內直接點餐、結帳。服務業者可以用 LIFF 開發預約表單，用戶填寫後自動發送到官方帳號後台。遊戲開發商可以用 LIFF 開發互動小遊戲，增加用戶黏著度。

常見問題與排解

Webhook 驗證失敗怎麼辦？

若 Webhook 驗證失敗，請檢查你的伺服器是否正常運作，並確認 Webhook URL 是否為 HTTPS 開頭（LINE 要求 Webhook 端點必須使用 HTTPS）。你也可以使用 ngrok 等工具在本地測試，確認伺服器能正確回應 LINE 的驗證請求。驗證請求的格式為 GET 請求，需回傳「200 OK」狀態碼。

訊息發送失敗的可能原因

若透過程式發送訊息失敗，常見原因包括：Access Token 已過期（短期 Token 效期為 30 天，建議使用長期 Token）；Channel secret 填寫錯誤；發送的訊息格式不符合 LINE API 規範（如 JSON 格式錯誤、訊息內容過長）。建議使用官方提供的 API 測試工具先驗證 API 呼叫是否正常。

LIFF 網頁無法在 LINE 中開啟

若 LIFF 網頁無法正常開啟，請檢查：端點網址是否為 HTTPS 開頭；網頁是否允許被嵌入 iframe（需設定 X-Frame-Options 允許來自 LINE 的嵌入）；LIFF 應用程式的設定是否正確（如尺寸、權限範圍）。可以在 LIFF 應用程式的「開發者工具」中查看錯誤日誌。