> 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/es/comandos-personalizados/creating-a-command.md).
# Crear un comando personalizado
:crown: **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, disparador, opciones y permisos).
## 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 cuando te acercas al límite.
* Admite el formato markdown de Discord.
* Tiene un selector de emojis integrado.
* Cuando el comando está **Solo tickets**activado, 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 cada 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).
* En todos los embeds de un comando: hasta 6000 caracteres en total.
Cuando **Solo tickets** 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 agregar **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 comience con http\:// o https\:// (hasta 512 caracteres). Un botón puede usar solo un emoji sin etiqueta.
Son útiles 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.
### Disparador del comando
El texto que escriben los usuarios 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 funciona. 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 disparador no hace nada. |
| **Solo tickets** | interruptor | Desactivado | Cuando está activado, el comando se activa solo dentro de los 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 disparador del usuario después de responder. |
| **Responder al mensaje del comando** | interruptor | Activado | Cuando está activado, la respuesta del bot es una respuesta 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 en 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 que pueden 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 disparador del comando es obligatorio"*
* *"El comando debe tener contenido o al menos un embed"*
* *"El nombre del comando ya existe"*
* *"El disparador del comando ya existe"*
## Marcadores de posición (modo Solo ticket)
Cuando **Solo tickets** está activado, estos marcadores de posición se completan cuando se activa el comando:
| Marcador de posición | Se completa 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 se muestra 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
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, and the optional `goal` query parameter:
```
GET https://ticketking.xyz/docs/es/comandos-personalizados/creating-a-command.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.