Reference
LiveAll 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,/muteand/warntarget the author of the message you replied to;/delremoves 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
| Command | What it does | Access |
|---|---|---|
/ban /tban /dban /sban | Ban a member. t — for a duration, d — with message deletion, s — silently. | ⚙️ Administrators+ |
/unban | Remove a ban. | 🛡 Moderators+ |
/mute /tmute /dmute /smute | Restrict sending messages. t — for a duration, d — with deletion, s — silently. | 🛡 Junior moderator+ |
/unmute | Remove the restriction. | 🛡 Moderators+ |
/kick /dkick /skick | Remove from the group (the user can rejoin via a link). | 🛡 Moderators+ |
/del /sdel | Delete a message by reply. s — without a notification. | 🛡 Moderators+ |
/purge /spurge | Queue 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
| Command | What it does | Access |
|---|---|---|
/warn /dwarn /swarn | Issue a warning. When the limit is reached, a punishment is triggered. | 🛡 Junior moderator+ |
/unwarn /dunwarn /sunwarn | Remove one point; d deletes the source message; s removes the command and suppresses confirmation. | 🛡 Junior moderator+ |
/warns | Show a member's warning counter. | 🛡 Junior moderator+ |
/resetwarns | Reset the counter. | 🛡 Junior moderator+ |
/setwarnlimit /warnlimit | Set the warning limit (default 3). | 🛡 Junior moderator+ |
/setwarnmode | Action at the threshold: mute, ban, kick or nothing. | 🛡 Junior moderator+ |
Flexible escalation steps are configured in the panel — see Warnings.
Roles
| Command | What it does | Access |
|---|---|---|
/mod /unmod | Assign or remove a moderator. | ⚙️ Administrators+ |
/halfmod /unhalfmod | Junior moderator. | ⚙️ Administrators+ |
/cleaner /uncleaner | Cleaner. | ⚙️ Administrators+ |
/booster /unbooster | Booster (sponsor). | ⚙️ Administrators+ |
/helper /unhelper | Helper. | ⚙️ Administrators+ |
/free /unfree | Exempt member (immunity to filters). | 👑 Cofounder+ |
/admin /unadmin | Assign or remove an administrator. | 👑 Co-founders+ |
/cofounder /uncofounder | Co-founder. | ★ Owner |
/staff | Show the group's moderation team. | 🟢 Everyone |
/adminlist /modlist /halfmodlist /cleanerlist /helperlist /boosterlist /cofounderlist /freelist | Lists of members with a role. | ⚙️ Administrators+ |
/reload | Rebuild 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
| Command | What it does | Access |
|---|---|---|
/start | Greeting and brief information. | ⚙️ Administrators+ |
/help | List of commands available for your role. | 🟢 Everyone |
/me | Your role and statistics in the group. | 🟢 Everyone |
/rules | Show the group rules. | 🟢 Everyone |
/status | Information about a member (by reply or mention). | 🛡 Junior moderator+ |
/chat | Information about the group. | 🟢 Everyone |
/chatid | ID of the current chat. | 🛡 Junior moderator+ |
/ping | Check the bot's response. | 🟢 Everyone |
Chat and settings
| Command | What it does | Access |
|---|---|---|
/pin /unpin /unpinall /repin | Manage pinned messages. | ⚙️ Administrators+ |
/report | Report a message (by reply). | 👤 Members only |
/admins | Call administrators; a reply is optional. | 👤 Members only |
/reports [on|off] | Show state, or enable/disable report calls. | 🛡 Junior moderator+ |
/revokelink | Revoke the current invite link. | ⚙️ Administrators+ |
/nightmode on|off|status /night | Night mode. | ⚙️ Administrators+ |
/settopic | Default forum topic for the bot's messages. | ⚙️ Administrators+ |
/setcaptchatopic /setgreetingtopic /setfarewelltopic /setreputationtopic | Forum 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.
| Command | What it does | Access |
|---|---|---|
/rep /reputation /karma | Show reputation — your own or a member's by reply. | 🟢 Everyone |
/toprep /topkarma /leaderboard | Reputation leaderboard. | 🟢 Everyone |
AI spam check
The Beta module. Enabled by an administrator and works within the plan's monthly limit.
| Command | What it does | Access |
|---|---|---|
/spam | Check a message (by reply) with AI. If it is spam, the message is deleted. | 🟢 Everyone, if the module is enabled |
/spamon | Enable the AI check module. | ⚙️ Administrators+ |
/spamoff | Disable the module. | ⚙️ Administrators+ |
/spamstatus | Remaining monthly check limit. | ⚙️ Administrators+ |
The monthly limit depends on the group's plan. Details are in AI spam check.
Supporting the project
| Command | What it does | Access |
|---|---|---|
/donate | Ways to support the project. | 🟢 Everyone |
Commands in a private chat with the bot
Send these directly to the bot, not to a group.
| Command | What it does | Access |
|---|---|---|
/start | Open the main menu and WebApp. A deep link may open a specific flow. | 🟢 Everyone |
/help | Show help for the private menu. | 🟢 Everyone |
/premium | Show eligible groups and plans when Telegram Stars billing is enabled. Otherwise the bot reports that the feature is unavailable. | Administrators of their groups |
/terms | Open the Terms of Use. | 🟢 Everyone |
/privacy | Open the Privacy Policy. | 🟢 Everyone |
/paysupport | Open 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.