Bot 機能(モジュール)

チケット

チケット機能は、メンバーがボタンをクリックすると専用の「チケットチャンネル」が自動で作られ、そこでスタッフ(またはスタッフチーム)と 1 対 1 でやり取りできる、問い合わせ・サポート用の機能です。お問い合わせ、応募、通報、サポート受付などに使えます。

仕組み:

  1. まず、ダッシュボードで「チケットパネル」(チケット作成ボタンが付いたメッセージ)の内容を設定します。
  2. Discord 上でそのパネルを設置します。
  3. メンバーがパネルのボタンをクリックすると、新しいチケットチャンネルが自動で作成されます。
  4. そのチャンネルで、メンバーとスタッフがやり取りします。
  5. 用件が終わったら、チケットを閉じる(アーカイブ)か削除します。

チケット機能は無料で使えます。

この機能でできること

  • ボタンをクリックするだけでメンバーが問い合わせ用チャンネルを作れる「チケットパネル」を設置できます。
  • チケットチャンネルが作られる場所(カテゴリー)を指定できます。
  • チケット内のやり取り(会話履歴)を、指定した「ログチャンネル」に送れます。
  • チケット作成時にメンションする「通知ロール」を設定できます。
  • チケットを閲覧・管理できる「スタッフロール」を設定できます。
  • 1 人が同時に作れるチケットの数(作成上限)を制限できます。
  • チケットを閉じたときの動作(アーカイブして残す / 即時削除する)を選べます。

サーバーは複数登録でき、さらに 1 つのサーバーの中に複数のチケット設定 を作れます。たとえば「サポート用」「応募用」など、用途ごとに設定名を分けてパネルを使い分けられます。

まずは機能を有効化する

ダッシュボードで対象の Bot を開き、モジュール一覧から「チケット」を選びます。ページ上部の「機能の有効化」トグルがオフのままだと、以降の設定をしてもチケットパネルやチケット作成は動作しません。

コマンド権限設定

「コマンド権限設定」では、/ticket create /ticket setting /ticket panel それぞれの有効 / 無効と、誰が使えるか(権限)を設定します。各コマンドの内容は コマンド一覧 を参照してください。操作方法は全機能で共通です — コマンド権限設定の使い方

サーバー別チケット設定

「サーバー別チケット設定」では、サーバーごとのチケットシステム設定を作成・編集します。

新しいチケット設定を追加する

「対象サーバー」を選ぶ

「新しいチケット設定を追加」をクリックして追加フォームを開き、「対象サーバー」の選択欄から設定したいサーバーを選びます。検索欄にサーバー名や ID を入力して絞り込めるほか、リスト下部の「id で直接入力」欄に ID を入力して「適用」をクリックする方法でも指定できます。この選択欄の操作は、以降のカテゴリー・チャンネル・ロールの選択欄でも共通です。

「設定名」を入力する

この設定を区別するための識別名を入力します(例: Support)。同じサーバー内に 同じ名前 の設定は作れません。

「追加」をクリックする

対象サーバーと設定名の 両方 が入力されるまで「追加」はクリックできません。

登録済み設定の一覧

追加した設定は、折りたたみ(アコーディオン)形式の一覧に「サーバーID: (サーバーID)」と設定名で並びます。行をクリックすると、その下に詳細設定が開きます。

チケット設定の詳細

登録した設定の行を開くと、その設定の詳細を編集できます。設定項目は大きく「基本設定」「チャンネル設定」「ロール設定」「動作設定」「埋め込み設定」に分かれています。

基本設定(設定名・チケット作成上限)

行を開いた一番上に、次の 2 つの項目があります。

項目説明
「設定名」追加時に付けた識別名です。ここから変更できます(例: Support Ticket)。
「チケット作成上限」1 人が同時に開けるチケットの最大数を数値で入力します(例: 5)。

チャンネル設定(カテゴリー・ログチャンネル)

続いて、チケットチャンネルに関わる場所を 2 つ指定します。

項目説明
「カテゴリー」チケット作成時にチャンネルが作られるカテゴリーです。新しいチケットチャンネルはこのカテゴリーの中に作成されます。
「ログチャンネル」チケットの会話履歴の送信先です。チケットが閉じられた際などに、やり取りの記録がこのチャンネルへ送られます。テキストチャンネルを指定します。

どちらも、選択欄でサーバーを選んでからカテゴリー / チャンネルを選びます。「カテゴリー」に指定したカテゴリー内に Bot がチャンネルを作成できる権限が必要です。

ロール設定(通知ロール・スタッフロール)

チケットに関わるロールを設定します。

通知ロール (メンション)

「通知ロール (メンション)」は、チケットが作成されたときにメンションされるロールです。サポート担当に「新しいチケットが来た」とお知らせしたいときに指定します。

選択欄(「通知ロール」)でサーバーを選ぶとロールの一覧が表示されます。

スタッフロール (閲覧・管理権限)

「スタッフロール (閲覧・管理権限)」に指定したロールが、作成されたチケットチャンネルの閲覧・管理権限を持ちます。問い合わせに対応するスタッフのロールを必ず指定してください。

スタッフロールは 複数 登録できます。「スタッフロールを追加」と表示された選択欄(「ロールを追加...」)からロールを選ぶと追加され、追加済みのロールの「×」で外せます。

動作設定(自動クローズ・チケット削除/閉鎖)

チケットの動作に関わる 2 つのトグルがあります。

自動クローズ

「自動クローズ」をオンにすると、チケットを作成したメンバーがサーバーから退出したときに、そのチケットを自動的に閉じます。

チケット削除/閉鎖

「チケット削除/閉鎖」は、チケットを終了させるときの動作を切り替えるトグルです。

状態説明文動作
オフ(初期状態)「チケットをクローズ(アーカイブ)します」チケットチャンネルを閉じて(アーカイブして)残します。会話履歴を後から確認できます。
オン「チケットを即時削除します」チケットチャンネルを閉じる代わりに、即時に削除します。

「チケット削除/閉鎖」をオンにすると、閉じた時点でチャンネルが削除され、アーカイブは残りません。会話履歴を残したい場合はオフ(クローズ=アーカイブ)のままにしてください。

埋め込み設定(チケットパネルのメッセージ)

「埋め込み設定」では、チケット作成ボタンを含むパネルメッセージ(埋め込み / Embed)の見た目をデザインします。ここで設定した内容が、Discord に設置されるパネルの表示になります。

設定エリアの下部には、実際に Discord で表示されたときのイメージを確認できる「PREVIEW(プレビュー)」があります。「🖥️ PC」「📱 Mobile」のボタンで表示幅を切り替えられます。

新しいチケット設定を追加した直後の初期値(書き換え可):

項目初期値
タイトルチケット作成
説明下のボタンを押してチケットを作成してください。

埋め込みの設定は、次のタブに分かれています。

タブ設定できる内容
「基本設定」タイトル、タイトルURL、説明(Description)、カラー
「著者 (Author)」著者名、著者URL、アイコンURL
「画像設定」画像URL(メイン画像)、サムネイルURL
「フッター」フッターテキスト、フッターアイコンURL、タイムスタンプの表示
「フィールド」見出しと内容のセットを最大 25 個まで追加

主な入力項目:

項目説明
「タイトル」埋め込みの見出しです(最大 256 文字)。
「タイトルURL」タイトルをクリックしたときに開くリンク先です。
「説明 (Description)」本文です。Markdown に対応しています(最大 4096 文字)。
「カラー」埋め込み左側の縦線の色です。カラーピッカーまたは色コードで指定します。
「著者名 (Author Name)」埋め込み上部に表示される著者名です(最大 256 文字)。
「画像URL (Main Image)」埋め込み内に大きく表示する画像の URL です。
「サムネイルURL (Thumbnail)」埋め込み右上に小さく表示する画像の URL です。
「フッターテキスト」埋め込み下部のテキストです(最大 2048 文字)。
「タイムスタンプを表示」オン(ON)にすると埋め込み下部に日時が表示されます。

フィールドの追加

「フィールド」タブでは、「見出し」と「内容」のセット(フィールド)を追加できます。

「フィールドを追加」をクリックする

「フィールド」タブを開き、「フィールドを追加」ボタンをクリックすると、新しいフィールド(「Field #1」「Field #2」…)が作られます。

内容を入力する

各フィールドの「Name」に見出し、「Value」に内容を入力します。「Inline」のスイッチをオンにすると、複数のフィールドを横並びに表示できます。

不要なフィールドは、そのフィールド右上のゴミ箱アイコンをクリックすると削除できます。

埋め込みの編集画面は、ログ機能やウェルカムメッセージなど他の機能と共通です。詳しくは 埋め込みメッセージ をご覧ください。

チケット設定を削除する

「サーバー別チケット設定」の一覧で、削除したい設定の行の「削除」ボタンをクリックすると、その設定が一覧から取り除かれます。

削除すると、そのチケット設定(基本設定・チャンネル・ロール・動作・埋め込みのすべて)が一覧から消えます。保存前であれば保存バーの「破棄」で元に戻せます。誤って削除したまま保存しないよう注意してください。

設定を保存する

変更内容は、画面下部の保存バーで「保存」するまで反映されません。「破棄」で編集前の状態に戻せます。保存バーの詳しい挙動は モジュールの基本と共通操作 をご覧ください。

Discord にパネルを設置する

ダッシュボードでの設定を保存しただけでは、まだ Discord 上にチケットパネルは表示されません。設定を保存したあと、パネルを設置したいチャンネルで /ticket panel を実行すると、設定した内容のチケットパネル(チケット作成ボタン付きのメッセージ)が設置されます。コマンドが見つからないときは、「コマンド権限設定」で /ticket panel が有効になっているか確認してください。

Discord 上での実際の動作

チケットを開くとき

メンバーがパネルの 🎫 チケットを開く ボタンをクリックすると、その人専用のテキストチャンネルが新しく作成されます。チャンネル名は頭に絵文字を付けた 🎫-ユーザー名 の形になります。「カテゴリー」を設定していれば、そのカテゴリーの中に作られます。

作られたチャンネルでは、次のように権限が設定されます。

  • チケットを開いたメンバーには、閲覧・書き込み・リアクションの権限が付きます。
  • サーバー全体(@everyone)からは見えないようにブロックされます。
  • 「スタッフロール」に指定したロールには、閲覧・管理の権限が付きます。

チケットチャンネルの中には、最初のメッセージ(埋め込み)と 🔒 閉じる ボタンが投稿されます。この最初のメッセージでは、チケットを開いた本人と、設定していれば「通知ロール」がメンションされます。埋め込みのタイトル・説明は、ダッシュボードの「埋め込み設定」で指定した内容が使われます。

チケットを閉じるとき

チケットチャンネル内の 🔒 閉じる ボタンをクリックすると、閉じる理由を入力する小さなフォーム(モーダル)が開きます。理由の入力は任意で、空のまま送信すると 理由なし として扱われます。理由は最大 500 文字まで入力できます。

閉じる処理では、まずそのチャンネルの会話履歴がすべて書き出され、「ログチャンネル」を設定していればそこへ記録(埋め込みと履歴ファイル)が送られます。そのあと、「チケット削除/閉鎖」の設定に応じて次のどちらかが行われます。

  • クローズ(アーカイブ)の場合: チャンネルは削除されず、名前が closed-元の名前 に変わります。チケットを開いた本人は閲覧できなくなり、スタッフはそのまま閲覧できます。チャンネル内には 🔓 閉鎖取り消し❌ 削除 のボタンが表示されます。
  • 即時削除の場合: チャンネルがそのまま削除されます。アーカイブは残りません。

閉じたチケットを再開・削除するとき

クローズ(アーカイブ)したチケットには、2 つのボタンが残ります。

  • 🔓 閉鎖取り消し(再開): チケットを開いた本人の閲覧・書き込み・リアクション権限が元に戻り、チャンネル名も 🎫-ユーザー名 の形に戻ります。「ログチャンネル」を設定していれば、再開も記録されます。
  • ❌ 削除: チャンネルを削除します。

上限と既定値

項目説明
チケット作成上限(1 人あたり)初期値 5、設定範囲 1〜501 人が同時に開けるチケットの最大数です。上限に達すると新しいチケットを開けません。
閉じる理由の文字数最大 500 文字🔒 閉じる のときに入力する理由の上限です。
削除までの待ち時間約 2 秒閉じたチケットの ❌ 削除 をクリックしてから削除されるまでの時間です。
カテゴリー初期は未設定未設定のときは、チケットチャンネルがサーバーの最上位(カテゴリー外)に作られます。
通知ロール初期は未設定未設定のときは、チケット作成時に本人だけがメンションされます。
スタッフロール初期は未設定未設定のときは、作成されたチケットをスタッフが閲覧できません。必ず設定してください。
ログチャンネル初期は未設定未設定のときは、チケットの開閉・再開の記録は送られません。
閉じたときの動作初期はクローズ(アーカイブ)初期状態では削除せずアーカイブして残します。

表示されるメッセージ

対処が必要なときに表示される主なメッセージです。{} の部分には、チャンネル名やロール名、上限の数値などが入ります。

状況表示されるメッセージ
作成上限に達しているときこれ以上チケットを作成できません。作成上限は{上限}件です。
チケット設定が見つからないときチケット設定が見つかりません。管理者に連絡してください。
チケット以外のチャンネルで閉じようとしたときこのチャンネルはチケットチャンネルではありません。
チケット作成中に問題が起きたときチケットの作成中に予期せぬエラーが発生しました。
再開中に問題が起きたときチケットの再開中にエラーが発生しました。
/ticket create で同じ名前の設定が既にあるとき設定 {設定名} は既に存在します。
/ticket panel で設定が見つからないとき指定されたチケット設定が見つかりませんでした。
作成上限に範囲外の値を入れたとき1から50までの数値を入力してください。

コマンド一覧

チケット機能では、Discord 上で次のスラッシュコマンドが使えます。いずれもサーバー内でのみ使用でき、応答は基本的に操作した本人にだけ見える形(エフェメラル)で返ります。

コマンドできること
/ticket create新しいチケット設定を、指定した名前で作成します。同じ名前の設定が既にある場合は作成されません。
/ticket setting指定したチケット設定の設定画面を Discord 上で開きます。カテゴリー・通知ロール・スタッフロール・ログチャンネル・作成上限・埋め込み・閉じ方を変更できます。設定名は入力時に候補(オートコンプリート)から選べます。
/ticket panel現在のチャンネルにチケットパネル(🎫 チケットを開く ボタン付きのメッセージ)を設置します。タイトル・説明・画像を指定でき、省略時は既定の文言が使われます。

/ticket setting で開く設定画面と、ダッシュボードの「サーバー別チケット設定」は同じ設定を編集します。どちらから変更しても、設定はその設定名・サーバーごとに保存されます。

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

スタッフがチケットを見られない

「スタッフロール」を設定していないと、作成されたチケットチャンネルをスタッフが閲覧できません。問い合わせに対応するスタッフのロールを必ず「スタッフロール」に指定してください。スタッフロールは複数登録でき、/ticket setting 側では同じロールをもう一度選ぶと外せる(追加と削除の切り替え)挙動になっています。

カテゴリーやログチャンネル・ロールを後から消したとき

  • 「カテゴリー」に指定したカテゴリーを後から削除すると、それ以降のチケットはエラーにはならず、サーバーの最上位(カテゴリー外)に作られます。
  • 「ログチャンネル」を後から削除したり Bot から見えない状態にすると、チケットを閉じる処理自体は成功しますが、ログだけが静かに送られなくなります。記録を残したい場合は、ログチャンネルが Bot から書き込める状態か確認してください。
  • 「スタッフロール」「通知ロール」に指定したロールを削除すると、設定上は残ったままになりますが、そのロールは実際には効果を持たなくなります。

作成上限のカウントについて

上限はチケットを開こうとした時点で、その人が今いくつチケットを開いているかを数えて判定します。上限に達したときは、不要なチケットを閉じる(またはスタッフが削除する)と、また新しく開けるようになります。

古い形式のチケットは再開できない

仕様の更新前に作られた古い形式のチケットでは、🔓 閉鎖取り消し(再開)が使えないことがあります。この場合は このチケットは形式が古く、再開できません。 と表示されます。また、チケットを開いた本人がサーバーを退出している場合は、再開しても本人の権限を元に戻せず チケットの作成者が見つかりません。 と表示されることがあります。

パネルと設定名の対応

設置したパネルのボタンは、設置した時点の設定名と結びついています。設定を作り直したり名前を変えたりしても、すでに設置済みのパネルは自動では更新されません。設定を変更したときは、必要に応じて /ticket panel で新しいパネルを設置し直してください。

チケットの操作(開く・閉じる・再開・削除)は、そのチャンネルを見られる人なら誰でも実行できます。スタッフ以外に勝手に閉じられたくない場合は、チケットチャンネルを閲覧できる範囲(スタッフロールの設計)を意識して運用してください。

AI による自動返信

チケットチャンネル内でのユーザーの発言に AI が自動で返信する「チケット自動返信」を、「AI 応答」モジュールと組み合わせて利用できます。

  • 設定はこのページではなく、「AI 応答」モジュールの「チケット自動返信」面で行います。ここで自動返信の有無、使うモデル、応答の長さ(トークン上限)を指定します。この面は既定でオフで、標準ティアに加えて**上位ティア(非推論)**のモデルも選べます。
  • 自動返信させるには、「AI 応答」モジュール全体の有効化(オプトイン)と「チケット自動返信」面の有効化の 両方 が必要です。

詳しい設定方法は AI 応答 のページをご覧ください。

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

最終更新:

目次