📢 Sistema Anti-Spam

El sistema Anti-Spam de Sentinel Bot protege tu servidor contra mensajes spam, enlaces no autorizados y comportamiento molesto automáticamente. Detecta y bloquea spam en tiempo real, manteniendo tu servidor limpio y seguro.

Puedes gestionar toda la protección Anti-Spam desde comandos de Discord (/antispam) o desde el panel web en la pestaña Settings → Anti-Spam.

🎯 ¿Qué detecta el Anti-Spam?

El sistema Anti-Spam detecta y bloquea automáticamente:

• ✅ Mensajes repetidos: Usuarios enviando el mismo mensaje múltiples veces
• ✅ Palabras repetidas: Mensajes con la misma palabra repetida muchas veces
• ✅ Menciones excesivas: Demasiadas menciones a usuarios o roles en un mensaje
• ✅ @everyone/@here: Menciones masivas (bloqueables)
• ✅ Enlaces excesivos: Demasiados enlaces en un solo mensaje
• ✅ Caracteres repetidos: Mensajes con caracteres repetidos (ej: "aaaaaaaaa")
• ✅ Enlaces no autorizados: Protección avanzada contra enlaces no permitidos

⚙️ Configuración del Anti-Spam

1. Activar/Desactivar

Usando comandos (rápido):

• /antispam enable - Activa toda la protección Anti-Spam
• /antispam disable - Desactiva toda la protección Anti-Spam
• /antispam status - Ver el estado completo de la protección

Usando el panel web:

1. Ve a tu servidor en el panel web
2. Pestaña "Settings" → "Anti-Spam"
3. Busca "📢 Protección Anti-Spam"
4. Activa o desactiva el interruptor "Estado sistema"

2. Configurar Acción

Cuando se detecta spam, puedes elegir qué acción tomar:

• ⚠️ Advertir: Envía un mensaje privado de advertencia al usuario
• 👢 Expulsar: Expulsa al usuario del servidor
• 🔨 Banear: Banea permanentemente al usuario

Recomendación: Para servidores nuevos, usa "Advertir" primero. Una vez que veas qué tipo de spam recibes, puedes ajustar la acción.

3. Umbral de Mensajes Repetidos

Define cuántos mensajes repetidos activan la protección.

Ejemplo: Si configuras 5 mensajes, el bot eliminará todos los mensajes repetidos cuando un usuario envíe el mismo mensaje 5 veces en un minuto.

4. Máximo de Menciones por Mensaje

Limita cuántos usuarios/roles pueden ser mencionados en un solo mensaje.

• 0: Bloquea todas las menciones (no recomendado)
• 1-3: Muy estricto, solo menciones individuales
• 3-5: Moderado, permite menciones normales
• 5+: Permisivo, permite muchas menciones

5. Permitir @everyone/@here

Controla si los usuarios pueden mencionar @everyone o @here.

🔗 Protección de Enlaces

Una de las características más poderosas del Anti-Spam es la protección avanzada de enlaces. Puedes bloquear todos los enlaces excepto los que explícitamente permitas.

¿Cómo funciona?

1. El bot detecta todos los enlaces en los mensajes
2. Verifica si el usuario está en la whitelist (si está, puede enviar cualquier enlace)
3. Compara el enlace con tu lista blanca de dominios permitidos
4. Si el enlace no está permitido, elimina el mensaje y ejecuta la acción configurada

Configurar Protección de Enlaces

discord.gg
youtube.com
github.com
twitch.tv

Reglas de la Lista Blanca

• ✅ Puedes poner solo el dominio (ej: discord.gg)
• ✅ Puedes poner la URL completa (ej: https://discord.gg)
• ✅ El bot normaliza automáticamente (ignora www, protocolos, etc.)
• ✅ Los subdominios están incluidos (si permites discord.gg, también se permite status.discord.gg)

Exención de Whitelist

🎫 Enlaces en Tickets de Sentinel

Una característica especial del sistema Anti-Spam es la capacidad de permitir o bloquear enlaces específicamente en los tickets de Sentinel.

/antispam links-tickets permitir:true

/antispam links-tickets permitir:false

🚨 Detecciones Específicas

1. Mensajes Duplicados

El bot detecta cuando un usuario envía el mismo mensaje múltiples veces en un minuto.

2. Palabras Repetidas

Detecta mensajes con la misma palabra repetida muchas veces.

3. Menciones Excesivas

Bloquea mensajes con demasiadas menciones de usuarios o roles.

4. Enlaces Excesivos

Detecta mensajes con demasiados enlaces.

🤖 Comandos de Anti-Spam

Puedes gestionar toda la protección Anti-Spam directamente desde Discord usando comandos rápidos:

Comandos Principales

/antispam enable

/antispam disable

/antispam status

/antispam links activar:true

/antispam links activar:false

/antispam links-tickets permitir:true

/antispam links-tickets permitir:false

Ejemplos de Uso

📋 Logs de Spam

Todas las acciones del Anti-Spam se registran automáticamente en el canal de logs de spam configurado.

¿Qué se registra?

• ✅ Usuario que envió el spam
• ✅ Tipo de spam detectado (mensajes duplicados, enlaces, menciones, etc.)
• ✅ Canal donde ocurrió
• ✅ Acción ejecutada (advertencia, expulsión, baneo)
• ✅ Timestamp del evento

Configurar Canal de Logs

1. Ve a Settings → Logs
2. Busca "Canal de Logs de Spam"
3. Pega el ID del canal donde quieres recibir los logs
4. Guarda los cambios

⚡ Optimización y Rendimiento

El sistema Anti-Spam está optimizado para responder en menos de 30 milisegundos, lo que significa que:

• ✅ No ralentiza tu servidor
• ✅ Detecta spam casi instantáneamente
• ✅ Elimina mensajes antes de que otros usuarios los vean
• ✅ Funciona sin interferir con otros bots

🎯 Mejores Prácticas

1. Empieza con acciones suaves: Usa "Advertir" al principio y ajusta según lo que veas.
2. Ajusta los umbrales según tu servidor: Servidores grandes necesitan umbrales más altos.
3. Usa la whitelist estratégicamente: Añade usuarios de confianza para evitar falsos positivos.
4. Revisa los logs regularmente: Te ayudará a ajustar la configuración.
5. Configura la protección de enlaces cuidadosamente: Añade los dominios que realmente necesitas permitir.

❓ Preguntas Frecuentes

¿El Anti-Spam afecta a usuarios en whitelist?

No. Los usuarios en la whitelist están exentos de todas las protecciones de spam EXCEPTO las menciones @everyone/@here (si está bloqueado para todos). Además, pueden enviar cualquier enlace sin importar la lista blanca.

¿Qué pasa si un usuario legítimo envía muchos mensajes?

El bot solo detecta mensajes repetidos (el mismo texto). Si un usuario envía mensajes diferentes rápidamente, no se considerará spam.

¿Puedo desactivar solo la protección de enlaces?

Sí. Puedes activar el Anti-Spam general pero desactivar específicamente la protección de enlaces. Son configuraciones independientes. Puedes usar /antispam links activar:false para desactivar solo la protección de enlaces.

¿Cómo sé si un enlace será bloqueado?

Si el dominio del enlace no está en tu lista blanca Y el usuario no está en whitelist, el enlace será bloqueado. Sin embargo, si el mensaje está en un ticket de Sentinel y tienes activada la opción "Enlaces en Tickets", el enlace será permitido.

¿Los enlaces en embeds también se bloquean?

El bot detecta enlaces en el contenido del mensaje. Los enlaces en embeds pueden no ser detectados dependiendo de cómo se envíen.

¿Puedo permitir enlaces en tickets pero bloquearlos en otros canales?

Sí, absolutamente. Esa es exactamente la función de "Enlaces en Tickets". Activa la protección de enlaces normalmente y luego activa la opción "Enlaces en Tickets" desde el panel web o con /antispam links-tickets permitir:true. Así, los enlaces estarán bloqueados en el servidor pero permitidos en los tickets de soporte.

¿Qué pasa si desactivo la protección Anti-Spam pero dejo activada la protección de enlaces?

La protección de enlaces es independiente. Puedes tener el Anti-Spam general desactivado pero la protección de enlaces activada. En este caso, solo se bloquearán enlaces no permitidos, pero no se detectará otro tipo de spam.