🛡️ 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. 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. Planes y Suscripciones

❓ 10. 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 del Servidor dentro de tu Dashboard. Te permite ingresar cualquier texto o estafa simulada y ver exactamente cómo respondería tu configuración actual sin afectar a ningún miembro real.