Skip to main content

🗳️ Vote Ban

Vote Ban lets members vote to act against another member. A member replies to a message with /voteban, and if enough members agree before the vote expires, the agent carries out the action you set. A member without ban permission who replies with /ban starts a vote too.

Configuration​

In the webapp​

Open your workspace, select the Telegram group under Channels in the sidebar, then select Moderation, then the Vote Ban tab. Changes save with the Save bar at the bottom of the page.

In Telegram (bot menu)​

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.

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.

Time Limit​

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

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.

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

This permanently deletes that member's earlier messages in the group.

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.

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

On this page