EC-CUBE 4.2 / 4.3 対応プラグイン

定期購入 LINE次回お届け通知&1-Clickスキップ・変更プラグインマニュアル

🌟 プラグインの概要・目的
定期購入をご契約中のお客様へ、次回お届け予定日の直前（標準5〜7日前）にLINE公式アカウントからリマインド通知を自動配信します。
お客様はLINE通知内のボタンから、ログイン不要・1-Clickで「次回スキップ」や「お届け日変更」を行うことができます。
定期継続率の向上、突然の解約防止、およびショップ側のお問い合わせ対応負担の大幅削減に貢献します。

1. 主な機能フロー

機能フロー	詳細内容
① マイページでのLINE連携	マイページの専用メニューから、公式LINEを友だち追加します。 3つの方法に対応: ・📱 スマホの方: 「公式LINEを友だち追加」ボタンタップで直接LINE起動・💻 PCの方: 画面のQRコードをスマホカメラで読み取り追加・🔍 ID検索: LINE ID（@xxxx）をワンクリックコピーして検索友だち追加後、画面に表示される32桁の連携コードをトークルームに送信するだけで、自動でアカウント連携が完了します。
② お届け前自動通知	次回お届け日の設定日数前（例: 5日前）に、契約内容（商品名・数量・金額・お届け予定日）をカード型レイアウトで自動配信します。
③ 1-Click スキップ	LINE通知内の「次回をスキップ」ボタンをタップすると、ログイン不要で次回のお届け分が即座に1回スキップされます。 ※ 処理完了と同時に、LINEトークルームへ次回日程の確認メッセージが自動送信されます。
④ 1-Click お届け日変更	LINE通知内の「お届け日を変更」ボタンをタップすると、スマホ専用の日付選択画面が開き、希望日を選択してワンクリックで変更できます。 ※ 変更完了と同時に、新しいお届け日を記載した確認メッセージがLINEへ届きます。
⑤ 注文完了時のLINE連携促進	購入完了画面（Shopping/complete）に、LINE連携を促進する案内バナーを自動表示します（既に連携済みの会員には自動的に非表示となります）。
⑥ マイページでの通知管理	マイページ上で連携中のLINE表示名やアイコン画像、連携日を確認できます。また、「通知をオフにする」ボタンによる一時停止や「連携解除」も自由に行えます。
⑦ 管理画面での連携会員一覧	管理画面から現在LINE連携を行っている全会員の一覧（LINEアイコン・表示名・会員名・メールアドレス・連携日時・通知設定状態）をリアルタイムに把握できます。

2. LINE公式アカウント & Developers 初期設定手順

1 LINE Official Account Manager でアカウント作成
LINE Official Account Manager にてLINE公式アカウントを作成します。
アカウント作成後、画面左上に表示される ベーシックID（例: @587kcrcr） を控えます。

2 Messaging API の有効化
管理画面の「設定」→「Messaging API」を開き、「Messaging APIを利用する」 をクリックしてプロバイダーを選択（または新規作成）します。

3 LINE Developers でトークン発行 & Webhook 設定
LINE Developers コンソールにログインし、作成したチャネルを開きます。

チャネル基本設定タブ: Channel ID と Channel Secret をコピーします。
Messaging API設定タブ: 最下部にある「チャネルアクセストークン（長期）」の 発行 ボタンを押し、トークンをコピーします。
Webhook URL の登録: https://あなたのサイトURL/recurring/line/webhook を入力して登録し、「Webhookの利用」を【ON】 に設定します。

4 EC-CUBE 管理画面への登録・設定
EC-CUBE管理画面の 「定期購入」→「LINE次回通知設定」 を開き、各項目を入力して保存します：

Channel ID: LINE Developersの Channel ID
Channel Secret: LINE Developersの Channel Secret
チャネルアクセストークン（長期）: 発行した長期アクセストークン
LINE 公式アカウントベーシックID: @587kcrcr 形式のID

🔒 機密情報のマスキング保護仕様:
保存後、Channel Secret と Channel Access Token は d5d8a2c...********************...6724d63 のように先頭と末尾以外が自動的に伏字化されます。
画面共有時や第三者閲覧時の漏洩を防ぎます。変更したい場合は右側の [変更] ボタンからいつでも再入力できます。

3. 動作テスト手順

A. 管理画面からのプッシュ送信テスト

公式LINEアカウント（@xxxx）をお手元のスマホのLINEアプリで 友だち追加 します。
LINE Developers の「チャネル基本設定」最下部にある ユーザーID（Uから始まる33桁） をコピーします。
EC-CUBE管理画面の「LINE テスト送信」欄にユーザーID を貼り付け、「テストメッセージを送信」をクリックします。
スマホのLINEにテストメッセージが届けば疎通成功です。

B. 会員マイページからの実機連携テスト

EC-CUBEのショップフロントで会員ログインし、「マイページ」→「LINE次回お届け前通知」を開きます。
表示されたQRコードまたは友だち追加ボタンからLINEを友だち追加します。
画面に表示された32桁の「連携コード」をコピーし、LINEのトークルームへ送信します。
即座に「🎉 LINE連携が完了しました！」という自動メッセージが届き、マイページ側も「🟢 LINE連携中」へ自動更新されます。

4. 自動配信バッチの設定

毎日決まった時刻に自動で対象となる契約（次回お届け日のX日前）を抽出し、LINE通知を送信するための cron 設定例です。

# 毎日朝9時00分に定期購入LINE次回通知を実行
0 9 * * * /usr/bin/php /var/www/html/bin/console recurring:line:remind >> /var/www/html/var/log/line_remind.log 2>&1

※ 管理画面の「手動バッチ即時実行」ボタンを押すことで、cron未設定時でも今すぐ手動で送信実行が可能です。

5. セキュリティと安全性

セキュリティ機構	詳細内容
暗号論的トークン	LINE連携コードおよび1-Click操作URLには、`random_bytes(16)` による推測不可能な暗号学的トークンを使用しています。
有効期限管理	マイページの連携コードは発行後24時間、配信されたLINEメッセージの1-Click操作は送信後14日間の有効期限が設定されています。
Webhook 署名検証	LINEプラットフォームから届くWebhookリクエストは、Channel Secretと `x-line-signature` ヘッダーを用いた署名検証を行い、なりすまし通信を遮断します。
シークレットキーのマスキング	管理画面に保存されたChannel SecretおよびChannel Access Tokenは先頭と末尾のみ表示され、HTMLソースにも生データを出力しません。
テーマ非依存デザイン	マイページおよび管理画面のスタイルシート・スクリプトは完全独立しており、ショップテーマのCSS崩れや競合を起こしません。

定期購入 LINE次回お届け通知&1-Clickスキップ・変更プラグイン マニュアル