> ## 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.

# アプリケーションパネル

> 質問フォーム、資格ゲート、レビュアー投票、自動アクションを使って、スタッフを募集しロールリクエストを処理します。

メンバーがボタンをクリックし、質問に答え、スタッフが承認または却下します。承認時に Vetox はロール付与、DM 送信、ニックネーム変更、面接チャンネル開設などを行えます。

## 制限

|                  | Starter | Basic | Max | Black |
| ---------------- | ------- | ----- | --- | ----- |
| パネル              | 1       | 3     | 10  | 10    |
| フォームあたりの質問数      | 5       | 15    | 50  | 50    |
| ステージあたりのアクション    | 1       | 3     | 10  | 10    |
| パネルあたりのフォーム（ボタン） | 1       | 3     | 5   | 10    |

<Warning>
  **ダウングレードすると、新しい制限を超える質問は永久に削除されます。** Vetox の中で、ダウングレードがデータを無効化するのではなく破棄してしまう唯一の箇所です。

  Max（50 問）から Basic（15 問）に下げると、16 問目以降は永久に消えます。再度アップグレードしても戻ってきません。

  **ダウングレードする前に、質問をエクスポートまたはコピーしてください。**
</Warning>

ダウングレード時のそれ以外のものは、削除ではなく無効化され、アップグレードで戻ります。

## 2 つの提出フロー

<CardGroup cols={2}>
  <Card title="ダイアログボタン" icon="window-maximize">
    Discord のポップアップフォーム。すべてのティアで無料。**最大 5 問**。
  </Card>

  <Card title="プライベートメッセージ" icon="envelope">
    Vetox が応募者に DM を送り、質問を 1 つずつ尋ねます。質問数の上限まで対応可能。
  </Card>
</CardGroup>

<Warning>
  **6 問以上あるダイアログフォームで、5 問目以降のいずれかが必須である場合、応募者は決して提出できません。**

  Discord のポップアップは 5 フィールドまでです。それを超える質問は表示されませんが、必須項目は依然としてチェックされます — そのため応募者は「必須項目が未回答」と言われるだけで、回答手段がありません。保存時にも警告は表示されません。

  質問数が 5 を超える場合は、**プライベートメッセージ**フローを使用してください。
</Warning>

### DM フローでできないこと

DM フローは質問をチャットメッセージとして尋ねるため、リッチな質問タイプは劣化します:

| 質問タイプ            | ダイアログボタン | プライベートメッセージ     |
| ---------------- | -------- | --------------- |
| ショートテキスト、段落      | ネイティブ    | ネイティブ           |
| ドロップダウン          | ネイティブ    | ネイティブピッカー       |
| **ユーザーピッカー**     | ネイティブ    | **入力テキスト、検証なし** |
| **ロールピッカー**      | ネイティブ    | **入力テキスト、検証なし** |
| **チャンネルピッカー**    | ネイティブ    | **入力テキスト、検証なし** |
| **ユーザー／ロールピッカー** | ネイティブ    | **入力テキスト、検証なし** |
| **ファイルアップロード**   | ネイティブ    | **ファイル名のみ**     |

<Warning>
  DM フローでは、4 種類のピッカーは検証なしで**任意のテキスト**を受け付けます。応募者は何でも入力でき、それが回答として保存されます。DM フォームでは、ピッカーの回答が実在するユーザー、ロール、チャンネルだと信用しないでください。
</Warning>

## 質問

8 種類あります。テキスト質問は 0〜4,000 文字、ドロップダウンは最大 25 選択肢、ファイルアップロードは最大 10 ファイルです。

## 応募資格

誰が応募できるか:

| ゲート            | チェック内容                               |
| -------------- | ------------------------------------ |
| **最低アカウント年齢**  | Discord アカウントがどれだけ古いか                |
| **最低サーバー在籍期間** | サーバーに参加してからの期間                       |
| **必須ロール**      | これらのうち**いずれか**または**すべて**を保持している必要がある |
| **禁止ロール**      | これらのうち**いずれか**または**すべて**を保持していてはいけない |
| **複数サーバー検証**   | 指定された他のサーバーのメンバーである必要がある（**Max**）    |
| **クールダウン**     | 応募間隔 0〜1,440 分                       |
| **最大保留数**      | 1 人あたり 1〜5 件の未処理応募                   |
| **DM 受信可能**    | DM が開いている必要がある（デフォルトでオン）             |

<Info>
  必須および禁止ロール、自動却下は **Basic** が必要です。複数サーバー検証は **Max** が必要です。
</Info>

<Warning>
  **「すでに承認済み」ゲートは存在しません。** 一度承認されたユーザーは、クールダウンが切れ次第再応募できます。繰り返し応募を防ぎたい場合は、長いクールダウンを設定するか、承認後のロールを**禁止ロール**に追加してください。
</Warning>

## ワークフローアクション

提出時、承認時、却下時に何が起きるか。

| アクション                | ティア   |
| -------------------- | ----- |
| ロール追加、ロール削除          | 無料    |
| 埋め込み送信、DM 送信、ロールへの通知 | 無料    |
| ニックネーム編集、フォーラムタグの設定  | 無料    |
| キック、Ban、メンバーのタイムアウト  | Basic |
| スレッド名の編集             | Basic |
| 面接チャンネルの作成           | Basic |
| 試用ロールの自動割り当て         | Max   |
| アクションの遅延／連鎖          | Max   |
| **コマンドの実行**          | Max   |

<Warning>
  **「コマンドの実行」は何もしません。** 保存でき、Max ゲートの背後にあり、ボットはログを出すだけでコマンドを実行せず先に進みます。エディタもその旨のラベルを表示しますが、それでも有償機能として提示されています。

  この機能に依存するワークフローを構築しないでください。
</Warning>

### アクションメッセージ内の変数

<Warning>
  メンバー変数およびサーバー変数（`{username}`、`{user.displayName}`、`{nickname}`、`{guildname}`、`{server.name}`、`{server.memberCount}`）は、**ワークフローアクションのテンプレート内では何にも解決されません。**

  `[{answer1}] {username}` のようなテンプレートは `[彼らの回答]` の後に空白が付いた形で表示されます。ワークフローアクションでは回答変数と静的テキストを使い、メンバー詳細は変数が機能する DM メッセージに含めてください。
</Warning>

## スタッフレビュー

応募はレビューチャンネルに投稿され、レビュアーが承認または却下します。

| オプション          | 備考                                |
| -------------- | --------------------------------- |
| **レビューチャンネル**  | テキスト、アナウンス、フォーラム                  |
| **レビュアーロール**   | 最大 10                             |
| **応募にスレッドを追加** | 応募ごとのスレッド（**Basic**）              |
| **投票**         | 判断前に N 件の承認または却下を必要とする（**Basic**） |
| **自動却下**       | 保留 1〜720 時間後に却下（**Basic**）        |

<Note>
  レビュースレッドの**プライベートスレッド**オプションは効果がありません — レビュースレッドは常にレビューチャンネルを閲覧できる全員にとって公開です。代わりにチャンネル自体を制限してください。
</Note>

<Note>
  レビュアーは自分自身の応募をレビューできません。
</Note>

## Vetox が必要とする権限

| アクション          | 権限                                                 |
| -------------- | -------------------------------------------------- |
| ロールの追加または削除    | **Manage Roles**、対象ロールが Vetox より**下**に位置していること     |
| ニックネーム編集       | **Manage Nicknames**、対象メンバーが Vetox より下             |
| キック／Ban／タイムアウト | 対応する権限、対象メンバーが Vetox より下                           |
| レビュー埋め込みの投稿    | **View Channel**、**Send Messages**、**Embed Links** |
| レビュースレッド       | **Manage Threads**                                 |
| 面接チャンネル        | **Manage Channels**                                |

<Warning>
  **Vetox がレビューチャンネルに投稿できない場合でも、応募者には応募が提出されたと通知されます** — 一方でスタッフはそれを見ることができません。公開前に、ボットがレビューチャンネルに投稿できるか確認してください。
</Warning>

その他ほとんどの失敗はレビューチャンネルに通知され、スタッフが何が起きたかを確認できます。

## 設定手順

<Steps>
  <Step title="サーバーセットアップでアプリケーションをオンにする" />

  <Step title="テンプレートから始める">
    6 種類が提供されています — Staff Application、Game Member、Role Request、Event Signup、Partner Inquiry、Verification — もしくは白紙から始められます。
  </Step>

  <Step title="フローを選ぶ">
    質問数が 5 以下ならダイアログボタンで問題ありません。5 を超える場合はプライベートメッセージを使用してください。
  </Step>

  <Step title="レビューチャンネルとレビュアーロールを設定する">
    Vetox がそこに投稿できるか確認してください。
  </Step>

  <Step title="承認アクションを追加する">
    典型的には: ロールを付与し、ウェルカム DM を送る。ロールが Vetox の下に位置していることを確認してください。
  </Step>

  <Step title="応募資格を設定する">
    最低アカウント年齢を設けるだけで、正当な応募者にほとんど負担をかけずに使い捨てアカウントを排除できます。
  </Step>

  <Step title="パネルを送信し、自分でテストする">
    本物の応募を提出し、承認まで通してから公開告知してください。
  </Step>
</Steps>

## トラブルシューティング

<AccordionGroup>
  <Accordion title="応募者に必須回答未入力のエラーが出るが直せない">
    5 問を超えるダイアログフォームで、後ろの質問が必須になっているケースです。プライベートメッセージフローに切り替えるか、6 問目以降を任意にしてください。
  </Accordion>

  <Accordion title="応募は送信されるがスタッフには届かない">
    Vetox がレビューチャンネルに投稿できていません。応募者にはとにかく成功と通知されます。
  </Accordion>

  <Accordion title="承認時にロールが付与されない">
    Manage Roles と、ロールがロールリストで Vetox より下にあることを確認してください。
  </Accordion>

  <Accordion title="すでに承認された人が再応募してきた">
    予期される挙動です — このためのゲートはありません。承認後のロールを禁止ロールに追加してください。
  </Accordion>

  <Accordion title="変数が承認アクション内で空になる">
    メンバーおよびサーバー変数はワークフローアクションでは解決されません。そのテキストを承認 DM に移動してください。
  </Accordion>

  <Accordion title="プラン変更後に質問が消えた">
    ダウングレードは新しい制限を超える質問を切り捨て、復元できません。
  </Accordion>

  <Accordion title="ボタンを押しても何も起きない">
    通常はメッセージ送信後にパネルが編集または再作成された場合です。パネルを再送信してください。
  </Accordion>
</AccordionGroup>

<CardGroup cols={2}>
  <Card title="提出" icon="inbox" href="/ja/utility/applications/submissions">
    応募をレビュー、フィルタ、エクスポートします。
  </Card>

  <Card title="分析" icon="chart-line" href="/ja/utility/applications/analytics">
    承認率と、応募者がどこで離脱するかを確認します。
  </Card>
</CardGroup>