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

# 티켓 일반 설정

> 서버 전역 티켓 설정 — 로그 채널, 한도, 서포트 역할, 차단 사용자, 개인 스태프 알림.

여기 설정은 서버의 **모든** 티켓 패널에 적용됩니다. 패널별 동작은 [Panels](/ko/utility/tickets/panels)에 있습니다.

네 개 탭: **General**, **Limits**, **Access**, **Notifications**.

## General

### 티켓 번호 매기기

| 설정                       | 기본값   | 효과                                        |
| ------------------------ | ----- | ----------------------------------------- |
| **Continuous numbering** | **켬** | 번호가 계속 증가합니다. 끄면 티켓이 종료될 때마다 빈 번호를 재사용    |
| **Number padding**       | 0     | 앞자리 0, 0\~6. padding 4는 `#7`을 `#0007`로 만듦 |

<Tip>
  연속 번호 매기기는 켜두세요. 재사용되는 번호는 대화록과 감사 추적을 모호하게 만듭니다 — 서로 다른 두 티켓이 `#12`를 공유하게 될 수 있습니다.
</Tip>

### 티켓 임베드 기본값

<Info>
  **Basic**이 필요합니다.
</Info>

이를 재정의하지 않는 티켓 임베드에 적용되는 기본 색상과 기본 푸터(텍스트 + 아이콘).

<Note>
  푸터 아이콘을 설정했지만 푸터 텍스트를 비워두면 저장 시 아이콘이 폐기됩니다. 아이콘이 유지되려면 텍스트가 필요합니다.
</Note>

### 백업 및 복원

<Info>
  **Basic**이 필요합니다.
</Info>

**Export configuration**은 전체 티켓 설정을 다운로드합니다. **Import configuration**은 이를 덮어씁니다.

<Warning>
  Import는 현재 설정을 덮어씁니다. 먼저 확인을 묻지만 되돌리기는 없습니다 — Import 전에 Export하세요.
</Warning>

### 위험 구역

* **Reset All Ticket Settings** — 이 페이지의 모든 항목을 기본값으로 되돌림
* **Revoke Transcript Links** — 지금까지 발급된 모든 대화록 링크를 무효화

<Warning>
  대화록 링크 폐기는 즉시 전역적으로 적용됩니다. 멤버와 공유했거나 다른 곳에 아카이빙한 모든 링크가 동작을 멈춥니다.
</Warning>

## Limits

| 설정                              | Starter | Basic 이상 | 기본값 |
| ------------------------------- | ------- | -------- | --- |
| **Max active tickets** (서버)     | 200     | 무제한      | 200 |
| **Max active tickets per user** | **1**   | 5        | 1   |
| **Cooldown between tickets**    | 0       | 0        | 0   |
| **Max closed tickets per user** | 3       | 100      | 0   |
| **Max closed tickets** (서버)     | 50      | 2,000    | 0   |
| **Limit bypass roles**          | 최대 10   | 최대 10    | 없음  |

<Note>
  종료된 티켓 한도에서 **0**은 무제한을 의미합니다 — 종료된 티켓이 무기한 보관됩니다.
</Note>

<Warning>
  **Starter에서는 "max active tickets per user"가 조용히 1로 강제됩니다.** 5를 입력해도 저장되지만 저장된 값은 프리미엄 배지도 설명도 없이 1이 됩니다. 이 페이지에서 게이팅 되어 있다는 시각적 표시가 없는 유일한 한도입니다.
</Warning>

### 쿨다운 동작

쿨다운은 초 단위이며 저장 시 스냅됩니다:

* **10 미만**은 **0**이 됨 (쿨다운 없음)
* **3600 초과**는 **3600**이 됨 (1시간)

따라서 5초 쿨다운은 짧은 쿨다운이 아니라 쿨다운이 아예 없는 상태입니다.

### 우회 역할

<Warning>
  우회 역할은 이 탭의 **모든** 한도를 한 번에 건너뜁니다 — 사용자당 한도, 서버 한도, 쿨다운, 두 가지 종료 티켓 한도.

  하나만 우회할 방법은 없습니다. 스태프에게만 부여하세요.
</Warning>

## Access

* **Support roles** — 서버 전역 스태프. 패널은 그 위에 자체적으로 추가 가능
* **Blocked roles** — 이 역할을 가진 멤버는 티켓을 열 수 없음
* **Blocked users** — 개별 멤버, 만료 시간과 사유는 선택 사항

<Info>
  차단 사용자: Starter는 **100**, Basic 이상은 **500**.
</Info>

차단은 영구이거나 1시간, 1일, 7일, 30일 후 만료되도록 설정할 수 있습니다. 사유는 최대 500자로 참고용으로 저장됩니다.

## Notifications

일곱 개의 독립적인 로그 채널, 모두 기본 꺼짐:

| 채널             | 로그 대상    |
| -------------- | -------- |
| **Opened**     | 새 티켓     |
| **Closed**     | 종료       |
| **Reopened**   | 재개       |
| **Renamed**    | 채널 이름 변경 |
| **Deleted**    | 삭제       |
| **Transcript** | 생성된 대화록  |
| **Rating**     | 멤버 평가    |

### 내 알림

스태프별 DM 설정, 모두 기본 꺼짐: 티켓 오픈, 에스컬레이션, 종료, 평가, SLA 위반.

<Note>
  이는 **여러분의** 설정이지 서버 전역 설정이 아닙니다. 각 스태프가 자신의 설정을 지정합니다.
</Note>

## Vetox에 필요한 권한

| 권한                                                   | 이유                  |
| ---------------------------------------------------- | ------------------- |
| **Manage Channels**                                  | 티켓 채널 생성, 이름 변경, 삭제 |
| **Manage Roles**                                     | 티켓별 권한 오버라이트 적용     |
| **View Channel**, **Send Messages**, **Embed Links** | 패널과 티켓 메시지 게시       |
| **Read Message History**                             | 대화록 생성              |
| **Manage Threads**, **Create Private Threads**       | 스레드 모드 패널 전용        |

<Warning>
  **티켓 시스템 어디에서도 역할 계층을 확인하지 않습니다.** 서포트 역할이 Vetox 역할 **위에** 있으면 그와 관련된 권한 변경이 조용히 실패합니다 — 채널에 오류도 없고, 로그에도 없으며, 티켓은 동작하는 것처럼 보입니다.

  Vetox 역할을 모든 서포트 역할 위로 드래그하세요. "스태프가 티켓을 못 봐요"의 가장 흔한 원인입니다.
</Warning>

<Note>
  **Read Message History**가 없으면 티켓은 여전히 정상 종료되지만 대화록이 비어 있게 됩니다.
</Note>

## 대화록

**5,000 메시지**, 메시지당 **2,000자**, 대화록당 **10 MB**로 제한됩니다. 이보다 긴 티켓은 잘립니다.

## 다운그레이드 시 변화

<Note>
  **티켓 데이터는 절대 삭제되지 않습니다.** 한도를 초과한 값은 clamp되고, 게이트된 기능은 꺼지며, 업그레이드하면 모든 것이 돌아옵니다.

  구체적으로: 서버 및 종료 티켓 한도는 무료 상한으로 clamp되고, 연결된 패널과 에스컬레이션 대상은 비워지며, 폼은 분리되고, 우선순위는 none으로 초기화되며, 지원 시간은 모두 열림으로 강제됩니다.
</Note>

## 문제 해결

<AccordionGroup>
  <Accordion title="스태프가 티켓을 보거나 조작할 수 없어요">
    거의 항상 역할 계층 문제입니다 — Vetox 역할을 서포트 역할 위로 옮기세요. 이에 대한 어떤 경고도 없습니다.
  </Accordion>

  <Accordion title="멤버가 두 번째 티켓을 열 수 없어요">
    Starter에서는 사용자당 한도가 1이며 올릴 수 없습니다. Basic 이상에서 최대 5까지 설정하세요.
  </Accordion>

  <Accordion title="설정한 쿨다운이 무시돼요">
    10초 미만 값은 0으로 저장됩니다. 10 이상을 사용하세요.
  </Accordion>

  <Accordion title="티켓 채널은 있는데 버튼이 동작하지 않아요">
    생성 중 드물게 발생하는 실패로 채널이 저장된 상태 없이 남을 수 있습니다. 수동으로 삭제하고 멤버가 새로 열게 하세요.
  </Accordion>

  <Accordion title="대화록이 비어 있어요">
    티켓 채널에서 Vetox에 **Read Message History** 권한이 없습니다.
  </Accordion>

  <Accordion title="퇴장 시 자동 종료 옵션을 설정했는데 발동되지 않아요">
    그 토글은 현재 반영되지 않습니다. 멤버가 떠날 때 수동으로 티켓을 종료하세요.
  </Accordion>
</AccordionGroup>

<CardGroup cols={2}>
  <Card title="패널" icon="ticket" href="/ko/utility/tickets/panels">
    패널별 질문, 버튼, 라우팅.
  </Card>

  <Card title="티켓 개요" icon="circle-info" href="/ko/utility/tickets/overview">
    시스템이 처음부터 끝까지 동작하는 방식.
  </Card>
</CardGroup>
