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

다운그레이드의 다른 모든 것은 삭제가 아니라 비활성화되며 업그레이드 시 복원됩니다.

## 두 가지 제출 흐름

<CardGroup cols={2}>
  <Card title="Dialog Button" icon="window-maximize">
    Discord 팝업 폼. 모든 등급에서 무료. **최대 5개 질문.**
  </Card>

  <Card title="Private Message" icon="envelope">
    Vetox가 신청자에게 DM을 보내 한 번에 하나씩 질문합니다. 전체 질문 한도를 지원합니다.
  </Card>
</CardGroup>

<Warning>
  **질문이 6개 이상이고 5번을 넘는 질문 중 하나라도 필수인 다이얼로그 폼은 절대 제출할 수 없습니다.**

  Discord 팝업은 5개 필드까지만 담습니다. 그 이후 질문은 표시되지 않지만 필수 항목은 여전히 검증됩니다 — 그래서 신청자는 필수 답변이 누락되었다는 안내를 받지만 답할 방법이 없습니다. 저장 시 이에 대한 경고는 없습니다.

  5개보다 많은 질문이 필요하다면 **Private Message** 흐름을 사용하세요.
</Warning>

### DM 흐름이 할 수 없는 것

DM 흐름은 질문을 채팅 메시지로 보내므로 풍부한 질문 유형은 저하됩니다:

| 질문 유형          | Dialog Button | Private Message |
| -------------- | ------------- | --------------- |
| 짧은 텍스트, 문단     | 네이티브          | 네이티브            |
| 드롭다운           | 네이티브          | 네이티브 선택기        |
| **사용자 선택기**    | 네이티브          | **입력 텍스트, 미검증** |
| **역할 선택기**     | 네이티브          | **입력 텍스트, 미검증** |
| **채널 선택기**     | 네이티브          | **입력 텍스트, 미검증** |
| **사용자/역할 선택기** | 네이티브          | **입력 텍스트, 미검증** |
| **파일 업로드**     | 네이티브          | **파일명만**        |

<Warning>
  DM 흐름에서 네 가지 선택기 유형은 검증 없이 **모든 텍스트**를 받습니다. 신청자는 무엇이든 입력할 수 있고 그것이 답변으로 저장됩니다. DM 폼에서 선택기 답변이 실제 사용자, 역할, 채널이라고 가정하지 마세요.
</Warning>

## 질문

여덟 가지 유형. 텍스트 질문은 0\~4,000자, 드롭다운은 최대 25개 선택지, 파일 업로드는 최대 10개 파일을 받습니다.

## 자격

누가 신청할 수 있는지:

| 게이트             | 확인 항목                         |
| --------------- | ----------------------------- |
| **최소 계정 나이**    | Discord 계정이 얼마나 오래됐는지         |
| **최소 서버 재적 기간** | 이 서버에 얼마나 있었는지                |
| **필수 역할**       | 이 중 **하나** 또는 **전부**를 가져야 함   |
| **차단 역할**       | 이 중 **하나** 또는 **전부**를 가지면 안 됨 |
| **멀티 서버 검증**    | 지정된 다른 서버들의 멤버여야 함 (**Max**)  |
| **쿨다운**         | 신청 사이 0\~1,440분               |
| **최대 대기**       | 인당 열린 신청 1\~5개                |
| **DM 도달 가능**    | DM이 열려 있어야 함 (기본 켬)           |

<Info>
  필수 및 차단 역할, 자동 거절은 **Basic**이 필요합니다. 멀티 서버 검증은 **Max**가 필요합니다.
</Info>

<Warning>
  **"이미 승인됨" 게이트는 없습니다.** 한번 승인된 사람도 쿨다운이 만료되는 즉시 다시 신청할 수 있습니다. 반복 신청을 원치 않는다면 긴 쿨다운을 설정하거나 승인된 역할을 **차단 역할**에 추가하세요.
</Warning>

## 워크플로 액션

제출, 승인, 거절 시 발생할 일.

| 액션                  | 등급    |
| ------------------- | ----- |
| 역할 부여, 역할 제거        | 무료    |
| 임베드 전송, DM 전송, 역할 핑 | 무료    |
| 닉네임 편집, 포럼 태그 설정    | 무료    |
| 킥, 밴, 타임아웃          | Basic |
| 스레드 이름 편집           | Basic |
| 인터뷰 채널 생성           | Basic |
| 보호관찰 역할 자동 지정       | Max   |
| 액션 지연 / 액션 체인       | Max   |
| **Execute command** | Max   |

<Warning>
  **Execute command는 아무것도 하지 않습니다.** 저장되고 Max로 게이팅되지만, 봇이 이를 로그에 남기고 명령어를 실행하지 않은 채 넘어갑니다. 에디터는 이를 표시하지만 여전히 유료 기능으로 제시됩니다.

  이에 의존하는 워크플로를 구축하지 마세요.
</Warning>

### 액션 메시지의 변수

<Warning>
  멤버 및 서버 변수 — `{username}`, `{user.displayName}`, `{nickname}`, `{guildname}`, `{server.name}`, `{server.memberCount}` — 는 **워크플로 액션 템플릿 내부에서 아무 값도 반환하지 않습니다.**

  `[{answer1}] {username}` 같은 템플릿은 `[그들의 답] `으로 뒤에 공백이 있는 채로 렌더링됩니다. 워크플로 액션에서는 답변 변수와 정적 텍스트를 사용하고, 멤버 세부 정보는 정상 동작하는 DM 메시지에 넣으세요.
</Warning>

## 스태프 리뷰

신청서는 리뷰 채널에 게시되며 리뷰어가 승인 또는 거절합니다.

| 옵션             | 설명                                |
| -------------- | --------------------------------- |
| **리뷰 채널**      | 텍스트, 공지 또는 포럼                     |
| **리뷰어 역할**     | 최대 10개                            |
| **제출에 스레드 추가** | 신청서당 스레드 하나 (**Basic**)           |
| **투표**         | 결정 전에 N개의 승인 또는 거절 요구 (**Basic**) |
| **자동 거절**      | 대기 1\~720시간 후 거절 (**Basic**)      |

<Note>
  리뷰 스레드의 **private thread** 옵션은 효과가 없습니다 — 리뷰 스레드는 리뷰 채널을 볼 수 있는 사람 누구에게나 항상 공개입니다. 대신 채널 자체를 제한하세요.
</Note>

<Note>
  리뷰어는 자신의 신청서를 리뷰할 수 없습니다.
</Note>

## Vetox에 필요한 권한

| 액션           | 권한                                                   |
| ------------ | ---------------------------------------------------- |
| 역할 부여 또는 제거  | **Manage Roles**, 그리고 역할이 Vetox **아래** 있어야 함         |
| 닉네임 편집       | **Manage Nicknames**, 그리고 멤버가 Vetox 아래에 있어야 함        |
| 킥 / 밴 / 타임아웃 | 해당 권한, 그리고 멤버가 Vetox 아래에 있어야 함                       |
| 리뷰 임베드 게시    | **View Channel**, **Send Messages**, **Embed Links** |
| 리뷰 스레드       | **Manage Threads**                                   |
| 인터뷰 채널       | **Manage Channels**                                  |

<Warning>
  **Vetox가 리뷰 채널에 게시할 수 없어도 신청자는 여전히 신청이 접수되었다는 안내를 받습니다** — 스태프는 절대 보지 못하는데도 말이죠. 실사용 전에 리뷰 채널에 봇이 게시할 수 있는지 확인하세요.
</Warning>

대부분의 다른 실패는 리뷰 채널에 보고되어 스태프가 무엇이 잘못됐는지 볼 수 있습니다.

## 설정하기

<Steps>
  <Step title="서버 설정에서 Applications 켜기" />

  <Step title="템플릿으로 시작">
    여섯 가지가 제공됩니다 — Staff Application, Game Member, Role Request, Event Signup, Partner Inquiry, Verification — 또는 빈 상태로 시작.
  </Step>

  <Step title="흐름 선택">
    질문이 5개 이하라면 Dialog Button이면 충분합니다. 5개를 넘으면 Private Message를 쓰세요.
  </Step>

  <Step title="리뷰 채널과 리뷰어 역할 설정">
    Vetox가 거기에 게시할 수 있는지 확인.
  </Step>

  <Step title="승인 액션 추가">
    보통: 역할 부여, 환영 DM 전송. 역할이 Vetox 아래에 있는지 확인하세요.
  </Step>

  <Step title="자격 설정">
    최소 계정 나이는 진짜 신청자에게는 거의 비용 없이 일회용 계정을 차단합니다.
  </Step>

  <Step title="패널을 보내고 직접 테스트">
    공지하기 전에 실제 신청을 제출하고 승인까지 진행해 보세요.
  </Step>
</Steps>

## 문제 해결

<AccordionGroup>
  <Accordion title="신청자가 해결할 수 없는 필수 답변 오류를 받아요">
    5개보다 많은 질문의 다이얼로그 폼에서 뒷 질문이 필수인 경우입니다. Private Message 흐름으로 전환하거나 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="/ko/utility/applications/submissions">
    신청서 검토, 필터링, 내보내기.
  </Card>

  <Card title="분석" icon="chart-line" href="/ko/utility/applications/analytics">
    승인율과 신청자가 이탈하는 지점.
  </Card>
</CardGroup>