Owner controls
/showlimits reads back the dashboard's rate limits and blocks. User Limits, the Twitter whitelist, Owner Notifications and Transfer Bot Ownership are dashboard-only.
/showlimits
/showlimits lists every blocked and rate-limited user on the bot — the same data as Management → User Limits. Private chat with the bot only, for the bot's owner. The slash is optional and @botusername is accepted.
What it prints
| Input | Output |
|---|---|
| No restrictions on the bot | **User Restrictions** No restrictions configured for this bot. |
| 2 blocked users, 1 rate-limited user | **User Restrictions for @examplebot** **Blocked Users:** @spammer1 @spammer2 **Rate Limited Users:** @chris -- 25 commands/day |
Rate limits and blocks
Management → User Limits lists every per-user restriction on a bot. Each is either a Rate Limit (a daily command cap) or a Block. Rate Limit is the default.
Adding a restriction
- Click Add Restriction.
- Enter Username (leading
@optional). The username can't be changed once saved. - Pick Restriction Type: Rate Limit or Block.
- Rate Limit only: set Daily Limit — minimum 1, default 50, no maximum.
- Pick Restriction Duration: Permanent (default), 1 hour, 1 day, 3 days or 7 days. Reopening a restriction to edit it shows Permanent here again, whatever was saved.
- Click Add Restriction (Save Changes when editing).
| Setting | Value |
|---|---|
| Duplicate username | Restriction already set for @{username} on this bot |
| Expired restrictions | Disappear from the list. |
| Deleting | Trash icon, then confirm. |
Every saved edit is added to that restriction's Edit History (clock icon next to the username), recording the previous type, daily limit and expiry.
Twitter whitelist
The Whitelist tab is for Twitter bots only. It controls which X accounts can trigger the bot by @mentioning it; mentions from anyone else are filtered out at X and never reach the bot.
Whitelist rules
| Setting | Value |
|---|---|
| Handle | Letters, numbers and underscore, 1–15 characters. Leading @ optional. |
| Cap | 200 handles. |
| Removing | Trash icon on the row. No confirmation. |
Adding handles
- Click AddUsers.
- Paste handles — one per line, or comma/space-separated.
- The preview shows how many are new, already listed, or rejected.
- Click Add {n} user(s).
Limit
Pasting more than the remaining room fails with
Combined list would exceed 200 entries (current: {n}, adding: {m})and saves nothing.
Owner notifications
Settings → Notifications (Owner Notifications) controls which dashboard edits DM the bot's owner. Three toggles, all on by default:
Owner Notifications toggles
| Toggle | DMs the owner when |
|---|---|
| Command Changes | Text or button commands are added, edited or removed. |
| Rate Limits & Blocks | Rate limits or blocked users change. |
| Profile Changes | The bot's name, bio or avatar changes. |
Two of the DMs
| Input | Output |
|---|---|
| Rate Limits & Blocks — adding a Rate Limit | ➕ **Rate Limit Set** User: @chris Daily Limit: 25 prompts/day |
| Command Changes — turning Admin Moderation on | 🛡️ **Moderation Updated** Ban: Enabled Mute: Enabled |
The Moderation DM is gated by Command Changes, not Rate Limits & Blocks.
Transfer Bot Ownership
Profile → Advanced Bot Settings → Transfer Bot Ownership moves a Telegram bot to another Telegram account. It is permanent: you lose access immediately and only the new owner can manage the bot. Changing your own @username needs no transfer — ownership follows your account.