✨ XP
Members earn XP by taking part, and reach levels as their total grows. Levels can give out roles, and XP feeds the leaderboard.
Where to configure it
In the webapp: open your workspace, select the Telegram group under Channels in the sidebar, then select Gamification, then the XP & Levels tab. Changes save with the Save bar at the bottom of the page.
In Telegram (bot menu): send /settings and open 🏆 Gamification → ✨ XP.
How members earn XP
| Source | How it works |
|---|---|
| Messages | XP per message, set with 💬 Set Messages XP. Commands (starting with / or !) and edited messages don't earn XP. |
| Reactions | XP for each reaction a member adds, set with 👍 Set Reactions XP. |
| XP Drops | Bonus XP for long messages, set under 🎲 XP Drops. |
| Daily claim | Members send /claim once a day, set under 🎁 Daily Claim. |
| Secret codes | Codes that award XP when redeemed, set under 🔑 Secret Codes. |
| Quizzes | XP for correct answers. See Quizzes. |
| Token Gating | A one-time XP bonus for verified holders. See Token Gating. |
| Admins | /setxp sets a member's XP directly. |
⏱️ Set Cooldown sets how many seconds a member must wait between XP awards, so sending many short messages doesn't farm XP. Messages sent during the cooldown earn nothing.
Turning XP off (🔄️ Enabled / 🔄️ Disabled) stops earning but keeps everyone's XP and levels. They carry on when you turn it back on.
Levels
Each level has an XP required value: the total XP a member needs to reach it, not the extra XP on top of the previous level. If a member passes several levels at once, only the highest is announced.
The default levels are created the first time a group's levels are opened:
| Level | Total XP |
|---|---|
| 1 | 100 |
| 2 | 300 |
| 3 | 600 |
| 4 | 1,000 |
| 5 | 1,500 |
| 6 | 2,100 |
| 7 | 2,800 |
| 8 | 3,600 |
| 9 | 4,500 |
For example, a member with 600 XP in total is Level 3.
To change them, open ⚡ XP Levels. Select ➕ Add Level and set the level number, the XP required and an optional reward, or select a level to remove it.
Level-up message
Under 💬 Level-up Message, turn the message on or off and select ✏️ Edit to write your own. Use {name} for the member's name and {level} for the new level.
Resetting XP
🔄 Reset XP resets XP for all members of the group.
Commands
| Command | Description |
|---|---|
/xp [username/id/reply] | Show a user's XP and level. |
/setxp [username/id/reply] | Set a user's XP (admins). |
/claim | Claim the daily XP reward, once per day. |
/me | Show your own stats, XP, roles and profile. |
Troubleshooting
Members aren't earning XP
- Check XP is 🟢 Enabled and the XP per message or reaction is above 0.
- Messages inside the cooldown, commands and edits don't earn XP.
XP grows too fast or too slowly
- Change the XP per message or reaction, the cooldown, or the level thresholds.
No level-up message
- Check 💬 Level-up Message is enabled, and that the agent can post in the group.
A role isn't given at a level
- Check the role's XP threshold in Roles.