> For the complete documentation index, see [llms.txt](https://ticketking.xyz/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ticketking.xyz/docs/pt-br/comandos-personalizados/creating-a-command.md).

# Criando um comando personalizado

Cada campo no criador de comando personalizado.

<i class="fa-crown">:crown:</i> **Recurso Premium.** No painel, abra **Comandos Personalizados**, depois **+ Novo Comando** para abrir o criador.

O criador tem dois painéis. O **painel esquerdo** é onde você monta a resposta (o conteúdo da mensagem, embeds e botões). O **painel direito** contém as configurações do comando (nome, gatilho, opções e permissões).

<figure><img src="https://2122257628-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrnuG1qjzbOoh0efVpoK8%2Fuploads%2Fgit-blob-f073408c18f40041bd51b74c75710d75fda5958e%2Fcustom-command-creator.png?alt=media" alt="The custom-command creator open showing both panes"><figcaption></figcaption></figure>

## Painel esquerdo, a resposta

O painel esquerdo é onde você constrói o que o comando envia. Há três abas.

### Aba Conteúdo de Texto

Um editor de várias linhas para a resposta do bot.

* Limite: 2000 caracteres. Um contador é exibido e fica vermelho à medida que você se aproxima do limite.
* Suporta markdown do Discord.
* Tem um seletor de emoji embutido.
* Quando o comando está **Somente Ticket**, os placeholders de ticket funcionam aqui (veja a seção de Placeholders abaixo).

Texto de ajuda: *"O conteúdo é opcional se pelo menos um embed for fornecido."*

### Aba de Embeds

Até 10 embeds. Abra o **Designer de Embed** para editar cada um. É o mesmo designer usado em outras partes do painel.

* Por embed: título (256), descrição (4096), rodapé (2048), autor (256), uma cor, uma imagem, uma miniatura e até 25 campos (nome do campo 256, valor do campo 1024).
* Em todos os embeds em um comando: até 6000 caracteres no total.

Quando **Somente Ticket** está ativado, os campos de texto do embed também aceitam placeholders de ticket.

Um botão "Excluir Tudo" remove todos os embeds de uma vez, com uma etapa de confirmação.

### Aba de Pré-visualização da Resposta

Uma pré-visualização ao vivo de como a resposta ficará no Discord, para que você possa conferir a formatação antes de salvar.

### Botões de link

Dentro dos embeds, você pode adicionar **botões de link**. Esses são apenas botões de link.

* Até 5 linhas com até 5 botões cada.
* Cada botão precisa de um rótulo (até 80 caracteres) e uma URL começando com http\:// ou https\:// (até 512 caracteres). Um botão pode usar apenas um emoji, sem rótulo.

Isso é útil para padrões como "Aqui está nossa política de reembolso" com um botão que abre a página.

## Painel direito, as configurações

### Nome do Comando

Uma caixa de texto que nomeia o comando no seu painel. **Os usuários não veem isso.**

* Placeholder: `Ticket Incorreto`
* Texto de ajuda: *"Usado apenas para identificar este comando no seu painel. Os usuários não vão vê-lo."*
* Obrigatório.
* Convertido automaticamente para minúsculas.
* Deve ser único no seu servidor.

### Gatilho do Comando

O texto que os usuários digitam para acionar o comando.

* Placeholder: `!wrongticket`
* Texto de ajuda: *"O texto que os usuários digitarão para acionar este comando."*
* Obrigatório.
* Convertido automaticamente para minúsculas.
* Deve ser único no seu servidor.

Você não precisa usar um `!` prefixo. Qualquer texto funciona. Escolha um estilo e use-o em todos os seus comandos para que sua equipe possa se lembrar deles.

### Opções

| Campo                               | Tipo        | Padrão     | Comportamento                                                                                                                                   |
| ----------------------------------- | ----------- | ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| **Comando Ativado**                 | alternância | Ativado    | Quando desativado, digitar o gatilho não faz nada.                                                                                              |
| **Somente Ticket**                  | alternância | Desativado | Quando ativado, o comando é executado somente dentro de canais de ticket, e os placeholders de ticket funcionam na resposta.                    |
| **Excluir Mensagem do Comando**     | alternância | Desativado | Quando ativado, o bot exclui a mensagem de gatilho do usuário depois de responder.                                                              |
| **Responder à Mensagem do Comando** | alternância | Ativado    | Quando ativado, a resposta do bot é uma resposta à mensagem do usuário. Esta opção fica oculta quando Excluir Mensagem do Comando está ativado. |

### Permissões

| Campo                                                                | Tipo              | Comportamento                                                                                     |
| -------------------------------------------------------------------- | ----------------- | ------------------------------------------------------------------------------------------------- |
| **Permitir Toda a Equipe**                                           | alternância       | Quando ativado, qualquer pessoa com uma função de suporte em todo o servidor pode usar o comando. |
| **Funções** (mostrado quando Permitir Toda a Equipe está desativado) | seletor de função | As funções específicas permitidas a usar este comando.                                            |

## Validação

O botão Salvar permanece desativado até que o comando seja válido. Mensagens comuns:

* *"O nome do comando é obrigatório"*
* *"O gatilho do comando é obrigatório"*
* *"O comando deve ter conteúdo ou pelo menos um embed"*
* *"O nome do comando já existe"*
* *"O gatilho do comando já existe"*

## Placeholders (modo Somente Ticket)

Quando **Somente Ticket** está ativado, estes placeholders são preenchidos quando o comando é executado:

| Placeholder       | Preenchido com                        |
| ----------------- | ------------------------------------- |
| `{USER}`          | Uma menção ao autor do ticket         |
| `{TICKET_NUMBER}` | O número do ticket                    |
| `{TYPE}`          | O rótulo da opção do painel           |
| `{USER_ID}`       | O ID do Discord do autor do ticket    |
| `{USER_NAME}`     | O nome de exibição do autor do ticket |
| `{GUILD_NAME}`    | Nome do seu servidor                  |
| `{CREATED_AT}`    | O horário de criação do ticket        |

Um placeholder sem valor aparece como `N/D`, escrito no idioma do seu servidor. Comandos que não são Somente Ticket não suportam placeholders.

## Salvando

Clique em **Salvar**. O comando fica ativo imediatamente. O registro de auditoria registra que o comando foi criado.

## Relacionados

{% content-ref url="/pages/3f5d920d3cbe46be20159cd42a7090289d45e92b" %}
[Editando e excluindo comandos](https://ticketking.xyz/docs/pt-br/comandos-personalizados/editing-and-deleting.md)
{% endcontent-ref %}

{% content-ref url="/pages/137ed7788e72ce250016f0604f56d5b20271b133" %}
[Casos de uso](https://ticketking.xyz/docs/pt-br/comandos-personalizados/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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://ticketking.xyz/docs/pt-br/comandos-personalizados/creating-a-command.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
