LINE push が200なのに届かない?送信先の条件を確認
LINE Messaging APIのプッシュリクエストは、HTTP 200でもユーザーに届かない場合があります。LINEは、アカウントを削除したユーザー、送信元の公式アカウントをブロックしたユーザー、例外条件に当てはまらない友だち未追加ユーザーを挙げています。再送する前に、実際の送信チャネル、宛先ID、公式アカウントとの関係を確認してください。HTTPの成功は配信の証明でも、ブロックされた証明でもありません。
要点
- Webhook受信サーバーの200ではなく、実際のプッシュ送信リクエストを調べます。
- 友だち未追加でも、その公式アカウントに1対1のトークでメッセージを送ったユーザーには、7日以内であればプッシュ送信できます。
- この例外は、サイト訪問者、グループ参加者、ログイン済みユーザー全員に適用されるものではありません。
- 成功が確認できた送信を自動再送せず、送信先の条件と未確認の配信状態を分けて扱います。
LINE push が成功しても届かない理由
LINE Messaging APIリファレンスは、次のプッシュ送信条件を記載しています。
| 送信先 | 公式に記載された条件 |
|---|---|
| 個人ユーザー | 送信元のLINE公式アカウントを友だち追加している |
| グループトーク・複数人トーク | 公式アカウントが参加している |
| 友だち未追加の個人 | 過去7日以内に、その公式アカウントへ1対1のトークでメッセージを送っている |
同じリファレンスには、アカウントを削除した、公式アカウントをブロックした、または友だち未追加で例外にも当てはまらないユーザーへの送信は、200を返しても届かないとあります。
これは考えられる原因の一覧であり、成功レスポンスに含まれる診断結果ではありません。「届いていない」という申告だけでCRMに「ブロック済み」と表示しないでください。グループでのやり取りも、条件を満たす1対1のメッセージの証拠にはなりません。
処理に時間がかかるサポート業務では、該当する受信メッセージの時刻、ジョブ作成時刻、実際の送信時刻を別々に記録する設計を推奨します。友だち未追加の条件は送信直前にも確認します。AI処理を7日以内に開始しても、将来の送信条件が確保されるわけではありません。
1件の送信を、チャネルから宛先まで追う
以下は推奨するアプリケーション側の調査記録であり、LINE APIの追加フィールドではありません。
1. 調べるべきレスポンスを特定する
200が出ているのは、外向きのプッシュリクエストでしょうか。自分のWebhookが返した成功は、受信処理の確認にすぎません。独自キューAPIの成功も、ジョブを保存したことだけを示している可能性があります。
メソッド、エンドポイント、時刻、HTTPステータス、x-line-request-idを保存します。LINEの開発ガイドラインも、こうしたリクエスト情報の記録を推奨しています。アクセストークンや顧客のメッセージ本文を通常のログへ出力しないでください。
2. 送信元と宛先を組み合わせて確認する
稼働中のワーカーがどのチャネルアクセストークンを選び、そのチャネルがどの公式アカウントに対応し、宛先IDをどこから取得したかを確認します。テスト用と本番用は似た名前の場合があります。設定画面のスクリーンショットだけでは、実際に使用した設定は証明できません。
LINEのユーザーIDガイドは、APIのユーザーIDを表示名や友だち検索用のLINE IDと区別し、プロバイダーごとに発行されることを説明しています。LINE Loginや別の連携から得た宛先なら、プロバイダー不一致の確認手順で対応関係を確認してください。サイトへのログインだけでは、送信元アカウントとの友だち関係は成立しません。
3. この公式アカウントとの関係を確認する
個人への送信では、友だち関係の根拠、またはこの公式アカウントに対する最近の1対1のメッセージを確認します。古いCRM活動、ページ閲覧、別アカウントへのメッセージは同じ根拠ではありません。
根拠が不十分なら不明のままにします。ブロックの有無を推測するために繰り返し送信しないでください。LINEの開発ガイドラインは同一ユーザーへの大量送信を禁止しています。調査を不要な連絡に変えないことが大切です。
4. 受付済み、拒否、不明を分ける
| 観測した内容 | 次の判断 |
|---|---|
pushは200、ユーザーは未受信と申告 | IDと条件を確認し、自動再送しない |
| APIが成功以外のレスポンスを返した | そのレスポンスを調査し、200のケースと混同しない |
| タイムアウトでレスポンスがない | 受付結果を不明として、別の再試行手順へ進む |
Webhookだけが200を返した | 外向きリクエストが実行されたか確認する |
タイムアウトにはLINEのリトライキー解説を参照してください。再試行の保護は受付結果の不確実性に対処するもので、送信先の条件を変えたり、届かない成功リクエストを配信可能にしたりはしません。
再送ループではなく、合意のあるテストを行う
同意したテストユーザーと、LINEアプリ上で正しい公式アカウントと友だち関係を確認し、同じ稼働中チャネルから識別しやすいテストメッセージを1件送ります。HTTP記録と、通知バナーだけでなくトーク内に実際に表示された内容を照合します。
成功しても、そのユーザーのその時点の経路を確認できただけです。別の顧客の関係や過去の未配信原因は証明できず、古いジョブを再送する根拠にもなりません。
遅延ジョブの判定はローカルでテストできます。送信直前に非友だちの7日条件を外れるケース、別連携の宛先を保存したケース、受付済み操作を再試行ワーカーが処理するケースを用意します。期待結果は、それぞれ保留、IDの再確認、重複送信なしです。これは推奨テストであり、実施済みの本番結果ではありません。
UnifyPortの証拠は別に扱う
UnifyPortの非公式インターフェースは、独立したメッセージングアカウントの接続経路です。テキスト送信仕様はaccount_id、to、messageを使い、成功例にstatus: acceptedを返します。これは配信確認ではなく、以前の公式アカウントのpushを復旧するものでもありません。
プロバイダー別イベント一覧にはLINEの配信・既読イベントのマッピングがありますが、すべてのアカウントや環境で必ず発生する保証ではありません。受信した確認イベントは、そのイベントが示すメッセージだけに適用します。確認がないことは失敗やブロックの証拠ではありません。表示名が一致するだけで、別アカウントの確認イベントを公式pushに結び付けないでください。
送信元をLINE公式アカウントにする必要があるなら、公式Messaging APIを使用します。送信者の変更は自動復旧操作ではなく、受信者の選択も変えません。
FAQ
HTTP 200なら、相手がブロックしたと判断できますか?
できません。配信も未配信の理由も証明しません。公式資料には複数の条件が記載されています。
友だち追加していない人にもpushできますか?
その公式アカウントへ過去7日以内に1対1でメッセージを送ったユーザーには例外があります。サイト訪問やグループでのやり取りには一般化できません。
届いていないなら再送すべきですか?
受付成功が分かっている場合、自動再送しないでください。送信元、宛先、条件、証拠を先に確認します。タイムアウトと観測済みの200は別のケースです。
次の作業と出典
問題のpushを1件選び、公式の送信条件と照合してください。既存のUnifyPort連携では、配信ラベルを付ける前に独立した送信仕様を確認します。
公式情報の確認日:2026-11-18。
メッセージ連携を安定したプロダクトパイプラインへ。
まずは 1 つの API で送信を始め、標準イベントですべての inbound メッセージを業務システムへ戻しましょう。