Bot General Behaviour

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.

Bot Settings

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.

Changing Bot Language

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.

  1. Select "Settings" on your chat profile

  2. Select "Edit" on the "General Behaviour" card

  3. Scroll to "Bot Settings" and select a new option in the"Language" drop down.

  4. Click "Save Changes" button

Allow Anonymous Admins

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.

  1. Select "Settings" on your chat profile

  2. Select "Edit" on the "General Behaviour" card

  3. Scroll to "Bot Settings" and enable the toggle"Allow Anonymous Admins".

  4. Click "Save Changes" button

Delete Bot Replies / Commands

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.

  1. Select "Settings" on your chat profile

  2. Select "Edit" on the "General Behaviour" card

  3. Scroll to "Bot Settings"

  4. Amend the value for "Delete Bot Replies After X minutes" we recommend 5 - 15 minutes.

  5. Amend the value for "Delete Commands After X seconds" we recommend 5 - 20 seconds.

  6. 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

User Moderation Warning System

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.

  1. Select "Settings" on your chat profile

  2. Select "Edit" on the "General Behaviour" card

  3. Scroll to "User Moderation Warning System"

  4. Amend the value for "Maximum Warning Limit" we recommend 3 - 4.

  5. 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.

  6. Click "Save Changes" button

Service Message Deletion

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:

  1. Select "Settings" on your chat profile

  2. Select "Edit" on the "General Behaviour" card

  3. Scroll to "Service Messages" section

  4. Turn on Remove Join Message, Remove Leave Message & Remove User Pinned Message dependent on which ones you wish to be removed.

  5. Click "Save Changes" button

Export & Import Chat Settings

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.

  1. Select "Settings" on your chat profile

  2. Select "Edit" on the "General Behaviour" card

  3. Scroll to "Export/Import Settings" section

  4. Click "Export Chat Settings" button

  5. Copy the text in the pop up and store it somewhere safe.

To import your chat settings complete the following steps

  1. Select "Settings" on your chat profile

  2. Select "Edit" on the "General Behaviour" card

  3. Scroll to "Export/Import Settings" section

  4. Paste in the text you had been provided when exporting settings previously into the "Import Chat Settings" text box.

  5. 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:

  1. Select "Settings" on your chat profile

  2. Select "Edit" on the "General Behaviour" card

  3. Scroll to "Copy Settings Between Your Chats" section

  4. Select a chat to copy FROM in the drop down list

  5. Click the "Import" button

FAQ & Troubleshooting

I want the bot to leave responses to our commands in the chat, it keeps deleting them!

You will need to set the value to 0 for "Delete bot replies" option in this settings area.

How can I export/back up my actions & commands?

The general behavior export and back up options only covers the options under the "Settings" area. To back up / export other areas there are dedicated export all options on their relevant pages. Navigate to the "Actions" or "Commands" pages and click "Export all" buttons to get a copy. You can then import these back into the relevant chats on the same pages using the "import" text boxes.

Last updated