LINEの友だち数と取得したユーザーID数が違う理由｜顧客連携前の確認順

LINE公式アカウントの管理画面の友だち数と、Messaging APIで取得したユーザーIDの件数は、一致しない場合があります。件数差だけで取り込みの失敗や顧客データの消失と判断せず、取得処理が最後まで終わったかと、一覧に含まれる対象を分けて確認してください。

この記事は、既存の公式アカウントの友だちを顧客管理へつなぐ際に、一覧の取得結果を点検する担当者向けです。友だちの人数を伸ばす方法や、LINEログインのIDがプロバイダー間で異なる問題とは分けて扱います。後者はLINEログインとMessaging APIのIDの関係を参照してください。

まず、一覧取得を利用できるアカウントか確認する

公式のユーザーID取得ガイドによると、友だち全員のユーザーIDを取得する機能は、認証済アカウントまたはプレミアムアカウントで利用できます。配信の有料プランを契約していることとは別の条件です。

使うエンドポイントはGET /v2/bot/followers/idsです。APIリファレンスの現行条件と、対象のアカウント種別を確認してから処理を進めます。利用できない場合に、表示名をかき集めてユーザーIDの代わりにしたり、別の公式アカウントで取得した一覧を混ぜたりしないでください。

これからWebhookで取得するIDと、過去からの友だちの一覧は、記録の入口が異なります。Webhookを有効にしただけで、その前からいる全員のIDが自動で届く前提にもできません。今回の一覧取得は、どこまで確認済みの顧客情報があるかを点検するために使います。

一覧の応答にnextが含まれるときは、続きがあります。その値を次のリクエストのstartへ渡し、nextが含まれなくなるまで取得します。1回の取得上限を大きくすることと、全ページを取得したことは同じではありません。

結果が少ない場合の確認順は次のとおりです。

取得する間にもユーザーは操作するため、別の時点の値を一つの固定された名簿のように比較しないようにします。調査記録には件数・対象・時刻・処理の完了状態を残し、全員のIDやプロフィールをそのまま広い共有範囲のログへ出す必要はありません。

友だちIDの件数差を調べる確認図。利用できるアカウント種別を確かめ、nextがなくなるまでページを取得したかを確認。その後、一覧の対象外になる削除・ブロック・プロフィール取得未同意を区別する。管理画面の人数と一致させるために別人のIDを補わず、顧客との連携は別に確認する。

図：取り込みの点検に使う順番です。一覧取得の完了と、顧客の本人確認を同じ完了にしないでください。

公式リファレンスは、LINEアカウントを削除したユーザー、対象の公式アカウントをブロックしたユーザー、プロフィール取得に同意していないユーザーのIDが一覧に含まれないと説明しています。そのため、取得処理が正常に終わっても、管理画面などの友だち数と一致しない場合があります。

プロフィール取得の同意については、公式の同意に関する説明も参照してください。一覧にない人を、すべて「退会した顧客」や「反応しない人」として分類するのは不適切です。取得できない理由と、サービス側の会員状態・取引の状態を混同しないようにします。

件数を合わせる目的で、別の会員情報から推測したIDを補うことも避けます。名簿の数字が揃っても、相手を取り違えて連絡すれば、お客様に不安を与えます。分からない対応づけは未確認として残す方が、確認した一人への返答を正しく続けられます。

ユーザーIDを取得したことは、その人とサービスの会員が正しく結び付いた証拠ではありません。本人がログインした会員と確認したLINEの情報など、連携の正しい経路を用意します。名前が同じ、登録日が近いといった情報だけでの自動連携は行わないでください。

また、IDの取得後にブロックやLINEアカウントの削除が行われることもあります。一覧に入っているだけで、いま送信したメッセージが相手へ届いたと判断できません。送信結果の見方はプッシュ送信の200と到達の違いで確認できます。

最初は、取得対象、完了ページ、重複を除いた件数、確認した会員連携の件数を別々に記録してください。「取り込み済み」だけを成果にせず、その情報が同じお客様への正しい対応につながるかを確かめてから広げます。

※仕様の確認日：2026年10月9日。今回、実顧客のID一覧の取得・保存・連携・送信は行っていません。