# 사용자 지정 명령어란

<i class="fa-crown">:crown:</i> **프리미엄 기능입니다.** 커스텀 명령어를 설정할 수 있습니다 **접두사 스타일의** 직원이 입력하여 짧은 한 명령으로 저장된 응답을 보낼 수 있는 트리거입니다.

사용자가 Discord 채널에 트리거 텍스트를 입력하면 커스텀 명령어가 실행됩니다. 예를 들어, `!faq` 티켓 채널에서 입력하면 봇이 저장해 둔 FAQ 답변을 게시합니다.

## 이것들은 슬래시 명령어가 아닙니다

Ticket King의 커스텀 명령어는 **접두사 트리거입니다**. 봇은 일반 메시지에서 트리거 텍스트를 감시합니다. 이는 Discord 슬래시 명령어가 아닙니다.

이것이 의미하는 바:

* 이것들은 `/` 슬래시 명령어 선택기에 나타나지 않습니다.
* 트리거는 사용자가 입력한 정확한 텍스트입니다. 많은 팀이 `!` 접두사를 사용하지만, 어떤 텍스트든 사용할 수 있습니다.
* 봇이 트리거를 볼 수 있도록 채널의 메시지를 읽을 권한이 필요합니다.

## 설정하는 항목

대시보드에서 열기 **사용자 지정 명령어** 사이드바에 있습니다. 이 페이지는 프리미엄입니다.

각 명령어에 대해 설정하는 항목:

* **명령 이름**, 해당 명령어의 참조 이름입니다. 최대 100자까지 가능합니다. 소문자로 저장되며 서버 내에서 고유해야 합니다. 사용자는 볼 수 없습니다.
* **명령 트리거**, 사용자가 입력하는 텍스트입니다. 예를 들어 `!faq`.
* **응답 내용**, 최대 2000자까지 가능합니다.
* **임베드**, 선택 사항이며 최대 10개까지 가능합니다.
* **링크 버튼**, 선택 사항이며 최대 5개의 행, 각 행에 최대 5개의 버튼까지 가능합니다.
* **권한**, '모든 스태프 허용' 또는 특정 역할 목록 중 하나입니다.
* **옵션**, 활성화, 티켓 전용, 명령어 메시지 삭제, 명령어 메시지에 답장 토글입니다.

[커스텀 명령어 만들기](/docs/ko/custom-commands/creating-a-command.md)

## 제한

* 최대 **커스텀 명령어 25개** 서버당.
* 무료 서버는 커스텀 명령어를 만들 수 없습니다.

## 사용 사례

커스텀 명령어가 자주 사용되는 용도:

* FAQ 답변. 스태프가 입력하면 `!faq.refund` 봇이 기본 환불 답변을 게시합니다.
* 간단한 인사말. `!greet` 새 티켓에서 친근한 인사를 보내는 용도.
* 잘못된 티켓 안내. `!wrongticket` 회원에게 정중하게 다른 곳으로 안내하는 용도.
* 서버 규칙. `!rules` 티켓에 규칙을 다시 게시합니다.
* 일반적인 문제 해결 단계. `!restart` "다시 시작해 보셨나요?"를 위한 것입니다.

[사용 사례](/docs/ko/custom-commands/use-cases.md)

## 티켓 전용 명령어

명령어를 다음으로 설정할 수 있습니다 **티켓 전용**, 그래서 티켓 채널 안에서만 작동합니다. 티켓 전용 명령어는 다음과 같은 티켓 자리표시자도 사용할 수 있습니다. `{TICKET_NUMBER}` 및 `{USER}`.

명령어가 티켓 안에서만 의미가 있고 일반 채널에서는 실행되면 안 될 때 사용하세요.

## 권한

각 명령어에는 권한 섹션이 있습니다:

* **모든 스태프 허용**, 그래서 서버 전반의 지원 역할을 가진 사람이라면 누구나 명령어를 사용할 수 있습니다.
* 또는 역할 선택기로 선택한 특정 역할입니다.

명령어를 사용하려고 서버 관리자가 될 필요는 없습니다. 허용된 역할만 있으면 충분합니다.

## 관련

{% content-ref url="/pages/e525fd14e9ae7e243b198f8ac4cac05e584b5a5a" %}
[커스텀 명령어 만들기](/docs/ko/custom-commands/creating-a-command.md)
{% endcontent-ref %}

{% 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 %}

{% content-ref url="/pages/63ae2173d6c8d53bd4f2dc7bca2e3c8ab96a4135" %}
[제한](/docs/ko/custom-commands/limits.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/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.