# Tickets

## ¿Qué son los Tickets?

Los Tickets son un sistema de **soporte interactivo** donde los miembros pueden crear "incidencias" privadas para resolver problemas. Es como un formulario de soporte automático.

### Casos de Uso

* ✅ Soporte técnico
* ✅ Reportar bugs
* ✅ Solicitar permisos
* ✅ Resolver conflictos
* ✅ Gestionar aplicaciones
* ✅ Ventas y consultas

***

## 🚀 Configuración Básica (Para Usuarios Nuevos)

{% stepper %}
{% step %}

### Crear Canal Base

1. Abre Configuración → Canales
2. Crea un canal: `#crear-ticket` o `#soporte`
3. Escribe una descripción: "Crea un ticket haciendo clic en el botón"
   {% endstep %}

{% step %}

### Activar Tickets

```bash
/setticket setup #crear-ticket
```

El bot te pedirá:

* ✏️ **Tipo de componente:** Botón o Menú de selección
* 📁 **Canal de logs:** Donde guardar registros
* 📝 **Título:** Del mensaje
* 💬 **Mensaje:** Descripción
* 🖼️ **Imagen:** URL (opcional)
* 🎨 **Color:** Del embed
  {% endstep %}

{% step %}

### ¡Listo!

Los miembros verán un botón y podrán crear tickets
{% endstep %}
{% endstepper %}

***

## ⚙️ Opciones de Componentes

### Opción 1: Botón Único

Un solo botón que crea tickets:

```
[🎫 Crear Ticket]
```

**Mejor para:** Soporte general

### Opción 2: Menú de Selección

Múltiples categorías de tickets:

```
[▼ Selecciona tu categoría]
├─ Soporte Técnico
├─ Reportar Bug
├─ Aplicación
└─ Otra consulta
```

**Mejor para:** Servidores complejos

***

## 📋 Configuración de Categorías

### Crear Categoría de Ticket

En el setup puedes definir:

```
Nombre: "Soporte Técnico"
Emoji: 🛠️
Staff Role: @Support Team
Categoría de canal: Tickets
```

### Opciones de Categoría

* **Nombre:** El que ve el usuario
* **Emoji:** Icono representativo
* **Rol de Staff:** Quién accede a los tickets
* **Categoría:** Dónde crear el canal
* **Embed personalizado:** Mensaje al crear

***

## 🎯 Flujo de un Ticket

{% stepper %}
{% step %}

### Usuario Crea Ticket

```
Usuario hace clic en [🎫 Crear Ticket]
↓
Bot crea un canal privado: ticket-123
↓
Solo el usuario + staff pueden ver
```

{% endstep %}

{% step %}

### Conversación

```
Usuario describe el problema
Staff responde y ayuda
Se guardan mensajes en logs
```

{% endstep %}

{% step %}

### Cerrar Ticket

```
[✅ Cerrar]  [🔒 Bloquear]  [💬 Sugerencia]
↓
Se guarda transcript (opcional)
↓
Canal se archiva/elimina
```

{% endstep %}
{% endstepper %}

***

## 📝 Ejemplo Práctico

**Setup Soporte en 3 pasos:**

{% stepper %}
{% step %}

### Setup

```
/setticket setup #crear-ticket
Tipo: Menu de seleccion
Canales de logs: #ticket-logs
```

{% endstep %}

{% step %}

### Categorías

```
1. 🛠️ Soporte Técnico → @Tech Support
2. 🐛 Reportar Bug → @Developers  
3. 📋 Aplicación → @Admins
4. 💬 Otra → @Moderators
```

{% endstep %}

{% step %}

### Resultado

Usuarios seleccionan su categoría y se crea un ticket privado
{% endstep %}
{% endstepper %}

***

## 🔍 Administración de Tickets

### Ver Tickets Abiertos

```bash
/setticket lista
```

Muestra:

* ✅ Nombre del usuario
* 📊 Categoría
* ⏰ Cuándo lo creó
* ✏️ Estado

### Información del Ticket

```bash
/setticket info
```

Muestra detalles completos

### Cerrar Ticket (Forzado)

```bash
/setticket close [ticket-number]
```

### Reapertura

Los usuarios pueden reabrir si no está cerrado del todo

***

## 🎨 Personalización

### Cambiar Mensaje

```bash
/setticket setup
Mensaje: "Hola! Describe tu problema en detalle"
```

### Cambiar Color

```bash
/setticket setup
Color: #FF6BB1 (Rosa)
```

### Agregar Imagen

```bash
/setticket setup
Imagen: https://ejemplo.com/banner.png
```

### Cambiar Thumbnail

```bash
/setticket setup
Thumbnail: https://ejemplo.com/icono.png
```

***

## 📊 Transcripts (Guardando Tickets)

El bot puede guardar automáticamente el historial:

```
Cada ticket cerrado se guarda como:
- Texto plano
- HTML
- JSON
```

Útil para registros y análisis.

***

## 🔍 Solución de Problemas

| Problema                     | Solución                                   |
| ---------------------------- | ------------------------------------------ |
| **No aparece el botón**      | Verifica permisos en el canal              |
| **No se crea el ticket**     | Asegúrate que el bot tiene "Crear Canales" |
| **El staff no ve el ticket** | Añade el rol al setup de categoría         |
| **Demasiados canales**       | Cierra tickets antiguos regularmente       |

***

## 💡 Mejores Prácticas

### ✅ Haz

* Organiza por categorías claras
* Responde rápido a tickets
* Guarda transcripts importantes
* Entrena a tu staff
* Revisa tickets cerrados

### ❌ No hagas

* Ignores tickets
* Categorías confusas
* Demasiadas categorías (máx 25)
* Dejes canales abiertos eternamente
* Olvides responder

***

## 👥 Permisos Necesarios

El bot necesita:

* ✅ Crear Canales
* ✅ Gestionar Canales
* ✅ Ver Mensajes
* ✅ Enviar Mensajes
* ✅ Añadir Reacciones

***

## 📞 ¿Problemas?

1. Verifica permisos del bot
2. Comprueba la categoría
3. Revisa que el rol de staff existe
4. Pide ayuda en [soporte](https://discord.gg/2ZKdT6SRsZ)

***

## 🔗 Relacionado

* [Logs](broken://pages/89a441194bbdca14865cb61ec71c1568227caa9d)
* [Moderación](broken://pages/bf01583efe95df66938611f006518b6f74a78355)


---

# Agent Instructions: 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:

```
GET https://okaa.gitbook.io/okaa-wiki/configuracion/tickets.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.