Skip to content

Admin Logging

While it's nice to use Telegram's "recent actions" feature to view recent actions in your group, it's not always easy to use this to keep track of what actions have been done by the bot, and which admin issued them. Not to mention, they're recent, so if you need to check something quite far back, you're out of luck. Thankfully, Rose allows you log the actions of your admins!

Setting Up A Log Channel

There are a several steps you'll need to take to set up a log channel, which are listed below:

  1. The first step is to create a new channel. You can also use a pre-existing channel if you wish. Name the channel anything you want, the name isn't important to Rose. Remember, channels are not the same as groups. You cannot use a group chat as a log channel - it must be an actual channel!
  2. Add Rose to the channel as an admin. You actually don't have a choice in this, as Telegram will present you with a pop-up to advise you that you may only add bots to channels as administrators. Go ahead and do this.
  3. Send the below command to the channel:

/setlog

  1. You'll get a response from Rose telling you to forward the original /setlog message
  2. As per Rose's instructions, forward this /setlog command to the group chat you wish to be logged.
  3. That's it! Rose will now log admin actions in the channel!

Note

You may set multiple group chats to use the same log channel. Simply forward the /setlog command to whichever other group chats you wish to be logged in the channel (like you originally did in Step #5)

Stop Chat Logging

If at any point you wish to stop logging a group chat, simply issue the below command in the group chat that you no longer want logging to be performed on:

/unsetlog

Rose will reply to the chat with a message letting you know that the chat will no longer be logged.

Check Current Log Channel

If you want to check if your group chat is currently being logged, and if so, what the name of the log channel is, you can issue the below command in the group chat:

/logchannel

Customising log categories

If you don't want Rose to log all actions, you can customise the categories that are handled. By default, all categories are enabled.

Available categories

You can check the available log categories with the following command:

/logcategories

For simplicity's sake, the current categories are:

  • settings: Bot settings which can be toggled or edited - such as blocklists, welcomes, rules, etc.
  • admin: Admin actions - such as bans, mutes, kicks, and warns.
  • user: User actions - such as kickme, or joining/leaving
  • automated: Automated admin actions taken after locks, blocklists, or antiflood have been triggered
  • reports: Reports from users - through @admin, or /report.
  • other: Logs regarding extra features, such as notes and filters.

Note

The log for users leaving is only logged until the group reaches 50 users; this is to be in line with Telegram's settings, and to avoid spamming low-quality information in your log channel.

Enabling categories

By default, all categories are enabled. But to explicitly enable them, use:

/log <type(s)>

Example

For example, to enable admin and user categories, use:

/log admin user

Similarly, to stop logging certain categories, use this command:

/nolog <type(s)>

Example

For example, to stop logging setting changes, use:

/nolog settings