Telegram

Setup (Creators)

1

Create a Private Group

Create a private Telegram group or channel for your subscribers.

2

Add the Bot

• Add @basepass_bot to the group

• Make it an admin with permissions: Ban users, Invite via link

3

Get the Group ID

• Add @userinfobot to your group temporarily

• It replies with the chat ID (starts with -100...)

• Remove @userinfobot after copying

4

Create an Invite Link

Group Settings → Invite Links → Create link → Copy

5

Configure in Dashboard

1. base-pass.xyz/dashboard → Integrations tab

2. Enter Group ID and Invite Link under Telegram Gating

3. Click Save

The bot checks subscriptions every 5 minutes. Active subscribers receive the invite link via DM. Expired subscribers are removed from the group.

Subscriber Setup

1

Go to Settings

Go to base-pass.xyz/settings

2

Connect Telegram

Click Connect Telegram

3

Confirm in Telegram

Redirects to Telegram → confirm in the bot

4

Wait for Detection

Page auto-detects when linked

Security

The linking flow is cryptographically secure:

• Short-lived token (10 min) tied to your wallet

• Token is SHA-256 hashed before storage

• Single-use (replay-proof)

• Rate-limited (5 attempts/min)

• 1 wallet ↔ 1 Telegram (both directions)

Bot Commands

Command	Description
/start	Welcome + linking instructions
/status	Check your linked wallet
/unlink	Remove wallet link
/help	Show commands

Troubleshooting

Problem	Solution
"Token expired"	Generate new link from Settings (tokens last 10 min)
Not added to group	Bot must be admin with ban permissions
"Already linked to another wallet"	Use /unlink first, then re-link
Bot not responding	Check BACKEND_URL env var on bot server