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，不適用於 quick reply。- 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，但不適用於 quick reply。公告亦將使用桌面屬性的情境列為 Flex Message，不應延伸至範本訊息或 rich menu。
以下是供 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 字元。若較長值仍被拒絕，請檢查應用程式內的驗證規則。
quick reply 可以使用 altUri.desktop 嗎？
不可以。LINE 明確指出此屬性不適用於 quick reply。請在文件支援的 Flex Message 情境使用，並測試相應桌面客戶端。
這會增加按鈕數量或 MINI App 分享權限嗎？
不會。變化只涉及指定 URI action 屬性的長度。版面限制、分享流程、身分驗證及目標存取權仍需分開處理。
下一步與來源
先按LINE URI action 文件檢查訊息建構器。若仍在選擇原生卡片與標準化訊息接入，請先查閱UnifyPort 訊息支援矩陣，再實作發送流程。
官方來源核對日期：2026-11-07。
令訊息接入變成一條穩定嘅產品管線。
先用統一嘅 API 跑通發送，再用標準事件將所有入站訊息接返去業務系統。