LINE Webhook が応答しない

sanitized snapshot

Last synced: 2026-02-14

要約

受信不可の症状に対して、原因切り分けと復旧手順を整理した。
現象から対処までの流れを短く辿れるように構成している。
外部共有可能な情報のみで、即時連携に使える。

決定事項

症状を起点に確認順を固定する
原因候補は設定不備と接続不備を優先確認する
復旧後は再発防止メモを必ず残す

未決

監視通知の初動担当をどの体制で回すか
再発防止レビューの周期をどう設計するか
障害メモの保管ルールをどこに統一するか

次アクション

実装担当: 症状別チェックリストを整理する
運用担当: 復旧確認の記録テンプレートを作る
監督担当: 再発防止のレビュー観点を整備する

リスク

切り分け順が曖昧だと復旧が遅延する
復旧後確認が不足すると再発しやすい
記録不足で改善学習が蓄積しない

参照ID

TS-LINE-001
TMPL-LINE-001

概要

LINEにメッセージを送ってもWebhookが反応しない症状を、原因別に切り分けて対処する。

対象ユーザー

LINE自動応答を構築したが動作しないユーザー
TMPL-LINE-001のセットアップ後に不具合が発生した場合

前提条件

LINE公式アカウントのMessaging APIが有効であること
自動化ツールのWebhookエンドポイントが設定済みであること

構成（ノード/データフロー）

メッセージ送信 → LINE Platform → Webhook URL → 自動化ツール → 応答処理
         ↑ここのどこで止まっているかを特定する

セットアップ（診断手順）

Step 1: LINE側の疎通テスト

LINE Developersコンソール → 対象チャネル → Messaging API設定
「Webhook URL」欄に正しいURLが入力されていることを確認
「検証」ボタンをクリックし、成功/失敗を確認
失敗の場合 → Step 2 へ

Step 2: Webhook URL到達性の確認

自動化ツールのWebhookノードがアクティブ（実行中）であることを確認
URLの末尾スラッシュ有無を確認（一致させる）
HTTPS必須：HTTPのみのURLは不可
ファイアウォール/IP制限がある場合、LINE Platformの送信元IPを許可リストに追加

Step 3: 自動化ツールのログ確認

自動化ツールの実行ログを開く
Webhookトリガーの受信ログがあるか確認
ある場合 → 後続ノードでエラーが発生していないか確認
ない場合 → Step 2の接続性に問題あり

Step 4: 応答メッセージ設定の確認

LINE公式アカウント管理画面 → 応答設定
「応答メッセージ」がオフであること
「Webhook」がオンであること

Step 5: トークン有効性の確認

チャネルアクセストークンの発行日を確認
必要に応じて再発行し、自動化ツール側を更新

運用（監視・例外・復旧）

監視: Webhook受信ログの件数を日次確認。急減した場合は疎通障害の疑い
例外: LINE Platform側の障害はLINE Status Pageで確認
復旧: 本記事のStep 1-5を順に再実行

詰まりTOP5

「検証」ボタンで成功するのに実メッセージで動かない → 応答メッセージ設定の競合
HTTPSの証明書エラー → 自動化ツールの証明書が有効か確認
自動化ツールを再起動したらWebhook URLが変わった → 固定URL設定を確認
テスト時は動くが本番で動かない → 環境変数の設定漏れ（本番環境）
突然止まった → トークン有効期限切れ or 自動化ツールのプラン制限

反証3（失敗条件）

LINE Platform障害: 自分側に問題がなくてもLINE側の障害で止まる。ステータスページを先に確認
URLが正しいのに到達しない: DNS伝播の遅延やCDN設定の問題。nslookup/tracerouteで確認
一部メッセージだけ届かない: メッセージタイプ（画像/スタンプ等）にWebhookフィルタがかかっている

トラブルシュート

症状	原因	対処
検証ボタンで「失敗」	URL誤り/サーバー停止	URL再確認＋サーバーステータス確認
検証OK、実メッセージNG	応答設定の競合	応答メッセージOFF、WebhookON
ログに受信あり、返信なし	後続ノードエラー	自動化ツールのエラーログ確認
間欠的に失敗	タイムアウト/負荷	タイムアウト延長/リソース増強
突然全く動かなくなった	トークン失効/プラン制限	トークン再発行/プラン確認

Secrets注意

Webhook URL、チャネルアクセストークン、ユーザーIDは記載禁止
ログのスクリーンショットには個人情報・トークンをマスク
診断結果を共有する場合は sanitized 版で

ロールバック（停止/戻し）

診断中の一時措置: LINE側の応答メッセージをオンに戻し、手動対応に切り替え
自動化ツール停止時: ワークフローを無効化し、LINE側の設定も戻す
原因特定後: 修正適用 → テスト → 本稼働の順で復旧

FAQ10

Q: 検証ボタンはどこにある? A: LINE Developers → チャネル → Messaging API設定 → Webhook URL横
Q: Webhook URLが変わってしまった場合は? A: 自動化ツールで固定URL（カスタムドメイン等）を設定
Q: LINE側の障害情報はどこで確認? A: LINE公式のステータスページ
Q: 複数のWebhook URLを設定できるか? A: 1チャネルにつき1 URL。分岐は自動化ツール側で実装
Q: テストメッセージを自動で送れるか? A: Push APIで自分宛に送信可能（要ユーザーID）
Q: エラー通知を受け取りたい A: 自動化ツールのエラーハンドリングで通知先を設定
Q: Webhook受信の遅延はどこで計測? A: 自動化ツールの実行ログのタイムスタンプで確認
Q: IP制限がかかっている場合は? A: LINEの送信元IPレンジを許可リストに追加
Q: 他の記事への導線は? A: TMPL-LINE-001（セットアップガイド）を参照
Q: それでも解決しない場合は? A: ログのsanitized版を用意し、サポートに問い合わせ

変更履歴

日付	変更内容	関連ID
2026-02	初版作成（TMPL-LINE-001からの導線記事）	TS-LINE-001

last_verified

2026-02