liff.requestFriendship()メソッドならLINE公式アカウントの友だち追加やブロック解除を自然に促すことができます

こんにちは！テクニカルライターの古木です。

LIFFアプリやLINEミニアプリに組み込まれるLIFF SDKには、さまざまなメソッドが継続して追加されています。今回は、2026年3月24日に追加されたliff.requestFriendship()メソッドを推しメソッドとして紹介します！

※ 「推し」という表現は、著者個人の感想を表したものです。

• liff.requestFriendship()メソッドとは
• 推しポイント
  • アプリの利用を中断しないシームレスなUX
  • profileスコープ不要で簡単に実行可能
  • ユースケースになじむデザイン
• おわりに

liff.requestFriendship()メソッドとは

liff.requestFriendship()メソッドは、チャネルにリンクされたLINE公式アカウントの友だち追加、またはブロック解除を促すサブウィンドウを表示するメソッドです。

• LINE公式アカウントと友だちになっていない場合は、友だち追加を促すサブウィンドウが表示されます。
• LINE公式アカウントをブロックしている場合は、ブロック解除を促すサブウィンドウが表示されます。
• LINE公式アカウントと既に友だちになっている場合は、サブウィンドウが表示された後、自動で閉じられます。

具体的な動作イメージは以下のとおりです。

友だち追加前	ブロック中	友だち追加済み

なお、liff.requestFriendship()メソッドはLIFFブラウザの画面サイズがFullの場合のみ利用できます。画面サイズについて詳しくは、『LIFFドキュメント』の「LIFFブラウザの画面サイズ」を参照してください。

推しポイント

• アプリの利用を中断しないシームレスなUX
• profileスコープ不要で簡単に実行可能
• ユースケースになじむデザイン

アプリの利用を中断しないシームレスなUX

推しポイントの1つ目は、利用中のLIFFアプリやLINEミニアプリの画面上でそのまま友だち追加やブロック解除を促せる点です。

外部ページやLINE公式アカウントのプロフィール画面に遷移させず、サブウィンドウ（モーダル）上で処理が完結するため、ユーザーは簡単に元の画面に戻ってくることができます。このため、フォーム入力などの操作中であっても、アプリを閉じることなく友だち追加を促せます。

profileスコープ不要で簡単に実行可能

次の推しポイントは、liff.requestFriendship()メソッドの実行にはprofileスコープを必要としない点です。

このため、友だち関係の取得は行わずに、まずは友だち追加だけを促したいケースで組み込みやすいのが利点です。

特にLINEミニアプリでは、チャネル同意の簡略化による認可フローでopenidスコープの権限を取得していればこのメソッドを実行できます。追加の権限要求を前提にしなくてよいため、実装や導線の設計をシンプルに保ちやすくなります。

const { friendFlag } = await liff.getFriendship();

// 友だち追加されているか
if (!friendFlag) {
  // 友だち追加されていない場合、友だち追加のリクエストを送る
  try {
    await liff.requestFriendship();
  } catch (error) {
    console.log(error);
  }
}

ユースケースになじむデザイン

3つ目の推しポイントは、友だち追加を促す場合のユースケースになじむデザインです。

友だち追加を起点としたクーポン配信やリマインド通知、会員向け情報の案内といったユースケースにおいて、自然になじむシンプルで直感的なデザインになっています。

「特典を受け取るためには、LINE公式アカウントを友だち追加してください。」といった案内の後にサブウィンドウを表示することで、必要なフローをユーザーに分かりやすく伝えることができます。

おわりに

今回は、推しメソッドとしてliff.requestFriendship()メソッドをご紹介しました。liff.requestFriendship()メソッドは、少ない実装でLINE公式アカウントへの導線をアプリ内に組み込める、実用的なメソッドです。ユーザー体験を大きく崩さずに友だち追加やブロック解除を促したい場合は、ぜひ活用を検討してみてください！

この記事の著者

ふるき（テクニカルライター）：LINE Developersサイトのドキュメントを担当。テクニカルライティングに関するコミュニティ「Technical Writing Meetup」を主催。