Bot General Behaviour
Last updated
Last updated
When setting up your Modr8 protected chat there are a number of general settings which you may want to adjust. The General Behaviour area is dedicated to quick and simple settings which you most likely set once and then do not need to touch again. So if you are looking to update the number of warnings in the warning system or maybe you want to import or export your chat settings then this is where you will need to be.
The following sections will itemise each of the options, explain their usage and how to set them.
Every chat has its own "Settings" this means you can have your bot responding to users in English with 2 warnings before a ban in one chat, whilst responding in Chinese in another chat with the warning system set to 10 warnings.
Under bot settings you are able to change the language the bot will respond to users with in its standard moderation notifications as well as how bot commands and replies are cleaned up after being sent.
When Modr8 takes action in your chat or outputs some of its standard commands it will use the language you specify in the Language area. To change the default from English to another language complete the following steps.
Select "Settings" on your chat profile
Select "Edit" on the "General Behaviour" card
Scroll to "Bot Settings" and select a new option in the"Language" drop down.
Click "Save Changes" button
Sometimes you may wish your admins to remain anonymous in your chat, where their messages show up as if they were sent by the chat itself. Whilst this is great for anonymity unfortunately telegram removes so much information that sometimes we are unable to see who is requesting commands and moderation to be executed. You may remember, during activation of your chat we had to remove anonymous admins, however once that has been completed we can infer the level of access since we do not specifically need to know if an admin is the bot owner of not.
To enable anonymous admins in your chat to use your bot moderation features such as /ban /warn etc then complete the following steps.
Select "Settings" on your chat profile
Select "Edit" on the "General Behaviour" card
Scroll to "Bot Settings" and enable the toggle"Allow Anonymous Admins".
Click "Save Changes" button
When the bot issues a response in your chat to either a command or filter it will leave the message in place for some time. You may wish to adjust how long this response stays visible before being deleted.
In addition, you may wish to change how long the actual /command /ban etc stays in the chat itself. Often communities want their bot responses to commands to last for a few minutes, but want the actual command that executed them to be removed quite quickly.
To amend these settings complete the following steps.
Select "Settings" on your chat profile
Select "Edit" on the "General Behaviour" card
Scroll to "Bot Settings"
Amend the value for "Delete Bot Replies After X minutes" we recommend 5 - 15 minutes.
Amend the value for "Delete Commands After X seconds" we recommend 5 - 20 seconds.
Click "Save Changes" button
If you want bot replies to never be deleted then set the value to 0 or a negative number like -1
You can prevent the bot from sending out messages whenever it moderates a post, allowing moderation to occur silently. For instance, if media is filtered, the bot will no longer announce, "Bob (12345678) this type of media is not allowed in this chat."
Typically, these messages delete based on the "Delete Bot Replies" timeout, but you might just want to disable these from sending completed. To turn these messages off you can complete the following steps.
Select "Settings" on your chat profile
Select "Edit" on the "General Behaviour" card
Scroll to "Bot Settings"
Turn the switch on for the "Disable Bot Moderation Messages" option.
Click "Save Changes" button
Modr8 has a built in warning system which can be used to warn users prior to taking more permanent action against them. On various built-in features you may have seen "Issue Warning" when a filter is matched. The number of warnings before action is taken is configured in the user moderation warning system section.
You are able to adjust the number of warnings to limit and also the action to be taken. To make changes to the configuration complete the following steps.
Select "Settings" on your chat profile
Select "Edit" on the "General Behaviour" card
Scroll to "User Moderation Warning System"
Amend the value for "Maximum Warning Limit" we recommend 3 - 4.
Amend the selected value for the action to be taken when warning limit is reached "If limit reached then.." you may wish to mute, kick (non-permanent ban) or ban the user from the community. If you select to mute you can specify the duration for it to last.
Click "Save Changes" button
When a new user joins, someone leaves or a message is pinned you will notice there can be a lot of chat "service messages" stacking up. Modr8 can clean these up for you to ensure conversations flow more smoothly.
To automatically clear telegram service notifications turn on the following options:
Select "Settings" on your chat profile
Select "Edit" on the "General Behaviour" card
Scroll to "Service Messages" section
Turn on Remove Join Message, Remove Leave Message & Remove User Pinned Message dependent on which ones you wish to be removed.
Click "Save Changes" button
There can be times where you may use multiple bots within your chat and you don't want your modr8 bot to respond to conflicting commands i.e. /ban /warn etc. Enable the option to disable moderation commands to have your bot ignore these messages.
To disable moderation commands turn on the following option:
Select "Settings" on your chat profile
Select "Edit" on the "General Behaviour" card
Scroll to "Disable Moderation Commands" section
Turn on Disable Moderation Commands toggle.
Click "Save Changes" button
Your bot will no longer respond to any of the built in Moderation Commands.
You may find that you wish to have "Admins" in your chat to provide them with customised "Titles", something that is easy to do on Discord but not so easy on Telegram. Often, these Admins do not have permissions to remove users, ban, change chat info and add other admins. They may however, still be able to use Modr8 bot commands to carry out these actions, since your bot has the required access.
To ensure your admins who have a restricted scope of administrative permissions are also stopped from using Modr8 built in bot commands i.e. /ban /pin /warn then you can enable our "Admin Command Access" module.
Select "Settings" on your chat profile
Select "Edit" on the "Advanced Settings" card
Turn on"Restrict Command Access" toggle
Your Modr8 bot will now only allow commands to be executed based on the permissions your admin has in Telegram.
When setting up multiple chats you may wish to configure a base set of configuration and then import these into other chats. You may also wish to just take a backup of all of your filters and other bot settings. To do this we have an import and export settings area. You can use this to extract settings as well as paste in settings to import them.
To export your chat settings complete the following steps.
Select "Settings" on your chat profile
Select "Edit" on the "General Behaviour" card
Scroll to "Export/Import Settings" section
Click "Export Chat Settings" button
Copy the text in the pop up and store it somewhere safe.
To import your chat settings complete the following steps
Select "Settings" on your chat profile
Select "Edit" on the "General Behaviour" card
Scroll to "Export/Import Settings" section
Paste in the text you had been provided when exporting settings previously into the "Import Chat Settings" text box.
Click "Import Chat Settings"
As well as being able to import chat settings from settings configuration text, we also hae the ability to copy settings between chats that the bot is already an admin and is already activated for.
To complete a copy-over follow these steps:
Select "Settings" on your chat profile
Select "Edit" on the "General Behaviour" card
Scroll to "Copy Settings Between Your Chats" section
Select a chat to copy FROM in the drop down list
Click the "Import" button
