# Crear un comando personalizado

<i class="fa-crown">:crown:</i> **Función premium.** En el panel, abre **Comandos personalizados**, luego **+ Nuevo comando** para abrir el creador.

El creador tiene dos paneles. El **panel izquierdo** es donde construyes la respuesta (el contenido del mensaje, los embeds y los botones). El **panel derecho** contiene la configuración del comando (nombre, activador, opciones y permisos).

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

## Panel izquierdo, la respuesta

El panel izquierdo es donde construyes lo que envía el comando. Hay tres pestañas.

### Pestaña de contenido de texto

Un editor de varias líneas para la respuesta del bot.

* Límite: 2000 caracteres. Se muestra un contador y se vuelve rojo a medida que te acercas al límite.
* Admite Markdown de Discord.
* Incluye un selector de emoji en línea.
* Cuando el comando está **Solo ticket**, los marcadores de posición de ticket funcionan aquí (consulta la sección de Marcadores de posición más abajo).

Texto de ayuda: *"El contenido es opcional si se proporciona al menos un embed."*

### Pestaña de embeds

Hasta 10 embeds. Abre el **Diseñador de embeds** para editar cada uno. Es el mismo diseñador que se usa en otras partes del panel.

* Por embed: título (256), descripción (4096), pie de página (2048), autor (256), un color, una imagen, una miniatura y hasta 25 campos (nombre del campo 256, valor del campo 1024).
* Entre todos los embeds de un comando: hasta 6000 caracteres en total.

Cuando **Solo ticket** está activado, los campos de texto del embed también admiten marcadores de posición de ticket.

Un botón "Eliminar todo" elimina todos los embeds a la vez, con un paso de confirmación.

### Pestaña de vista previa de la respuesta

Una vista previa en vivo de cómo se verá la respuesta en Discord, para que puedas comprobar el formato antes de guardar.

### Botones de enlace

Dentro de los embeds puedes añadir **botones de enlace**. Estos son solo botones de enlace.

* Hasta 5 filas de hasta 5 botones cada una.
* Cada botón necesita una etiqueta (hasta 80 caracteres) y una URL que empiece con http\:// o https\:// (hasta 512 caracteres). Un botón puede usar solo un emoji sin etiqueta.

Esto es útil para patrones como "Aquí está nuestra política de reembolsos" con un botón que abre la página.

## Panel derecho, la configuración

### Nombre del comando

Un cuadro de texto que nombra el comando en tu panel. **Los usuarios no ven esto.**

* Marcador de posición: `Ticket incorrecto`
* Texto de ayuda: *"Se usa solo para identificar este comando en tu panel. Los usuarios no lo verán."*
* Requerido.
* Se convierte automáticamente a minúsculas.
* Debe ser único en tu servidor.

### Activador del comando

El texto que los usuarios escriben para activar el comando.

* Marcador de posición: `!wrongticket`
* Texto de ayuda: *"El texto que los usuarios escribirán para activar este comando."*
* Requerido.
* Se convierte automáticamente a minúsculas.
* Debe ser único en tu servidor.

No tienes que usar un `!` prefijo. Cualquier texto sirve. Elige un estilo y úsalo en todos tus comandos para que tu personal pueda recordarlos.

### Opciones

| Campo                                | Tipo        | Predeterminado | Comportamiento                                                                                                                                                    |
| ------------------------------------ | ----------- | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Comando activado**                 | interruptor | Activado       | Cuando está desactivado, escribir el activador no hace nada.                                                                                                      |
| **Solo ticket**                      | interruptor | Desactivado    | Cuando está activado, el comando solo se ejecuta dentro de canales de ticket, y los marcadores de posición de ticket funcionan en la respuesta.                   |
| **Eliminar mensaje del comando**     | interruptor | Desactivado    | Cuando está activado, el bot elimina el mensaje activador del usuario después de responder.                                                                       |
| **Responder al mensaje del comando** | interruptor | Activado       | Cuando está activado, la respuesta del bot es una contestación al mensaje del usuario. Esta opción está oculta cuando Eliminar mensaje del comando está activado. |

### Permisos

| Campo                                                                      | Tipo              | Comportamiento                                                                                    |
| -------------------------------------------------------------------------- | ----------------- | ------------------------------------------------------------------------------------------------- |
| **Permitir a todo el personal**                                            | interruptor       | Cuando está activado, cualquiera con un rol de soporte de todo el servidor puede usar el comando. |
| **Roles** (se muestra cuando Permitir a todo el personal está desactivado) | selector de roles | Los roles específicos a los que se les permite usar este comando.                                 |

## Validación

El botón Guardar permanece deshabilitado hasta que el comando sea válido. Mensajes comunes:

* *"El nombre del comando es obligatorio"*
* *"El activador del comando es obligatorio"*
* *"El comando debe tener contenido o al menos un embed"*
* *"El nombre del comando ya existe"*
* *"El activador del comando ya existe"*

## Marcadores de posición (modo Solo ticket)

Cuando **Solo ticket** está activado, estos marcadores de posición se rellenan cuando se ejecuta el comando:

| Marcador de posición | Rellenado con                          |
| -------------------- | -------------------------------------- |
| `{USER}`             | Una mención del autor del ticket       |
| `{TICKET_NUMBER}`    | El número del ticket                   |
| `{TYPE}`             | La etiqueta de la opción del panel     |
| `{USER_ID}`          | El ID de Discord del autor del ticket  |
| `{USER_NAME}`        | El nombre visible del autor del ticket |
| `{GUILD_NAME}`       | El nombre de tu servidor               |
| `{CREATED_AT}`       | La hora de creación del ticket         |

Un marcador de posición sin valor aparece como `N/D`. Los comandos que no son Solo ticket no admiten marcadores de posición.

## Guardando

Haz clic en **Guardar**. El comando se activa de inmediato. El registro de auditoría registra que el comando fue creado.

## Relacionado

{% content-ref url="/pages/aa37b20f75846f72ae549c3466d0d47f6da32265" %}
[Editar y eliminar comandos](/docs/es/comandos-personalizados/editing-and-deleting.md)
{% endcontent-ref %}

{% content-ref url="/pages/ce89440e74214d9b19bbad7c5993b29dc5d19f7b" %}
[Casos de uso](/docs/es/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/es/comandos-personalizados/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.
