# Criando um comando personalizado
:crown: **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).
## Painel esquerdo, a resposta
O painel esquerdo é onde você monta 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 conforme você se aproxima do limite.
* Suporta markdown do Discord.
* Tem um seletor de emoji embutido.
* Quando o comando está **Apenas Ticket**, os placeholders de ticket funcionam aqui (veja a seção Placeholders abaixo).
Texto de ajuda: *"O conteúdo é opcional se pelo menos um embed for fornecido."*
### Aba Embeds
Até 10 embeds. Abra o **Designer de Embeds** 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 de um comando: até 6000 caracteres no total.
Quando **Apenas Ticket** está ativado, os campos de texto do embed também suportam placeholders de ticket.
Um botão "Excluir tudo" remove todos os embeds de uma vez, com uma etapa de confirmação.
### Aba Pré-visualizar Resposta
Uma prévia em tempo real de como a resposta ficará no Discord, para que você possa verificar a formatação antes de salvar.
### Botões de link
Dentro dos embeds, você pode adicionar **botões de link**. Estes 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 que comece 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 Errado`
* Texto de ajuda: *"Usado apenas para identificar este comando no seu painel. Os usuários não verão isso."*
* Obrigatório.
* Convertido automaticamente para minúsculas.
* Precisa 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.
* Precisa 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. |
| **Apenas Ticket** | alternância | Desativado | Quando ativado, o comando só é acionado 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 um cargo de suporte em todo o servidor pode usar o comando. |
| **Cargos** (mostrado quando Permitir Toda a Equipe está desativado) | seletor de cargos | Os cargos específicos permitidos 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 Apenas Ticket)
Quando **Apenas Ticket** está ativado, estes placeholders são preenchidos quando o comando é acionado:
| Espaço reservado | 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}` | O nome do seu servidor |
| `{CREATED_AT}` | A hora de criação do ticket |
Um placeholder sem valor aparece como `N/D`. Comandos que não são Apenas 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](/docs/pt-br/comandos-personalizados/editing-and-deleting.md)
{% endcontent-ref %}
{% content-ref url="/pages/137ed7788e72ce250016f0604f56d5b20271b133" %}
[Casos de uso](/docs/pt-br/comandos-personalizados/use-cases.md)
{% endcontent-ref %}
---
# Agent Instructions: 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/pt-br/comandos-personalizados/creating-a-command.md?ask=
```
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.