Adding Rules

Instead of spending hours of your time clicking and selecting different configuration settings like other moderation bots, Modr8.ai allows you to write your chat rules in natural language. As an example, if you wanted to block people sending messages with a certain name you can simply add a rule like "No messages from users with 'support' in their name" and the AI will take care of the rest.

Write your chat rules in to our AI engine and let your bot take care of the rest

The following section will walk you through adding rules which are applicable for both Text moderation & Media moderation.

Enabling Moderation Rules

First we will enable the Media / Text Moderation rule module.

1. Login to the Modr8 AI platform

2. Click "Manage" on the bot profile card

3. Find the Chat you wish to write rules for and click the "Text Moderation" or "Media Moderation" button

4. You will be redirected to the moderation rule configuration page.

5. Click the toggle button beside "AI Enabled" to turn the module on.

Enable or disable AI moderation using the AI enabled toggle

✍️ Adding Chat Rules

Rules are added using natural language, meaning you write your rules for your chat as you would if you wanted to post them in the chat for your group members to see. The AI interprets and ensures messages sent to your chat adhere to the rules you set. To start adding rules complete the following steps:

1. Login to the Modr8 AI platform

2. Click "Manage" on the bot profile card

3. Find the Chat you wish to write rules for and click the "Text Moderation" or "Media Moderation" button

4. You will be redirected to the moderation rule configuration page.

5. Scroll down to the "Chat Rule Creator" section

6. Enter a chat rule in the text box provided such as "No swearing or profanity"

7. Click "Add New Rule" button to save the rule.

8. Your rule will be added to the Chat Rules table

Add chat rules using the rule creator form. Remove rules from the chat rules table if you do not need them anymore.

Rules added to your moderation page will update in real-time and your AI bot will begin monitoring against them immediately.

✍️ Removing Chat Rules

When it's time to remove or clean up your rules you can simply delete them from your Chat Rules table. To do so complete the following steps:

1. Login to the Modr8 AI platform

2. Click "Manage" on the bot profile card

3. Find the Chat you wish to write rules for and click the "Text Moderation" or "Media Moderation" button

4. You will be redirected to the moderation rule configuration page.

5. Scroll down to the "Chat Rule" table

6. Review which rule you wish to remove and click the "Remove" button at the end of the row

7. Confirm you wish to delete and the table updates in real-time

Clicking the "Remove" button will delete a chat rule from the list

FAQ & Troubleshooting

What happens when a rule is matched or broken?

When a message is sent to your chat the AI bot will review whether it meets any of your rules. If it does and the AI bot decides the rule has been broken it will delete the message.

How do I know which rules are moderating messages?

To review which rules are triggering or being broken when the AI bot reviews messages being sent to your chat we recommend enabling the "Event Log" this functionality will show the output of AI decisions for every message being sent dependent on whether "kept" or "deleted".

To enable the Event Log follow the link here and complete the setup steps.

What type of rules can I write?

We send the whole payload to the AI model, so you can write rules around any part of the Telegram payload, bearing in mind there are text based messages and image based messages. To give an overview of what attributes you can reference here is a simple list: - User profile i.e. first name, username, user id - Message properties i.e. forwarded message, text, date & time sent, origin