Setup · ~2 min

Setup guide.

From cold start to a first moderated group. Five real steps, no filler — with the screens you'll actually see.

Guide · Connect → attach → replicate
01 / 05 · Authorisation

Sign in through the Telegram bot

Authorisation happens entirely through Telegram. No passwords are stored — the bot generates a one-time login link, scoped to your Telegram identity.

  1. Open @gramgroupsbot in Telegram.
  2. Press Start, or send /login if you've used the bot before.
  3. Tap the one-time link the bot replies with. It expires in 5 minutes.
  4. You land in the panel, signed in as your Telegram account.
app.gramgroupsbot.com/login
Screenshot · Sign-in page
First-time signup

New accounts receive $1.50 starter credit automatically. Enough for ~15 days of one active group or ~5 days of three.

02 / 05 · Permissions

Add the bot to a Telegram group

Bring the bot into the group you want to manage and promote it to admin. The exact permissions it needs:

  • Delete messages — required. Without it the bot can't enforce any rule.
  • Ban users — required for rate limits and mass-action bans.

Other admin permissions can stay off. The bot does not change member roles or edit group settings.

Telegram · group admin promotion
Screenshot · Promote bot dialog
03 / 05 · Registration

Run /connect in the group

Send /connect as a message in the group itself. The bot inspects its own permissions, then registers the group against your account.

group_one · running /connect
>/connect
 Checking bot permissions…
 Bot is admin
 Delete messages: granted
 Ban users: granted
 Group registered · id -5223195137
 Visit panel → Groups to assign rules.

The group now appears in your panel at Groups, with bot status, billing flag and last health check pre-filled.

Panel · Groups list
Screenshot · Groups table
04 / 05 · Configuration

Attach rule sets to the group

Open the group in the panel. Each rule type is a dropdown — pick a named list, template or limit you've already created (or jump to the rule type's tab and create one first).

  • Stop words list — names of shared lists you maintain centrally.
  • Required words list — optional, see Rules → Required words.
  • Links list — allowlist or blocklist.
  • Message limit — rate-limit profile.
  • Greeting — welcome message template.

Save. The configuration takes effect immediately — the next message that matches a rule is handled per the rule.

Panel · Group detail · Moderation settings
Screenshot · Rule attachments

Verify with a test message

Post one deliberately-violating message and one borderline message. The first should be deleted; the second should stay. If either behaves wrong, jump to Troubleshooting.

05 / 05 · Scale

Replicate to the rest of your network

Once the first group is configured, every subsequent group is a 30-second job. Two options:

Option A — per group, manually

Run /connect in each group, attach the same lists from the dropdowns. Fine for 2–5 groups.

Option B — mass action

Connect the rest of the groups (no rules yet). Go to Mass actions → Attach. Select the rule sets you want, select the groups, commit. Every selected group now points to the same lists.

Panel · Mass actions · Attach rule sets
Screenshot · Mass-attach dialog

The cost is per active group per day — see Pricing. Connect 50 groups, attach rules to 20 of them, you're billed for 20.

06 / 05 · Things that go wrong

Troubleshooting

"Bot is not admin"

You added the bot but didn't promote it. Open the group's admin list and toggle the bot to admin with the permissions listed in step 02.

"Delete messages: missing"

Bot is admin but the specific permission is off. Re-open the bot's admin settings and enable "Delete messages."

Rule attached but messages not deleted

Three common causes, in order:

  1. Bot lost admin since the last check. Hit Check bot on the group page.
  2. Word-boundary matching: spam doesn't match inside spamster. Switch to substring on that entry if needed.
  3. Exception list contains the phrase. Open the list and look for it in exceptions.

Welcome message not firing

Telegram's join events fire only on first-time joins, not on re-joins. Test with a brand-new account.

Still stuck

Open a chat with @AllGramSupportBot and send /support, or email [email protected] — include the group ID and the symptom.

Connect your first group in under two minutes.