Community Reputation

Saying thanks and ranking users by how well they engage with your community can be done with Modr8's community reputation module.

With our engine you are able to reward positive reputation for those that are doing good and if you wish you can enable negative reputation to remove rep from those who are not doing so well. On top of this, with Modr8 you can also gamify your chat by utilising additional custom actions to create jackpots, offer random rep and reward user activity. You are able to set levels / ranks which are obtained as reputation points are earned. Your bot will announce new levels being completed and display an image/gif at the same time. All of this is a great way to keep your community users engaged and often leads to friendly competition as they check out who ranks at the top of the reputation ranks

Enabling Reputation Module

The reputation management module settings allow you to specify the scope and what will trigger reputation in your chat

1. Select "Settings" on your chat profile

2. Select "Edit" on the "Community Reputation" card

3. Turn on"Enable Reputation" toggle

4. The "Reputation Access Control" option provides a way for you to scope who has permissions to give out reputation to users.

   • Bot Owner - Only the registered owner of the bot can issue reputation

   • Admins - Only Admins of the chat can issue reputation

   • Trusted - Only users who have been added to the trusted/whitelist can issue reputation

   • Member - Chat members can issue reputation to other members

5. Add in any additional reputation triggers you wish to use outside of the standard /rep commands. For example you may want to give reputation to a user using !rep or + or even an emoji like 👍

6. Click "Save Changes"

Negative Reputation Options

As well as being able to provide positive reputation, you may want to remove reputation from users and allow general negative reputation to be issued. If a user has enough negative reputation their reputation points will go into -ve figures and you can use sub zero based ranks for them.

1. Select "Settings" on your chat profile

2. Select "Edit" on the "Community Reputation" card

3. Turn on"Enable Negative Reputation" toggle

4. The "Negative Reputation Access Control" option provides a way for you to scope who has permissions to give out negative reputation to users.

   • Bot Owner - Only the registered owner of the bot can issue negative reputation.

   • Admins - Only Admins of the chat can issue negative reputation.

   • Trusted - Only users who have been added to the trusted/whitelist can issue negative reputation.

   • Member - Chat members can issue negative reputation to other members

5. Add in any additional negative reputation triggers you wish to use outside of the standard /rep commands. For example you may want to remove reputation using - or even an emoji like 👎 or ⬇️

6. Click "Save Changes"

Limiting Reputation

Issuing out reputation is great for building trust and confidence in engaging with your community. To ensure the system is not abused by people trying to gain top ranks by giving each other rep points the Modr8 engine utilises methods to limit the amount that can be given. The following settings can be used to constrain the system to suit your needs.

Modr8 capabilities on limiting reputation that can be used in your chat

1. Select "Settings" on your chat profile

2. Select "Edit" on the "Community Reputation" card

3. Scroll to the"Reputation Limit Settings" section

4. Enter a value for the maximum amount of reputation points that can be given out.

5. Enter a value fro the time limit for this limit to be replenished back to the total value.

6. State whether you want "Admin users to bypass rep spam limits", meaning only your normal members will need to regenerate reputation every x hours, whereas admins will not have a limit.

7. Elect to turn on "Allow multi-rep to be given" which allows your users to reply to messages with /rep X where X is the number of points they wish to issue. As an example you could reply to a message with /rep 5 to give 5 reputation points to the user.

Advanced Settings

Our advanced reputation management settings are reserved for the custom use-cases communities may have. The options you can enable are listed below along with a description of the behavior and usage in your chat.

Modr8 Advanced Reputation Settings to handle any custom use-cases you may have in your community

• "Show Rank Images in /myrep" - When a user in your chat wishes to check their rep ranking they will use the /myrep command. This option will also display the associated image with the rank when turned on.

• "Hide User Link In Ranks" - By default when running /toprep and displaying the top reputation ranks in the chat a link to the users profile will attempt to be displayed (Dependent on user privacy settings). You can enable this option to disable this functionality and simply display the name as normal text.

• "Use Global Reputation" - This will enable global reputation rankings. When running /toprep or /myrep users will see the reputation points total they have gained from all chats your bot is moderating. Find out more in our guide Global & Multi-Chat Features.

• "Remove admins from rankings"- Often we find that the admins of a chat gain the more reputation points due to offering help and engaging with the community. You may wish to remove these users from the /toprep rankings so general chat members can take the top ranks.

• "Trust users with X or more rep points" - This is a very powerful option which will allow you to automatically trust/whitelist users who gain the number of points specified. The effect this has on the user is that they will then bypass moderation filters. You can utilise this automation with other modules to allow "trusted" users to community moderate or even now be able to give out rep.

If there are changes or settings you want outside of the scope of the options above we can always help out! Using "Actions" we are able to make even more customisations to how reputation works in your community. Feel free to drop by our Telegram Community Chat to ask for help.

Exporting & Deleting Reputation Data

Modr8 allows you to export out all of your reputation history as well as a snapshot of the current state of reputation in your chat.

1. Select "Settings" on your chat profile

2. Select "Edit" on the "Community Reputation" card

3. Scroll to the"Data Management" section

The options you will find have the following functionality:

• "Export Reputation Snapshot" - Provides a spreadheet download of the current reputation ranks and values your users have in the chat.

• "Export Reputation History" - Provides a spreadsheet download of how reputation has been added of removed by each user within your chat. A really good tool for auditing reputation!

• "Reset All User Reputation" - The nuclear option to delete all of your reputation data and start over. Make sure to run exports if you need history!

You can use the /resetrep command in reply to a users message or by mentioning the user to set their reputation back to 0.

Adding Reputation Ranks

Giving out reputation becomes even more fun when users get to gain ranks and even have images/gifs or badges given to them. Modr8 supports the ability for you define unlimited numbers of reputation levels to be obtained.

Adding an unlimited number of reputation ranks for your users to gain!

1. Select "Settings" on your chat profile

2. Select "Edit" on the "Community Reputation" card

3. Scroll to the"Set Reputation Rankings" section

4. You can add a new rank by clicking the "Add New Rank" button or you can edit existing ranks

5. Set a "Level" value, which is the number of reputation points to be reached

6. Set a "Rank" which is the name of the ranking that will be used

7. Set a "Rank Image" if you want to display an image or animation when the rank is reached

We recommend spacing out your rank levels so that there is time between gaining one to the next. Something exponential like 0, 10, 20, 40, 80, 160 etc. This makes it more fun when gaining ranks.

How Do Chat Users Give Out Reputation?

Once you have your module all set up how you want you will be able to let your chat users know they can now give out reputation.

The new standard set of commands that open up when enabling the reputation module are:

• /rep - Used to give reputation to a user, either directly or by replying to their message.

• /toprep - Displays reputation point rankings, which can be filtered by time or limited numbers.

• /myrep - Displays the users current reputation points and how many they have left to give out.

The following new commands become available if negative reputation is enabled:

• /remrep - Removes reputation from a user.

In addition to the above, any additional custom rep triggers you made will work too.

When a user types /commands in your chat they will see these reputation commands listed with an explanation of their usage.

❓FAQ & Troubleshooting

Why do my reputation rank images not show?

This can be due to many reasons but its always worth checking for the following:

• You have not supplied a valid image or video file as a DIRECT link that ends in .jpg / .png / .mp4 / .gif

• The link provided has been blacklisted/removed by Telegram

• The link provided is too big for the Telegram Bot API to send to your chat. We recommend limiting files to 20mb in size.

If you are still having issues drop by our community support chat.

How can I remove my admins from showing in reputation ranks?

You will want to turn on the "Remove admins from rankings" setting in our advanced settings section. We've provided information on how to do so here.

How can I see who has given who reputation?

We offer a reputation history export which will show the users who have participated in giving reputation, as well as the target user they gave rep to, the amount and any dates. This audit trail should provide everything you need. We've discussed how to download the reputation history file here.

How can I view reputation ranks in Modr8?

Reputation ranks can be viewed in a number of ways. We've listed below the main methods which you can use:

• Typing /toprep in your chat will display the rankings. You can expand the list by adding the number of ranks to show e.g. /toprep 10 for top 10, /toprep 20 for top 20

• Running the reputation snapshot export from the data management area of the reputation module. You can find instructions on how to export here.

• You can navigate the "Users" page and sorting the list of users by reputation column which will display the full list by total reputation amount.

Can I create jackpots and random reputation wins?

Yes - This is where our "Actions" module comes in. We have an example action you can import into your chat listed on our Actions Marketplace. The action marketplace can be found here. You will want to scroll down to the "Game" section and copy the reputation jackpot example.

We discuss using actions further in our dedicated Actions documentation.