🎫 Sistema de Tickets
El Sistema de Tickets de Sentinel es un sistema avanzado de gestión de tickets diseñado específicamente para bots antiraid. Incluye funciones únicas de seguridad, verificación automática de identidad y protección contra usuarios maliciosos.
🎯 ¿Qué hace único a este sistema?
- ✅ Verificación Anti-Raid Automática: Analiza automáticamente a los usuarios al crear tickets
- ✅ Integración con OpenBanlist: Verifica usuarios contra una base de datos abierta de usuarios baneados
- ✅ Limitaciones Automáticas: Aplica restricciones automáticamente a usuarios sospechosos
- ✅ Análisis Completo de Perfil: Verifica biografía, foto de perfil, estado, nombre, etc.
- ✅ Detección de Comportamiento Sospechoso: Identifica patrones de spam y comportamiento anómalo
- ✅ Notificaciones Inteligentes: Alertas automáticas al staff sobre tickets sospechosos
⚡ Características Principales
1. Sistema de Tickets Tradicional
- Creación de tickets mediante panel interactivo
- Categorías personalizables
- Cierre automático con transcripciones
- Gestión de múltiples tickets por usuario
2. Verificación de Seguridad Automática
Cada vez que un usuario crea un ticket, el sistema ejecuta automáticamente:
- ✅ Verificación de antigüedad de cuenta
- ✅ Verificación de lista negra global
- ✅ Verificación de lista gris (comportamiento sospechoso previo)
- ✅ Verificación de participación en raids anteriores
- ✅ Análisis completo de perfil (biografía, foto, estado, nombre)
- ✅ Verificación en OpenBanlist (base de datos abierta)
3. Limitaciones Automáticas
Si se detecta un usuario sospechoso, el sistema aplica automáticamente:
- ⏱️ Escritura lenta (Slowmode): 30-60 segundos según el nivel de riesgo
- 🚫 Bloqueo de archivos: No puede enviar archivos adjuntos
- 🖼️ Bloqueo de imágenes: No puede enviar imágenes
- 🔗 Bloqueo de embeds: No puede usar embeds
- 😀 Bloqueo de reacciones: No puede usar reacciones
- 🎨 Bloqueo de emojis externos: No puede usar emojis externos
- 🎭 Bloqueo de stickers: No puede usar stickers externos
- 🧵 Bloqueo de hilos: No puede crear hilos
⚙️ Configuración
Configuración Básica
Para configurar el sistema de tickets, ve al Panel Web → Settings → Tickets.
Campos Requeridos:
- Estado sistema: Activa o desactiva el sistema de tickets
- Categoría de Tickets (ID): ID del canal categoría donde se crearán los tickets
- Canal de Transcripciones (ID): Canal donde se enviarán las transcripciones al cerrar tickets
- Rol de Staff (ID): Rol que tendrá acceso a los tickets
- Canal del Panel (ID): Canal donde se mostrará el panel de tickets
Campos Opcionales:
- Título del Panel: Título personalizado para el panel de tickets
- Descripción del Panel: Descripción personalizada
- Footer del Panel: Texto del footer del embed
- Canal de Tickets Sospechosos (ID): Canal donde se enviarán alertas de tickets sospechosos
Configuración de Categorías
Puedes crear múltiples categorías de tickets. Cada categoría incluye:
- Emoji: Emoji que se mostrará en el botón
- Valor: Identificador único de la categoría
- Etiqueta: Nombre visible de la categoría
- Descripción: Descripción de la categoría
- 🎫 Soporte General
- 🐛 Reportar Bug
- 💡 Sugerencia
- ⚠️ Reportar Usuario
Configuración de Límites
- Límite de Tickets por Usuario: Número máximo de tickets que un usuario puede tener abiertos simultáneamente (por defecto: 3)
- Rate Limit: Tiempo mínimo entre creación de tickets (por defecto: 1 minuto)
Configuración de Seguridad
- Verificación de Seguridad: Activa la verificación automática de cuentas nuevas (< 1 día)
- Auto-categorización: Categoriza automáticamente los tickets según el contenido
- OpenBanlist: Activa la verificación contra OpenBanlist (habilitado por defecto)
🛡️ Verificación Anti-Raid Automática
¿Qué verifica el sistema?
El sistema ejecuta automáticamente las siguientes verificaciones cuando un usuario crea un ticket:
Análisis de Antigüedad de Cuenta
- Cuenta < 1 día: Riesgo alto, marca como sospechoso
- Cuenta < 7 días: Riesgo medio, añade advertencia
Verificación de Lista Negra Global
Verifica si el usuario está en la lista negra global del bot. Si está en la lista negra: Riesgo crítico
Verificación de Lista Gris
Analiza eventos de seguridad del usuario en los últimos 90 días. Si tiene 3+ eventos sospechosos: Riesgo alto
Eventos considerados sospechosos:
- SPAM_DETECTED
- SUSPICIOUS_BEHAVIOR
- WARNING_ISSUED
- KICK
- BAN
- QUARANTINE
- RAID_DETECTED
Verificación de Participación en Raids
Verifica si el usuario participó en raids detectados en los últimos 30 días. Si participó: Riesgo alto
Análisis Completo de Perfil
El sistema analiza:
- Nombre de usuario: Detecta patrones sospechosos (números secuenciales, caracteres especiales, etc.)
- Nombre en servidor (Display Name): Verifica nombres sospechosos
- Foto de perfil: Detecta avatares genéricos o ausentes
- Banner: Verifica banners sospechosos
- Biografía: Analiza contenido sospechoso (enlaces, palabras clave de estafas, etc.)
- Estado/Actividades: Detecta actividades sospechosas
Verificación de Tiempo en el Servidor
Recién unido (< 1 hora): Riesgo alto
Niveles de Riesgo
El sistema clasifica a los usuarios en diferentes niveles de riesgo:
| Nivel | Descripción |
|---|---|
| Bajo (Low) | Usuario normal, sin limitaciones |
| Medio (Medium) | Usuario con algunas características sospechosas |
| Alto (High) | Usuario con múltiples indicadores de riesgo |
| Crítico (Critical) | Usuario en lista negra, OpenBanlist, o con comportamiento muy sospechoso |
Limitaciones según Nivel de Riesgo
| Nivel de Riesgo | Slowmode | Bloqueo de Archivos | Bloqueo de Embeds |
|---|---|---|---|
| Bajo | No | No | No |
| Medio | 30 segundos | Sí | Sí |
| Alto | 45 segundos | Sí | Sí |
| Crítico | 60 segundos | Sí | Sí |
🌐 Integración con OpenBanlist
¿Qué es OpenBanlist?
OpenBanlist es una base de datos abierta y gratuita de usuarios baneados en Discord. Permite a los servidores compartir información sobre usuarios maliciosos.
¿Cómo funciona la integración?
- Al crear un ticket: El sistema consulta automáticamente la API de OpenBanlist
- Si el usuario está en OpenBanlist:
- Se marca como riesgo crítico
- Se aplican todas las limitaciones automáticas
- Se notifica al staff con información detallada
Configuración
La verificación de OpenBanlist está habilitada por defecto. Puedes desactivarla en:
Panel Web → Settings → Tickets → Integración OpenBanlist
Información que se verifica
Cuando un usuario está en OpenBanlist, el sistema obtiene:
- Razón del ban: Por qué fue baneado
- Severidad: Nivel de severidad del ban
- Fuente: Origen de la información
- Evidencia: Evidencia del comportamiento malicioso (si está disponible)
- Timestamp: Fecha del ban
🚫 Limitaciones Automáticas
¿Cuándo se aplican las limitaciones?
Las limitaciones se aplican automáticamente cuando:
- El usuario está en lista negra global
- El usuario está en OpenBanlist
- El usuario tiene comportamiento sospechoso previo (lista gris)
- El usuario participó en raids anteriores
- El usuario tiene un perfil sospechoso
- La cuenta es muy nueva (< 1 día)
- El usuario se unió recientemente al servidor (< 1 hora)
Limitaciones Aplicadas
1. Escritura Lenta (Slowmode)
- Riesgo Medio: 30 segundos
- Riesgo Alto: 45 segundos
- Riesgo Crítico: 60 segundos
El usuario solo puede enviar un mensaje cada X segundos.
2. Bloqueo de Archivos
El usuario NO puede:
- Enviar archivos adjuntos
- Enviar imágenes
- Enviar documentos
3. Bloqueo de Embeds
El usuario NO puede:
- Enviar enlaces que generen embeds
- Usar embeds personalizados
4. Bloqueo de Reacciones
El usuario NO puede:
- Añadir reacciones a mensajes
- Usar emojis externos
- Usar stickers externos
5. Bloqueo de Hilos
El usuario NO puede crear hilos en el canal del ticket.
Mensaje al Usuario
Cuando se aplican limitaciones, el usuario recibe un mensaje que explica las limitaciones sin mencionar que es sospechoso:
Por seguridad, algunas funciones están limitadas en este ticket:
• Escritura lenta: Puedes enviar un mensaje cada X segundo(s)
• Archivos bloqueados: No se pueden enviar archivos adjuntos
• Imágenes bloqueadas: No se pueden enviar imágenes
• Embeds bloqueados: No se pueden usar embeds
• Reacciones bloqueadas: No se pueden usar reacciones
El staff te ayudará lo antes posible.
📝 Comandos Disponibles
Comandos de Usuario
/ticket close [razón]
Cierra el ticket actual.
Parámetros:
razón(opcional): Razón por la que se cierra el ticket
Ejemplo:
/ticket close Problema resuelto/ticket info
Muestra información sobre el ticket actual.
Información mostrada:
- Usuario que creó el ticket
- Categoría del ticket
- Fecha de creación
- Estado del ticket
- Nivel de riesgo (si es sospechoso)
Comandos en el Panel de Ayuda
Los comandos de tickets están disponibles en:
/help → Categoría "Tickets"
Muestra información completa sobre:
- Comandos disponibles
- Funciones de seguridad automáticas
- Configuración del sistema
🔔 Notificaciones al Staff
Canal de Notificaciones
Las notificaciones se envían a:
- Canal de Tickets Sospechosos (si está configurado)
- Canal de Transcripciones (fallback)
- Canal del Ticket (fallback final)
Información Incluida
Cuando se detecta un ticket sospechoso, el staff recibe un embed con:
Información del Usuario
- Usuario: Mencion del usuario
- ID: ID de Discord del usuario
- Cuenta creada: Fecha de creación de la cuenta
- Unido al servidor: Fecha de unión al servidor
Información de Seguridad
- Nivel de riesgo: Bajo, Medio, Alto o Crítico
- Razones de sospecha: Lista de razones por las que es sospechoso
- Acciones aplicadas: Limitaciones que se han aplicado automáticamente
Información Adicional
- Lista Negra Global: Si está en lista negra, se muestra la razón
- OpenBanlist: Si está en OpenBanlist, se muestra la información
- Lista Gris: Si tiene comportamiento sospechoso previo
- Participación en Raids: Si participó en raids anteriores
🌐 Panel de Control Web
Acceso al Panel
- Ve a tu panel web de Sentinel
- Selecciona tu servidor
- Ve a Settings → Tickets
Secciones del Panel
1. Configuración Básica
- Estado del sistema (toggle)
- Categoría de tickets
- Canal de transcripciones
- Rol de staff
- Canal del panel
2. Configuración del Panel
- Título del panel
- Descripción del panel
- Footer del panel
3. Categorías de Tickets
- Añadir/eliminar categorías
- Configurar emoji, valor, etiqueta y descripción
4. Límites y Rate Limiting
- Límite de tickets por usuario
- Rate limit (tiempo entre tickets)
5. Funciones de Seguridad
- Verificación de seguridad
- Auto-categorización
- Integración OpenBanlist
6. Canal de Tickets Sospechosos
- Configurar canal para alertas de seguridad
Guardado Automático
El panel guarda automáticamente los cambios después de 2 segundos de inactividad. No es necesario hacer clic en "Guardar".
❓ Preguntas Frecuentes
¿Cómo activo el sistema de tickets?
- Ve al Panel Web → Settings → Tickets
- Activa el toggle "Estado sistema"
- Configura los campos requeridos (categoría, canal de transcripciones, etc.)
- Guarda los cambios
¿Puedo desactivar la verificación de OpenBanlist?
Sí, puedes desactivarla en Settings → Tickets → Integración OpenBanlist. Sin embargo, se recomienda mantenerla activa para mayor seguridad.
¿Qué pasa si un usuario sospechoso crea un ticket?
El sistema aplica automáticamente limitaciones de seguridad y notifica al staff. El usuario puede seguir usando el ticket, pero con restricciones.
¿Puedo personalizar las limitaciones?
Las limitaciones se aplican automáticamente según el nivel de riesgo detectado. No se pueden personalizar manualmente, pero puedes desactivar la verificación de seguridad si lo deseas.
¿Cómo funcionan las categorías de tickets?
Cada categoría tiene un botón en el panel de tickets. Cuando un usuario hace clic en un botón, se crea un ticket con esa categoría.
¿Dónde se guardan las transcripciones?
Las transcripciones se envían al canal configurado en "Canal de Transcripciones" cuando se cierra un ticket.
¿Puedo tener múltiples tickets abiertos?
Sí, pero hay un límite configurable (por defecto: 3 tickets por usuario).
¿Qué es la lista gris?
La lista gris es una lista automática de usuarios con comportamiento sospechoso previo. Se basa en eventos de seguridad de los últimos 90 días.
¿Cómo funciona la detección de spam en tickets?
El sistema detecta automáticamente patrones de spam en los mensajes de los tickets y aplica acciones según la configuración del servidor.
🔧 Solución de Problemas
El panel de tickets no aparece
- Verifica que el sistema de tickets esté activado
- Verifica que el canal del panel esté configurado correctamente
- Verifica que el bot tenga permisos para enviar mensajes en el canal
Los tickets no se crean
- Verifica que la categoría de tickets esté configurada correctamente
- Verifica que el bot tenga permisos para crear canales
- Verifica que no haya alcanzado el límite de tickets
Las limitaciones no se aplican
- Verifica que la verificación de seguridad esté activada
- Verifica que el bot tenga permisos para modificar permisos del canal
- Revisa los logs del bot para ver si hay errores
OpenBanlist no funciona
- Verifica que la integración esté activada
- Verifica tu conexión a internet
- La API de OpenBanlist puede estar temporalmente no disponible