Moderation commands

Moderation commands are for immediate action in chat. Configure recurring automated policy in the WebApp, then use commands for a particular message or member.

Target a member#

The safest method is to reply to the offending message. Defendy then targets its author without needing a username.

You can also provide an @username or numeric Telegram ID:

/ban @username advertising
/mute 123456789 flooding

Put the reason after the member or duration. A clear reason helps other moderators and may appear in the log.

Ban, temporary ban and unban#

/ban blocks a member until /unban is used. /tban accepts a duration:

/tban 2d attempted scam

When used as a reply, the target is the original author. /dban also deletes that message, while /sban performs the action without posting a separate bot response.

A ban is stronger than a kick: a kicked member may rejoin with a valid invitation, while a banned member cannot.

Mute and unmute#

/mute prevents posting until /unmute. Use /tmute for a temporary restriction:

/tmute 30m flooding

/dmute also removes the replied-to message and /smute stays silent. See time formats for supported duration syntax.

Kick#

/kick removes a member without preventing a later rejoin. /dkick also removes the source message and /skick is silent.

/kick @username please complete verification again

Warnings#

/warn adds one point. An automatic filter configured for Warning can add its selected weight from 1 to 5. Reaching a threshold applies the configured action; a high-weight event can reach a higher tier immediately.

/warn continued off-topic posting

Use /warns to inspect the current total, not an incident history. /unwarn removes one point: if an event added three, one correction leaves two. /resetwarns clears the total and applied-tier state. The d variants remove the source message; the s variants suppress the bot response.

Correcting points does not lift an existing mute or ban. If the restriction was mistaken, check access separately and use /unmute or /unban. Removing a restriction does not clear warning points either.

Hypothetical policy: three warning points trigger a one-hour mute, and the total resets 24 hours after the first addition in its window. Later additions do not restart that window. Ending the mute does not clear points, and further additions can trigger the final action again. Configure thresholds and tiers under Warnings.

Delete messages#

Reply with /del to remove one message. Reply with /purge to the first message of a range. Deletion is queued, not instant. For a range longer than 200 message IDs, only the latest 200 IDs through the command are targeted; the start of a long range can remain. The s variants perform the same work silently.

Verify the first message before purging. Telegram message deletion cannot be undone.

Troubleshooting#

1. Confirm the reply or member identifier is correct.
2. Check your Defendy role and the bot's Telegram permissions.
3. Run /reload after administrator rights change.
4. Review the moderation log and the bot's exact response.

See All bot commands for every alias and access level.

Check the duration after changing an action#

Changing the punishment type can reset its duration to 0. Where supported, zero means an indefinite action, not a disabled punishment. A temporary mute lasts at least 60 seconds. Recheck the duration before leaving the form.