Настройка GramGroupsBot
Следуйте этим шагам, чтобы подключить первую Telegram-группу. Начните с одной группы, проверьте права бота и протестируйте правила на реальных сообщениях, прежде чем применять такую же настройку к остальным группам сети.
1. Откройте GramGroupsBot в Telegram
Откройте бота в личном чате. Здесь вы запускаете вход и получаете ссылки в dashboard.
Нужны Telegram-аккаунт, доступ к боту в личке и права администратора в целевой группе.
2. Войдите в dashboard
Отправьте в личке /start или /login. Бот пришлет одноразовую ссылку входа /auth/telegram-login/:token.
Откройте ссылку сразу: она одноразовая и ограничена по времени.
Если вход не получился, запросите новую ссылку командой /login.
3. Создайте аккаунт
После входа откройте dashboard. Если это первый вход, используйте Create account в onboarding.
Ожидаемый результат: создан workspace, доступна страница /groups.
Если пропустить этот шаг, подключение через /connect завершится ошибкой.
4. Добавьте бота в Telegram-группу
Добавьте GramGroupsBot в нужную Telegram group или supergroup.
Для подключения используйте того же Telegram-пользователя, который вошел в dashboard.
5. Назначьте бота администратором
До запуска /connect бот должен быть администратором группы.
Для модерации ключевое право — can_delete_messages. Для массовых действий также нужно can_restrict_members.
Если бот не админ, группа не подключится.
6. Отправьте /connect в группе
В этой группе отправьте /connect от имени того же Telegram-пользователя, который вошел в систему и создал аккаунт.
Ожидаемый результат: ответ бота Group connected successfully.
Используйте только /connect. Дополнительный текст после команды в текущей версии игнорируется.
7. Проверьте группу в dashboard
Откройте /groups. Подключенная группа должна появиться в списке.
После /connect группа сохраняется как status=active и billing_status=billable.
Откройте страницу группы из /groups, чтобы проверить статус бота и назначения правил.
8. Исправьте предупреждения по правам
Если видите предупреждения Cannot delete или Cannot restrict, сначала исправьте права бота в Telegram.
Затем откройте страницу группы и нажмите Check bot, чтобы обновить сохраненные флаги прав.
В панели хранятся технические поля bot_status, bot_can_delete_messages и bot_can_restrict_members.
9. Назначьте первые правила
Назначайте правила на странице группы или массово через /groups.
/stop_word_lists— стоп-слова/required_word_lists— обязательные слова/link_rules— правила ссылок/rate_limit_rules— лимиты сообщений/welcome_message_rules— приветствия
Правило работает только там, где назначено. Созданное, но не назначенное правило на группу не влияет.
10. Проверьте правила на реальных сообщениях
Проведите быстрые проверки в подключенной группе:
- сообщение со стоп-словом
- сообщение без обязательного слова
- сообщение со ссылкой
- несколько повторных сообщений для лимитов
Важно: проверка обязательных слов может пропускать replies с reply_to_message. При этом другие фильтры могут работать и на replies.
11. Проверьте статус оплаты
Подключенная активная группа считается платной группой. Списание не происходит сразу после /connect; стоимость рассчитывается ежедневным billing job.
Новый аккаунт получает тестовый баланс $1.50.
Технически группа сохраняется как status=active и billing_status=billable.
12. Ошибки подключения
Сообщение ошибки
Use /connect inside a group or supergroup chat.Что значит: команда отправлена в личном чате.
Что сделать: отправьте /connect внутри Telegram group или supergroup.
Сообщение ошибки
Only group admins can connect this group.Что значит: команду отправил пользователь без прав администратора.
Что сделать: отправьте /connect от имени администратора группы.
Сообщение ошибки
Please make this bot an admin in this group first.Что значит: бот в группе, но не администратор.
Что сделать: назначьте бота админом и повторите /connect.
Сообщение ошибки
Please open @<bot_name> in private chat first and use /start.Что значит: система еще не связала этого пользователя Telegram с входом в сервис.
Что сделать: откройте личный чат и используйте /start или /login, затем повторите команду в группе.
Сообщение ошибки
You do not belong to any account yet. Open dashboard and create or join an account.Что значит: вход есть, но аккаунт не создан.
Что сделать: откройте dashboard и сначала создайте аккаунт.
Сообщение ошибки
You belong to multiple accounts. Open dashboard and select which account should own this group.Что значит: Telegram-пользователь связан с несколькими аккаунтами.
Что сделать: выберите нужный аккаунт в dashboard и повторите /connect.
Сообщение ошибки
This group is already connected to your account.Что значит: группа уже корректно подключена.
Что сделать: переходите в /groups и настраивайте правила.
Сообщение ошибки
This group is already connected to another account.Что значит: группа уже принадлежит другому аккаунту GramGroupsBot.
Что сделать: использовать аккаунт-владелец; автоматической перепривязки нет.
Сообщение ошибки
Could not connect group right now. Please try again.Что значит: временная ошибка Telegram API или внутренняя ошибка.
Что сделать: перепроверьте права, подождите и повторите попытку.
13. Частые проблемы
- Команду отправляет не администратор группы.
- Бот не админ или нет
can_delete_messages. - После входа не создан аккаунт.
- Правило создано, но не назначено этой группе.
- Тест идет в reply-сценарии, где поведение обязательных слов отличается.
Следующий шаг: настройте правила
После того как группа появилась в /groups, создайте первое правило и назначьте его этой
группе. Начните с одного стоп-слова или одного правила ссылок, проверьте его на реальном сообщении и
только потом применяйте настройку к другим группам.