Reference

Live

All bot commands

Complete Defendy command reference: moderation, warnings, roles, information, settings and AI checks — syntax, aliases and required permissions.

The complete list of Defendy commands. Commands work in a group where the bot has been added as an administrator. For commands that act on a specific message or member, reply to the message in question.

How commands work

  • Prefixes. A command can start with /, !, ., , or ;. The Russian keyboard layout is recognized automatically — the bot will understand a command typed by key position.
  • Reply to a message. /ban, /mute and /warn target the author of the message you replied to; /del removes the message itself.
  • Name modifiers. Some commands accept a prefix:
    • d… — perform the action and delete the original message: /dban, /dmute, /dkick, /dwarn.
    • s… — silently, without a bot reply in the chat: /sban, /smute, /sdel, /spurge.
    • t… — with a duration: /tban 1h, /tmute 30m.
    • un… — undo the action: /unban, /unmute, /unwarn.

The time format is described in the Time formats section.

Access legend

  • 🟢 Everyone — available to any member.
  • 👤 Members only — members who are not Telegram administrators or the group owner. Having an internal Defendy role does not by itself exclude this access.
  • 🛡 Junior moderators+ — junior moderators and higher Defendy roles.
  • 🛡 Moderators+ — moderator, administrator, co-founder or owner.
  • ⚙️ Administrators+ — administrator and above.
  • 👑 Co-founders+ — co-founder and owner.
  • ★ Owner — the group owner only.

Roles and permissions are described in detail on the Roles and permissions page.

Moderation

CommandWhat it doesAccess
/ban /tban /dban /sbanBan a member. t — for a duration, d — with message deletion, s — silently.⚙️ Administrators+
/unbanRemove a ban.🛡 Moderators+
/mute /tmute /dmute /smuteRestrict sending messages. t — for a duration, d — with deletion, s — silently.🛡 Junior moderator+
/unmuteRemove the restriction.🛡 Moderators+
/kick /dkick /skickRemove from the group (the user can rejoin via a link).🛡 Moderators+
/del /sdelDelete a message by reply. s — without a notification.🛡 Moderators+
/purge /spurgeQueue deletion of up to the latest 200 message IDs from the reply through the command.🛡 Moderators+

Examples: /tmute 30m flooding, /ban @username advertising, reply to a message + /del.

The exact access is determined by the role's permissions. For example, a ban (/ban) is available from the administrator role, while a warning and a mute are already available to a junior moderator. The full matrix is on the Roles and permissions page.

Warnings

CommandWhat it doesAccess
/warn /dwarn /swarnIssue a warning. When the limit is reached, a punishment is triggered.🛡 Junior moderator+
/unwarn /dunwarn /sunwarnRemove one point; d deletes the source message; s removes the command and suppresses confirmation.🛡 Junior moderator+
/warnsShow a member's warning counter.🛡 Junior moderator+
/resetwarnsReset the counter.🛡 Junior moderator+
/setwarnlimit /warnlimitSet the warning limit (default 3).🛡 Junior moderator+
/setwarnmodeAction at the threshold: mute, ban, kick or nothing.🛡 Junior moderator+

Flexible escalation steps are configured in the panel — see Warnings.

Roles

CommandWhat it doesAccess
/mod /unmodAssign or remove a moderator.⚙️ Administrators+
/halfmod /unhalfmodJunior moderator.⚙️ Administrators+
/cleaner /uncleanerCleaner.⚙️ Administrators+
/booster /unboosterBooster (sponsor).⚙️ Administrators+
/helper /unhelperHelper.⚙️ Administrators+
/free /unfreeExempt member (immunity to filters).👑 Cofounder+
/admin /unadminAssign or remove an administrator.👑 Co-founders+
/cofounder /uncofounderCo-founder.★ Owner
/staffShow the group's moderation team.🟢 Everyone
/adminlist /modlist /halfmodlist /cleanerlist /helperlist /boosterlist /cofounderlist /freelistLists of members with a role.⚙️ Administrators+
/reloadRebuild administrative roles from Telegram; internal assignments can be replaced.Telegram administrators

A user can be specified by replying to a message, via @username, or by numeric ID.

Information

CommandWhat it doesAccess
/startGreeting and brief information.⚙️ Administrators+
/helpList of commands available for your role.🟢 Everyone
/meYour role and statistics in the group.🟢 Everyone
/rulesShow the group rules.🟢 Everyone
/statusInformation about a member (by reply or mention).🛡 Junior moderator+
/chatInformation about the group.🟢 Everyone
/chatidID of the current chat.🛡 Junior moderator+
/pingCheck the bot's response.🟢 Everyone

Chat and settings

CommandWhat it doesAccess
/pin /unpin /unpinall /repinManage pinned messages.⚙️ Administrators+
/reportReport a message (by reply).👤 Members only
/adminsCall administrators; a reply is optional.👤 Members only
/reports [on|off]Show state, or enable/disable report calls.🛡 Junior moderator+
/revokelinkRevoke the current invite link.⚙️ Administrators+
/nightmode on|off|status /nightNight mode.⚙️ Administrators+
/settopicDefault forum topic for the bot's messages.⚙️ Administrators+
/setcaptchatopic /setgreetingtopic /setfarewelltopic /setreputationtopicForum topic for a specific module.⚙️ Administrators+

To call administrators, use /admins or reply to the problem message with /report. Avoid /admin for reports because it is also a role-assignment command.

Both calls are visible in the current group or forum topic. They do not create anonymous complaints, private staff tickets or Telegram platform reports. /report without a reply gives usage guidance; /reports without arguments shows the current switch state. See the reporting workflow for privacy, evidence and missing responses.

Rules, greetings, filters and punishment settings are easier to change in the Defendy panel — commands are meant for quick actions and forum topics.

Reputation

Available if the reputation module is enabled.

CommandWhat it doesAccess
/rep /reputation /karmaShow reputation — your own or a member's by reply.🟢 Everyone
/toprep /topkarma /leaderboardReputation leaderboard.🟢 Everyone

AI spam check

The Beta module. Enabled by an administrator and works within the plan's monthly limit.

CommandWhat it doesAccess
/spamCheck a message (by reply) with AI. If it is spam, the message is deleted.🟢 Everyone, if the module is enabled
/spamonEnable the AI check module.⚙️ Administrators+
/spamoffDisable the module.⚙️ Administrators+
/spamstatusRemaining monthly check limit.⚙️ Administrators+

The monthly limit depends on the group's plan. Details are in AI spam check.

Supporting the project

CommandWhat it doesAccess
/donateWays to support the project.🟢 Everyone

Commands in a private chat with the bot

Send these directly to the bot, not to a group.

CommandWhat it doesAccess
/startOpen the main menu and WebApp. A deep link may open a specific flow.🟢 Everyone
/helpShow help for the private menu.🟢 Everyone
/premiumShow eligible groups and plans when Telegram Stars billing is enabled. Otherwise the bot reports that the feature is unavailable.Administrators of their groups
/termsOpen the Terms of Use.🟢 Everyone
/privacyOpen the Privacy Policy.🟢 Everyone
/paysupportOpen payment-support information.🟢 Everyone

Emoji catalog maintenance commands and the service-only /msg command are restricted to the Defendy owner and intentionally excluded from the user reference.

The ordinary /mute and /ban commands also accept a duration at the start of the reason. Temporary mutes must last at least 60 seconds. See time formats.

Need help?

If a setting behaves differently than expected, contact support.@ubotz