Skip to content

Moderation commands

Type the commands in the group. To select the target, type the command as a reply to the message of the person. Or write the @username as the first word after the command: /mute @johndoe 10m spam. Only the first word counts. An @name in the reason is not a target. Permission: team role + Telegram admin status + bot permission. The bot silently ignores a command without permission.

Command Example Role
/warn [reason] /warn spam Moderator+
/mute [duration] [reason] /mute 10m link Moderator+
/unmute Moderator+
/kick [reason] Moderator+
/ban [duration] [reason] /ban 3d Moderator+
/sban [count] [duration] [reason] /sban 3 Senior moderator+
/unban Senior moderator+
/purge [count] /purge 20 or reply with /purge Senior moderator+
/report everyone —

A Senior moderator and a Moderator must write a reason for /warn, /mute, /kick, /ban and /sban.

Duration format: 10m, 2h, 3d, 1w. For a penalty with no end, leave the duration empty.

  • The reply of the bot is temporary (the bot deletes it after 15 seconds). If the bot cannot send it, you get a private message.
  • The Undo button shows for 30 seconds.
  • A report card goes to the log channel. The first person who acts on the card makes the decision. The second person sees "Already handled."
  • A member can send at most 3 reports in 10 minutes. A report about yourself does not count.
  • Warning ladder: the 3rd warning gives a 24-hour mute. Warnings expire after 30 days.
  • The bot writes each action to the audit log. The bot sends you a summary of the action in a private message. If the 📣 Notification target setting of the group (Chats → group → 🧹 Filters) is "log chat", the summary goes to the log channel. If the setting is "private message + log chat", the summary goes to both places. If the bot cannot write to you (you did not start the bot), the summary goes to the log channel.
  • The person sees the decision and a short reason in a private message. The message has an "Appeal" button.
  • Silent ban (/sban): the bot deletes the replied message (if there is one) and the command, and bans the person. The bot also deletes the "removed" service message. /sban 3 also deletes the last 3 messages of the person (from the last 48 hours). No reply shows in the group, and the person gets no message. You get the card in a private message (if you did not start the bot, the card goes to the log channel). The Unban button on the card has no time limit. Bot permissions: restrict members and delete messages. You can also select silent ban as the action of a filter. On that path, the bot also deletes the messages of the person from the last 30 minutes. The default action of every filter category is "delete + warn".
  • Repeated spam: the bot deletes a message that looks like a known spam message. The bot does not ban anyone automatically for this reason. If the person joined in the last 24 hours, you get a 🔁 Repeated spam card. The 🔇 Ban silently button does the same action as /sban (valid for 24 hours). The bot does not learn links from you or from a trusted member as spam.
  • Ban in my other chats too: the /ban result and the silent ban card have a ⛔ Ban in my other chats too (N) button. The bot also bans the person in your other approved groups and channels in the same workspace. With a silent ban, no notice shows in those groups either. The bot does not delete the messages of the person in the other chats. In each chat, you must be an admin and the bot must have the ban permission. The bot skips a chat where this is not true. The card shows that chat with the reason. ↩️ Unban in the other chats removes only the bans that this button added.

Trusted list

Automatic moderation does not touch a person or a bot on the trusted list. Thus the bot does not remove this account, mute it or delete its messages by mistake.

Command What it does Role
/trust Makes the sender of the replied message, or the person in /trust @name, trusted in all your chats Admin+
/trust here Makes the sender trusted only in this chat Admin+
/untrust Removes the person from the list (here: only the record for this chat) Admin+
  • The exemption covers hard rules (words, flood, mass mention, links, newcomer limits) and content filters. It also covers the silent ban filter, AI moderation, natural-language rules and repeated spam learning. It also covers new member verification, raid mode, CAS, the bot-add rule and moderation steps in automations.
  • Commands that you give by hand (/ban, /sban …) still work. The card shows the ⚠ On the trusted list warning.
  • Moderation cards have a ✅ Make trusted button. If a ban or a mute is active, the bot removes it first. Then the person becomes trusted in all your chats.
  • Ban in my other chats too skips the chats where the person is trusted, and shows how many it skipped.
  • Manage the list in the bot, on the /panel → 🛡 Trusted list screen. To add a person, forward one of their messages or type their numeric Telegram ID. Then select the scope. If a person hides their account in forwarded messages, the forwarded message does not show the ID. In this case, use /trust in the group.
  • Command permission: the Owner or Admin role on the team, and Telegram admin status in the group. A Moderator cannot change the list.