Admin Commands

Project-owner-only commands you can use in the chat with your MemberPass-powered bot — /check and /ban.

By the end of this page, you'll know exactly what admin commands are available inside your bot and how to use them safely.

MemberPass exposes a small set of admin commands you can use in the direct chat with your own project's bot. These commands are:

Hidden from the bot's public command menu (regular users don't see them).
Available only to you as the project owner — when the bot detects your Telegram user ID, it accepts admin commands; for any other user, the commands silently fail or return "unknown command".

Commands

/check — inspect a user

Returns a detailed status report for a specific user, including their active subscription, payment history, and assigned resources.

Usage:

/check <user_id>

Example:

/check 123456789

You can also invoke this via a deep-link:

https://t.me/YourBotName?start=-check_-123456789

When to use it:

A subscriber claims they paid but don't have access — /check tells you their current status and recent payments.
Pre-ban sanity check — make sure you're banning the right user.
Support debugging — see exactly what the bot thinks about a specific person.

/ban — permanently block a user

Bans a user from your project. This has significant consequences — read carefully before running.

What /ban does (in order):

Marks the user's status as Banned.
Cancels all their active subscriptions on the project.
Revokes all their invite links.
Kicks them from every connected Telegram channel, group, and supergroup.

Usage:

/ban <user_id>

Example:

/ban 123456789

Deep-link variants (from Deep-linking):

Interactive (recommended) — opens a confirmation menu before applying:
```
https://t.me/YourBotName?start=-ban_-123456789
```
Immediate (automated) — bans instantly without confirmation:
```
https://t.me/YourBotName?start=-ban_-123456789_-confirm
```

The immediate variant skips all safety prompts. Only use it in trusted automation scripts where you're certain the user ID is correct. Once banned, restoring a user requires direct database intervention — coordinate with support if you ban in error.

How to find a user's Telegram ID

Both commands take a Telegram user ID, not a username. Getting the ID:

From your dashboard — open the Members list. Each row shows the Telegram ID beneath the name.
From the user directly — they can forward any of their messages to @userinfobot, which reveals their user ID.
From Telegram's own admin UI — in a group or channel you both belong to, tap the user's avatar to see their profile; some clients display the numeric ID.

Permissions

Both commands require the bot to recognise you as the project owner. The bot reads the Telegram user ID of the sender and matches against the project's owner — it's tied to your Telegram identity, not your MemberPass password or session.

If you run /check or /ban and nothing happens:

Confirm you're chatting with the correct bot (the one connected to your project).
Confirm your Telegram account matches the one your MemberPass creator account was registered with.
Confirm the project is Active on your dashboard.

Audit and rollback

Every admin command is logged in the project's activity timeline — visible per-member in the Members detail view.
Unbanning isn't exposed as a command today. If you need to reverse a ban, contact support.

Deep-linking — craft admin-command deep-links.
Managing members — find user IDs and see ban/activity history.
Telegram integration — broader platform-level mechanics including whitelisting.