LINE活用の基礎

LINE WebhookにreplyTokenがないとき|standbyと返信担当を確認

制作:LIFE合同会社

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

#Messaging API#Webhook#モジュール#返信

この記事の結論

Messaging APIで受信できても返信トークンがない場合、イベントの種類とmodeを確認。モジュール連携時のstandby、期限切れとの違い、Pushへ切り替える前の返信担当の照合を説明します。

最終更新:2026年11月17日

Webhookが届いたのに replyToken がない場合は、期限切れを調べる前に、イベントの種類と mode を確認します。 モジュール連携で standby になっているイベントには、返信トークンが含まれません。その場合、受信できたという理由だけで自分のシステムから返信を進めないようにします。

この記事は、LINEのモジュールを使う拡張機能との連携がある環境で、返信を担当するシステムを切り分けるためのものです。一般的な外部CRMとの接続が、すべてモジュール方式であるとは限りません。特定の製品がこの方式を使っていると推定する記事でもありません。

モジュールのstandbyは、有人チャットの設定名ではない

モジュールの公式説明では、LINE公式アカウントへ拡張機能のモジュールチャネルを連携する仕組みが説明されています。利用には所定の手続き・条件があり、現行資料ではLINEマーケットプレイスへ有償の拡張機能として公開する場合に限ると案内されています。

この仕組みにおけるチャットの主導権と、LINE Official Account Managerのチャット・応答時間・手動対応の設定は分けて考えます。「スタッフが画面を開いたから必ず standby になった」とは判断できません。

管理画面と外部ボットから同じ返信が重なる問題は、チャット・応答設定・Webhookの確認順で、返信元を先に整理してください。

modeが示す返信の扱いを読む

モジュールからMessaging APIを利用する公式資料では、次の違いがあります。

mode受信後に確認すること
active主導権を持つ側。イベントとAPIの条件に沿って返信を扱う
standby主導権を持たない側。返信トークンは含まれず、メッセージ送信を控える

モジュールが返信している可能性があるため、standby で replyToken がないときに、すぐPushへ置き換えると、別のシステムの返答と重なるおそれがあります。送信手段を変える前に、どこが返答する担当なのかを調べます。

active でも、どんなイベントにも返信トークンが付くとは限りません。また、受信したイベントの mode だけで、その後もずっと同じ主導権が続くと決めつけず、調査時点の連携状態も照合します。

Webhookを受信したことと、このシステムが返信することを分ける確認図。まずイベントの種類を確認する。modeがstandbyなら返信トークンは含まれず、Pushへの置き換えを急がず、主導権を持つ連携先と返信担当を確認する。activeならイベントに返信トークンが付く条件を確認し、存在するトークンの期限や使用状況を別に調べる。顧客への返信が終わったかは、受信結果だけで判断しない。

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

「ない」と「あるが使えない」を同じエラーにしない

まず署名を検証した元の受信内容で、type、mode、replyToken の有無を確認します。保存や変換の途中で項目を落としていないかも、権限のある環境で照合します。返信トークンそのものを一般の調査ログへ書き出す必要はありません。

  • イベントがstandbyで、トークンがない:その仕様に沿った状態です。連携先と主導権、実際の返信を確認します。
  • イベントがactiveで、トークンがない:そのイベントに返信トークンが含まれる仕様かをWebhookイベントの公式定義で確認します。
  • トークンはあるがReply APIが失敗する:受信からの経過、使用済みか、実際のエラーを調べます。返信トークンの期限と再利用の切り分けです。

アカウント連携の失敗通知など、別の理由で返信トークンが含まれない場合もあります。replyToken がないという一項目だけでモジュール連携が原因だと断定せず、アカウント連携イベントの確認も必要に応じて参照します。

受信先のアカウントと、お客様を取り違えない

Webhookの destination は、受信先のLINE公式アカウントのボットのユーザーIDです。メッセージを送ったお客様のIDではありません。送信者やトークの情報は source と照合します。

複数アカウントを扱う連携先へ問い合わせる場合は、「どの公式アカウントの、どのチャネルで、何のイベントを受けたか」が分かるようにします。表示名だけで顧客を特定したり、別アカウントで確認したIDを無条件につないだりしません。

架空の予約相談で、外部ボットがstandbyのイベントを受けたものの、拡張機能側が既に案内を返していたとします。受信担当が独自に別の案内をPushする前に、その返信内容と予約受付の状態を、必要な権限のある担当者同士で確認します。返信が一通あったことも、予約確定を意味するとは限りません。

変更前に、連携担当へ渡す確認事項

次のメモをそろえると、トークンの再発行や設定の一括停止を先に試さずに調べられます。

  1. 対象公式アカウントと、受信したチャネル・連携方式。
  2. イベントの種類、発生時刻、mode、トークンの有無。
  3. 連携先で返信を送ったかと、その確認結果。
  4. お客様への返答を引き取る人と、未確認の作業。

モジュールの解除や主導権の変更は、返信経路へ影響します。原因が分からない段階で連携を外すのではなく、管理者と連携先が担当範囲を確認してから変更します。Webhookの受信は確認できても顧客への返事が確認できない相談は、対応済みにせず担当へ残してください。

仕様確認:2026年11月15日。公式仕様に基づく切り分けと架空例です。モジュールの導入、主導権変更、実際のメッセージ送信を行った記録ではありません。

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