Skip to main content

🗳️ Vote Ban

The Vote Ban feature empowers communities to collectively moderate messages and users. Members can trigger actions, such as removing a message or banning a user, by responding to their content with a command /voteban .

Overview​

This feature democratizes moderation while ensuring efficient management of harmful or disruptive content. Instead of relying solely on admins, the community collectively decides when a user should be moderated, creating a more inclusive and fair moderation system.

Configuration​

To access Vote Ban settings:

  1. Use the /settings command in your chat
  2. Navigate to 🛡️ Moderation → 🗳️ Vote Ban
  3. Use the Toggle Vote Ban option to turn the feature 🟢 Enabled or 🔴 Disabled

Configuring Vote Ban Settings​

Saves Enabled​

Allows other users to cast a save vote in case someone is being unfairly targeted. If enough save votes are received in time, the action is canceled.

Protecting Against Abuse

Enable saves to prevent coordinated attacks or false accusations. This creates a balanced voting system where the community can defend innocent users.

Votes Needed​

Select the number of votes required to trigger the action.

🔨: The number of votes needed for a vote to pass. 😇: The number of saves needed for a vote to fail."

Recommended Settings by Community Size
  • Small groups (10-50 members): 3-5 votes
  • Medium groups (50-200 members): 5-10 votes
  • Large groups (200+ members): 10-20+ votes

Time Limit​

Specifies the cooldown time (in seconds) before a new vote can be initiated.

Use case: Prevents vote flooding and gives the community time between voting sessions.

Vote Expiry Time​

Defines how long (in minutes) a vote remains active before it expires.

📝 Note: If set to 0, the vote will never expire.

Choosing Expiry Time

Balance between giving enough time for votes to accumulate and preventing stale votes from lingering. Active communities can use shorter times (1-10m), while quieter groups may need longer periods (60m+).

Action​

You can define the trigger word and choose what action should be taken:

Available actions:

  • Mute: Silence the user temporarily or permanently
  • Kick: Remove the user, allowing them to rejoin
  • Ban: Permanently remove the user from the group
  • ⏲️ Duration: Set the duration (in days) for which the user is restricted.

Additional option:

  • Delete previous messages: To keep the chat clean, you can enable the option to remove that user's previous messages from the group
Message Deletion

Enabling message deletion will remove the user's chat history. Use this cautiously as it permanently erases their contributions.

Vote Ban in Action​

Here's how the Vote Ban process works:

Step 1: Initiate Vote​

A community member types the command /voteban in response to a user's message.

[User2 posts spam]
User1: /voteban

Step 2: Bot Announcement​

The bot announces the proposal:

"{User1} is proposing to ban {User2}. Do you agree?"

Step 3: Community Votes​

The group members can choose between two options:

  • Ban: Vote to ban the user
  • Save: Vote to save the user (if saves are enabled)

Step 4: Resolution​

Once the required number of votes is reached (for either Ban or Save), the bot takes the corresponding action:

  • Ban: The user is banned from the group
  • Save: The user remains in the group, and the vote is closed
Vote Progress

The bot shows vote progress in real-time, displaying how many votes have been cast and how many are needed.

Best Practices​

Effective Vote Ban System
  • Set vote thresholds proportional to your community size
  • Enable saves to protect against coordinated abuse
  • Set reasonable expiry times (60-120 minutes typically works well)
  • Combine with admin oversight
  • Educate community on when voting is appropriate
Troubleshooting

Vote command not triggering?

  • Verify Vote Ban is toggled 🟢 Enabled
  • Ensure the command is used as a reply to a message
  • Verify bot has necessary permissions

Votes not counting?

  • Check if the vote expiry time has passed
  • Verify users are using the correct voting buttons
  • Ensure the same user isn't voting multiple times

Save votes not working?

  • Verify "Saves Enabled" is turned on
  • Check if save threshold is set appropriately
  • Ensure save votes are cast before expiry

Action not executing?

  • Confirm bot has admin privileges
  • Check if bot has permissions for the action (mute/kick/ban)
  • Verify the user being voted on isn't an admin or whitelisted
  • Ensure vote threshold was actually reached

Too many false positive votes?

  • Increase votes needed threshold
  • Enable saves feature
  • Extend vote expiry time for more careful consideration
  • Educate community on proper use
  • Consider admin oversight for all votes

On this page