🔧 Moderation

---

⛔ Ban User

/ban

• Description
  Permanently removes a user from the group. The banned user cannot rejoin unless manually unbanned.

• Usage
  Can be used in one of the following ways:

  • By replying to a user's message:

    /ban 
  • By passing the Telegram user ID:

    /ban 1122334455 <reason?>
  • By passing the Telegram username:

    /ban @username <reason?>

• Arguments

  Argument	Type	Required	Description
  (none)	—	No	When replying to a user's message
  user_id	number	No	Telegram user ID of the target user
  @username	string	No	Telegram username of the target user (with @ prefix)
  reason	string	No	Add a reason for this action.

• Permissions
  Admins only

• Bot Response
  ✅ - User [@USERNAME] banned

• Notes
  Only one input method should be used at a time.
  The message that is replied to will be automatically deleted by the bot.

---

♻️ Unban User

/unban

• Description
  Reverses a previous ban, allowing the user to rejoin the group.

• Usage
  Can be used in one of the following ways:

  • By replying to a user's message:

    /unban
  • By passing the Telegram user ID:

    /unban 1122334455 <reason?>
  • By passing the Telegram username:

    /unban @username <reason?>

• Arguments

  Argument	Type	Required	Description
  (none)	—	No	When replying to a user's message
  user_id	number	No	Telegram user ID of the target user
  @username	string	No	Telegram username of the target user (with @ prefix)
  reason	string	No	Add a reason for this action.

• Permissions
  Admins only

• Bot Response
  ✅ - User [@USERNAME] unbanned

• Notes
  Only one input method should be used at a time.

---

🔇 Mute User

/mute

• Description
  Restricts the user from sending any messages in the group for a specified period or indefinitely.

• Usage
  Can be used in one of the following ways:

  • By replying to a user's message (with optional time):

    /mute [time]
  • By passing the Telegram user ID (mute indefinitely):

    /mute 1122334455 <reason?>
  • By passing the Telegram username (mute indefinitely):

    /mute @username <reason?>

• Arguments

  Argument	Type	Required	Description
  (none)	—	No	When used in reply without time, user is muted indefinitely
  [time]	string	No	Duration to mute the user: e.g., 10m, 2h, 3d, 1w
  user_id	number	No	Telegram user ID (required if not replying) — mutes indefinitely
  @username	string	No	Telegram username (required if not replying) — mutes indefinitely
  reason	string	No	Add a reason for this action. Only for forever mute.

• Permissions
  Admins only

• Bot Response
  ✅ - User [@USERNAME] muted until [DATE]
  or
  ✅ - User [@USERNAME] muted

• Notes
  Time format accepts:

  • Xm for minutes
  • Xh for hours
  • Xd for days
  • Xw for weeks
    (e.g., 10m, 3h, 2d, 1w)
    If no time is specified, the mute is permanent.

---

🔊 Unmute User

/unmute

• Description
  Lifts the mute restriction, allowing the user to send messages again.

• Usage
  Can be used in one of the following ways:

  • By replying to a user's message:

    /unmute
  • By passing the Telegram user ID:

    /unmute 1122334455 <reason?>
  • By passing the Telegram username:

    /unmute @username <reason?>

• Arguments

  Argument	Type	Required	Description
  (none)	—	No	When replying to a user's message
  user_id	number	No	Telegram user ID of the target user
  @username	string	No	Telegram username of the target user (with @ prefix)
  reason	string	No	Add a reason for this action.

• Permissions
  Admins only

• Bot Response
  ✅ - User [@USERNAME] unmuted

• Notes
  Only one input method should be used at a time.

---

⚠️ Warn User

/warn

• Description
  Issues a warning to a user. Repeated warnings can be used to trigger automated punishments like kicks or bans.

• Usage
  Must be used by replying to a message:

  /warn

  /warn <reason?>

• Arguments

  Argument	Type	Required	Description
  (none)	—	Yes	Must be used in reply to message
  reason	string	No	Add a reason for this action.

• Permissions
  Admins only

• Bot Response
  ✅ - User [@USERNAME] warned - Total warns: x/y

• Notes
  This command only works when used in reply to a user's message.
  The message that is replied to will be automatically deleted by the bot.

---

🧹 Remove User Warnings

/unwarn

• Description
  Clears the warnings issued to a user, resetting their strike count.

• Usage
  Can be used in one of the following ways:

  • By replying to a user's message:

    /unwarn
  • By passing the Telegram user ID:

    /unwarn 1122334455 <reason?>
  • By passing the Telegram username:

    /unwarn @username <reason?>

• Arguments

  Argument	Type	Required	Description
  (none)	—	No	When replying to a user's message
  user_id	number	No	Telegram user ID of the target user
  @username	string	No	Telegram username of the target user (with @ prefix)
  reason	string	No	Add a reason for this action.

• Permissions
  Admins only

• Bot Response
  ✅ - User [@USERNAME] warnings reset

• Notes
  Only one input method should be used at a time.

---

✅ Whitelist User

/whitelist

• Description
  Allows a user to bypass group restrictions without giving them admin privileges.
  For example, they can send messages containing blocklisted words without being warned.

• Usage
  Must be used by replying to a user's message:

  /whitelist

• Arguments

  Argument	Type	Required	Description
  (none)	—	Yes	Must be used in reply to message

• Permissions
  Admins only

• Bot Response
  ✅ - User [@USERNAME] WHITELISTED

• Notes
  This command only works when used in reply to a user's message.

---

🚩 Report a Message

/report

• Description
  This command allows users to report inappropriate or problematic messages to the group admins.

• Usage
  Must be used by replying to a message:

  /report

• Arguments

  Argument	Type	Required	Description
  (none)	—	Yes	Must be used in reply to message

• Permissions
  Everyone

• Bot Response
  Sends a direct message to all admins who have started the bot, notifying them about the reported message.

• Notes
  This command only works when used in reply to a user's message.