> ## 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**를 담고 있으며, 이것이 패널이 열 수 있는 티켓의 종류입니다.

<Warning>
  **거의 모든 동작은 패널이 아니라 option에서 설정합니다.** 같은 패널의 두 option이 카테고리, 스태프, 폼, 종료 규칙, 메시지를 완전히 다르게 가질 수 있습니다.

  설정을 찾고 있다면 그건 option에 있습니다.
</Warning>

## 설정이 결정되는 방식

가장 중요하게 이해해야 할 부분입니다.

<Note>
  설정은 **option에서 지정되거나**, Vetox의 **기본값**으로 넘어가거나 둘 중 하나입니다.

  패널 단위의 중간 계층은 없으며, option이 [일반 설정](/ko/utility/tickets/settings)을 상속하지도 **않습니다**. 항목을 비워 두는 것은 "기본값을 쓰라"는 뜻이지 "서버 전체 값을 쓰라"는 뜻이 아닙니다.
</Note>

유일한 예외는 지원 역할입니다 — 아래를 보세요.

## 패널

| 설정                     | 설명                          |
| ---------------------- | --------------------------- |
| **Panel Name**         | 내부용 라벨, 스태프만 봅니다            |
| **Type**               | 채널을 만들지 스레드를 만들지. 생성 시 결정   |
| **Embed**              | 패널의 겉모습                     |
| **Extra items**        | 추가 embed 또는 이미지 최대 10개      |
| **Link buttons**       | FAQ 같은 외부 링크 최대 5개          |
| **Select placeholder** | option이 드롭다운으로 표시될 때의 안내 문구 |

새 패널에는 작동하는 embed와 **Open Ticket** option 하나가 들어 있어, 방금 만든 패널도 바로 보낼 수 있습니다.

<Warning>
  **저장하지 않은 변경이 있으면 전송이 막히고**, option의 **Configure** 링크도 이동을 거부하며 저장 바를 흔듭니다. 먼저 저장하세요.
</Warning>

버튼도 드롭다운 option도 없는 패널은 전송이 거부됩니다.

## Options

각 option은 버튼이나 드롭다운 항목이 됩니다. 설정은 일곱 개 탭으로 나뉘어 있습니다.

### Identity

채널 이름 규칙(기본값 `ticket-{ticket-number}`), 티켓이 생성될 카테고리, **오버플로 카테고리**, 트랜스크립트 채널, 기본 우선순위.

<Warning>
  **바쁜 패널에는 반드시 오버플로 카테고리를 지정하세요.** 디스코드는 카테고리당 50개 채널이 상한입니다. 오버플로가 없으면 Vetox는 서버 최상위에 티켓을 만들고 opened-tickets 로그에 경고를 남깁니다.
</Warning>

<Note>
  무엇을 입력하든 디스코드는 채널 이름을 소문자로 바꾸고 공백과 특수문자를 하이픈으로 치환합니다.
</Note>

### Access

**누가 티켓을 만들 수 있는지** — 역할 허용 목록입니다. 비워 두면 모두 가능합니다.

**Custom Support Roles** — 이 티켓 유형을 위한 추가 스태프.

<Warning>
  화면에서는 Custom Support Roles를 서버 전체 지원 역할의 *덮어쓰기* 라고 설명하지만 **그렇지 않습니다.** 두 목록은 합쳐지며, option의 역할이 서버 전체 역할에 더해집니다.

  이 항목으로 [서버 전체 지원 역할](/ko/utility/tickets/settings)보다 접근 범위를 좁힐 수는 없습니다.
</Warning>

### Forms

티켓이 열리기 전에 묻는 질문 최대 **5개**. **Basic**이 필요하며, 해당되지 않는 서버에는 항목 없이 잠긴 카드만 보입니다.

항목 유형: 짧은 텍스트, 문단, 드롭다운, 사용자 선택, 역할 선택, 채널 선택, 사용자-또는-역할 선택, 파일 업로드.

모든 항목에는 **Required** 토글이 있습니다. 이를 끄면 선택형과 파일 업로드를 포함한 모든 유형에서 실제로 선택 사항이 되어, 멤버가 답하지 않고도 폼을 제출할 수 있습니다.

<Warning>
  **항목 라벨은 실질적으로 서로 달라야 합니다.** 공백과 대소문자를 무시했을 때 같아지는 두 라벨은 저장 시 거부됩니다. 디스코드가 라벨에서 내부 식별자를 만들기 때문에, 중복되면 폼이 영구히 열리지 않게 됩니다.
</Warning>

### Field limits

디스코드는 폼이 열릴 때 전체를 검증하므로, 잘못된 항목 하나가 티켓 유형 전체를 열지 못하게 만듭니다. 그래서 Vetox는 저장 시점에 다음 조합을 거부합니다.

| 규칙                                    | 적용 대상          |
| ------------------------------------- | -------------- |
| 최소 길이가 최대 길이를 넘을 수 없음                 | 짧은 텍스트, 문단     |
| 최소 선택 수가 최대 선택 수를 넘을 수 없음             | 모든 선택형, 파일 업로드 |
| 드롭다운에는 라벨과 값을 **모두** 가진 선택지가 최소 하나 필요 | 드롭다운           |
| 최대 선택 수가 선택지 개수를 넘을 수 없음              | 드롭다운           |

길이는 0~~4000자, 선택 수는 0~~25이며 파일 업로드는 10개가 상한입니다.

<Note>
  **최소 0은 "선택 사항"을 뜻합니다.** 멤버가 건너뛰어도 되는 파일 업로드나, 꼭 채우지 않아도 되는 선택 항목에 쓰세요. 최소를 1 이상으로 두면 그만큼의 선택이 강제됩니다.
</Note>

<Warning>
  선택지 목록이 빈 채로 저장된 드롭다운이나 값이 빠진 선택지는 거부됩니다. 예전에는 멀쩡히 저장된 뒤 멤버가 폼을 열면 사라졌습니다 — 질문이 조용히 티켓에서 빠지고, 그 질문을 가리키던 자동 우선순위 규칙도 한 번도 맞지 않았습니다.
</Warning>

**Automatic priority**는 폼 답변을 우선순위에 연결합니다. "Account compromised" 같은 답변이 생성 시점에 티켓을 긴급으로 만들 수 있습니다.

### Messages

맞춤 설정 가능한 메시지 여섯 가지: 환영, 종료, 평가, 개설 시 DM, 종료 시 DM, 모더레이터 메시지. **Basic**이 필요하며, 해당되지 않는 서버에는 흐린 미리보기가 보입니다.

모두 수식어를 포함한 [티켓 변수 전체](/ko/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**이 필요합니다.

<Warning>
  **이 탭의 두 설정은 프리미엄이 필요하다는 표시가 없습니다.**

  **Staff thread**와 **SLA**에는 프리미엄 배지가 없어 어느 등급에서나 편집 가능해 보입니다. Starter와 Basic에서는 오류 없이 저장된 뒤 조용히 지워집니다. 이 둘에는 **Max**가 필요합니다.

  반대로 **Ping Support Roles**는 화면상 프리미엄으로 잠긴 듯 보이지만 실제 제한은 전혀 없습니다.
</Warning>

### Rating

평가를 켜고, 버튼과 드롭다운 중 고르고, 서면 코멘트를 필수로 하고, 별 다섯에도 필수로 하고, claim되지 않은 티켓의 평가를 허용합니다. **Basic**이 필요합니다.

## 지원 시간

패널에 스태프가 있는 시간을 정합니다. **Max**가 필요합니다.

주당 최대 14개 구간을 두고 각각을 **Open**, **Reduced**, **Emergency**, **Closed** 중 하나로 설정하며, 구간마다 별도의 메시지를 지정할 수 있습니다.

| 상황                             | 동작                                           |
| ------------------------------ | -------------------------------------------- |
| **Closed** 구간 안                | option의 closed-ticket 모드를 따름 — 경고 후 허용하거나 거부 |
| **Reduced** 또는 **Emergency** 안 | 경고를 보여 주면서 티켓은 열림                            |
| 정의된 어느 구간에도 없음                 | **기본적으로 생성이 차단됨**                            |

<Warning>
  일정의 빈 구간은 "열림"으로 취급되지 않습니다. 평일 시간만 정의했다면, 그 설정을 바꾸지 않는 한 주말에는 티켓 생성이 막힙니다.
</Warning>

바이패스 역할은 일정을 완전히 무시하며, 특정 option을 일정에서 제외할 수도 있습니다.

지원 시간은 [서버 설정](/ko/server-management/setup)에서 상속받지 않고, 일정 자체에 설정된 자체 시간대를 사용합니다.

## Escalation과 linked panels

**Escalation**은 스태프가 `/ticket escalate`로 티켓을 다른 패널로 옮기게 해 줍니다. **Basic**이 필요합니다.

<Warning>
  모든 escalation 대상에는 **표시 라벨**이 필요합니다. 라벨이 빈 채로 저장된 대상은 버려지며, 스태프가 명령어 자동완성에서 찾을 수 없습니다.
</Warning>

**Linked panels**는 다른 패널의 option을 이 패널에 합칩니다. **Basic**이 필요합니다.

## Templates

gaming, e-commerce, community, tech support, bot support, development를 아우르는 기성 구성 여섯 가지가 있습니다.

<Warning>
  **템플릿을 적용하면 기존 패널이 교체됩니다.** 병합이 아닙니다. 남겨 둘 설정이 있다면 먼저 [백업](/ko/utility/tickets/settings)을 내보내세요.
</Warning>

## 패널 삭제

<Warning>
  패널을 삭제하면 **그 패널에 속한 열린 티켓이 모두 종료되고**(대시보드와 디스코드 양쪽에서), 다른 패널의 escalation 대상에서도 제거됩니다. 되돌릴 수 없습니다.
</Warning>

## 다운그레이드 이후

프리미엄 항목은 지워지지 않고 **디스크에 보존됩니다**. 관련 없는 설정을 수정해도 제한 대상 값이 사라지지 않으며, 다시 업그레이드하면 그대로 돌아옵니다.

패널과 option 개수 제한은 새로 만드는 것을 거부하는 방식으로 적용되며, 기존 것을 삭제하지는 않습니다.

<CardGroup cols={2}>
  <Card title="Tickets overview" icon="ticket" href="/ko/utility/tickets/overview">
    처리량, 응답 시간, 스태프 성과.
  </Card>

  <Card title="General Settings" icon="gear" href="/ko/utility/tickets/settings">
    서버 전체 제한, 로그 채널, 접근 권한.
  </Card>
</CardGroup>
