Skip to main content

🎭 Roles

Roles recognise members and can give them extra permissions. A role can be given out automatically (on join, after captcha, or at an XP or message threshold) or assigned by admins with /promote.

What a role does

Fren One gives a role its permissions (bypass restrictions, kick, mute, warn, pin messages, manage quizzes, manage scheduler), its visible Telegram tag, and its promotion message. Anything beyond that, such as priority support, exclusive content or giveaway entries, is a promise your team keeps by hand: Fren One doesn't apply XP multipliers, grant voting power or unlock channels for a role.

In the webapp​

Open your workspace, select the Telegram group under Channels in the sidebar, then select Roles. Roles is its own page under the group in the sidebar, not a tab of Gamification. Changes save with the Save bar at the bottom of the page.

The role editor has four parts:

  • Role details: the name, an optional Mention handle (the @handle used to mention members with the role; left empty, it's generated from the name), Priority (when a member holds several roles, the lowest number wins the visible Telegram tag), an optional Member limit, and Sync as Telegram tag to show the role as a native Telegram member tag (the name must be short enough).
  • How is this role given out?: Manual only (admins assign it with /promote), On member join, On captcha completion, XP threshold, or Message threshold.
  • What can members with this role do?: Bypass restrictions, Kick, Mute, Warn, Pin messages, Manage quizzes, and Manage scheduler.
  • Reward message: an optional announcement when a member earns the role. Leave it empty to use the default.

Two settings apply to all roles: Role promotion messages, and who can use the /roles command.

In Telegram (bot menu)​

Send /settings in the group and open 🏆 Gamification → 🎭 Roles. The menu lists your roles, with ➕ Create Role and ⚙️ Role Settings.

Creating a role​

  1. Select ➕ Create Role.

  2. Send the role details in this format:

    Role Name | XP Required (optional) | Promotion Message (optional)

    In the promotion message, {name} inserts the member's name and {roleName} the role name.

Examples:

Active Member | 1000 | Congratulations {name}, you are now an {roleName}!
Veteran | 5000
Moderator

A role without an XP requirement, like Moderator, is only given out manually. The agent confirms the role and adds it to the list.

Viewing, editing and deleting​

Select a role to see its details (name, XP required, permissions, whether it's the default role, and its reward message) and these actions:

ActionWhat it does
✏️ EditChange the name, XP requirement, promotion message or default-role status. Send the new details in the same format. A new name applies to everyone who holds the role. Raising the XP requirement doesn't take the role away from members who already hold it; only /demote or removing it by hand does.
🔒 PermissionsToggle each permission on (✅) or off (❌), then select 💾 Save. Changes apply immediately to everyone who holds the role.
🗑️ DeleteAfter you confirm, the role is permanently deleted and removed from every member who holds it. If it was the Token Gating holder role, that setting is cleared too.

Permissions​

PermissionWhat role holders can do
Mute membersMute and unmute users with !mute and !unmute.
Kick membersRemove users from the group with !kick.
Warn membersWarn users and clear their warnings with !warn and !acquit.
Pin messagesPin messages with !pin.
Bypass restrictionsImmunity from all moderation restrictions.
Manage quizzesCreate, edit and delete quizzes with /quiz_settings.
Manage scheduled messagesManage scheduled messages with /scheduler.

Moderation permissions act on other members, so give them only to people you trust.

Role settings​

Select ⚙️ Role Settings:

SettingWhat it does
Role MessagesWhen enabled, the agent posts the role's promotion message in the chat when a member earns a role. The default role never triggers one. When disabled, roles are given silently.
🔒 VisibilityPublic: any member can use /roles to see the group's roles and who holds them. Private: only admins can. Select it to switch between the two.
📛 Default RoleThe role given automatically when someone joins the group or passes the captcha. Pick one of your existing roles.

Commands​

CommandDescription
/promote [username/id/reply] [role_name]Give a user a role, whatever its XP requirement.
/demote [username/id/reply] [role_name]Remove a role from a user.
/roles [username/id/reply]Show your roles or another user's. Available to everyone when visibility is Public.

Troubleshooting​

A role isn't given out automatically

  • Check how the role is given out, and its XP or message threshold.
  • Check the member has actually reached the threshold on the XP page.

A role's permission doesn't work

  • Check the permission is switched on for the role, and that the member holds the role.
  • Use the ! commands listed above (!pin, !warn and so on).
  • Check the agent itself has the matching Telegram admin permission.

No promotion message appears

  • Check Role Messages is enabled, and remember the default role never posts one.

New members don't get the default role

  • Check a 📛 Default Role is set. If captcha is on, members get it only after passing.

Members can't use /roles

  • Set 🔒 Visibility to Public.

On this page