自動応答(レスポンダー)

「自動応答(レスポンダー)」は、メンバーの送ったメッセージに特定のキーワードや言い回しが含まれていたとき、Bot が自動でメッセージを返す機能です。たとえば「おはよう」と書かれたら挨拶を返したり、「ルール」と書かれたらサーバーのルール案内を表示したり、といった反応をノーコードで設定できます。

仕組みはとてもシンプルです。

• トリガー: 反応するきっかけになるキーワードや言い回しを登録します。
• 返信メッセージ: トリガーにマッチしたときに、Bot が自動で送る内容です。

トリガーへの反応のしかた(「含む」「完全に一致する」など)や、連続反応を防ぐクールダウン、反応してよいチャンネル・ロールの範囲まで、サーバーごと・設定名ごとに細かく決められます。

このページでは、次の 2 つを設定します。

• コマンド権限設定: サーバーのメンバーが Discord 上で /responder settings コマンドを使えるかどうかと、その権限を決めます。
• サーバー別Responder設定: ダッシュボード上で、サーバーごとに名前を付けた自動応答の設定を作成・編集します。1 つのサーバーに複数の自動応答を登録できます。

自動応答の画面を開く

コマンド権限設定

「コマンド権限設定」のカードでは、自動応答に関するコマンドの利用可否と権限を設定できます。

設定できるコマンドは次の 1 つです。

コマンドの行を開くと、次の項目を設定できます。

• コマンドを有効化: このコマンド自体を利用可能にします。行の右側には、有効なら「有効」、無効なら「無効」のバッジが表示されます。
• 個別権限設定を有効化: オンにすると BotShade 独自の権限設定を使い、どのロールや権限に許可・拒否するかを細かく設定できます。オフのときは通常の Discord 権限判定を使います。
• Discord権限より個別設定を優先: 個別権限設定を Discord 既存権限より優先して強制適用します。「個別権限設定を有効化」をオンにしているときだけ設定できます。

コマンド権限の詳しい設定方法は、共通ページのコマンド権限設定の使い方もあわせてご覧ください。

サーバー別Responder設定

「サーバー別Responder設定」のカードでは、サーバーごとに名前を付けた自動応答を作成・編集・削除できます。

作成した自動応答は、対象サーバーごとにまとめて表示されます。1 つのサーバーに複数の設定を持つことができ、サーバー単位の見出し(アコーディオン)を開くと、そのサーバーの設定一覧が表示されます。カードの右上には現在の設定の合計数(「(件数) 個の設定」)が表示されます。

新しい自動応答を追加する

自動応答カードの基本

各自動応答のカードには、上部に設定名のバッジと、現在のマッチ方式(「match: ○○」)のバッジが表示されます。カードの右上の「削除」ボタンをクリックすると、その自動応答を削除できます。

カードの上部では、次の 2 つを確認・設定します。

マッチ方式

「マッチ方式」では、登録したトリガーをメッセージとどのように照合するかを選びます。選べるのは次の 6 種類です。

トリガー(反応するキーワード)

「トリガー」欄には、自動応答のきっかけになるキーワードを登録します。

高度なトリガー(正規表現)

より複雑な条件で反応させたいときは、「高度なトリガー（正規表現）」を使います。ここには正規表現(パターン文字列)を登録できます。通常のトリガーと同じく、入力欄に入力し、Enter キーで追加します。追加したパターンはタグとして表示され、ゴミ箱アイコンで削除できます。

入力欄の右側にある正規表現ビルダーのボタンをクリックすると、正規表現の作成を補助するパネルを開けます。正規表現に慣れていない場合は、こちらを利用すると便利です。

クールダウンと返信モード

短時間に何度も同じ自動応答が連続して送られないように、クールダウン(待機時間)を設定できます。また、返信(リプライ)の形で送るかどうかも選べます。

クールダウン種別

「クールダウン種別」では、クールダウンをどの範囲で適用するかを選びます。

クールダウン秒

「クールダウン種別」を「なし」以外にすると、「クールダウン秒」の入力欄が表示されます。ここに待機する秒数(0 以上の整数)を入力します。

クールダウンは、種別を「なし」以外にしたうえで秒数が 1 以上のときにだけ有効になります。設定した秒数が経過するまで、対象の範囲(サーバー・チャンネル・ユーザーなど)では同じ自動応答が再び送られません。

返信モード

「返信モード」のスイッチをオンにすると、きっかけになったメッセージへの返信(リプライ)として自動応答を送信します。オフのときは通常のメッセージとして送られます。

許可範囲(チャンネル・ロール)

自動応答が反応してよいチャンネルやロールの範囲を、「許可チャンネル」「許可ロール」で指定できます。どちらも次の 3 つから選びます。

対象のチャンネル・ロールを追加する

「すべて」以外(「指定のみ」または「除外」)を選ぶと、対象を追加するための欄が表示されます。

返信メッセージを作成する

「返信メッセージ」では、トリガーにマッチしたときに Bot が送る内容を作成します。メッセージは、本文(メッセージ内容)と埋め込み(Embed)の両方を組み合わせて作れます。

• メッセージ内容 (Content): 通常のテキスト本文です。最大 2000 文字まで入力できます。
• 埋め込み(Embed): 枠線つきで見やすく整形されるメッセージです。タイトル・説明文・著者欄・画像・フッター・フィールドを設定できます。

返信メッセージは、本文と埋め込みのどちらか一方だけでも、両方を組み合わせても送れます。ただし、本文・埋め込みのタイトル・埋め込みの説明文がすべて空のままだと、反応してもメッセージを送れません。少なくとも 1 つは内容を入れてください。

埋め込みは、「基本設定」「著者 (Author)」「画像設定」「フッター」「フィールド」のタブに分かれています。入力した内容は「PREVIEW(プレビュー)」で、実際に Discord で表示される見た目を確認しながら作成できます(画面が狭いときは「プレビューを開く」ボタンで確認できます)。

設定を保存する

ここまでの設定(マッチ方式・トリガー・クールダウン・許可範囲・返信メッセージなど)を変更すると、画面下部に「未保存の変更があります」という保存バーが表示されます。「保存」ボタンをクリックすると変更が確定します。やめたいときは「破棄」ボタンをクリックすると、編集前の状態に戻ります。

設定例: 「おはよう」に挨拶を返す

ここまでの操作を組み合わせた、かんたんな設定例です。

これで、設定したサーバーで誰かが「おはよう」を含むメッセージを送ると、Bot が自動で挨拶を返すようになります。

実際の動作と既定値

ここでは、ダッシュボードで作った自動応答が Discord 上で実際にどう動くかを説明します。

メッセージがサーバーに届くと、Bot は有効になっている自動応答を順番にチェックし、次の条件をすべて満たしたときだけ反応します。

• 送信者が Bot ではないこと(Bot の発言には反応しません)。
• 「許可チャンネル」「許可ロール」の範囲で許可されていること。
• 登録したトリガー(キーワードまたは正規表現)のいずれかにマッチすること。
• クールダウン中でないこと。

これらを満たすと、Bot は返信メッセージを送り、必要に応じてクールダウンの待機を開始します。条件を満たさない場合は何もせず、ユーザーに通知は出ません。

トリガーの照合のしかた

キーワードは大文字・小文字を区別せずに照合されます。「マッチ方式」によって、次のように反応する条件が変わります。

高度なトリガー(正規表現)は、大文字・小文字を区別して照合されます。複数のパターンを登録した場合は、いずれか 1 つでもマッチすれば反応します。

作成直後の既定値

「新しいサーバー設定を追加」で作ったばかりの自動応答は、次の状態になっています。あとから自由に変更できます。

作成直後の返信メッセージ本文には、仮の文言として 設定を編集してください。 が入っています。実際に使う前に、必ず返信メッセージを書き換えてください。

有効/無効の切り替え

自動応答は、個別に有効・無効を切り替えられます。無効にした自動応答は、どのメッセージにも反応しません。サーバー内のすべての自動応答が無効になっている場合、Bot はメッセージのチェック自体を行いません。

返信モードの動作

「返信モード」をオンにすると、きっかけになったメッセージへの返信(リプライ)として送信され、そのメッセージにひもづいた形で表示されます。万一、元のメッセージが削除済みなどで返信に失敗した場合でも、他の自動応答の処理は止まらず続行されます。

上限とクールダウン

入力欄や設定にはいくつかの上限があります。

クールダウンは「クールダウン種別」を「なし」以外にし、秒数を 1 以上にしたときだけ有効になります。設定した秒数が経過するまで、対象範囲では同じ自動応答が再送されません。

表示されるメッセージ

設定の入力内容に問題があると、Bot は次のようなメッセージを表示します(本人にだけ見える形で表示されます)。表示されたら、案内に従って入力を見直してください。

設定名に使えない文字が含まれているとき:

ルール名には半角英数字、アンダースコア(`_`)、ハイフン(`-`)のみ使用できます。

キーワードも正規表現も 1 つも入力していないとき:

キーワードまたは正規表現のいずれかを1つ以上指定してください。

同じ名前の設定がすでに存在するとき({ruleName} には入力した設定名が入ります):

ルール `{ruleName}` は既に存在します。

正規表現として正しくないパターンを入力したとき({number} は何件目か、{error} は理由が入ります):

正規表現 {number} 件目が無効です: {error}

埋め込みのカラー指定が正しくないとき(カラーは #FF5733 のような 16 進数か、random(ランダムな色)を指定します):

カラーは `#FF5733` のような16進数か `random` を指定してください。

注意点・うまくいかないとき

• 反応しないとき: その自動応答が「有効」になっているか、「許可チャンネル」「許可ロール」の範囲で対象が許可されているか、クールダウン中でないかを確認してください。マッチ方式が「strict(完全に一致する)」になっていて、メッセージ全体が完全一致していないケースもよくある原因です。
• 意図しないメッセージに反応するとき: マッチ方式が「contains(含む)」だと、キーワードがメッセージのどこかに含まれるだけで反応します。広すぎる正規表現も反応しすぎの原因になります。まずは通常のトリガーで動作を確認してから、必要に応じて範囲を絞ってください。
• Bot 同士で反応しないか: 自動応答は Bot の発言には反応しません。Bot の投稿をきっかけに自動応答を連鎖させることはできません。
• 添付ファイルは送れません: 返信メッセージで送れるのは、本文・埋め込み・画像 URL までです。ファイルそのものを添付して送ることはできません。画像は埋め込みの画像 URL・サムネイル URL で指定してください。
• 削除は取り消せません: 自動応答カードの「削除」を押すと、その設定はすぐに削除されます。確認画面は出ないため、削除する前に内容をよく確認してください。

コマンド一覧

自動応答に関する Discord 上のコマンドは次の 1 つです。

このコマンドを実行すると、登録済みの自動応答の一覧と、新しく作るためのボタンが表示されたメニューが開きます。自動応答が 1 つも登録されていないときは、その旨が表示されます。メニューはあなたにだけ見える形(エフェメラル)で開きます。

コマンドの利用可否や権限は、ダッシュボードの「コマンド権限設定」で調整できます。詳しくはコマンド権限設定の使い方をご覧ください。

次のステップ / 関連ページ

• コマンド権限設定の使い方 — /responder settings の権限設定について
• 埋め込みメッセージ — 返信メッセージの埋め込みエディタの詳しい使い方
• モジュールの基本と共通操作 — 機能の有効化や保存バーなど、各機能に共通の操作