> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vetox.io/llms.txt
> Use this file to discover all available pages before exploring further.
# チケットパネルとオプション
> チケットパネルを設計し、独自のフォームとスタッフを持つチケットタイプを定義し、サポート時間を設定します。
**パネル**はメンバーが操作するメッセージです。各パネルは **options** を持ち、これが開けるチケットの種類にあたります。
**ほとんどすべての挙動はパネルではなく option 側で設定します。** 同じパネル上の 2 つの option が、まったく異なるカテゴリー、スタッフ、フォーム、クローズ規則、メッセージを持てます。
設定を探しているなら、それは option にあります。
## 設定の解決順序
これが最も重要な点です。
設定は **option で指定される**か、Vetox の**組み込みデフォルト**にフォールバックするかのどちらかです。
パネル階層の中間レイヤーは存在せず、option が[一般設定](/ja/utility/tickets/settings)を継承することも**ありません**。項目を空欄にする意味は「組み込みデフォルトを使う」であって、「サーバー全体の値を使う」ではありません。
唯一の例外はサポートロールです — 下記を参照してください。
## パネル
| 設定 | 備考 |
| ---------------------- | -------------------------- |
| **Panel Name** | 内部用のラベル。スタッフのみ |
| **Type** | チャンネルを作るかスレッドを作るか。作成時に決定 |
| **Embed** | パネルの見た目 |
| **Extra items** | 追加の embed または画像を最大 10 個 |
| **Link buttons** | FAQ など外部リンクを最大 5 個 |
| **Select placeholder** | option をドロップダウンで表示するときの案内文 |
新しいパネルには動作する embed と **Open Ticket** option が 1 つ最初から入っているので、作成直後でもすぐ送信できます。
**未保存の変更がある間は送信がブロックされ**、option の **Configure** リンクも遷移を拒否して保存バーを揺らします。先に保存してください。
ボタンもドロップダウン option もないパネルの送信は拒否されます。
## Options
各 option はボタンまたはドロップダウンの項目になります。設定は 7 つのタブに分かれています。
### Identity
チャンネルの命名（既定は `ticket-{ticket-number}`）、チケットが作成されるカテゴリー、**オーバーフローカテゴリー**、トランスクリプトチャンネル、既定の優先度。
**混み合うパネルでは必ずオーバーフローカテゴリーを設定してください。** Discord はカテゴリーあたり 50 チャンネルが上限です。オーバーフローがないと Vetox はサーバー直下にチケットを作成し、opened-tickets ログへ警告を残します。
何を入力しても、Discord はチャンネル名を小文字にし、空白と特殊文字をハイフンへ置き換えます。
### Access
**誰がチケットを作成できるか** — ロールの許可リスト。空なら全員です。
**Custom Support Roles** — このチケット種別のための追加スタッフ。
画面では Custom Support Roles をサーバー全体のサポートロールの\_上書き\_と説明していますが、**そうではありません。** 2 つのリストは結合され、option のロールがサーバー全体のロールに追加されます。
この項目で[サーバー全体のサポートロール](/ja/utility/tickets/settings)より狭くアクセスを絞ることはできません。
### Forms
チケットを開く前に尋ねる質問を最大 **5 問**。**Basic** が必要で、対象外のサーバーには項目のないロック済みカードだけが表示されます。
項目の種類：短文、段落、ドロップダウン、ユーザー選択、ロール選択、チャンネル選択、ユーザーまたはロール選択、ファイルアップロード。
すべての項目に **Required** トグルがあります。これをオフにすると、選択系やファイルアップロードも含めてすべての種類で本当に任意になり、メンバーは未回答のままフォームを送信できます。
**項目ラベルは実質的に異なる必要があります。** 空白と大文字小文字を無視すると同じになる 2 つのラベルは保存時に拒否されます。Discord はラベルから内部識別子を導出するため、重複するとフォームが恒久的に開けなくなるからです。
### Field limits
Discord はフォームを開くときに全体を検証するため、たった 1 つの不正な項目でチケット種別全体が開けなくなります。そこで Vetox は保存の時点で次の組み合わせを拒否します。
| ルール | 対象 |
| ------------------------------------ | ------------------ |
| 最小長は最大長を超えられない | 短文、段落 |
| 最小選択数は最大選択数を超えられない | すべての選択系、ファイルアップロード |
| ドロップダウンにはラベルと値の**両方**を持つ選択肢が最低 1 つ必要 | ドロップダウン |
| 最大選択数は選択肢の数を超えられない | ドロップダウン |
長さは 0〜4000 文字、選択数は 0〜25、ファイルアップロードは 10 ファイルが上限です。
**最小 0 は「任意」を意味します。** メンバーが省略してよいファイルアップロードや、入力必須でない選択項目に使ってください。最小 1 以上にすると、その数だけ選択が強制されます。
選択肢が空のまま保存されたドロップダウンや、値が欠けた選択肢は拒否されます。以前はそのまま保存でき、メンバーがフォームを開くと消えていました — 質問が黙ってチケットから外れ、それを参照する自動優先度ルールも一度も一致しませんでした。
**Automatic priority** はフォームの回答を優先度へ対応づけます。「Account compromised」という回答で、作成時にチケットを緊急にできます。
### Messages
カスタマイズできるメッセージが 6 種類：ウェルカム、クローズ、評価、開設時の DM、クローズ時の DM、モデレーター向けメッセージ。**Basic** が必要で、対象外のサーバーには淡色のプレビューが表示されます。
いずれも修飾子を含む[チケット変数一式](/ja/help/variables)に対応しています。
### Buttons
Close、Claim、Add User、Remove User、Delete、Reopen、Transcript の各ボタンについて、ラベル・絵文字・色を変更し、どれを表示するか選べます。すべての階層で無料です。
### Behavior
最も大きなタブで、claiming、オーナーロール、クローズとライフサイクル、スタッフスレッドと SLA、通知、対応時間のメッセージを扱います。
| Claiming モード | 効果 |
| ------------- | ----------------------- |
| **Disabled** | claiming なし |
| **Enabled** | サポートメンバーなら誰でも claim できる |
| **Read-only** | 他の人は読めるが返信はできない |
| **Private** | claim した人だけが見られる |
クローズ設定では、理由の必須化、スタッフのみクローズ可能にするか、2 段階確認、既定の理由、チャンネルを削除するかアーカイブするかを決めます。
**無操作による自動クローズ**は最短 **6 時間**から最長 **7 日**まで設定でき、事前警告も任意で出せます。**Basic** が必要です。
**このタブの 2 つの設定には、プレミアムが必要だという表示がありません。**
**Staff thread** と **SLA** にはプレミアムバッジが付かず、どの階層でも編集できるように見えます。Starter と Basic ではエラーなく保存され、その後黙って消去されます。これらには **Max** が必要です。
逆に **Ping Support Roles** は画面上プレミアムでロックされているように見えますが、実際には何の制限もありません。
### Rating
評価を有効にし、ボタンかドロップダウンかを選び、コメントの記入を必須にし、5 つ星でも必須にし、未 claim のチケットの評価を許可します。**Basic** が必要です。
## 対応時間
パネルにスタッフがいる時間帯を定義します。**Max** が必要です。
週あたり最大 14 の期間を設定でき、それぞれを **Open**、**Reduced**、**Emergency**、**Closed** のいずれかにして、個別のメッセージを持たせられます。
| 状況 | 挙動 |
| ---------------------------------- | -------------------------------------------- |
| **Closed** の期間内 | option の closed-ticket モードに従う — 警告して許可、または拒否 |
| **Reduced** または **Emergency** の期間内 | 警告を表示したうえでチケットは開く |
| 定義したどの期間にも入らない | **作成は既定でブロックされる** |
スケジュールの空白は「開いている」とは扱われません。平日の時間帯だけを定義した場合、その設定を変えない限り週末はチケット作成がブロックされます。
バイパスロールはスケジュールを完全に無視し、特定の option を対象外にすることもできます。
対応時間は[サーバー設定](/ja/server-management/setup)から継承せず、スケジュール自身に設定された独自のタイムゾーンを使います。
## Escalation と linked panels
**Escalation** を使うと、スタッフは `/ticket escalate` でチケットを別のパネルへ移せます。**Basic** が必要です。
すべての escalation 先に**表示ラベル**が必要です。ラベルが空のまま保存された対象は破棄され、コマンドの補完にも出てきません。
**Linked panels** は他パネルの option をこのパネルにまとめます。**Basic** が必要です。
## Templates
gaming、e-commerce、community、tech support、bot support、development をカバーする 6 種類の既成構成があります。
**テンプレートの適用は既存のパネルを置き換えます。** マージではありません。残しておきたい設定があるなら、先に[バックアップ](/ja/utility/tickets/settings)を書き出してください。
## パネルの削除
パネルを削除すると、**そのパネルに属する開いているチケットがすべてクローズされ**（ダッシュボードでも Discord でも）、他パネルの escalation 先からも取り除かれます。元に戻せません。
## ダウングレード後
プレミアム項目は消去されず、**ディスク上に保持されます**。無関係な設定を編集しても制限対象の値は壊れず、再びアップグレードすればそのまま元に戻ります。
パネル数と option 数の上限は、新規作成を拒否することで適用されます。既存のものが削除されることはありません。
件数、応答時間、スタッフの実績。
サーバー全体の上限、ログチャンネル、アクセス。