Groups

For the conceptual model (what’s shared vs what’s owned by the linked user, the quota math), see Groups vs Private. This page walks the actual operations.

Adding the bot

Add @reign to your Telegram group like any other bot — open the group, tap “Add member” or “Invite to group”, search for the bot’s handle. The bot doesn’t need admin rights; member-level access is sufficient for it to read messages addressed to it and post alerts.

Once the bot is in the group, it doesn’t auto-link. Someone has to run /link.

Bot commands

Command	What it does	Run by
`/link`	Start the link flow (DM confirmation required)	Any group member
`/unlink`	End the link, preserving wallets	Linked user only
`/groupstatus`	Show link state, owner, wallet count	Anyone, in group or DM
`/limits`	Per-chain wallet quota breakdown across private + groups	Anyone
`/track`, `/list`, `/remove`, `/rename`	Same as private chat, scoped to the group	Any group member

Linking flow (`/link`)

Run /link in the group. The bot replies in the group:

📩 Check your DMs!

I sent you a confirmation message. Please confirm there to link this group.

In your DM with the bot, you’ll see:

🔗 Link Group Confirmation

You requested to link: My Trading Squad

What this means:
• Your wallet limit will be shared with this group
• Anyone in the group can add/remove wallets
• Wallets added there count toward YOUR limit
• Alerts will be sent to the group

Your current usage:
📊 EVM: 40/250 (210 remaining)
🏷️ Tier: Pro

This request expires in 5 minutes.

With ✅ Confirm Link and ❌ Cancel inline buttons. Tap confirm within 5 minutes — after that the request expires and you start over.

On confirm, the DM updates to:

✅ Group Linked Successfully!

Group: My Trading Squad

Your wallet usage:
📊 EVM: 40/250 (210 remaining)
SOL: 2/25 (23 remaining)

You can now use /track, /list, /untrack in the group.

And the group gets:

✅ Group Linked!

Linked by: @yourhandle
EVM Wallets: 40/250 | SOL Wallets: 2/25

Available commands:
• /track [address] [label]
• /list
• /untrack [address]
• /groupstatus

Wallets tracked here count toward yourhandle's limit(s).

Edge cases

Situation	What happens
Group already linked to you	”This group is already linked to your account” — no DM sent
Group already linked to someone else	”This group is already linked to @user. Only one user can link a group. The current owner must /unlink first.”
You’re at your tier’s group limit	Bot replies with current usage and tells you to upgrade or unlink another group
Group migrates to supergroup mid-session	Telegram sends a `migrate_to_chat_id` event; the bot updates the chat ID automatically — no action needed

Unlinking flow (`/unlink`)

Run /unlink in the group (only the linked user can do this — other members get a “not the owner” error). Same 5-minute DM confirmation pattern:

⚠️ Unlink Group Confirmation

You requested to unlink: My Trading Squad

This group has:
• 35 tracked wallet(s)

What happens when you unlink:
• Wallet tracking will be disabled
• Alerts will stop being sent to the group
• Tracked wallets will be preserved (can resume if re-linked)

This request expires in 5 minutes.

On confirm, the group is marked inactive (soft delete — the link, wallets, and history are kept). Re-link later and everything resumes.

Status and quota commands

`/groupstatus`

Run in a group:

📊 Group Status

Group: My Trading Squad
Linked by: @yourhandle
Wallets in group: 35

Owner's limit: 75/250 (combined private + all groups)
Remaining: 175

Run in DM, lists every group you’ve linked:

📋 Your Linked Groups

1. My Trading Squad
   Wallets: 35

2. Alpha Chasers
   Wallets: 12

`/limits`

Returns a breakdown of where every tracked wallet is across your contexts:

📊 Wallet Limits

EVM Wallets: 75/250
├ Private: 40
├ My Trading Squad: 23
├ Alpha Chasers: 12
Remaining: 175

SOL Wallets: 5/25
├ Private: 2
├ My Trading Squad: 3
Remaining: 20

Member permissions

Action	Linked user	Other members
`/track` to add a wallet	✅	✅
`/remove` / `/untrack` a wallet	✅	✅
`/rename` a wallet	✅	✅
Change group settings (notification mute, chain filter, cluster, alert types)	✅	❌
`/unlink` the group	✅	❌

Members can manage the wallet list, but only the linked user can manage settings or end the link. The dashboard’s group context view is also restricted to the linked user — non-linker members see alerts in the group chat but can’t open the group’s dashboard settings.

Dashboard view

Open the dashboard with /web, navigate to the Groups page (top-level sidebar item). You’ll see:

Wallet limits card

Aggregated usage across private + all your linked groups, broken down per chain. Each linked group shows its individual usage.

Linked groups list

One card per group with:

Group title
Wallet count
Active / Muted badge

Click a group to expand its details inline:

Settings — notification on/off toggle for the whole group
Wallets — table with label, address, chain badge, transaction count, “Added by” attribution (which member added each wallet)
Recent activity — chronological log of the last 20 actions: wallet added, removed, renamed, settings updated, who triggered each, when
Unlink button at the top with a confirmation dialog

Configuring group-specific settings

The Groups page has a notification mute toggle, but per-group chain filter, alert type toggles, min USD threshold, and cluster settings live behind the context switcher.

To configure: top-left of the sidebar → switch from “Private Chat” to your group → the rest of the dashboard re-renders for that group’s context. Configure as if it were your personal account; settings save scoped to the group.

Wallet attribution

When a member adds a wallet, the bot records added_by_user_id. The dashboard’s group wallet table shows the attribution as “Added by @username” so you can see which group member contributed which wallets — useful for collaborative tracking lists.

What happens when…

Event	Effect on the group
Linked user upgrades tier	Wallet quota for the group increases instantly. Group alert rate limit (shared across all the user’s groups) also increases.
Linked user downgrades tier	Wallet quota decreases. Existing group wallets are preserved, but new `/track` calls fail until the group fits the new quota.
Linked user’s subscription expires while over free limit	The group goes silent (alerts paused) along with the linked user’s private alerts. Renew or downgrade to fix.
Linked user paused for inactivity	Group goes silent. Linked user sends any command to reactivate.
Bot is removed from the group	Group is marked inactive automatically. Wallets and history are preserved. Re-add the bot and someone runs `/link` to resume.
Group title changes in Telegram	The bot picks up the new title on the next `/link`-related interaction; existing alerts and data are unaffected.

What’s next

Analytics Wallet stats, PnL, top performers — across private and group contexts.

Notifications & Delivery Per-group notification settings, mute, and how alerts reach Telegram.