# 패널 개요

A **패널** 멤버들이 티켓을 열기(또는 신청서를 제출하기) 위해 상호작용하는, Ticket King이 서버에 게시하는 메시지입니다.

설정, 로그, 전사본, 사용자 지정과 같은 봇의 다른 부분들은 패널이 하는 일을 뒷받침합니다.

<figure><img src="/files/a1c7cf9cd62044d44860e82db6c8709b5416c304" alt="A finished panel as it appears in a Discord channel"><figcaption></figcaption></figure>

## 패널의 구조

모든 패널에는 세 가지 계층이 있습니다:

### 1. 임베드

멤버가 보는 보이는 카드입니다. 제목, 설명, 색상, 선택적 이미지, 썸네일, 푸터. 최대 **패널당 임베드 10개** (Discord 한도). 이는 패널 편집기의 임베드 하위 패널에서 디자인합니다.

→ [임베드 편집](/docs/ko/panels/edit-the-embed.md)

### 2. 상호작용 구성 요소

멤버가 클릭하는 항목입니다. 세 가지 유형이 있습니다:

* **버튼.** 멤버가 취할 수 있는 동작 하나당 하나씩입니다. 패널에는 최대 5개 행에 각 최대 5개 버튼까지 넣을 수 있어, 총 최대 25개 버튼을 담을 수 있습니다.
* **선택 메뉴** (드롭다운). 멤버가 목록에서 선택합니다. 선택 메뉴 하나가 한 줄 전체를 차지하며, 각 메뉴에는 최대 25개의 옵션을 넣을 수 있습니다. 많은 버튼보다 하나의 깔끔한 목록이 필요할 때 좋습니다.
* **링크 버튼.** 티켓을 여는 대신 멤버를 웹사이트로 안내합니다.

패널은 최대 **총 5개의 구성 요소 행**. 각 행에는 최대 5개의 버튼 또는 선택 메뉴 1개만 들어갑니다.

### 3. 옵션

각 버튼(및 각 선택 메뉴 항목)은 **옵션**. 각 옵션에는 카테고리, 지원 역할, 환영 메시지, 양식 등 고유한 옵션별 설정이 있습니다.

이것이 가장 중요한 개념입니다: **모든 옵션은 각각 독립적으로 설정할 수 있습니다.** 옵션이 버튼이든 선택 메뉴 항목이든, 각 항목은 서로 다른 카테고리, 서로 다른 지원 팀, 서로 다른 양식 질문으로 티켓을 열 수 있습니다. 하나의 패널은 여러 행에 걸쳐 많은 옵션을 담을 수 있으므로, 하나의 패널로 멤버를 여러 다른 티켓 유형으로 안내할 수 있습니다.

## 패널의 두 가지 종류

{% columns %}
{% column %}

### 티켓 패널

버튼을 클릭하거나(또는 선택 옵션을 고르면) **티켓 채널 또는 스레드를 엽니다**, 멤버가 짧은 양식을 작성한 후에 열릴 수도 있습니다.

일반 지원, 버그 신고, 역할 요청처럼 멤버가 행동하자마자 대화를 시작하고 싶은 곳에 선택하세요.
{% endcolumn %}

{% column %}

### 신청 패널

버튼을 클릭하면 **팝업 양식**. 제출 내용은 검토자 대기열로 전달되며 **채널은 생성되지 않습니다**. 팀이 이를 승인하거나 거절하며, 승인 시 역할이 자동으로 부여됩니다.

직원 지원서, 파트너 신청, 역할 신청에 선택하세요.

→ [신청서 개요](/docs/ko/applications/overview.md)
{% endcolumn %}
{% endcolumns %}

## 패널 제한

* **무료:** 최대 **10개 패널** 서버당.
* **프리미엄:** **무제한 패널** 서버당.
* **템플릿:** 서버당 무료 1개, 프리미엄 25개.

→ [패널 제한](/docs/ko/panels/panel-limits.md)

## 하나의 패널을 만들 때와 여러 개를 만들 때

{% tabs %}
{% tab title="하나의 패널, 여러 옵션" %}
**다음과 같은 경우에 더 적합합니다:** 모든 흐름이 같은 채널에 속하며 하나의 서비스의 일부처럼 보일 때.

* "티켓 열기" 패널, 다음 버튼 포함 `🐛 버그 신고`, `❓ 질문`, `💡 제안`, `🤝 파트너십`.
* 각 버튼은 여전히 각자의 카테고리, 각자의 지원 역할, 각자의 양식으로 연결될 수 있습니다.

가장 일반적인 패턴입니다.
{% endtab %}

{% tab title="여러 개의 개별 패널" %}
**다음과 같은 경우에 더 적합합니다:** 패널이 서로 다른 채널에 있거나 서로 다른 대상에게 제공됩니다.

* `#staff-tickets` 한 팀용, `#member-support` 모두를 위한.
* 직원 지원서 패널과 파트너 지원서 패널을 분리하세요.
* 언어별 패널 (`#support-en`, `#support-es`).
  {% endtab %}
  {% endtabs %}

## 멤버가 보게 되는 내용

멤버가 패널 버튼을 클릭할 때 **양식 없음**:

1. 봇이 새 채널/스레드를 생성합니다.
2. (선택 사항) 지원 역할을 멘션합니다.
3. 환영 임베드를 게시합니다.

다음이 **양식**:

1. 최대 5개의 질문이 있는 Discord 팝업 양식이 열립니다.
2. 제출 후, 환영 임베드에 답변이 포함된 채널이 열립니다.

멤버에게 이미 열려 있는 티켓이 있고 사용자당 한도값이 1(기본값)이라면, 정중한 "이미 열려 있는 티켓이 있습니다" 메시지를 받습니다.

→ [열려 있는 티켓 제한](/docs/ko/tickets/limits-on-open-tickets.md)

## 이 섹션의 페이지

<table data-view="cards"><thead><tr><th></th><th></th><th></th></tr></thead><tbody><tr><td><i class="fa-ticket">:ticket:</i> <strong>티켓 패널 만들기</strong></td><td>생성 마법사 안내.</td><td><a href="/pages/fe378606eb49607c41ed0567b6285af843828db9">티켓 패널 만들기</a></td></tr><tr><td><i class="fa-clipboard-list">:clipboard-list:</i> <strong>애플리케이션 패널 만들기</strong></td><td>지원서 패널이 어떻게 다른지.</td><td><a href="/pages/001b55090e916b32ad29c02929ff76cce6db8d9c">애플리케이션 패널 만들기</a></td></tr><tr><td><i class="fa-pen-to-square">:pen-to-square:</i> <strong>패널 편집</strong></td><td>패널 편집기와 그 두 개의 창.</td><td><a href="/pages/48cf552cb5fafde047947116df94e932e178dd9e">패널 편집</a></td></tr><tr><td><i class="fa-window-maximize">:window-maximize:</i> <strong>임베드 편집</strong></td><td>제목, 설명, 색상, 이미지, 푸터.</td><td><a href="/pages/a592fb2d163b7a4320f25aea8b067a4894c3ef1c">임베드 편집</a></td></tr><tr><td><i class="fa-square-plus">:square-plus:</i> <strong>버튼 편집</strong></td><td>레이블, 색상, 이모지.</td><td><a href="/pages/00b63fdd0dd5c16db7f684af490c051773080f8d">버튼 편집</a></td></tr><tr><td><i class="fa-list-ul">:list-ul:</i> <strong>셀렉트 메뉴 편집</strong></td><td>자리표시자, 옵션.</td><td><a href="/pages/a93aa48637286977a979ba4d189faf76fd5cc605">셀렉트 메뉴 편집</a></td></tr><tr><td><i class="fa-link">:link:</i> <strong>링크 버튼 편집</strong></td><td>멤버를 외부 웹사이트로 보내기 위한 것입니다.</td><td><a href="/pages/3f8ebd0f80b86ae4bd3fb18299ba49b81c88093f">링크 버튼 편집</a></td></tr><tr><td><i class="fa-sliders">:sliders:</i> <strong>패널 전체 기본값</strong></td><td>값을 패널 수준에서 한 번만 설정합니다.</td><td><a href="/pages/6cb6f920fee19b71e1bc5aa38df7cec057b43c2a">패널 전체 기본값</a></td></tr><tr><td><i class="fa-gear">:gear:</i> <strong>옵션별 설정</strong></td><td>단일 버튼 또는 옵션의 모든 설정.</td><td><a href="/pages/1a336312dccc23ede6de8a6d04477c20f51879ef">옵션별 설정</a></td></tr><tr><td><i class="fa-copy">:copy:</i> <strong>템플릿</strong></td><td>패널 디자인을 저장하고 다시 사용하세요.</td><td><a href="/pages/e25a41a5d7471f408d2fd30df6ab9c348fde367e">템플릿</a></td></tr><tr><td><i class="fa-wand-magic-sparkles">:wand-magic-sparkles:</i> <strong>공개 프리셋</strong></td><td>선별된 시작 디자인.</td><td><a href="/pages/4c43804226e1e651e8444c0cee966a6da3a5860e">공개 프리셋</a></td></tr><tr><td><i class="fa-ruler">:ruler:</i> <strong>패널 제한</strong></td><td>패널에 적용되는 제한.</td><td><a href="/pages/6266bf995a9cd79d9311407d78bb334696bfd0a8">패널 제한</a></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ticketking.xyz/docs/ko/panels/overview.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.