Перед добавлением VibeGuard
Вам нужен доступ владельца группы или администратора, который может добавлять ботов и управлять администраторами.
VibeGuard работает по группе: у каждой Telegram-группы свои настройки, включённые функции, права, модерационное состояние, профили, AI usage, сводки и Mini App-контекст. Один чат можно настроить строго, другой — оставить только с базовой модерацией, третий — использовать для AI/ИИ-сводок.
Не включайте всё в первый день. Безопасный старт простой: добавить бота, выбрать правильную группу, выдать только нужные права, открыть Центр безопасности и сначала проверить правила в режиме аудита.
Шаг 1. Откройте VibeGuard в Telegram
Откройте VibeGuard.bot в Telegram и выберите добавление в группу.
Telegram может показать экран подтверждения перед добавлением бота. Проверьте, что вы выбираете именно тот чат, который хотите защитить или настроить. Это особенно важно, если у вас несколько групп, саппорт-чаты, маркетплейс, фан-чат или сетка Telegram-чатов.
После добавления оставьте VibeGuard в группе, чтобы настройка успела завершиться. В зависимости от клиента Telegram и настроек группы вы можете увидеть сообщение бота, inline-кнопки или кнопку запуска Mini App / Центра безопасности.
Шаг 2. Выберите правильную группу
VibeGuard привязывает настройки к конкретной Telegram-группе. Поэтому важно не перепутать чат.
Если вы добавили бота не туда, удалите его из неправильной группы и повторите добавление для нужного чата. Не пытайтесь «перенести» настройки вручную, если вы ещё не понимаете, какая группа активна в Центре безопасности.
Один проект может иметь несколько групп, но каждая группа остаётся отдельной, пока админы явно не настроят сетку чатов.
Шаг 3. Сделайте VibeGuard админом
Чтобы VibeGuard мог выполнять модерационные и защитные действия, сделайте бота администратором группы.
Откройте Telegram-группу, зайдите в информацию о группе, откройте список администраторов, выберите добавление администратора, найдите VibeGuard и подтвердите права, которые хотите выдать.
VibeGuard может находиться в группе и без всех прав. Но удаление спама, муты, баны, кики, обработка заявок и действия с инвайт-ссылками требуют соответствующих Telegram admin rights.
Шаг 4. Выдайте только нужные права
Не обязательно выдавать все права сразу. Дайте боту только те права, которые нужны функциям, которые вы собираетесь включить.
| Что хотите использовать | Какие права могут понадобиться | Как начать безопасно |
|---|---|---|
| Удаление спама и скам-ссылок | Удаление сообщений | Сначала включить антиспам в режиме аудита |
| Муты, баны и кики | Ограничение участников | Проверить доступ модераторов и причины действий |
| Проверка заявок и join gate | Обработка join requests | Начать с очереди новичков и review |
| Работа с инвайт-ссылками | Права на управление invite links | Использовать только для проверенных сценариев |
| Чистка после флуда или рейда | Удаление сообщений и достаточные права модерации | Сначала использовать preview / dry-run, где доступно |
| Антирейд и lockdown | Зависит от выбранных действий | Начать с Watch / Audit, затем усиливать |
Если вы хотите только проверить правила, начните с меньшего набора прав и режима аудита. VibeGuard покажет, что он бы поймал, без немедленного удаления сообщений или наказаний.
Шаг 5. Откройте Центр безопасности
Центр безопасности — это Mini App-админка VibeGuard для проверки установки и дальнейшего управления.
Откройте его после добавления бота, чтобы посмотреть:
- какие функции включены для этой группы;
- каких Telegram-прав не хватает;
- какие правила работают в audit mode;
- какие события уже попали в аудит;
- есть ли очередь новичков, инциденты, кейсы или diagnostics;
- какой статус у AI usage и доступных функций.
Если у вас несколько групп, проверьте, что в Центре безопасности открыт правильный чат. Это защитит от ситуации, когда вы меняете настройки не той группы.
Шаг 6. Запустите первый сценарий в режиме аудита
После добавления бота и проверки прав выберите первую проблему, которую хотите решить.
Если проблема — спам и ссылки: Начните с антиспама: фильтры ссылок, флад, suspicious media, стикер-спам, channel-sender abuse, edit abuse и первые сообщения новичков.
Если проблема — рейды: Начните с антирейда: массовый вход, bot waves, invite attacks, одинаковые первые сообщения, lockdown-сценарии и recovery.
Если модерация стала хаотичной: Начните с команд: варн, мут, бан, кик, чистка, причины, доступ к командам, кейсы, апелляции и журнал действий.
Если чат слишком активный: Начните с AI/ИИ-сводок: резюме дня, главные темы, вопросы для админов, best-of моменты и, если включено, голосовое резюме.
Для первого запуска лучше оставить правила в режиме аудита. Посмотрите несколько реальных срабатываний, настройте исключения и только потом включайте удаления, муты, баны или lockdown.
Быстрая проверка после добавления
| Проверка | Что должно быть понятно |
|---|---|
| Бот находится в нужной группе | Вы не перепутали чат |
| Бот сделан админом | У VibeGuard есть нужные Telegram-права |
| Выданы только нужные права | Нет лишней власти для функций, которые не используются |
| Центр безопасности открывается | Админ видит правила, диагностику и audit events |
| Первый сценарий выбран | Антиспам, антирейд, модерация или AI/ИИ-сводки |
| Режим аудита включён | Правила можно проверить без жёстких действий |
Если что-то не получилось
Бот добавлен, но ничего не происходит. Проверьте, остался ли VibeGuard в группе, видны ли сообщения бота и не скрывает ли Telegram-клиент Mini App-кнопки или inline-кнопки.
Не получается сделать бота админом. Проверьте, есть ли у вас право управлять администраторами группы. Иногда обычный модератор не может повышать ботов до админов.
Бот не удаляет спам. Проверьте право на удаление сообщений и статус правила. Возможно, правило всё ещё работает только в режиме аудита.
Мут, бан или кик не применяются. Проверьте права на ограничение участников и доступ модератора к командам.
Заявки новичков не обрабатываются. Проверьте права на join requests и включённую проверку новичков.
Центр безопасности показывает missing permissions. Откройте список прав бота в Telegram и добавьте только те права, которые нужны выбранной функции.
FAQ
Обязательно ли делать VibeGuard админом?
Для просмотра базовой установки бот может находиться в группе, но для защиты и модерации нужны права администратора. Удаление сообщений, муты, баны, кики, заявки и действия с инвайтами работают только при соответствующих Telegram-правах.
Какие права выдать в первый день?
Зависит от задач группы. Для многих групп достаточно начать с удаления сообщений и ограничения участников, а затем добавить join requests или invite-link permissions, если вы включаете проверку новичков или антирейд-сценарии.
Можно ли добавить бота без автоудаления и автобанов?
Да. Используйте режим аудита: VibeGuard покажет потенциальные срабатывания, но не будет удалять сообщения или наказывать участников, пока админы не включат конкретные действия.
Что делать, если я добавил бота не в ту группу?
Удалите VibeGuard из неправильного чата и повторите добавление для нужной группы. Перед изменением настроек проверьте активную группу в Центре безопасности.
Почему действие не сработало, хотя правило включено?
Чаще всего причина в Telegram-правах: нет права удалять сообщения, ограничивать участников, обрабатывать заявки или управлять инвайтами. Начните с диагностики в Центре безопасности.
Добавление VibeGuard бесплатное?
Да. У VibeGuard есть бесплатная версия навсегда для каждой группы. Каждый участник может использовать до 10 бесплатных AI help/prompts; расширение нужно только при большем AI usage, продвинутых правилах, автоматизации или управлении сеткой чатов.
Добавьте VibeGuard в нужную группу, выдайте только необходимые права и начните с режима аудита.