> For the complete documentation index, see [llms.txt](https://gubo.gitbook.io/gubo-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gubo.gitbook.io/gubo-docs/moderacion/tickets.md).

# Tickets Plugin

El plugin de Tickets proporciona un sistema profesional de soporte donde los usuarios pueden crear tickets privados para recibir asistencia del equipo de staff.

***

## 📑 Contenido

* [Características Principales](#caracteristicas-principales)
* [Configuración Inicial](#configuracion-inicial)
* [Uso para Usuarios](#uso-para-usuarios)
* [Gestión de Tickets](#gestion-de-tickets)
* [Sistema de Categorías](#sistema-de-categorias)
* [Sistema de Prioridad](#sistema-de-prioridad)
* [Transcripciones](#transcripciones)
* [Configuración Avanzada](#configuracion-avanzada)
* [Casos de Uso](#casos-de-uso)
* [Mejores Prácticas](#mejores-practicas)
* [Solución de Problemas](#solucion-de-problemas)

***

## 🎯 Características Principales

### Plan Free

* ✅ Botón para crear tickets
* ✅ Modal de motivo al abrir ticket
* ✅ Canal privado automático para cada ticket
* ✅ Una categoría de tickets (opcional)
* ✅ Botón para cerrar tickets
* ✅ Límite de tickets abiertos por usuario

### Plan Premium 💎

* ✅ **Todo lo del Plan Free**, más:
* ✅ **Múltiples categorías** con selector desplegable
* ✅ **Auto-asignación** de roles de soporte por categoría
* ✅ **Transcripciones automáticas** al cerrar (HTML completo)
* ✅ **Sistema de prioridad** basado en roles/economía
* ✅ **Canal de transcripciones** dedicado
* ✅ **Límite configurable** por usuario
* ✅ **Logs de tickets** con estadísticas

***

## 🚀 Configuración Inicial

### Paso 1: Activar el Plugin

1. Accede al **Dashboard** en <https://gubo.com.ar>
2. Selecciona tu servidor
3. Ve a la sección **Plugins**
4. Activa el plugin **Tickets**

### Paso 2: Crear el Botón de Tickets

Usa el comando `/ticket-create-button` en el canal donde quieras que aparezca el botón.

**Sintaxis:**

```
/ticket-create-button [mensaje]
```

**Parámetros:**

* `mensaje` (opcional): Mensaje personalizado sobre el botón

**Ejemplo:**

```
/ticket-create-button mensaje:¿Necesitas ayuda? Abre un ticket con el equipo de soporte
```

**Resultado:**

* Se crea un mensaje con un botón "🎫 Abrir Ticket"
* Los usuarios pueden hacer clic para crear su ticket

***

## 👥 Uso para Usuarios

### Cómo Abrir un Ticket

1. **Hacer clic en el botón** "🎫 Abrir Ticket"
2. **Seleccionar categoría** (si hay múltiples - 💎 Premium)
   * Aparece un menú desplegable
   * Elige la categoría que mejor describa tu problema
3. **Completar el modal**
   * Se abre una ventana emergente
   * Escribe una descripción breve de tu problema
   * Haz clic en "Enviar"
4. **Esperar creación**
   * El bot crea automáticamente un canal privado
   * Solo tú y el equipo de soporte pueden verlo
   * Recibes un mensaje de confirmación

### Qué Esperar

**En el canal del ticket:**

* Un mensaje de bienvenida del bot
* Información de tu ticket (categoría, razón)
* Etiqueta de prioridad (si aplica - 💎 Premium)
* Botón para cerrar el ticket cuando se resuelva

**Notificación al staff:**

* Los roles de soporte configurados son mencionados automáticamente
* Pueden ver todos los detalles de tu ticket

### Límite de Tickets

**Plan Free:**

* Máximo 3 tickets abiertos al mismo tiempo por usuario

**Plan Premium:**

* Límite configurable en el dashboard (1-10 tickets)

Si intentas abrir más tickets del límite, recibirás un mensaje indicándolo.

***

## 🛠️ Gestión de Tickets

### Para el Staff

#### Responder en un Ticket

Simplemente escribe mensajes en el canal del ticket. El usuario verá tus respuestas en tiempo real.

**Consejos:**

* Sé claro y profesional
* Usa embeds para información estructurada
* Adjunta imágenes si ayuda a explicar

#### Cerrar un Ticket

**Método 1: Botón**

* Haz clic en el botón "❌ Cerrar Ticket" en el canal

**Método 2: Eliminar canal**

* Elimina manualmente el canal del ticket
* El bot detecta la eliminación y registra el cierre

**Al cerrar:**

* Se genera una transcripción automática (💎 Premium)
* Se envía al canal de transcripciones configurado
* El canal se elimina
* Se actualiza el contador de tickets del usuario

#### Añadir Colaboradores

Menciona a otros miembros del staff en el ticket para que puedan ayudar:

```
Hola @OtroModerador, ¿puedes ayudar con este problema de permisos?
```

***

## 📁 Sistema de Categorías (💎 Premium)

Las categorías permiten organizar los tickets por tipo de soporte.

### Configurar Categorías

Desde el **Dashboard**:

1. Ve a **Tickets** > **Categorías y Canales**
2. Haz clic en S**eleccionar opción**
3. Elije las categorias de la lista que quieras usar
4. Selecciona el esquema para el nombre del ticket

### Ejemplos de Categorías

**Servidor de Gaming:**

* 🎮 Soporte de Juego
* 🐛 Reportar Bug
* 💡 Sugerencias
* 🚫 Reportar Usuario

**Servidor de Comunidad:**

* 🎫 Soporte General
* 👤 Verificación
* 📢 Colaboraciones
* ⚠️ Reportes

**Servidor de Ventas:**

* 🛒 Soporte de Compras
* 💳 Problemas de Pago
* 📦 Estado de Pedido
* 🔄 Devoluciones

### Ventajas de Múltiples Categorías

* ✅ Organización clara de problemas
* ✅ Staff especializado por categoría
* ✅ Diferentes roles de soporte según el tipo
* ✅ Mejor manejo de volumen de tickets

***

## ⭐ Sistema de Prioridad (💎 Premium)

Los tickets pueden tener prioridad automática basada en:

### 1. Roles VIP

Configura roles que dan prioridad:

* Moderadores
* Donadores
* Miembros VIP
* Boosters del servidor

**Efecto:** El ticket se marca con "🌟 PRIORIDAD: VIP"

### 2. Economía

Si el plugin de Economía está activo, los usuarios con más coins reciben prioridad automática.

**Configuración:**

* Umbral de coins en el dashboard
* Ejemplo: Usuarios con 1000+ coins = prioridad

### Cómo se Muestra

* Etiqueta visible en el canal del ticket
* Notificación destacada al staff
* Orden sugerido de atención (el staff decide)

***

## 📄 Transcripciones (💎 Premium)

Al cerrar un ticket, se genera automáticamente una transcripción completa.

### Contenido de la Transcripción

**Archivo HTML con:**

* 📅 Fecha y hora de apertura/cierre
* 👤 Usuario que abrió el ticket
* 📁 Categoría del ticket
* 📝 Motivo inicial
* 💬 Todos los mensajes intercambiados (con timestamps)
* 🖼️ Imágenes y adjuntos (enlaces)
* 👥 Participantes del ticket

### Canal de Transcripciones

**Configuración:**

1. Crea un canal privado para transcripciones
2. Configúralo en el dashboard
3. Solo moderadores/admins deben tener acceso

**Uso:**

* Historial completo de soporte
* Auditoría de atención al cliente
* Referencia para casos similares
* Evidencia en casos de reportes

***

## ⚙️ Configuración Avanzada

### En el Dashboard

#### Configuración General

| Opción                       | Descripción                                      | Predeterminado |
| ---------------------------- | ------------------------------------------------ | -------------- |
| **Plugin Habilitado**        | Activa/desactiva el sistema                      | Desactivado    |
| **Límite de Tickets**        | Máximo de tickets abiertos por usuario           | 3              |
| **Canal de Transcripciones** | Donde se envían las transcripciones (💎 Premium) | Ninguno        |

#### Configuración por Categoría (💎 Premium)

| Opción                    | Descripción                        |
| ------------------------- | ---------------------------------- |
| **Nombre**                | Nombre visible de la categoría     |
| **Emoji**                 | Emoji para el selector             |
| **Roles de Soporte**      | Roles mencionados al abrir ticket  |
| **Categoría Discord**     | Carpeta donde se crean los canales |
| **Mensaje de Bienvenida** | Mensaje personalizado al abrir     |

#### Sistema de Prioridad (💎 Premium)

| Opción                 | Descripción                     |
| ---------------------- | ------------------------------- |
| **Roles VIP**          | Roles que otorgan prioridad     |
| **Umbral de Economía** | Coins necesarios para prioridad |
| **Mostrar Etiqueta**   | Visible en el canal del ticket  |

***

## 💡 Casos de Uso

### 1. Servidor de Gaming

**Configuración:**

* Categorías: Soporte, Bugs, Ban Appeal
* Límite: 2 tickets por usuario
* Prioridad: Boosters + VIP

**Mensaje del botón:**

```
¿Problemas en el servidor? ¿Encontraste un bug?
Abre un ticket y el equipo te ayudará lo antes posible.
```

***

### 2. Servidor de Ventas/Servicios

**Configuración:**

* Categorías: Compras, Pagos, Soporte Técnico, Devoluciones
* Límite: 5 tickets por usuario (clientes pueden tener varios pedidos)
* Prioridad: Clientes frecuentes (por economía)
* Transcripciones: Sí (auditoría de ventas)

**Mensaje del botón:**

```
¿Necesitas ayuda con tu compra?
Nuestro equipo de soporte está aquí para ti 24/7
```

***

### 3. Servidor de Comunidad

**Configuración:**

* Categorías: Soporte General, Verificación, Reportes, Sugerencias
* Límite: 3 tickets por usuario
* Prioridad: Moderadores + Patreons

**Mensaje del botón:**

```
¿Dudas o sugerencias? ¿Necesitas reportar algo?
Crea un ticket privado con el equipo de moderación
```

***

### 4. Servidor Educativo

**Configuración:**

* Categorías: Ayuda con Tareas, Dudas de Clase, Soporte Técnico
* Límite: 5 tickets por estudiante
* Sin prioridad (todos iguales)

**Mensaje del botón:**

```
¿Necesitas ayuda con la tarea o tienes dudas?
Abre un ticket y un tutor te ayudará
```

***

## ✅ Mejores Prácticas

### Para Usuarios

1. **Sé específico en el motivo**
   * Describe claramente tu problema
   * Incluye detalles relevantes
   * Menciona pasos que ya intentaste
2. **Un problema por ticket**
   * No mezcles múltiples problemas
   * Si tienes varios problemas, abre varios tickets
3. **Sé paciente**

* El staff responderá cuando esté disponible
  * No envíes múltiples mensajes esperando respuesta
  * No abras tickets duplicados

4. **Cierra el ticket cuando esté resuelto**
   * Haz clic en el botón de cerrar
   * Libera espacio para otros usuarios

### Para el Staff

1. **Responde rápido**
   * Reconoce el ticket aunque no puedas resolverlo de inmediato
   * Informa tiempos estimados de resolución
2. **Sé profesional**
   * Mantén un tono amable
   * Explica claramente los pasos
   * Ofrece alternativas si no puedes ayudar
3. **Usa las categorías correctamente**
   * Configura roles de soporte especializados
   * Asigna tickets según experiencia del staff
4. **Mantén organizado**
   * Revisa transcripciones de tickets similares
   * Crea respuestas predefinidas para problemas comunes
   * Actualiza la configuración según patrones

### Para Administradores

1. **Configura límites apropiados**
   * Balance entre accesibilidad y prevención de spam
   * Ajusta según el volumen de tu servidor
2. **Organiza el equipo**
   * Asigna roles de soporte claros
   * Define responsabilidades por categoría
   * Capacita al staff en el uso del sistema
3. **Monitorea transcripciones**
   * Revisa la calidad del soporte
   * Identifica problemas recurrentes
   * Mejora procesos basándote en datos
4. **Comunica el sistema**
   * Explica cómo usar los tickets en las reglas
   * Recuerda que no es un chat en vivo
   * Establece expectativas de tiempo de respuesta

***

## 🛠️ Solución de Problemas

### ❌ No puedo abrir un ticket

**Posibles causas:**

1. **Límite de tickets alcanzado**
   * ✅ Ya tienes el máximo de tickets abiertos permitido
   * ✅ Cierra tickets resueltos antes de abrir nuevos
2. **Plugin deshabilitado**
   * ✅ Verifica que el plugin esté activo en el Dashboard
   * ✅ Contacta a un administrador si no puedes crear tickets
3. **Permisos insuficientes del bot**
   * ✅ El bot necesita permiso para crear canales
   * ✅ El bot necesita permiso para gestionar permisos de canal
   * ✅ Contacta a un administrador para revisar los permisos

***

### ❌ El canal de ticket no se creó

**Soluciones:**

1. **Permisos del bot**
   * ✅ El bot necesita el permiso "Gestionar Canales"
   * ✅ El bot necesita el permiso "Ver Canal" en la categoría configurada
   * ✅ Contacta a un administrador para verificar los permisos
2. **Categoría de Discord llena**
   * ℹ️ Las categorías de Discord tienen un límite de 50 canales
   * ✅ Pide a un administrador que use otra categoría o limpie tickets antiguos

***

### ❌ No me mencionan al abrir ticket

**Soluciones:**

1. **Roles de soporte no configurados**
   * ✅ Verifica en el Dashboard que los roles de soporte estén configurados
   * ✅ Asegúrate de que la categoría tenga roles asignados
2. **Rol incorrecto**
   * ✅ Confirma que tu rol esté en la lista de roles de soporte
   * ✅ Verifica la jerarquía de roles (el rol del bot debe estar por encima)

***

### ❌ Las transcripciones no se envían

**Soluciones:**

1. **Canal no configurado**
   * ✅ Configura un canal de transcripciones en el Dashboard
   * ✅ Asegúrate de haber guardado los cambios
2. **Permisos del bot**
   * ✅ El bot necesita permiso de "Ver Canal" en el canal de transcripciones
   * ✅ El bot necesita permiso de "Enviar Mensajes" en el canal de transcripciones
3. **Plan no Premium**
   * ✅ Las transcripciones son una característica exclusiva del plan Premium 💎
   * ✅ Verifica tu plan actual en el Dashboard

***

### ❌ El sistema de prioridad no funciona

**Soluciones:**

1. **Configuración vacía**
   * ✅ Configura roles VIP en el Dashboard
   * ✅ O configura el umbral de economía (coins necesarios)
2. **Plugin de economía desactivado**
   * ✅ Si usas prioridad por coins, activa el plugin de Economía
   * ✅ Verifica la configuración del plugin de Economía

***

## 📊 Comparativa Plan Free vs Premium

| Característica                            | Free | Premium 💎 |
| ----------------------------------------- | ---- | ---------- |
| Botón para crear tickets                  | ✅    | ✅          |
| Modal de motivo                           | ✅    | ✅          |
| Canal privado automático                  | ✅    | ✅          |
| Botón para cerrar                         | ✅    | ✅          |
| Una categoría                             | ✅    | ✅          |
| Límite de 3 tickets/usuario               | ✅    | -          |
| **Múltiples categorías**                  | ❌    | ✅          |
| **Selector desplegable**                  | ❌    | ✅          |
| **Auto-asignación de roles**              | ❌    | ✅          |
| **Transcripciones automáticas**           | ❌    | ✅          |
| **Canal de transcripciones**              | ❌    | ✅          |
| **Sistema de prioridad**                  | ❌    | ✅          |
| **Límite configurable**                   | ❌    | ✅ (1-10)   |
| **Mensajes de bienvenida personalizados** | ❌    | ✅          |

***

## 📞 Soporte

Si tienes problemas con el plugin de Tickets:

1. ✅ Revisa esta guía completa
2. ✅ Consulta la sección de [Solución de Problemas](#solucion-de-problemas)
3. ✅ Verifica la configuración en el Dashboard
4. ✅ Confirma que el bot tenga los permisos necesarios
5. ✅ Contacta al soporte técnico de GUBO

***

**Última actualización:** Enero 2026

**Versión de la guía:** 1.0.0

***