> ## 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.

# Resumen de tickets

> Configura el panel privado de soporte de Headless, conoce sus límites y prueba el flujo antes de anunciarlo.

El sistema de Tickets permite que los miembros contacten al equipo en privado. Un botón del panel abre un canal privado con un formulario breve y controles para el equipo.

## Qué ofrece Tickets

Headless mantiene un panel por servidor. Desde ese panel, cada miembro puede abrir una conversación privada; el equipo puede reclamarla, generar un transcript y cerrarla.

> [!NOTE]
>
> La configuración es por servidor, no por panel. Headless no ofrece varios paneles, un menú desplegable de categorías ni formularios reutilizables.

> **Límites**
>
> * Un panel por servidor.
> * De `1–10` tickets abiertos simultáneamente por miembro; el valor inicial es 2.
> * Hasta 25 roles de soporte.
> * Hasta 4 enlaces HTTPS adicionales en el panel.
> * Los transcripts incluyen `25–5.000` mensajes; el valor inicial es 500.
> * El canal cerrado se elimina entre 0 y 86.400 segundos después; el valor inicial es 10 segundos.

> **Mensajes y transcripts**
>
> * El panel admite un mensaje de apertura configurable y menciones opcionales al solicitante o al equipo.
> * Los textos y etiquetas predeterminados se muestran en inglés. Headless actualiza los valores predeterminados antiguos reconocidos; conserva los textos personalizados guardados.
> * El motivo inicial se solicita en un modal de forma predeterminada. El Dashboard permite desactivar ese requisito.
> * Puedes configurar un mensaje para el canal privado y un canal explícito para logs y transcripts.
> * `.ticket transcript` genera un archivo de texto cuando el ticket y el canal de logs cumplen los requisitos.

> **Roles y privacidad**
>
> * Los roles de soporte configurados pueden ver y reclamar tickets.
> * Cada ticket es un canal privado con permisos de canal; configura el rol y la posición del bot para que pueda crear el canal y sus permisos.
> * Restringe el canal de logs: los transcripts pueden incluir mensajes, identificadores y enlaces de adjuntos.
> * Headless no ofrece una lista de bloqueo de tickets ni comandos para añadir participantes manualmente.

> **Ciclo de vida y automatización**
>
> * El flujo disponible es abrir, reclamar, transcribir y cerrar.
> * Al cerrar, Headless conserva el registro y programa la eliminación del canal según el retraso configurado. Un retraso de `0` elimina el canal inmediatamente.
> * No hay recordatorios por inactividad, cierre automático por inactividad, cierre al salir del servidor, reapertura ni traslado entre categorías.

> **Panel y apariencia**
>
> * El panel usa un botón para abrir el formulario; no tiene modo de botones múltiples ni menú desplegable.
> * Puedes ajustar el color de acento, el mensaje de apertura, una miniatura, una imagen o un GIF.
> * Se permiten hasta cuatro botones adicionales con enlaces HTTPS. No son opciones para crear distintos tipos de ticket.

## Configuración rápida

Sigue estos pasos para publicar el panel y comprobar los permisos antes de abrirlo a toda la comunidad.

> [!NOTE]
>
> Los comandos de configuración requieren `Manage Channels` (o una Fake Permission compatible si está configurada). Headless también necesita sus permisos nativos de Discord; las Fake Permissions no sustituyen esos permisos del bot.

**1. Elige los canales**

Selecciona un canal de texto visible para publicar el panel y, opcionalmente, una categoría donde crear tickets privados.

**2. Ejecuta el setup**

Usa `.ticket setup #panel [#categoría]`. El comando activa Tickets, guarda los destinos, publica el panel y muestra un diagnóstico de permisos.

**3. Añade el equipo**

Configura uno o más roles con `.ticket role @soporte`. Cada rol configurado obtiene acceso al canal privado del ticket.

**4. Configura los registros**

Usa `.ticket log #ticket-logs` para fijar el destino de logs y transcripts; comprueba que solo el personal autorizado pueda verlo.

**5. Prueba el recorrido**

Abre un ticket de prueba, revisa el motivo inicial y los permisos del canal, reclama el ticket, genera un transcript y ciérralo.

> [!WARNING]
>
> El setup puede publicar el panel y mostrar `REVISAR` si detecta permisos pendientes. Resuelve el diagnóstico y prueba la creación de un canal privado; que el panel se haya publicado no garantiza que las acciones posteriores vayan a funcionar.

## Sintaxis y ejemplo

```headless-command Syntax theme={null}
.ticket setup <panel_channel> [category]
```

```headless-command Example theme={null}
.ticket setup #ayuda #tickets
```

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

```headless-command Example theme={null}
.ticket role @Soporte
```

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

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

> [!TIP]
>
> Prueba primero el panel con una cuenta sin permisos de administración. Así confirmas que el miembro puede abrir un ticket y que los demás no pueden ver su canal privado.

## Siguientes pasos

> **[Comandos y permisos](/docs/server/tickets/commands.md)**
>
> Consulta el acceso requerido para configurar y gestionar tickets.

> **[Paneles](/docs/server/tickets/panels.md)**
>
> Revisa el panel de apertura, los controles y su publicación.

> **[Formularios](/docs/server/tickets/forms.md)**
>
> Comprueba qué datos solicita el formulario inicial.

> **[Ciclo de vida](/docs/server/tickets/lifecycle.md)**
>
> Sigue un ticket desde su apertura hasta el cierre y la eliminación.


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