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

# Opciones de tickets

> Valores iniciales, límites efectivos, controles del Dashboard y opciones de Tickets que Headless no implementa.

La configuración se guarda por servidor. La mayoría de los ajustes se cambian desde el Dashboard autenticado; el retraso de borrado también tiene un comando prefix. `.ticket setup` activa Tickets y deja `require_reason` en `true`.

## Ajustes y límites efectivos

> **Detalles de referencia**
>
> * **`enabled`** — **Valor inicial:** Desactivado hasta el setup · **Límite o comportamiento efectivo:** `.ticket setup` activa el módulo.
> * **`max_open_per_user`** — **Valor inicial:** 2 · **Límite o comportamiento efectivo:** De 1 a 10 tickets abiertos por miembro.
> * **`require_reason`** — **Valor inicial:** Desactivado antes del setup; activado por setup · **Límite o comportamiento efectivo:** El Dashboard puede desactivar el modal de motivo.
> * **`transcript_enabled`** — **Valor inicial:** Activado · **Límite o comportamiento efectivo:** Apagado impide transcripts a petición y al cerrar.
> * **`transcript_limit`** — **Valor inicial:** 500 mensajes · **Límite o comportamiento efectivo:** De 25 a 5.000 mensajes recientes.
> * **`close_delete_seconds`** — **Valor inicial:** 10 segundos · **Límite o comportamiento efectivo:** De 0 a 86.400; 0 solicita borrado inmediato tras cerrar.
> * **`dm_user_on_close`** — **Valor inicial:** Activado · **Límite o comportamiento efectivo:** DM de cierre opcional; el envío es best-effort.
> * **`mention_user`, `mention_staff`** — **Valor inicial:** Ambos activados · **Límite o comportamiento efectivo:** Controles separados para solicitante y roles de soporte.
> * **Roles de soporte** — **Valor inicial:** Ninguno · **Límite o comportamiento efectivo:** Hasta 25 por servidor.
> * **Enlaces extra del panel** — **Valor inicial:** Ninguno · **Límite o comportamiento efectivo:** Hasta cuatro enlaces HTTPS.

El Dashboard permite cambiar capacidad, requisito del modal, transcripts, DM y menciones, mensajes, etiquetas, medios y color. `.ticket close-delay [segundos=10]` configura el retraso de borrado. `.ticket log #canal` es un destino separado y obligatorio para enviar transcripts; el canal del panel no es un fallback.

> [!NOTE]
>
> El selector numérico actual del Dashboard anuncia 50–10.000 para `transcript_limit`, pero el runtime normaliza el valor efectivo a 25–5.000. Usa el rango efectivo; guardar un número fuera de él no amplía la transcripción.

## Pasos de configuración

**1. Define la capacidad**

Elige `max_open_per_user` entre 1 y 10 según la carga del equipo.

**2. Elige el modal**

Mantén `require_reason` activo para recopilar contexto o desactívalo en el Dashboard si quieres abrir sin esos campos fijos.

**3. Protege los transcripts**

Habilítalos solo con un canal de logs restringido, limita el historial y prueba el acceso al archivo enviado.

**4. Decide el cierre**

Configura el retraso con `.ticket close-delay [segundos=10]` y comprueba que la eliminación sirve a tus requisitos de retención.

## Entrega de transcripts

`.ticket transcript` crea un archivo de texto con hasta `transcript_limit` mensajes recientes. Tickets y transcripts deben estar habilitados y debe existir un canal de logs válido. Al cerrar, Headless intenta crear y enviar el archivo antes de concluir; el registro del ticket permanece cerrado si falla la generación, el canal de logs o el envío.

### Configura el destino de logs

```headless-command Syntax theme={null}
.ticket log <channel>
```

```headless-command Example theme={null}
.ticket log #ticket-logs
```

### Solicita un transcript

```headless-command Syntax theme={null}
.ticket transcript
```

```headless-command Example theme={null}
.ticket transcript
```

## Configura el retraso de borrado

El retraso inicial es de 10 segundos; el rango aceptado es 0–86.400 segundos. `0` solicita borrar de inmediato el canal cerrado. El registro del ticket permanece en almacenamiento por servidor después de eliminarse el canal de Discord.

```headless-command Syntax theme={null}
.ticket close-delay [seconds=10]
```

```headless-command Example theme={null}
.ticket close-delay 3600
```

> [!WARNING]
>
> Un retraso de cero solicita el borrado inmediato. El registro almacenado no conserva el canal eliminado ni sus mensajes de Discord.

## Funciones que no se implementan

No hay recordatorios por inactividad, auto-cierre por inactividad, borrado automático en un temporizador separado, ajustes por opción, categoría de desborde, varios paneles ni límites de formularios reutilizables.

## Páginas relacionadas

* [Formularios](/docs/server/tickets/forms.md)
* [Ciclo de vida](/docs/server/tickets/lifecycle.md)
* [Mensajes](/docs/server/tickets/messages.md)


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