Documentation

Badges Management through admin panel

Badges and achievements are the best solutions for highlighting users or encouraging them to take action. A badge resembles a colour label with short text or a small picture near the nickname. A user can receive one or several badges simultaneously. Badges can be permanent or disappear or change after a while.

How to assign a badge?

Possible to add badges for any user.

Badges can be used to engage users in chats more or to stimulate them to take paid actions, spend more time at the service, or consume more content.

You can set a notification to inform users that they are awarded. Also, you can add a tooltip for other users with the information on how to get a badge. Awarded users can see their own badges on their user profiles.

Examples of badges

Example of badges

Mechanics: how to assign it

Create a badge

Open “Widgets” on the admin panel, then “Badges and Achievements.” Click the “Badges” tab and create as many variants of badges as needed.

When you create a badge, you need to set the colours of the text and background. Use emojis if you wish. Check how your badge looks on the right side of the screen.

Don’t forget to set a notification for users about getting a badge and a tooltip for other chat participants with the information on how to be awarded. Notification can contain a picture.

When everything is ready, push the Save button.

Award users

There are two ways to award users manually.

  1. You can upload a file with the list of users to every badge. The file must be in .csv format, split with "," (comma), and include user IDs. Before uploading, you can see an example of a list.
  2. You can assign badges to users separately. To do so, click the Assign a badge button in the top right corner, find a user with their user ID, and choose a badge you want to assign (move a toggle). Then, the user gets a badge and appears on a list of awarded users.

Change or delete

You can delete a badge you don’t need anymore. To do that, click the button Edit for the badge you want to delete and click on Delete in the right corner of the page bottom.

If you want to change or remove a badge for a particular user, open the Users tab, find them by userID or nickname, and click the Edit button. Then, disable a toggle for a badge you want to take off or enable the one you want to assign.

Please note

  • Notifications about badge assignments are more important than marketing offers but less important than technical tooltips and notifications.
  • If a user has multiple badges, the chat interface displays those that fit in one line in the following priority:
    1. Role (admin/moderator, speaker, guest)
    2. Loyalty program (passed as the 'statusname' parameter)
    3. Other badges — in order of assignment
  • All badges are displayed in the profile (under "Settings/Profile"), regardless of their number.
  • You can open some functionality for particular badge owners (for example, open a sticker pack for them).