Studio Hermitage Logo
スタジオ・エルミタージュ | プラグイン公式マニュアル
ホーム プラグイン一覧 オーナーズストア ↗
Official Documentation

Discord リアルタイム
Webhook通知プラグイン

新規注文、お問い合わせ、在庫切れ、会員登録などのショップ内イベントをDiscordへリアルタイムプッシュ通知。見落としを防ぎ、店舗チームの迅速な初動を強力に支援する公式オンラインマニュアルです。

プラグインコード: DiscordNotifier
対応バージョン: EC-CUBE 4.2.0 〜 4.3.x
PHP要件: PHP 8.1 〜 8.3
連携方式: Discord Incoming Webhook
最終更新: 2026年9月

1. プラグイン概要・特徴

ネットショップ運営において、「注文の見落とし」「お問い合わせ返信の遅延」「在庫切れによる販売機会の損失」はショップの信用と売上に直結する重大なリスクです。

本プラグイン（DiscordNotifier）を導入することで、管理画面やメールを常時監視することなく、チームで利用しているDiscordのチャンネルへリアルタイムにプッシュ通知を自動集約できます。

⚡ リアルタイム即時プッシュ
注文確定やお問い合わせ送信と同時にDiscordへ通知。スマホ通知で外出先やリモート環境から即座に把握できます。
🔔 柔軟なメンション指定
イベントごとに「なし / @everyone / @here / 特定のロール」を選択可能。必要な担当者にピンポイントで通知できます。
🔒 顧客名マスキング対応
通知カード内のお名前を「田* 健*」のように伏字化する設定を搭載。社内チャットツール上での個人情報保護に配慮。
🔀 イベント別の個別チャンネル
注文用、お問い合わせ用、在庫アラート用など、イベントごとに別々のWebhook URLを指定してチャンネル振り分けも可能です。

2. 動作要件・システム環境

項目 要件・対応仕様
EC-CUBE バージョン EC-CUBE 4.2.0 〜 4.3.x（4.2系・4.3系両対応）
PHP バージョン PHP 8.1 / PHP 8.2 / PHP 8.3
外部連携方式 Discord Incoming Webhook（PHP curl または file_get_contents で送信）
必要な外部サービス Discordアカウントおよび通知先となるDiscordサーバー（無料プランで可）

3. Discord Webhook URLの取得手順

本プラグインはBOTの登録や複雑なOAuth認証は一切不要です。Discordサーバーで「ウェブフックURL」を1つ発行するだけで、最短3分で連携完了します。

  1. 1

    チャンネル設定を開く

    通知を受信したいDiscordチャンネルの歯車アイコン（チャンネルの編集）をクリックします。

  2. 2

    連携 ＞ ウェブフック

    左メニューの「連携」を選択し、「ウェブフックを作成」または「ウェブフックを表示」をクリックします。

  3. 3

    Webhook URLをコピー

    ウェブフック名（例: EC-CUBE通知）を確認し、「ウェブフックURLをコピー」をクリックします。

💡 発行されるURLの形式
コピーされるURLは https://discord.com/api/webhooks/1234567890/abcdefg... という形式になります。これを次の初期設定で使用します。

4. インストール・初期設定

  1. 1

    プラグインのインストール・有効化

    管理画面「オーナーズストア ＞ プラグイン ＞ プラグイン一覧」より本プラグインをインストールして有効化します。

  2. 2

    基本設定画面を開く

    左メニューの「設定 ＞ システム設定 ＞ Discord通知設定」を開きます。

  3. 3

    Webhook URLの登録・保存

    「共通Webhook URL」にコピーしたURLを貼り付け、通知を受け取りたいイベントにチェックを入れて保存します。

5. 対応通知イベントと設定一覧

設定項目 初期値 通知内容・設定のポイント
新規注文受付
notifyOrder		 ON お客様からの注文完了時に、注文番号、注文者名、購入商品名、数量、合計金額、決済方法を通知します。
注文商品明細の表示
includeOrderItems		 ON 通知カードの中に購入された商品名と数量の一覧を含めるかどうかを指定します。
お問い合わせ受付
notifyContact		 ON お問い合わせフォーム送信時に、問い合わせ番号、お名前、メール、相談内容を通知します。
在庫僅少・在庫切れ
notifyStockAlert		 ON 在庫数が指定した「在庫アラートしきい値（初期値: 0）」以下になった際に警告通知します。
新規会員登録
notifyCustomer		 ON 新規会員のアカウント登録完了時に通知します。
発送完了通知
notifyAdminOrder		 ON 管理画面での出荷登録完了時に、注文番号とお問い合わせ伝票番号を通知します。
会員退会
notifyWithdraw		 OFF 会員の退会手続き完了時に通知します。
顧客情報のマスキング
maskCustomerInfo		 ON 通知に含まれるお客様のお名前を「山田 太郎 → 山* 太*」のように部分伏字化してプライバシーを保護します。
メンション設定 なし イベントごとにメンション種別を選択できます：
  • なし： 音声を鳴らさず静かにメッセージのみ投函。
  • @everyone / @here： チャンネル内の全員またはオンラインメンバーに通知。
  • 特定のロール： 指定した「ロールID（数字）」を持つメンバーのみにピンポイント通知。
💡 DiscordロールIDの取得方法
Discordの開発者モードをONにした状態で、「サーバー設定 ＞ ロール」よりメンションしたいロールを右クリックして「ロールIDをコピー」を選択すると、123456789012345678 のような数字列が取得できます。これを管理画面の「ロールID」欄に入力してください。

6. 通知カードの表示サンプル

実際にDiscordへ投稿される埋め込みカード（Embed）のレイアウト例です。 

🛒 [新規注文受付] #10042 - 注文が確定しました
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
・ショップ名: 公式オンラインショップ
・ご注文者様: 田* 健* 様
・決済方法: クレジットカード決済
・購入商品:
   - プレミアムギリシャヨーグルト 500g × 2
   - 自家製ベリーコンポート 200g × 1
・合計金額: ¥3,850 (税込)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
※受注管理画面への直接リンクが下部に付与されます。

7. よくある質問・トラブルシューティング

Q. 通知がDiscordに届きません。

1. Webhook URLの先頭や末尾に不要なスペースや改行が含まれていないかご確認ください。
2. Webhookが登録されているDiscordチャンネルが削除されていないかご確認ください。
3. サーバーのセキュリティ設定（外向きポート443の通信制限）でDiscord API（discord.com）へのHTTPSリクエストが遮断されていないかサーバー会社にお問い合わせください。

Q. SlackやLINEへの通知には対応していますか？

本プラグインはDiscord専用となりますが、弊社ではSlackやLINE、Chatworkへの通知カスタマイズも受託開発にて承っております。ご希望の店舗様はお気軽にお問い合わせください。