Документация / Getting started guide / Инструкция первичной настройки
Техническая документация

Как добавить VibeGuard в Telegram-группу и начать безопасно

Используйте эту инструкцию, чтобы добавить VibeGuard.bot в Telegram-группу, сделать бота админом, выдать нужные права, выбрать первый сценарий настройки, запустить режим аудита и открыть Центр безопасности для проверки.

Перед началом

Для первой настройки вам нужен доступ администратора 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, включите аудит и проверьте первые правила на реальной группе — без лишнего риска и без фейкового давления.