LINE URI action：10,000 字元上限與桌面版連結檢查
LINE Messaging API 的 URI action 現在允許 uri 和 altUri.desktop 各自最多 10,000 個字元。LINE 於 2026 年 10 月 27 日公布這項調整。應更新這兩個屬性的驗證規則，而不是放寬所有 URL 或文字欄位。Flex Message 設定桌面替代連結後，macOS 與 Windows 版 LINE 會使用它而非 uri；這並非所有訊息類型通用的桌面入口。
重點整理
- 新上限適用於 URI action 的目的地，不是按鈕數量或整則訊息長度。
- 應檢查完成參數組合與編碼後，實際送出的 URI 字串。
altUri.desktop適用於支援的 Flex Message URI action，不適用於快速回覆。- API 接受訊息、使用者開啟頁面、業務操作完成，必須分別驗證。
LINE 改了什麼，沒有改什麼
LINE 2026 年官方公告彙整記錄了 10 月 27 日的調整。目前的 URI action 參考文件列出兩個目的地屬性的 10,000 字元上限。
| 屬性 | 目前上限 | 意義 |
|---|---|---|
uri | 10,000 字元 | 執行動作時開啟的 URI |
altUri.desktop | 10,000 字元 | 在支援情境下，macOS、Windows 版 LINE 使用的替代 URI |
LINE 列出的 scheme 為 http、https、line 和 tel，並要求 URI 使用 UTF-8 百分比編碼。scheme 合法、長度符合限制，不代表頁面存在，也不代表使用者有權存取。
不要把應用程式的所有長度限制都改成 10,000。圖片 URL、標籤、訊息文字及訊息容器各有自己的規格。如果問題是選項太多，而非目的地太長，請參閱LINE 按鈕範本的替代方案。
先決定手機與桌面版各自開啟哪裡
LINE 文件說明：設定 altUri.desktop 後，macOS 與 Windows 版 LINE 會忽略 uri，改用桌面替代網址。此屬性支援 Flex Message 中的 URI action，但不適用於快速回覆。公告也將使用桌面屬性的情境列為 Flex Message，不應推廣到範本訊息或圖文選單。
以下是供 Flex Message 使用的示意 action 物件，不是完整發送請求：
{
"type": "uri",
"label": "查看詳情",
"uri": "https://example.com/mobile/orders/42",
"altUri": {
"desktop": "https://example.com/orders/42"
}
}這些是範例網址，不是可用的訂單頁面。應將物件放入相容的訊息元件，再依 LINE 文件驗證完整訊息。如果流程是分享 MINI App 頁面，請使用自訂動作按鈕與永久連結流程；長度上限提高，並不取代正確的 MINI App 連結組成方式。
檢查最終 URI，不只檢查輸入框
啟用較長目的地之前，建議依序檢查：
- 找出所有本機驗證限制。 檢查編輯器、後端驗證、訊息建構器及應用程式使用的 SDK 模型。只調整這兩個 URI action 屬性，並核對實際安裝的 SDK；不要假設所有版本都已接受新上限。
- 先組合，再量測。 組合目的地與查詢參數，正確套用 UTF-8 百分比編碼。檢查最終屬性值，而非未編碼文字或整份 JSON 的長度。不要將完整 URL 當成單一查詢值編碼，也不要重複編碼已編碼的值。
- 分別驗證兩個目的地。 手機網址有效，不代表桌面網址有效。桌面頁面應能在手機專用流程之外使用，並獨立處理登入與紀錄無法取得的情況。
- 在目的地執行授權檢查。 作為應用程式安全措施，不要把 API key、工作階段憑證或不必要的個人資訊放進連結。欄位變長不是將完整客戶紀錄放進查詢字串的理由；優先使用由伺服器驗證存取權的紀錄參照。
- 測試實際點選流程。 先確認完整訊息獲接受，再於預期的手機及桌面用戶端點選動作。檢查重新導向後的最終頁面，而非只看建構器產生的 URL。
回歸測試建議包含：剛好達到及超過上限的值、編碼後的非 ASCII 查詢值、獨立無效的桌面 URI，以及需要登入的目的地。這些是待執行的測試建議，不是已完成的測試結果。不能只憑發送回應判定整個流程成功。
與 UnifyPort 的契約保持分離
這項調整屬於官方 LINE Messaging API。UnifyPort 的標準化訊息支援矩陣未記載 LINE Flex Message URI action 或 altUri.desktop 發送欄位。不要將該欄位直接加進 UnifyPort 請求，便假設會呈現原生卡片。
需要原生互動卡片時，應使用官方 LINE 串接。UnifyPort 的非官方介面處理另一類需求：連接一般 LINE 帳號，透過標準化事件處理支援的對話。請閱讀LINE 授權指南確認帳號接入方式。URI 長度調整與共用事件結構，都不會改變所選整合的身分或能力範圍。
常見問題
LINE URI action 還是最多 1,000 字元嗎？
不是。2026 年 10 月 27 日公告已提高上限；目前文件對 uri、altUri.desktop 均規定最多 10,000 字元。若較長值仍被拒絕，請檢查應用程式內的驗證規則。
快速回覆可以使用 altUri.desktop 嗎？
不可以。LINE 明確說明此屬性不適用於快速回覆。請在文件支援的 Flex Message 情境使用，並測試對應桌面用戶端。
這會增加按鈕數量或 MINI App 分享權限嗎？
不會。變化僅涉及指定 URI action 屬性的長度。版面限制、分享流程、身分驗證與目的地存取權仍是分開的問題。
下一步與來源
先依LINE URI action 文件檢查訊息建構器。若仍在選擇原生卡片與標準化訊息接入，請先查閱UnifyPort 訊息支援矩陣，再實作發送流程。
官方來源核對日期：2026-11-07。
讓訊息接入變成一條穩定的產品管線。
先用統一 API 跑通傳送，再用標準事件把所有入站訊息接回業務系統。