Anti-Spam System
Sentinel Bot's Anti-Spam system protects your server against spam messages, unauthorized links, and annoying behavior automatically. It detects and blocks spam in real-time, keeping your server clean and safe.
You can manage all Anti-Spam protection from Discord commands (/antispam) or from the web panel in the Settings → Anti-Spam tab.
What does Anti-Spam detect?
The Anti-Spam system automatically detects and blocks:
- ✅ Repeated Messages: Users sending the same message multiple times
- ✅ Repeated Words: Messages with the same word repeated many times
- ✅ Excessive Mentions: Too many mentions of users or roles in a message
- ✅ @everyone/@here: Mass mentions (blockable)
- ✅ Excessive Links: Too many links in a single message
- ✅ Repeated Characters: Messages with repeated characters (e.g., "aaaaaaaaa")
- ✅ Unauthorized Links: Advanced protection against unauthorized links
Configuration
Enable/Disable
Using commands
/antispam enable- Activates all Anti-Spam protection/antispam disable- Deactivates all Anti-Spam protection/antispam status- View complete protection status
Using the web panel
- Go to your server in the web panel
- Settings tab → Anti-Spam
- Find "📢 Anti-Spam Protection"
- Activate or deactivate the "System Status" switch
Configure Action
When spam is detected, you can choose what action to take:
- ⚠️ Warn: Sends a private warning message to the user
- 👢 Kick: Kicks the user from the server
- 🔨 Ban: Permanently bans the user
Recommendation For new servers, use "Warn" first. Once you see what type of spam you receive, you can adjust the action.
Repeated Messages Threshold
Define how many repeated messages trigger protection.
- 3-5 messages For small servers. Very strict protection.
- 5-7 messages For medium servers. Balance between protection and flexibility.
- 7-10 messages For large servers. Allows legitimate repetitions.
Example If you configure 5 messages, the bot will delete all repeated messages when a user sends the same message 5 times in a minute.
Maximum Mentions per Message
Limits how many users/roles can be mentioned in a single message.
- 0: Blocks all mentions (not recommended)
- 1-3: Very strict, only individual mentions
- 3-5: Moderate, allows normal mentions
- 5+: Permissive, allows many mentions
Allow @everyone/@here
Controls whether users can mention @everyone or @here.
We recommend setting this to 0 (always blocked). @everyone mentions can annoy all server members.
Link Protection
One of the most powerful features of Anti-Spam is advanced link protection. You can block all links except those you explicitly allow.
How does it work?
- The bot detects all links in messages
- Checks if the user is on the whitelist (if they are, they can send any link)
- Compares the link with your whitelist of allowed domains
- If the link is not allowed, deletes the message and executes the configured action
Configure Link Protection
Activate protection
In Settings → Anti-Spam, find "🔗 Link Protection" and activate the "System Status" switch.
Select action
Choose what to do when someone sends an unauthorized link:
- ⚠️ Warn: Only warns the user
- 👢 Kick: Kicks the user
- 🔨 Ban: Bans the user
Configure allowed links
In the "Allowed Links (Whitelist)" field, add the domains you want to allow, one per line:
discord.gg
youtube.com
github.com
twitch.tv
Whitelist Rules
- ✅ You can put just the domain (e.g., discord.gg)
- ✅ You can put the full URL (e.g., https://discord.gg)
- ✅ The bot automatically normalizes (ignores www, protocols, etc.)
- ✅ Subdomains are included (if you allow discord.gg, status.discord.gg is also allowed)
If you allow youtube.com, these links will also be allowed:
https://www.youtube.com/watch?v=...http://youtube.com/channel/...youtu.be/...if you also add it
Whitelist Exemption
Users who are on the server's whitelist can send any link, regardless of the configuration. This is a way to allow trusted moderators and administrators to share links freely.
🎫 Links in Sentinel Tickets
A special feature of the Anti-Spam system is the ability to allow or block links specifically in Sentinel tickets.
Why this function?
In support tickets, users often need to share links (screenshots, logs, information, etc.). This option allows you to allow links only in tickets while keeping protection active in the rest of the server.
Configure from web panel
In Settings → Anti-Spam, find the "🎫 Links in Tickets" card:
- Enabled: Users can send any link in tickets without restrictions
- Disabled: Link protection also applies in tickets
Configure from commands
Use the command:
/antispam links-tickets permitir:true
Or to block links in tickets:
/antispam links-tickets permitir:false
- This option only affects tickets from the Sentinel ticket system
- Links in other channels will continue to be controlled according to your normal configuration
- If enabled, users can send any link in tickets, even if it's not on the whitelist
- Whitelisted users can always send links in any channel
🚨 Specific Detections
1. Duplicate Messages
The bot detects when a user sends the same message multiple times in a minute.
14:30:00 - User: "Hola a todos!"
14:30:05 - User: "Hola a todos!"
14:30:10 - User: "Hola a todos!"
14:30:15 - User: "Hola a todos!"
14:30:20 - User: "Hola a todos!"
Result The bot deletes all duplicate messages and executes the configured action.
2. Repeated Words
Detects messages with the same word repeated many times.
Message: "spam spam spam spam spam spam spam"
Result Detected as spam and deleted.
3. Excessive Mentions
Blocks messages with too many mentions of users or roles.
If you configure maximum 3 mentions and someone writes: @User1 @User2 @User3 @User4 @User5
Result Message deleted (exceeds limit of 3).
4. Excessive Links
Detects messages with too many links.
If someone sends a message with more than 3 links: Check out these links: https://link1.com https://link2.com https://link3.com https://link4.com
Result Detected as spam.
🤖 Anti-Spam Commands
You can manage all Anti-Spam protection directly from Discord using quick commands:
Main Commands
Enable/Disable Complete Protection
/antispam enable
Activates all Anti-Spam protection at once:
- ✅ Repeated message detection
- ✅ Mass mention control
- ✅ @everyone/@here blocking
- ✅ Link protection (if configured)
/antispam disable
Deactivates all Anti-Spam protection.
View Current Status
/antispam status
Shows a complete summary of the Anti-Spam protection status:
- General status (enabled/disabled)
- Link protection status
- Links in tickets configuration
- Repeated messages threshold
- Maximum mentions
- Configured action for spam
Manage Link Protection
/antispam links activar:true
Activates link protection.
/antispam links activar:false
Deactivates link protection.
Manage Links in Tickets
/antispam links-tickets permitir:true
Allows users to send any link in Sentinel tickets.
/antispam links-tickets permitir:false
Blocks links in tickets (normal link protection will apply).
Usage Examples
/antispam enableResult All Anti-Spam protection is activated instantly.
/antispam statusResult The bot shows an embed with all current Anti-Spam configuration.
/antispam links-tickets permitir:trueResult Users can now share links in tickets without restrictions, while protection remains active in other channels.
- ✅ Instant changes - You don't need to wait for the panel to sync
- ✅ Quick access from Discord - You don't need to open the browser
- ✅ Easy to use - One command to enable/disable everything
- ✅ Automatic synchronization - Changes are reflected in the web panel
📋 Spam Logs
All Anti-Spam actions are automatically logged in the configured spam log channel.
What is logged?
- ✅ User who sent the spam
- ✅ Type of spam detected (duplicate messages, links, mentions, etc.)
- ✅ Channel where it occurred
- ✅ Action executed (warning, kick, ban)
- ✅ Event timestamp
Configure Log Channel
- Go to Settings → Logs
- Find "Spam Log Channel"
- Paste the ID of the channel where you want to receive logs
- Save changes
You can use the same channel for all types of logs or create separate channels for better organization.
⚡ Optimization and Performance
The Anti-Spam system is optimized to respond in less than 30 milliseconds, which means:
- ✅ It doesn't slow down your server
- ✅ Detects spam almost instantly
- ✅ Deletes messages before other users see them
- ✅ Works without interfering with other bots
🎯 Best Practices
- Start with soft actions Use "Warn" first and adjust based on what you see.
- Adjust thresholds according to your server Large servers need higher thresholds.
- Use whitelist strategically Add trusted users to avoid false positives.
- Review logs regularly It will help you adjust the configuration.
- Configure link protection carefully Add the domains you really need to allow.
❓ Frequently Asked Questions
Does Anti-Spam affect whitelisted users?
No. Users on the whitelist are exempt from all spam protections EXCEPT @everyone/@here mentions (if blocked for everyone). Additionally, they can send any link regardless of the whitelist.
What happens if a legitimate user sends many messages?
The bot only detects repeated messages (same text). If a user sends different messages quickly, it won't be considered spam.
Can I disable only link protection?
Yes. You can enable general Anti-Spam but specifically disable link protection. They are independent configurations. You can use /antispam links activar:false to disable only link protection.
How do I know if a link will be blocked?
If the link's domain is not on your whitelist AND the user is not on whitelist, the link will be blocked. However, if the message is in a Sentinel ticket and you have the "Links in Tickets" option enabled, the link will be allowed.
Are links in embeds also blocked?
The bot detects links in the message content. Links in embeds may not be detected depending on how they're sent.
Can I allow links in tickets but block them in other channels?
Yes, absolutely. That's exactly the "Links in Tickets" feature. Activate link protection normally and then enable the "Links in Tickets" option from the web panel or with /antispam links-tickets permitir:true. This way, links will be blocked in the server but allowed in support tickets.
What happens if I disable Anti-Spam protection but leave link protection enabled?
Link protection is independent. You can have general Anti-Spam disabled but link protection enabled. In this case, only unauthorized links will be blocked, but other types of spam won't be detected.
Anti-Spam is a powerful tool that requires initial configuration. We recommend starting with soft configurations and adjusting according to your server's needs. Remember to review logs regularly to understand what type of spam you receive and adjust accordingly.