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