Media & Text Filters

Modr8 has an array of built in options for you to filter media and text sent into your chat. Whether you wish to keep certain media out of your chat or you have identified some bad web-links being repeatedly used you can use our media & text filters module to take action.

To gain access to the media & text filters module follow these steps:

1. Login to the Modr8 platform

2. Select "Manage" on your bot profile

3. Scroll to your chat profile and select "Settings"

4. Click "Edit" on the "Media & Text Filters" card

The following sections are dedicated to explaining what each filter will do and how best to setup and amend its configuration options.

Media Management

The media management filter allows you to select which media the bot will delete as soon as it identifies a message of that type in the chat. It is a good way of keeping your chat clear of certain types of media that may need approval or you simply wish to keep clear of your group.

Modr8 supports removing: Animations, Audio, Contacts, Documents, Games, Locations, Passports, Photos, Stickers, Venues, Videos, Voice Messages & Polls.

Media management module will delete media messages that meet your criteria from the chat

1. Login to the Modr8 platform

2. Select "Manage" on your bot profile

3. Scroll to your chat profile and select "Settings"

4. Click "Edit" on the "Media & Text Filters" card

5. Scroll to "Media Management" section

6. Enable the module by toggling the "Remove Media" switch

7. Click into the "Remove Media List" and select the media items you do not want in your chat from the drop-down list.

8. Elect to enable "Issue Warning" switch if you want the bot to delete & issue the user a warning. If they breach your warning limits set in your general settings then the warning breach action will run too.

Forwarded Content Filter

Often members will forward messages and content into your chat to share with the rest of the group. Sometimes this content may not be relevant, such as spam or promotions for other groups. The Modr8 engine supports removing these messages by you specifying either:

• A list of users/channels/ID's you ONLY allow content to be forwarded from

• A list of users/channels/ID's you DO NOT allow content to be forwarded from

These two options make it easier for you to decide whether you work on a "deny by default" basis or an "allow with exceptions" basis. The choice is yours!

Forwarded content filters allow you to remove forwarded content that is sent to your chat by others

1. Login to the Modr8 platform

2. Select "Manage" on your bot profile

3. Scroll to your chat profile and select "Settings"

4. Click "Edit" on the "Media & Text Filters" card

5. Scroll down to the "Forwarded Content" section

6. Enable the "Remove Forwarded Messages" switch to enable the module

7. Elect to switch on the "Issue Warning" switch if you want the bot to delete & issue the user a warning. If they breach your warning limits set in your general settings then the warning breach action will run too.

8. Choose how you want your list to behave using the "List Behaviour" radio buttons.

   • Whitelist - You will provide a list of channels / usernames / ID's that you will ALLOW forwarded content from.

   • Blacklist - You will provide a list of channels / usernames / ID's that you DO NOT allow forwarded content from.

9. Add usernames or ID's to your "Black/White List" set with one item per row.

10. Add further rows by clicking the "Add Row" button

Profanity Filtering

Modr8 comes with a bult in list of profane words that can be used to filter against. This list includes various languages and also l33t sp34k versions for when users are attempting to hide the bad words they are using.

Modr8 Profanity Filter will delete any profanity in your chat.

1. Login to the Modr8 platform

2. Select "Manage" on your bot profile

3. Scroll to your chat profile and select "Settings"

4. Click "Edit" on the "Media & Text Filters" card

5. Scroll to the "Profanity Filter" section

6. Enable the module turning on the "Remove Profanity" switch

7. Elect to switch on the "Issue Warning" switch if you want the bot to delete & issue the user a warning. If they breach your warning limits set in your general settings then the warning breach action will run too.

Link Filtering

Being able to manage the web links shared by users in your chat is one of the most important filters you will use. Often users will use links for not just directing other users to web sites but also to other groups and invitations. You can use this module to delete links, even those which Telegram itself does not identify as a full web address will be identified by our algorithms.

The Modr8 engine supports removing messages containing links by you specifying either:

• A list of addresses, domains or sub domains you ONLY allow

• A list of addresses, domains or sub domains you DO NOT allow

These two options make it easier for you to decide whether you work on a "deny by default" basis or an "allow with exceptions" basis.

Modr8 link removal module will identify links in messages and allow you to set whether they should be deleted or not

1. Login to the Modr8 platform

2. Select "Manage" on your bot profile

3. Scroll to your chat profile and select "Settings"

4. Click "Edit" on the "Media & Text Filters" card

5. Scroll down to the "Link Handling" section

6. Enable the "Block Web Links" switch to enable the module

7. Elect to switch on the "Issue Warning" switch if you want the bot to delete & issue the user a warning. If they breach your warning limits set in your general settings then the warning breach action will run too.

8. Choose how you want your list to behave using the "List Behaviour" radio buttons.

   • Whitelist - A list of addresses, domains or sub domains you ONLY allow

   • Blacklist - A list of addresses, domains or sub domains you DO NOT allow

9. Add domains, full addresses or partial addresses into the "Link List" set with one item per row.

10. Add further rows by clicking the "New Row" button

Excessive Emojis Filter

There can be times where you have people using excessive amounts of emojis in chats. This can happen in single messages where someone is promoting or issuing an advert type of message. Modr8 can filter messages which breach a limit you set for the number of emojis that can be used in a single message.

Modr8 can filter messages that breach you limit of allowable emojis per message

1. Login to the Modr8 platform

2. Select "Manage" on your bot profile

3. Scroll to your chat profile and select "Settings"

4. Click "Edit" on the "Media & Text Filters" card

5. Scroll down to the "Excessive Emojis Filter"

6. Enable the "Remove Emojis" toggle switch to activate the module

7. Enter the number of emojis you will allow per message in the "Maximum Allowed Emojis" input box

8. Elect to switch on the "Issue Warning" switch if you want the bot to delete & issue the user a warning. If they breach your warning limits set in your general settings then the warning breach action will run too.

Regular Expression Filtering

If you have specific text patterns you wish to delete within your chat you can use Regular Expression filters to do so. This area is often used when there are simple patterns you wish to match, but if you need something more advanced or more customisations you can use our Actions engine. When a keyword is matched against the message then it is removed from your chat.

Regular Expression Filtering

1. Select "Settings" on your chat profile

2. Select "Edit" on the "Advanced Settings" card

3. Scroll down & turn on"Enable RegEx Filtering" toggle

4. Elect to issue a "Warn on Regex Match" to use the warning system

5. Elect to display a message saying a message was deleted due to meeting a rule by enabling "Display Deletion Notification"

6. Add in your regular expression rules, one per row in the "RegEx Rules" section.

We recommend testing out your rules at RegExr.com and for anything more advanced you'll want to use our Actions module.

❓FAQ & Troubleshooting

I want to block people sending invitations to WhatsApp or Telegram groups

You'll want to use the Link Filtering module for this.

In this module make sure you have configured it to work as a blacklist and provide the following links to the link list, one per row:

https://t.me/

https://w.app/