LINE活用の基礎

LINEのアカウント連携イベントが届かないとき|期限切れ・failed・保存失敗の確認

制作:LIFE合同会社

AIを使用して制作・更新制作方法と確認範囲

#Messaging API#ID連携#Webhook#障害調査

この記事の結論

Messaging APIのアカウント連携で、イベント未着、failed、ok後の保存失敗を切り分けます。連携トークンの期限・一回性、失敗時に含まれない情報、安全な再試行と担当への確認メモを解説。

最終更新:2026年11月15日

Messaging APIのアカウント連携は、失敗すれば必ず failed の通知が届く仕組みではありません。連携トークンが期限切れ・使用済みの場合、Webhookイベントは送信されず、利用者にエラーが表示されます。 一方、LINE側で利用者の照合に失敗した場合は、accountLink の失敗イベントが送られます。

「会員情報が出ない」という結果だけでは、通知の生成・配送・受信・自社の保存のどこで止まったかは決まりません。まず連携を試した時刻と画面、受信記録をそろえます。この記事はMessaging APIの連携手順が対象です。LINEログインやLIFFを使う方式の選択は、ID連携の仕組みを確認してください。

イベント未着とfailedを分ける

公式のアカウント連携ガイドでは、連携トークンは発行から10分間、1回だけ使用できます。これはLINEログインの認可コードや、メッセージへの返信トークンとは別のものです。

連携先のエンドポイントへ利用者がアクセスしたとき、LINEはトークンの発行対象と利用者を照合します。次の区別で確認してください。

  • 期限切れ・使用済みの連携トークン:イベントが送信されないため、Webhookの再送を待つだけでは解決しません。発行時刻、同じリンクを既に使っていないか、利用者に出たエラーを確認します。
  • 利用者の照合失敗:link.result が failed のイベントです。期限切れと同じ扱いにせず、連携を開始したLINEアカウントと操作した人を確認します。
  • 照合成功:link.result は ok です。その後、自社側で link.nonce に対応する会員を取得し、LINEユーザーIDとの対応を保存する処理が必要です。

受信記録がないだけで「期限切れだった」とは断定できません。利用者が途中で操作をやめた可能性や、通知の配送・受信側の問題も残ります。

Messaging APIの連携調査の早見表。イベントがない場合は期限切れ・使用済み・途中終了と配送受信を確認し、未着だけで原因を決めない。failedは本人照合失敗で、sourceとreplyTokenは含まれず、推定したIDへ紐付けない。okはnonceに対応する会員の取得と保存結果を確認する。再試行は確認済みの入口から新しく開始し、担当と回答予定を残す。

図解画像を開く(保存用)

failedには送信者情報と返信トークンがない

アカウント連携イベントのAPI仕様では、失敗時には source と replyToken が含まれません。どのイベントにもこの二つがある前提で処理すると、失敗の記録を残す前に自社側の処理が止まるおそれがあります。

開発担当は、type と link.result を確認し、成功・失敗で必要な情報を分けて扱います。失敗イベントから取り出せないユーザーIDを、直前の別ユーザーや似た表示名で補ってはいけません。返信トークンがない以上、そのイベントへの返信を前提に案内を設計しないでください。

利用者には連携を開始した画面から戻れる入口と、困ったときの確認先を用意します。スタッフが別の経路で案内する場合も、相手を確認できる既存の連絡手段を使う設計にします。

受信できた後は、署名と保存を確認する

受信した内容は、公式の署名検証手順に沿って、本文を加工する前に検証します。署名が一致しない通知を処理したり、原因調査のために検証を外したりしないでください。

署名確認後の ok イベントでも、自社会員の取得や保存の完了は別に確かめます。確認順は、nonceに対応する開始記録があるか、意図した会員を取得できたか、対応関係を保存できたか、利用者向け画面へ反映できたか、です。確認できない段階があれば未完了として残します。

HTTPで成功を返したことだけを連携完了と扱わない点は、Webhook障害の切り分けと共通です。イベントの配送・受信を調べるときは、対象チャネル・時刻・受信先をそろえて確認します。

古いリンクを配り直す前に、現在の状態を見る

以下は運用設計の提案です。先に自社側の連携状態を確認し、既に正しい組み合わせで保存されていれば、表示や案内の問題を調べます。状態が不明なまま別の会員へ上書きしません。

未完了で再試行が必要なら、本人が確認済みの入口から連携を新しく開始できるようにします。期限切れのURLをそのまま再送する運用は避け、公式手順に沿った新しいトークンとnonceを使います。自社サービスのログインと、意図した会員への紐付け確認は省略しません。利用者は公式アカウントの友だちである必要もあります。

架空の会員サイトの例では、スタッフが「もう一度リンクを押してください」とだけ返すと、使用済みリンクを繰り返し開く可能性があります。担当者が保存結果を確認し、必要な場合に新しい開始画面を案内する、という分担を決めておきます。実際の導入実績や実機試験の結果ではありません。

担当者へ渡す確認メモ

連携の問い合わせを受けたら、次の情報を一つのメモにまとめます。

  • 対象の公式アカウント・チャネルと、発行・操作・受信の時刻
  • 利用者に出た画面の内容。同じリンクを開き直したか
  • accountLink の受信有無と link.result。確認できなければ未確認
  • 署名確認、会員取得、保存、画面反映のうち確認できた段階
  • 次に確認する担当者、利用者へ返す担当者と回答予定

共有メモにはトークン、nonce、Cookie、パスワードや会員情報の実値を貼りません。必要な内部記録は閲覧権限のある場所で照合します。名前の一致を本人確認の代わりにしないことと、技術調査中にも誰が返答するかを残すことが、誤連携と回答漏れを避けるための設計です。

連携をやり直す話と、本人が連携を解除する話は分けてください。解除・ブロック・退会の違いはアカウント連携の解除で整理しています。

この記事に関連するサービス