🛡️ 1. Introducción a Zenith Shield

Zenith Shield es un sistema SaaS autónomo de ciberseguridad diseñado específicamente para proteger comunidades de Discord frente a la oleada moderna de estafas digitales, phishing y spam malicioso.

A diferencia de los bots antispam tradicionales que únicamente leen texto plano, los atacantes modernos utilizan capturas de pantalla fraudulentas (falsos sorteos de Nitro, transferencias crypto de MrBeast, imágenes con códigos QR engañosos y capturas de chats falsos de Steam) para eludir los filtros convencionales.

🚀 2. Guía de Instalación Paso a Paso

Integrar Zenith Shield en tu servidor de Discord es un proceso que toma menos de 60 segundos:

1. Invita al Bot a tu Servidor: Haz clic en el siguiente enlace oficial de autorización OAuth2:
   
   https://discord.com/oauth2/authorize?client_id=1543046907406979233&scope=bot%20applications.commands&permissions=1099511627775
2. Selecciona tu Servidor: En el desplegable de Discord, elige el servidor donde posees permisos de Administrador o Gestionar Servidor.
3. Autoriza los Permisos: Mantén activadas las casillas de verificación requeridas y completa el captcha de Discord.
4. Abre tu Dashboard: Entra en https://botzenithapp.com/dashboard con tu cuenta de Discord para ajustar la sensibilidad y los canales de tu comunidad.

🔑 3. Permisos y Jerarquía del Rol

Permisos Obligatorios del Bot:

👁️ 4. Motor OCR e Inteligencia Heurística

Cuando un usuario publica una imagen o archivo adjunto en cualquier canal protegido, Zenith Shield ejecuta el siguiente flujo de seguridad:

1. Filtrado de Exenciones: Comprueba si el autor o el canal pertenecen a la Lista Blanca. Si están exentos, el mensaje se omite al instante.
2. Extracción de Texto (OCR): Extrae los caracteres visibles en la imagen mediante OCR de alta velocidad optimizado para capturas de pantalla de Discord, Telegram, WhatsApp y navegadores.
3. Puntuación de Riesgo: Evalúa la presencia de vectores de amenaza conocidos:
   • Falsos sorteos de Discord Nitro (ej: free nitro, gift nitro, claim-gift).
   • Estafas financieras de MrBeast o criptomonedas (ej: giveaway, crypto payout, double money).
   • Canales de Telegram para señales de trading fraudulentas.
   • Enlaces con dominios suplantados (phishing de Steam, Riot, Blizzard).
4. Ejecución Defensiva: Si la puntuación de riesgo supera el umbral de sensibilidad, se dispara la sanción en milisegundos.

⚡ 5. Acciones de Sanción Configurables

En la pestaña Moderación & Sensibilidad de tu panel, puedes seleccionar el castigo automático a aplicar:

• ⏳ TIMEOUT (Aislamiento Temporal - Recomendado): El mensaje es eliminado y el usuario queda completamente silenciado durante el tiempo configurado (desde 1 hora hasta 7 días). Ideal para cuentas de miembros legítimos que han sido vulneradas.
• 🗑️ DELETE_ONLY (Solo Borrado): El mensaje es eliminado silenciosamente sin imponer ninguna sanción al usuario. Recomendado para comunidades que prefieren no silenciar automáticamente.
• 👢 KICK (Expulsión): Elimina el mensaje y expulsa al usuario del servidor. El usuario podrá volver a unirse si dispone de una invitación.
• 🔨 BAN (Bloqueo Permanente): Elimina el mensaje y bloquea al usuario de forma definitiva. Recomendado para servidores con ataques de raids reiterados.

📁 6. Canales y Roles Excluidos (Listas Blancas)

Para evitar falsos positivos o permitir que los miembros del equipo compartan capturas libremente, puedes configurar excepciones:

• Roles Excluidos: Los miembros que posean al menos uno de estos roles (ej: Moderadores, Administradores, Staff) no serán analizados ni sancionados bajo ninguna circunstancia.
• Canales Excluidos: Los canales seleccionados (ej: #zona-staff, #anuncios-oficiales) quedarán omitidos de la moderación automática.

🛡️ 7. Filtros Personalizados por Servidor

Además de la base de datos global de firmas de Zenith Shield, cada servidor puede definir sus propias reglas específicas en la pestaña Filtros Personalizados:

• Palabras Prohibidas: Términos, marcas o insultos específicos de tu comunidad. Cualquier mensaje o imagen que contenga estas palabras será neutralizado de inmediato.
• Dominios Bloqueados: Enlaces o sitios web específicos que deseas prohibir terminantemente en tu comunidad (ej: páginas de la competencia o acortadores maliciosos).

🚨 8. Modo Pánico & Blindaje de Emergencia

En situaciones de crisis extrema (como un ataque coordinado de raids, bots maliciosos que inundan todos los canales con invitaciones fraudulentas o una cuenta de moderación comprometida), cada segundo cuenta. Zenith Shield incorpora el Modo Pánico (Lockdown) para neutralizar el impacto de inmediato.

Activación Rápida

Puedes activar o desactivar el blindaje en cualquier instante desde dos vías:

• Desde el Dashboard Web: En la pestaña 🚨 Modo Pánico con un solo clic en el botón principal, o monitoreando el distintivo en la barra superior.
• Desde Discord: Mediante los comandos de barra slash /panic enable [motivo] o /lockdown enable [motivo] (y disable para restaurar el estado normal).

Efectos Inmediatos del Blindaje

• Congelación de Canales: Bloquea al instante los permisos de enviar mensajes al rol @everyone en todos los canales de texto públicos.
• Canales del Staff Intactos: Mantiene operativos los canales privados y de administración para que el equipo pueda comunicarse y solventar el incidente.
• Auditoría Forense de Emergencia: Registra la identidad del administrador que ejecutó el blindaje, hora exacta y motivo en el historial de eventos de pánico.

📋 8. Auditoría e Incidentes en Tiempo Real

Cada acción defensiva ejecutada por el bot genera un registro detallado:

• Canal de Logs en Discord: Si configuras un Canal de Alertas en el dashboard, el bot enviará un embed forense con el usuario infractor, el motivo, el score de amenaza y el canal donde ocurrió.
• Pestaña Auditoría de Incidentes: En tu Dashboard web puedes consultar la lista histórica de todas las amenazas neutralizadas, filtrando por usuario o tipo de incidente.

🎫 9. Sistema de Tickets Pro & Soporte Multi-Rol

Zenith Shield incluye un Sistema de Tickets Profesional Multi-Departamento completamente integrado en el Dashboard web y optimizado para servidores con alta demanda de atención a usuarios y clientes.

Múltiples Roles de Soporte por Categoría

A diferencia de los sistemas tradicionales limitados a un único rol de Staff, en Zenith Shield puedes asignar tantos roles de soporte como requiera cada departamento (ej: Soporte Técnico, Moderador, Administración, Facturación). Al abrirse un ticket en esa categoría, el bot otorga automáticamente permisos completos de lectura, escritura y gestión a todos los roles vinculados.

Control Granular de Menciones (🔔 Mencionar / 🔕 Sin mención)

Evita el agotamiento por pings en tu equipo. Para cada rol añadido a un departamento, puedes alternar de forma independiente:

• 🔔 Menciona al abrir: El rol recibirá una mención automática en el mensaje inicial del ticket para una respuesta inmediata.
• 🔕 Sin mención: El rol tendrá acceso completo al canal y permisos de respuesta, pero no será mencionado ni recibirá notificación sonora.

Gestión Interactiva de Miembros (👥 Añadir Usuario)

Cada ticket abierto incorpora un botón interactivo 👥 Añadir Usuario en su mensaje de control. Al pulsarlo, el Staff o creador puede elegir a cualquier miembro del servidor mediante un menú desplegable nativo o usando los comandos /adduser [usuario] y !adduser @usuario (con respuesta diferida anti-timeout para garantizar máxima fluidez).

⚡ 10. Flujo de Trabajo (/derivar, /mover & Transcripciones)

Zenith Shield proporciona herramientas de escalado en tiempo real sin salir de Discord:

• Escalado con /derivar [rol] [motivo] (o !derivar):
  Transfiere la atención del ticket a un rol especializado. El bot renombra el ticket anteponiendo un círculo de color distintivo (🟣, 🔵, 🟡, etc.), notifica al nuevo equipo de atención y revoca el acceso a departamentos previos.
• Reubicación con /mover [categoria] [motivo] (o !mover):
  Traslada físicamente el canal de texto a otra categoría de Discord, resincronizando permisos automáticamente y adaptando el prefijo del canal a la nueva categoría.
• Estados Visuales Dinámicos:
  Los canales de tickets actualizan su emoji en tiempo real según la interacción:
  • 🔴・ticket-...: Ticket nuevo pendiente de primera respuesta del Staff.
  • 🟢・ticket-...: Contestado por el Staff (atendido).
  • 🟠・ticket-...: El usuario ha vuelto a responder y requiere nueva atención.
• Transcripciones Automáticas HTML:
  Al cerrar un ticket o pulsar 📋 Descargar Transcripción, el bot genera un archivo HTML autosuficiente con diseño moderno, avatares, embeds y mensajes completos, enviándolo por DM al usuario y archivándolo en el canal de transcripciones.

📈 12. Métricas de Rendimiento & Staff KPIs

Zenith Shield proporciona un panel analítico completo para medir con precisión la eficacia y velocidad del equipo de soporte en la gestión de tickets.

Gráficos de Tendencia y Leaderboard

• Línea de Tendencia Diaria: Gráfico SVG comparativo de tickets creados versus tickets resueltos a lo largo del periodo seleccionado.
• Desglose por Departamentos: Barras de progreso que revelan qué categorías o departamentos acumulan mayor demanda.
• Ranking de Miembros del Staff: Tabla de clasificación que destaca a los moderadores más activos según tickets cerrados y tiempo medio de resolución.
• Filtro Temporal Ultra-Fluido: Selección rápida de periodos (7, 14, 30 y 90 días) con sistema de caché en memoria para visualización inmediata sin esperas.

💎 11. Planes y Suscripciones

❓ 12. Solución de Problemas Frecuentes

¿Por qué el bot elimina el mensaje pero no aplica el timeout al usuario?

Esto sucede cuando el rol de Zenith Shield se encuentra por debajo del rol del usuario infractor en los ajustes de Discord. Para solucionarlo, ve a Ajustes del Servidor > Roles y sube el rol de Zenith Shield por encima del resto.

¿Por qué no recibo alertas en mi canal de logs?

Verifica que hayas seleccionado el canal en la pestaña Moderación del Dashboard y guardado los cambios. Además, asegúrate de que el bot tenga permiso explícito de Ver Canal y Enviar Mensajes en ese canal específico.

¿Cómo puedo probar el bot sin arriesgar a mis usuarios?

Utiliza la pestaña 🧪 Simulador de Servidores & Sandbox Forense dentro de tu Dashboard (exclusivo para servidores con Plan Enterprise / Network Sovereign). Te permite someter tus reglas a pruebas de estrés, elegir entre cualquiera de tus servidores cubiertos, evaluar vectores de ataque reales y exportar informes forenses sin afectar a ningún miembro real.