Scarabeus Journal
All posts
3 min read

Bot commands in a Telegram group: the full list

Ban, mute and delete straight from the chat, as a reply to the offender. The full command list, duration formats and who can call what.

The dashboard is for setting up rules. Reacting quickly to one particular message does not need it — a single command in the chat, sent as a reply to the offender, is enough.

Command replies are visible only to whoever called them, so housekeeping does not clutter the chat.

For administrators#

Command What it does How to call it
/d delete the message as a reply only
/m mute /m @user 1h, or as a reply: /m 30m
/b ban /b @user 1d, or as a reply: /b 2h
/k kick as a reply or /k @user
/u lift a ban or a mute as a reply or /u @user
/s pick a punishment from a list as a reply or /s @user
/i the member's profile and log as a reply or /i @user
/log the member's log as a reply or /log @user
/msg write to a member as the bot /msg @user text, or as a reply: /msg text

Durations for mutes and bans are written short: 30m, 2h, 7d. A bare number means hours. Leave the duration out and the bot offers you options — handy when you are deciding on the spot.

For members#

Command What it does
/me my status in the chat
/why what I was punished for
/help which commands are available

/why is worth telling your members about: it heads off most of the "why was my message deleted" questions before they turn into a complaint to an administrator.

Who can do what#

A command checks dashboard permissions, not Telegram admin rights:

  • /i and /log — the "Members section" permission;
  • /m, /b, /d, /k, /s — the "Punishments" permission;
  • /u — the "lift ban and mute" permission;
  • /msg — available to the chat's Telegram administrators.

So a moderator you gave the logs to but not punishments can look up a profile with /i but cannot ban with /b. Permissions are granted in the Permissions section.

Switching them on and off#

Commands are configured per chat — both as a whole and one at a time. It is in the chat settings: you can leave administrators the full set and switch /me and /why off for members if your community has no use for them.

Everything done through a command lands in the moderation log alongside the automation, signed with the name of whoever called it. Manual bans do not get lost.

Commands are manual work. To need less of it, set up the automation: how to protect a Telegram group from spam.

How do I ban a user in a Telegram group through a bot?

Reply to their message with /b and a duration — for example /b 2h. Without a duration the bot offers options. For a permanent ban, pick the matching option from that list.

What format should the mute duration be in?

30m for thirty minutes, 2h for two hours, 7d for seven days. A bare number counts as hours.

Why does the bot not respond to my command?

Either you lack the matching permission in the dashboard's Permissions section, or the command is switched off for this chat. Telegram rights alone do not unlock a command.

Do other members see the bot's replies to commands?

No. The reply is shown only to whoever called the command.

Do manual bans end up in the log?

Yes, in the moderation log, with the name of whoever issued the punishment.

Read next