Welcome Message & Human Check

Being able to welcome new members to your community allows admins to provide rules, useful information and links out to wider resources.

Modr8 provides the ability to send welcome messages as users join the chat as well as include media such as images and videos. In addition, you may wish to show your links as clickable buttons below the message.

To create a welcome message complete the following steps. We will also show you options we have for human verification checks which can often stop automated user bots from joining just to spam your chat with bad messages.

Creating Your Welcome Message

The user interface for your

Looking to personalise your welcome message? Tap the "Click here for Personalisation tag guide" below the Welcome Text box to see a list of tags you can add to your message.

1. Select "Settings" on your chat profile

2. Select "Edit" on the "Welcome Message & Captcha Check" card

3. Turn on"Welcome Users" toggle

4. Add your message using the text editor - you can add personalisation using {{ }} tags like {{user}} to link to your users name.

5. Click "Save Changes"

Adding Media To Your Message

Modr8 supports adding an image, gif or video to your welcome message. If your message is relatively short we will send this image using the native Telegram image functionality with your actual text as a caption. This looks really nice! If your message is quite long, to bypass the limited character length of captions we will send the image as a web page preview, it will show below the text.

1. Scroll to the "Image" input box on the "Welcome Message" card

2. Paste a direct link to your media content

Make sure to use direct link to your image, animation or video. It should end in .png .jpg .gif .mp4. Often when using services like imgur they give you a link to a web page and not the actual image!

Adding Buttons To Your Message

A welcome message containing personalisation and a button linking to our Modr8 Announcements channel

To make your messages easier to understand you might want to add buttons to your welcome, rather than a long list of links. Modr8 allows you to add multiple buttons over multiple rows to your message. We also support buttons that can open a website, execute a custom command or execute an action that you may have built.

1. Scroll to the "Message Buttons" area and click the "Buttons" button.

2. A pop-up will open

3. Click the "+" button to add a new button to the row

4. Give the button a title, which will be shown to users on the button.

5. Select the "type" of button i.e. Link, Command or Action

   • If you select "link" then you can enter a website address in the "Web Link" input box

   • If you select "Command" a list of your custom commands will be shown to select from

   • If you select "Action" a list of your custom actions will be shown to select from

6. Click "Save" to complete the button setup.

7. If you want to add another button follow the same process again, if you want to add a new row click the "Add Row" button.

Adding a button to your welcome message can be done by clicking the green button!

Adding your website or another link is easy using the "Link" type

You can add multiple rows of buttons by click "Add Row"

Adding Human Verification & Captcha Checks

Whilst Modr8 offers lots of tools to block spam in your chat there are times you want to try and block the bots and spammers from entering your community before needing other measures.

When joining the chat users are automatically restricted from being able to send any content to your chat. To remove this restriction they need to complete verification. You are able to set a time-frame that they need to complete this by, if they do not complete the task they are kicked from the channel and can return to try again after 30 seconds. The Modr8 engine offers 3 types of verification checks and will be adding more soon. These are:

• Simple Button - Users are required to click a button displayed below the welcome message

• Review & Accept Rules - Users are required to click a button which opens up a direct message with your bot. They will be shown a set of rules/message you define and are required to click to accept.

• Answer Maths Question - Users are required to click a button which opens up a direct message with an image of a maths question. The user needs to enter the right answer.

Review the following sections to view instructions on how to set these up!

Option 1: Simple Button Click Verification

This is the lowest level of captcha/verification check available. When a user joins the chat they will be presented with your welcome message and a button to verify they are human. To setup this verification complete the following steps.

1. Select "Settings" on your chat profile

2. Select "Edit" on the "Welcome Message & Captcha Check" card

3. Turn on"Welcome Users" toggle if it is not already on and add your welcome message

4. Scroll down to "User Verification & Captcha" section and enable the "Require Verification" toggle.

5. Ensure the verification check type is set to "Simple Button Click"

6. Amend the text that will be shown on the button by editing the "Verify button text"

7. You can enable of disable showing a message in chat when a user passes or fails their check.

8. Amend the amount of time a user has to complete their check using the "Kick if not verified" amount which is set in minutes. We recommend leaving this to 3 minutes.

The Simple Button Check displayed below a welcome message to allow users to verify.

The outcome of a "passed" bot check is displayed if this is enabled. The failed check will display similar.

Option 2: Request To Review & Accept Community Rules

Often community rules are pinned to the chat header or they are mixed into the welcome message itself. You may want to prove users have explicitly accept or read some rules before they can begin to chat in your group. To handle this we recommend you use the Review & Accept Rules verification option. The rules are displayed in private message once the user clicks the button on your welcome announcement.

Request users to review a set of rules and explicitly accept them/agree before they are allowed to chat

1. Select "Settings" on your chat profile

2. Select "Edit" on the "Welcome Message & Captcha Check" card

3. Turn on"Welcome Users" toggle if it is not already on and add your welcome message

4. Scroll down to "User Verification & Captcha" section and enable the "Require Verification" toggle.

5. Ensure the verification check type is set to "Review & Accept Rules"

6. Amend the text that will be shown on the welcome button by editing the "Verify button text" we recommend using text like the image above.

7. Enter the rules, disclaimer or any other information you wish to be displayed to the user for them to agree to in the "Rules Text" input box. This will be displayed in private message to the user!

8. Amend the "Accept button text" which is displayed on the agreement button that unlocks the chat for the user and is displayed against the rules text message sent to them in private.

The user is presented the verify button text when joining the chat

The user is redirected to the bot in private message and the rules along with accept button are shown.

Option 3: Request To Answer Maths Question

Our maths question verification is one of the toughest measures for human verification at this time. It would require a scripted bot to click a button, go to private message and reverse engineer a maths question image to then present an answer. We've found this verification works very good for keeping your chat clean of spam bots.

Request users to verify they are human by answering a maths question in private chat with your bot

1. Select "Settings" on your chat profile

2. Select "Edit" on the "Welcome Message & Captcha Check" card

3. Turn on"Welcome Users" toggle if it is not already on and add your welcome message

4. Scroll down to "User Verification & Captcha" section and enable the "Require Verification" toggle.

5. Ensure the verification check type is set to "Answer Maths Question"

6. Amend the "Verify button text" which is displayed below your welcome message to suit your needs.

Upon joining your chat the user can click to verify where they are then sent to private chat with your bot to complete their maths question.

❓FAQ & Troubleshooting

Can I show a users name or profile in my welcome message? What tags do you support?

Modr8 offers injectable personalisation tags. To use them simply type the attribute between {{}} braces. The image below shows the tags we support for welcome messages:

My welcome message is not sending when a new user joins

Welcome messages can fail for a number of reasons, typically due to limitations in the Telegram server being unable to process various message types. It is worth checking the following items, if they do not fix the issue feel free to contact us on the support chat or community telegram chat.

• Your bot is not in your group or is not an admin

• Your chat does not have a valid subscription

• The image link provided does not have a valid media extension i.e. .jpg / .png / .mp4

• The message has been pasted from another editor and contains HTML that is not supported by Telegram

• The message length is too large and can not be processed by Telegram

• A button contains a web-link which is being blocked by Telegram, we have seen this happen with some websites Telegram deems as being high risk. To get around the issue just use a URL shortener like bit.ly instead

Often we will need to support you to identify the issue, but if you can't wait simply use the points above as a process of elimination. Try with a very simple message first then add on your links, buttons and images.