# 커스텀 명령어 만들기

<i class="fa-crown">:crown:</i> **프리미엄 기능입니다.** 대시보드에서 열기 **사용자 지정 명령어**, 다음으로 **+ 새 명령** 생성기를 열려면.

생성기에는 두 개의 패널이 있습니다.  **왼쪽 패널** 은 응답(메시지 내용, 임베드, 버튼)을 만드는 곳입니다.  **오른쪽 패널** 은 명령의 설정(이름, 트리거, 옵션, 권한)을 담고 있습니다.

<figure><img src="/files/a470d9f7ab4bac69887b552486b83ec92dc55e70" alt="The custom-command creator open showing both panes"><figcaption></figcaption></figure>

## 왼쪽 패널, 응답

왼쪽 패널에서는 명령이 전송할 내용을 만듭니다. 탭은 세 개입니다.

### 텍스트 콘텐츠 탭

봇의 답장을 위한 여러 줄 편집기입니다.

* 제한: 2000자. 카운터가 표시되며, 제한에 가까워질수록 빨간색으로 바뀝니다.
* Discord 마크다운을 지원합니다.
* 인라인 이모지 선택기가 있습니다.
* 명령이 **티켓 전용**이면, 티켓 플레이스홀더가 여기에서 작동합니다(아래 플레이스홀더 섹션 참조).

도움말 텍스트: *"콘텐츠는 최소한 하나의 임베드가 제공되면 선택 사항입니다."*

### 임베드 탭

최대 10개의 임베드.  **임베드 디자이너** 를 열어 각각을 편집하세요. 대시보드의 다른 곳에서도 사용하는 것과 동일한 디자이너입니다.

* 임베드당: 제목(256), 설명(4096), 푸터(2048), 작성자(256), 색상, 이미지, 썸네일, 그리고 최대 25개 필드(필드 이름 256, 필드 값 1024).
* 하나의 명령에 있는 모든 임베드 전체에서: 총 최대 6000자.

언제 **티켓 전용** 가 켜져 있으면 임베드 텍스트 필드에서도 티켓 플레이스홀더를 지원합니다.

"모두 삭제" 버튼을 누르면 확인 단계를 거쳐 모든 임베드를 한 번에 제거합니다.

### 응답 미리보기 탭

응답이 Discord에서 어떻게 보일지 실시간 미리보기를 제공하므로 저장하기 전에 서식을 확인할 수 있습니다.

### 링크 버튼

임베드 안에 **링크 버튼**을 추가할 수 있습니다. 이는 링크 버튼 전용입니다.

* 최대 5개 행, 각 행에 최대 5개 버튼.
* 각 버튼에는 라벨(최대 80자)과 http\:// 또는 <https://로> 시작하는 URL(최대 512자)이 필요합니다. 버튼은 라벨 없이 이모지 하나만 사용할 수 있습니다.

이는 "환불 정책은 여기입니다" 같은 패턴에 유용하며, 버튼으로 페이지를 열 수 있습니다.

## 오른쪽 패널, 설정

### 명령 이름

대시보드에서 명령의 이름을 지정하는 텍스트 상자입니다. **사용자는 이것을 보지 못합니다.**

* 플레이스홀더: `잘못된 티켓`
* 도움말 텍스트: *"대시보드에서 이 명령을 식별하는 데만 사용됩니다. 사용자는 볼 수 없습니다."*
* 필수입니다.
* 자동으로 소문자로 변환됩니다.
* 서버에서 고유해야 합니다.

### 명령 트리거

사용자가 명령을 실행하기 위해 입력하는 텍스트입니다.

* 플레이스홀더: `!wrongticket`
* 도움말 텍스트: *"사용자가 이 명령을 실행하기 위해 입력할 텍스트입니다."*
* 필수입니다.
* 자동으로 소문자로 변환됩니다.
* 서버에서 고유해야 합니다.

반드시 `!` 접두사를 사용할 필요는 없습니다. 어떤 텍스트든 괜찮습니다. 한 가지 스타일을 정해 모든 명령에 일관되게 사용하면 직원들이 기억하기 쉽습니다.

### 옵션

| 항목             | 유형 | 기본값 | 동작                                                                  |
| -------------- | -- | --- | ------------------------------------------------------------------- |
| **명령 사용**      | 토글 | 켜짐  | 꺼져 있으면 트리거를 입력해도 아무 일도 일어나지 않습니다.                                   |
| **티켓 전용**      | 토글 | 꺼짐  | 켜져 있으면, 명령은 티켓 채널 내에서만 실행되며 응답에서 티켓 플레이스홀더가 작동합니다.                  |
| **명령 메시지 삭제**  | 토글 | 꺼짐  | 켜져 있으면, 봇이 응답한 후 사용자의 트리거 메시지를 삭제합니다.                               |
| **명령 메시지에 답장** | 토글 | 켜짐  | 켜져 있으면, 봇의 응답은 사용자의 메시지에 대한 답장입니다. 이 옵션은 '명령 메시지 삭제'가 켜져 있으면 숨겨집니다. |

### 권한

| 항목                             | 유형     | 동작                                            |
| ------------------------------ | ------ | --------------------------------------------- |
| **모든 스태프 허용**                  | 토글     | 켜져 있으면, 서버 전체 지원 역할이 있는 누구나 이 명령을 사용할 수 있습니다. |
| **역할** (모든 직원 허용이 꺼져 있을 때 표시됨) | 역할 선택기 | 이 명령을 사용할 수 있도록 허용된 특정 역할입니다.                 |

## 유효성 검사

명령이 유효해질 때까지 저장 버튼은 비활성화된 상태로 유지됩니다. 일반적인 메시지:

* *"명령 이름은 필수입니다"*
* *"명령 트리거는 필수입니다"*
* *"명령에는 콘텐츠 또는 최소한 하나의 임베드가 있어야 합니다"*
* *"명령 이름이 이미 존재합니다"*
* *"명령 트리거가 이미 존재합니다"*

## 플레이스홀더(티켓 전용 모드)

언제 **티켓 전용** 가 켜져 있으면, 명령이 실행될 때 이 플레이스홀더들이 채워집니다:

| 플레이스홀더            | 채워지는 값             |
| ----------------- | ------------------ |
| `{USER}`          | 티켓 작성자 멘션          |
| `{TICKET_NUMBER}` | 티켓 번호              |
| `{TYPE}`          | 패널 옵션 라벨           |
| `{USER_ID}`       | 티켓 작성자의 Discord ID |
| `{USER_NAME}`     | 티켓 작성자의 표시 이름      |
| `{GUILD_NAME}`    | 서버 이름              |
| `{CREATED_AT}`    | 티켓 생성 시간           |

값이 없는 플레이스홀더는 다음과 같이 표시됩니다 `해당 없음`. 티켓 전용이 아닌 명령은 플레이스홀더를 지원하지 않습니다.

## 저장 중

클릭 **저장**. 명령은 즉시 활성화됩니다. 감사 로그에는 해당 명령이 생성되었다고 기록됩니다.

## 관련

{% content-ref url="/pages/503bec0aed769ce577b3725941df28a6ba3078c1" %}
[명령어 편집 및 삭제](/docs/ko/custom-commands/editing-and-deleting.md)
{% endcontent-ref %}

{% content-ref url="/pages/7e31f7971efc91dc79deb6e7516c00ff84fe5366" %}
[사용 사례](/docs/ko/custom-commands/use-cases.md)
{% endcontent-ref %}


---

# 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/custom-commands/creating-a-command.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.