GramGroupsBot
EN RU Open bot →

Connect a Telegram group

Group connection flow and checks.

Groups are connected from inside Telegram with /connect. The dashboard does not connect a group by chat ID alone; the bot verifies Telegram permissions in the target group.

Preconditions

Before running /connect:

  • You have opened the bot in private chat and sent /start.
  • You are signed in or have an account in GramGroupsBot.
  • You belong to exactly one GramGroupsBot account.
  • The bot has been added to the Telegram group or supergroup.
  • The bot is an admin in that group.
  • You are also an admin in that Telegram group.

Connection Command

Send this in the target group:

/connect

The command is valid only in group and supergroup chats.

What the Bot Checks

When /connect is received, the bot checks:

  1. The command was sent in a group or supergroup.
  2. The sender has a GramGroupsBot user record.
  3. The sender belongs to an account.
  4. The sender belongs to only one account.
  5. The sender is an admin or creator in the Telegram group.
  6. The bot is an admin or creator in the Telegram group.
  7. The group is not already connected to another account.

If all checks pass, the group is stored under the account and becomes active.

Successful Result

On success, the bot replies with a confirmation such as:

Group connected successfully.

The group then appears in the dashboard under Groups.

Stored group details include:

  • Telegram chat ID.
  • Title.
  • Username, when Telegram provides one.
  • Chat type.
  • Connected timestamp.
  • Last seen timestamp.
  • Bot admin status.
  • Whether the bot can delete messages.
  • Whether the bot can restrict members.

Already Connected

If the same group is already connected to your account, the bot replies that it is already connected.

If the group is connected to another account, the bot rejects the connection.

Multiple Accounts Case

If you belong to more than one account, /connect does not guess which account should own the group. The bot asks you to open the dashboard and select the correct account.

Common Failures

The Bot Says to Open Private Chat First

This means your Telegram user is not known to GramGroupsBot yet.

Fix:

  1. Open the bot in private chat.
  2. Send /start.
  3. Return to the group.
  4. Run /connect again.

Only Group Admins Can Connect This Group

The Telegram user who sent /connect is not an admin in that group.

Fix: promote that user to Telegram group admin or ask an existing group admin to run /connect.

Please Make This Bot an Admin First

The bot is in the group but is not admin.

Fix: promote the bot to admin, then run /connect again.

This Group Is Already Connected to Another Account

A group can belong to one GramGroupsBot account at a time.

Fix: use the account that already owns the group, or disconnect/remove the existing group record if you control that account.