LINE Buttons Template 最多 4 個操作：Quick Reply、Carousel 還是 Flex Message？
LINE Messaging API 的 buttons template 在 actions 陣列中最多支援 4 個 action 物件。如果卡片需要更多可見選項，不要把多個意思塞進同一個按鈕。即時選擇可用 quick reply，產品或分店清單可用 carousel template，自訂資訊層級可用 Flex Message；若選項可以分類，拆成兩輪對話通常最清晰。
重點
- LINE 官方 Messaging API reference 規定 buttons template 的
actions最多為 4 個物件。 - 圖片、標題或文字區域可另設一個 action，但不會成為第 5 個可見按鈕。
- Quick reply 最多可設定 13 個按鈕，適合當前問題的臨時選項。
- Carousel template 適合逐項瀏覽產品、分店或預約時段。
- Flex Message 版面較自由，但設計、驗證和多裝置測試也較複雜。
LINE buttons template 的 4 個 action 上限代表甚麼
LINE 把 template message 定義為預設互動版面，包括 buttons、confirm、carousel 和 image carousel。Buttons template 可以放圖片、標題、文字和操作按鈕；必填的 actions 陣列最多接受 4 個物件。圖片、標題或文字區域亦可設定一個可選 action。
兩者不要混淆。整張卡片可點擊，適合「查看詳情」，但不會把 4 個可見按鈕變成 5 個。用戶仍要清楚知道點擊區域會前往哪裏，4 個按鈕的標籤亦要清晰分開。
本文討論的是 Messaging API buttons template，不是 LINE MINI App 名稱相近的 custom action button。若你正在實作 liff.shareTargetPicker() 和 LINE 指定的分享卡片，請參考 LINE MINI App 自訂操作按鈕指南。
Buttons、quick reply、carousel 與 Flex Message 怎樣選
| 方案 | 最適合 | 主要限制 | 適用情況 |
|---|---|---|---|
| Buttons template | 一張卡片上的 1 至 4 個主要操作 | actions 最多 4 個物件 | 所有操作都重要，且屬同一情境 |
| Quick reply | 臨時選單或下一步問題 | 對話繼續後可能消失 | 用戶應立即從最多 13 項中選擇 |
| Carousel template | 產品、分店、預約等重複項目 | 內容需整理成一致 column | 每個項目都需要自己的圖文和操作 |
| Flex Message | 品牌化或資訊密集版面 | JSON、顯示和裝置測試較複雜 | 標準 template 無法清楚表達資訊層級 |
| 兩段式對話 | 可按類別分組的長清單 | 多一次用戶互動 | 先選大類，再顯示相關選項 |
LINE 官方的 message types 概覽 把這些列為不同訊息類型。它們各有互動模型，不只是同一張卡片的放大版本。
即時選擇用 quick reply
LINE 允許一則訊息設定最多 13 個 quick reply 按鈕。它們出現在聊天室底部，適合語言、送貨時段、問題類型或分店地區等需要立即回答的問題。
不要把 quick reply 當作長期導覽。LINE 文件說明，聊天室出現新訊息等情況會令按鈕消失。如果用戶稍後仍需返回選單，應採用較持久的訊息版面，或在正確流程狀態重新傳送選項。
每個選項都是項目時用 carousel
若選項代表不同產品、分店或預約紀錄，carousel 通常比在一張卡片堆疊操作自然。例如每間分店都需要「路線」「營業時間」「聯絡分店」，就應把分店做成結構一致的 column，而不是讓 4 間分店佔滿所有 action。
各 column 應保持可比較，不要把產品、客服指令和無關活動混在同一個 carousel。
問題在資訊層級時用 Flex Message
當限制來自視覺層級，而不只是選項數量，可考慮 Flex Message。LINE 的 Flex Message elements 文件 提供帶 action 的 button component 和多種樣式。
Flex 不代表應把所有操作放進一個畫面。手機可讀性、標籤清晰度、無障礙和顯示差異仍然重要。上線前應使用 Flex Message Simulator，並驗證最終 message object。
選項反映業務邏輯時拆成兩步
不少情況下，最佳方案不是更大的卡片，而是先問一個上層問題：
- 「你需要哪一類協助？」——訂單、退貨、選購建議、帳戶。
- 只顯示該類別下的相關操作。
每一步更短，後端亦能取得明確的路由狀態。香港或跨境團隊也可先按市場、語言或業務線分流，再進入實際處理流程。
上線前檢查清單
- 按用戶意圖排序。 最常用且影響最大的操作應保持可見。
- 分開導覽與回答。 持久入口和當前問題的答案不應擠在同一選單。
- 為長清單分組。 可自然分類時，優先採兩段式對話。
- 使用清晰標籤。 同時出現「更多」「其他」「詳情」容易造成混淆。
- 為每個 action 建立後端狀態。 Postback 或 message action 必須對應有效流程。
- 在手機測試。 檢查文字截斷、圖片裁切、點擊範圍和返回路徑。
若你未決定要使用 MINI App service message，還是 Messaging API 的 reply/push message，先閱讀 LINE Service Message 與 Messaging API 比較。先選對訊息介面，再決定版面。
UnifyPort 適合與不適合的範圍
以上都是 LINE 官方 Messaging API 的顯示功能。UnifyPort 不會重現 buttons template、quick reply、carousel template 或 Flex Message。業務必須使用這些 LINE 原生 UI 時，應採官方 Messaging API。
UnifyPort 處理的是另一項工作：透過非官方介面接收 LINE 對話，將標準化入站事件送入現有後端。渠道訊息支援矩陣 列出 LINE 目前對應的標準發送類型；標準 webhook 事件文件 則定義跨支援平台一致的 message.received envelope。
架構邊界可以這樣劃分：
- LINE Official Account 流程需要原生互動卡片：使用 Messaging API，選擇正確的官方 message type。
- 一般 LINE 帳戶訊息需要進入現有客服隊列：評估 UnifyPort 的入站路徑。
- 兩者都需要：把它們視為不同身份、不同責任的訊息介面，不要假設單一版面能涵蓋全部。
更多入站方案與限制，可閱讀 不註冊 Official Account 接收 LINE 訊息。
限制與取捨
4 個操作足夠時，標準 buttons template 仍最簡單。Quick reply 選項較多但屬臨時控制項；carousel 適合瀏覽項目，但內容必須一致；Flex Message 增加版面控制，也增加測試成本；兩段式對話多一次互動，卻通常令決策更清晰。
官方客戶端行為和 object 驗證規則可能調整。若實作依賴精確上限或顯示方式，上線前應再次核對 LINE 最新文件。
常見問題
LINE Messaging API buttons template 最多有幾個 action？
actions 陣列最多 4 個 action 物件。圖片、標題或文字區域的可選 action 是另一個點擊區，不是額外可見按鈕。
可以用 quick reply 放超過 4 個 LINE 按鈕嗎？
可以。LINE 文件說明一則訊息最多支援 13 個 quick reply 按鈕。它適合即時回答，不適合需要長期保留的導覽。
更多操作應用 carousel 還是 Flex Message？
重複項目且結構一致時用 carousel；需要自訂視覺層級時用 Flex Message。若選項可分組，兩段式對話通常更清楚。
UnifyPort 能發送 LINE buttons template 嗎？
不能。UnifyPort 目前文件中的標準化 LINE 發送能力不包含官方 buttons template、carousel、quick reply 或 Flex Message；它主要適合透過標準 webhook 接收和路由 LINE 訊息。
下一步
先檢查 UnifyPort 渠道訊息支援矩陣，再選擇入站與出站架構。原生 buttons、quick reply、carousel 或 Flex 版面請按 LINE 官方 Messaging API 文件實作。
來源
官方一手來源，核對日期：2026 年 8 月 18 日。
令訊息接入變成一條穩定嘅產品管線。
先用統一嘅 API 跑通發送，再用標準事件將所有入站訊息接返去業務系統。