LINE URIアクション：10,000文字の上限とPC用リンクの確認
LINE Messaging APIのURIアクションでは、uriとaltUri.desktopにそれぞれ最大10,000文字を指定できます。LINEは2026年10月27日にこの変更を発表しました。更新対象はこの2つのプロパティの検証処理であり、すべてのURLやテキスト項目ではありません。Flex MessageにPC用の代替URIを指定すると、macOS版とWindows版LINEではuriよりもそちらが優先されます。ただし、あらゆるメッセージ形式で使える設定ではありません。
要点
- 新しい上限はURIアクションの遷移先に適用されます。ボタン数やメッセージ全体の上限ではありません。
- パラメータの組み立てとエンコードを終えた、実際に送信するURIを検証します。
altUri.desktopは対応するFlex MessageのURIアクションで使用します。クイックリプライでは使えません。- APIによる受付、リンク先の表示、業務操作の完了は別々に確認します。
変更された範囲を限定する
LINEの2026年公式ニュースに10月27日の変更が掲載されています。現在のURIアクションのリファレンスでは、両プロパティの最大文字数を10,000としています。
| プロパティ | 現在の上限 | 用途 |
|---|---|---|
uri | 10,000文字 | アクション実行時に開くURI |
altUri.desktop | 10,000文字 | 対応する場面でmacOS版・Windows版LINEが開く代替URI |
LINEが認めているスキームはhttp、https、line、telです。URIにはUTF-8によるパーセントエンコーディングが必要です。スキームと文字数が正しくても、ページの存在やユーザーのアクセス権まで確認できるわけではありません。
アプリ内の上限を一律に10,000へ変更しないでください。画像URL、ラベル、メッセージ本文、コンテナ構造にはそれぞれ別の仕様があります。困っているのが長いURLではなく選択肢の数なら、LINEボタンテンプレートの代替案を参照してください。
スマートフォンとPCの遷移先を決める
LINEのリファレンスによると、altUri.desktopを設定した場合、macOS版とWindows版LINEではuriを無視して代替URIを開きます。このプロパティはFlex MessageのURIアクションに対応し、クイックリプライでは動作しません。公式発表もPC用プロパティを使用する形式をFlex Messageとしているため、テンプレートメッセージやリッチメニューにまで一般化しないでください。
以下はFlex Messageに組み込むためのアクションオブジェクトの例です。完全な送信リクエストではありません。
{
"type": "uri",
"label": "詳細を見る",
"uri": "https://example.com/mobile/orders/42",
"altUri": {
"desktop": "https://example.com/orders/42"
}
}URLは例示用で、実際の注文ページではありません。対応するメッセージコンポーネントへ組み込み、メッセージ全体をLINEの仕様に照らして検証してください。LINEミニアプリのページ共有が目的なら、カスタムアクションボタンとパーマネントリンクの実装ガイドを使います。文字数上限の拡大は、正しいミニアプリ用リンクの生成方法を置き換えません。
入力欄ではなく最終的なURIを確認する
長い遷移先を有効にする前に、次の点を確認します。
- ローカルの制限を洗い出す。 エディター、バックエンドの検証、メッセージビルダー、利用中のSDKモデルを確認します。変更するのは対象の2プロパティだけです。すべてのSDKバージョンが新しい上限に対応済みとは考えず、実際の導入版を確認してください。
- 組み立ててから測る。 遷移先とクエリパラメータを生成し、UTF-8のパーセントエンコーディングを適切に適用します。未エンコードの文字列やJSON全体ではなく、最終的なプロパティ値を検証します。URL全体を1つのクエリ値としてエンコードしたり、二重にエンコードしたりしないようにします。
- 両方の遷移先を個別に検証する。 スマートフォン用URIが正しくてもPC用URIの保証にはなりません。PC側はモバイル専用フローの外でも使えるようにし、ログインや対象データが利用できない場合を処理します。
- アクセス権は遷移先で確認する。 アプリの安全設計として、APIキー、セッション認証情報、不要な個人情報をリンクに入れないでください。文字数が増えても、顧客データ全体をクエリに詰め込む必要はありません。サーバー側でアクセス権を確認できるレコードへの参照を優先します。
- 表示されたアクションを操作する。 完全なメッセージが受け付けられることを確認した後、対象のスマートフォン版とPC版で実際にタップ・クリックします。生成したURLだけでなく、リダイレクト後の最終ページまで確認します。
回帰テストには、上限ちょうどの値と上限超過、非ASCIIのクエリ値をエンコードしたもの、PC用URIだけが不正な場合、ログインが必要な遷移先を含めてください。これは実施を提案するテストであり、実行済みの結果ではありません。送信レスポンスだけで一連の操作を成功と判断しないでください。
UnifyPortの送信仕様とは分ける
今回の変更は公式LINE Messaging APIのものです。UnifyPortの標準化メッセージ対応表には、LINEのFlex Message URIアクションや送信用altUri.desktopフィールドは記載されていません。UnifyPortのリクエストへそのフィールドを追加すればネイティブカードが表示される、と考えないでください。
LINE固有のインタラクティブなカードが必要なら、公式LINE連携を使用します。UnifyPortの非公式インターフェースは別の用途を対象にしています。一般のLINEアカウントを接続し、対応する会話を標準化イベントで処理するためのものです。その接続方式はLINE認証ガイドで確認できます。URIの上限変更や共通イベント形式は、選択した連携のアカウント種別や対応機能を変更しません。
よくある質問
LINE URIアクションは今も1,000文字までですか？
いいえ。2026年10月27日の発表で上限が引き上げられ、現在はuriとaltUri.desktopのどちらも最大10,000文字です。長い値が拒否される場合は、アプリ内の検証処理を確認してください。
クイックリプライでaltUri.desktopは使えますか？
使えません。LINEが明確に非対応としています。仕様で対応するFlex Messageの場面で使用し、対象のPCクライアントでテストしてください。
ボタン数やミニアプリの共有権限も増えますか？
いいえ。変わるのは指定されたURIアクションのプロパティの長さです。レイアウト、共有フロー、認証、遷移先のアクセス権は別の要件です。
次のステップと出典
まずLINE URIアクションのリファレンスに沿ってメッセージビルダーを点検してください。ネイティブカードと標準化メッセージのどちらを使うか検討中なら、送信処理の実装前にUnifyPortの対応表を確認します。
公式情報の確認日：2026-11-07。
メッセージ連携を安定したプロダクトパイプラインへ。
まずは 1 つの API で送信を始め、標準イベントですべての inbound メッセージを業務システムへ戻しましょう。