> ## Documentation Index
> Fetch the complete documentation index at: https://wiki.petto.sbs/llms.txt
> Use this file to discover all available pages before exploring further.

# Configura un sistema de tickets

> Arma un panel de soporte paso a paso: publícalo, agrega categorías con sus propios roles de staff y nombres, y pruébalo, o deja que !ticket setup lo haga con menús.

Un recorrido completo por el módulo de [Tickets](https://wiki.petto.sbs/es/community/tickets.md), armando un sistema de soporte con dos categorías.

> [!TIP]
>
> ¿Tienes prisa? `!ticket setup` hace todo esto con menús y botones en un solo panel: el canal, los roles de soporte, el canal de registros, el texto y los tipos de ticket. Los pasos de abajo muestran qué hace cada parte a mano.

**1. Crea una categoría de canales y un canal para el panel**

Crea una categoría de canales de Discord (p. ej. "Tickets") donde se crearán los canales de los tickets, y un canal de texto (p. ej. `#support`) donde vivirá el mensaje del panel.

**2. Publica el panel**

```javascript theme={null}
!ticket panel create #support "¿Necesitas ayuda?" "Elige una categoría abajo" --style button
```

Esto devuelve un `panel_id`, lo vas a necesitar para cada categoría que agregues.

![liam escribe !ticket panel create #soporte con un título, un texto y el estilo de botones; Petto publica la tarjeta ¿Necesitas ayuda? y responde que el panel 1 se publicó y cómo agregar categorías](https://mintcdn.com/wikipetto/aURko5p8En80OELa/images/discord/guides/es/ticket-system-setup-step-2.webp?fit=max\&auto=format\&n=aURko5p8En80OELa\&q=85\&s=550f444e4d381b9239a887d05d6b4a0e)

En Discord: el panel publicado en #soporte, sin botones hasta que tenga categorías.

**3. Agrega tu primera categoría**

```javascript theme={null}
!ticket category add 1 support "Soporte general" "Tickets" @Staff 🎫
```

`key` (aquí `support`) es como te vas a referir a esta categoría en todos los demás comandos, y `parent` es la categoría de canales donde se crean los canales de los tickets nuevos.

![El panel ahora tiene un botón Soporte general; liam escribió !ticket category add 1 support con la categoría de canales Tickets y @Staff, y Petto responde que la categoría support se agregó al panel 1](https://mintcdn.com/wikipetto/aURko5p8En80OELa/images/discord/guides/es/ticket-system-setup-step-3.webp?fit=max\&auto=format\&n=aURko5p8En80OELa\&q=85\&s=2c018cd980058a351f7c3c00ac9a17b6)

En Discord: la primera categoría: el panel recibe su botón.

**4. Agrega una segunda categoría**

```javascript theme={null}
!ticket category add 1 billing Facturación "Tickets" @Finance 💳
```

Un panel con estilo `button` admite hasta 5 categorías; cambia `style` a `select` al crear el panel si necesitas más (hasta 25, como menú desplegable en vez de botones).

![El panel ahora tiene los botones Soporte general y Facturación; liam escribió !ticket category add 1 billing con @Finance, y Petto responde que la categoría billing se agregó al panel 1](https://mintcdn.com/wikipetto/aURko5p8En80OELa/images/discord/guides/es/ticket-system-setup-step-4.webp?fit=max\&auto=format\&n=aURko5p8En80OELa\&q=85\&s=00cac74a6d0fb65ba2e050c4c4ff85a8)

En Discord: la segunda categoría, junto a la primera.

**5. Agrega más roles, si uno no alcanza**

```javascript theme={null}
!ticket support-role add support @Trainee
!ticket ping-role add support @on-call
```

`support-role` controla quién puede ver y gestionar los tickets de la categoría, y `ping-role` controla a quién se menciona cuando se abre uno; no tienen que coincidir.

![liam agrega @Trainee como rol de soporte y @on-call como rol a mencionar de support, y Petto confirma cada uno](https://mintcdn.com/wikipetto/aURko5p8En80OELa/images/discord/guides/es/ticket-system-setup-step-5.webp?fit=max\&auto=format\&n=aURko5p8En80OELa\&q=85\&s=a0d0bf1b021a7badc54295c177a3ce3c)

En Discord: un rol de soporte más y un rol a mencionar para support.

**6. Define un patrón de nombres (opcional)**

```javascript theme={null}
!ticket category edit support --naming ticket-{number}
```

Admite `{number}`, `{username}`, `{userid}` y `{category}`, y por defecto es `ticket-{number}`. Mira las [variables de tickets](https://wiki.petto.sbs/es/resources/scripting/variables.md#tickets).

![liam escribe !ticket category edit support --naming ticket-\{number} y Petto responde que la categoría support se actualizó](https://mintcdn.com/wikipetto/aURko5p8En80OELa/images/discord/guides/es/ticket-system-setup-step-6.webp?fit=max\&auto=format\&n=aURko5p8En80OELa\&q=85\&s=6487aab8e9b08635e9cd2245a744c4d5)

En Discord: el patrón de nombres de support.

**7. Pruébalo tú mismo**

Haz clic en tu propio panel. Una vez dentro, usa `!ticket claim` para tomarlo y `!ticket close "Probando"` para cerrarlo y generar un enlace a la transcripción.

![Debajo del panel Petto responde solo a liam: Ticket abierto: #ticket-0001](https://mintcdn.com/wikipetto/aURko5p8En80OELa/images/discord/guides/es/ticket-system-setup-step-7-open.webp?fit=max\&auto=format\&n=aURko5p8En80OELa\&q=85\&s=a4d146b9e1c37e4b5f4e3baf91b01d2f)

En Discord: liam presiona Soporte general en su propio panel.

![En #ticket-0001 la tarjeta de bienvenida menciona a @on-call; liam escribe !ticket claim y Petto publica Ticket reclamado, luego !ticket close Probando y Petto publica Ticket 0001 cerrado con Reabrir, Borrar y Ver transcript](https://mintcdn.com/wikipetto/aURko5p8En80OELa/images/discord/guides/es/ticket-system-setup-step-7.webp?fit=max\&auto=format\&n=aURko5p8En80OELa\&q=85\&s=21449a01d9974236eb1c1620e505bab9)

En Discord: dentro del ticket de prueba: la bienvenida menciona a @on-call, y luego reclamar y cerrar.

![liam publica el panel en #soporte: ¿Necesitas ayuda?, Elige una categoría abajo, y los botones Soporte general y Pagos](https://mintcdn.com/wikipetto/ym43wKcqHRA_RnWi/images/discord/guides/es/ticket-panel.webp?fit=max\&auto=format\&n=ym43wKcqHRA_RnWi\&q=85\&s=bce5277a639922a4842705e9d80a7d8b)

En Discord: el panel de esta guía con sus dos categorías.

## Usar un embed guardado para el panel o el mensaje de bienvenida

En vez de un `title`/`description` simple, `!ticket panel create` toma el nombre de un embed guardado con `--embed_template`, y `!ticket category add` (y `edit`) toma uno para el mensaje de bienvenida con `--welcome_embed`; mira [Embeds](https://wiki.petto.sbs/es/resources/scripting/embeds.md) para ver cómo crear uno primero.

![liam escribe !ticket panel create #soporte --embed\_template support-panel y Petto publica el embed Soporte de Petto Land y responde que el panel 1 se publicó](https://mintcdn.com/wikipetto/aURko5p8En80OELa/images/discord/guides/es/ticket-system-setup-embed.webp?fit=max\&auto=format\&n=aURko5p8En80OELa\&q=85\&s=8e8286a2efb8d98a9da2c3a72b0ae7d1)

En Discord: un panel hecho con un embed guardado.

## Hacer preguntas antes de que se abra un ticket (opcional)

Una categoría puede usar un [formulario](https://wiki.petto.sbs/es/community/tickets.md#formularios): una ventana emergente que el miembro rellena al pulsar el botón, para que el primer mensaje ya traiga los detalles. Además de respuestas cortas puede tener opciones, casillas, un selector de miembro, rol o canal y una **subida de archivos** donde los miembros adjuntan imágenes (una captura del problema, por ejemplo). Las respuestas, con las imágenes dibujadas, se publican en el ticket nuevo y se guardan en la [transcripción](https://wiki.petto.sbs/es/community/tickets.md#transcripts).

```javascript theme={null}
!ticket form create bug "long_text|what|¿Qué pasó?||required;file|shot|Captura||optional|images,2" "Reportar un error"
!ticket category edit support --form bug
```

## Errores comunes

> [accordion] "Category key already in use"
>
> Petto responde "Ya existe una categoría con la clave `billing`." Petto responde "Ya existe una categoría con la clave `billing`." Petto responde "Ya existe una categoría con la clave `billing`." Petto responde "Ya existe una categoría con la clave `billing`." Petto responde "Ya existe una categoría con la clave `billing`." `key` tiene que ser único en todo el servidor, no solo en cada panel. Elige algo específico como `billing-eu` en vez de repetir `billing` en dos paneles.
>
> ![liam vuelve a escribir !ticket category add 1 billing y Petto responde que ya existe una categoría con la clave billing](https://mintcdn.com/wikipetto/aURko5p8En80OELa/images/discord/guides/es/ticket-system-setup-key-taken.webp?fit=max\&auto=format\&n=aURko5p8En80OELa\&q=85\&s=ab83e62655442cfdf58a35e521f969c7)
>
> En Discord: la clave billing ya está en uso.

> [accordion] El panel se publicó pero no tiene botones ni menú
>
> Necesitas al menos una categoría agregada al panel antes de que muestre elementos interactivos; un panel vacío es solo el título y la descripción.
>
> ![La tarjeta ¿Necesitas ayuda? con su texto y nada debajo](https://mintcdn.com/wikipetto/aURko5p8En80OELa/images/discord/guides/es/ticket-system-setup-empty-panel.webp?fit=max\&auto=format\&n=aURko5p8En80OELa\&q=85\&s=d6f18b966dd56c07bc7d155eb9e853a1)
>
> En Discord: un panel sin categorías todavía.

> [accordion] Un miembro no puede abrir un segundo ticket
>
> Eso es `max_open`, que por defecto es 1 por categoría. Súbelo con `!ticket category edit` si tu servidor quiere que los miembros tengan varios tickets abiertos a la vez.
>
> ![Debajo del panel Petto responde solo al miembro que ya tiene 1 ticket abierto en esta categoría (límite 1)](https://mintcdn.com/wikipetto/aURko5p8En80OELa/images/discord/guides/es/ticket-system-setup-second-ticket.webp?fit=max\&auto=format\&n=aURko5p8En80OELa\&q=85\&s=c09ed50313f073def1f5830f24ebebde)
>
> En Discord: un miembro con un ticket abierto vuelve a presionar el botón.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.