Начните здесь
Новый админ VibeGuard? Начните с базового пути настройки.
Перед началом проверьте:
| Что нужно | Зачем это нужно |
|---|---|
| Вы админ Telegram-группы | Чтобы добавить бота и выдать нужные права. |
| Вы понимаете, какие функции хотите включить | Антиспам, антирейд, модерация, AI/ИИ-сводки и Центр безопасности требуют разных прав и настроек. |
| Вы готовы начать с режима аудита | Так можно проверить правила до удаления сообщений, мутов, банов или lockdown. |
| У вас есть доступ к Центру безопасности | Там проще увидеть правила, недостающие права, инциденты, кейсы и AI usage. |
Быстрый путь настройки:
- Добавьте VibeGuard в Telegram-группу.
- Выдайте только те Telegram-права, которые нужны включённым функциям.
- Включите базовые feature flags для этой группы.
- Запустите антиспам и антирейд в режиме аудита.
- Откройте Центр безопасности и проверьте диагностику прав.
Что должно получиться: VibeGuard добавлен в группу, права проверены, первые правила работают в audit mode, админы видят события и missing permissions в Центре безопасности.
Настройка и права бота
VibeGuard работает внутри Telegram, поэтому часть действий зависит от прав, которые вы выдали боту в группе.
Для удаления спама нужны права на удаление сообщений. Для мута, бана и кика — права на ограничение участников. Для проверки заявок — права на join requests. Для работы с invite links нужны соответствующие admin rights.
Начинайте с минимального набора прав под ваши включённые функции. Если чего-то не хватает, Центр безопасности должен показать это в диагностике, чтобы админ не гадал, почему команда или правило не сработали.
Рекомендуемые документы:
- Начало работы
- Добавить бота в группу
- Права Telegram-бота
- Центр безопасности
- Конфиденциальность и безопасность
Безопасность и модерация
Используйте этот раздел, когда группа сталкивается со спам-ссылками, фладом, рейдами, suspicious media, токсичными волнами новичков, ручной чисткой или спорными действиями модераторов.
Начните с настройки антиспама, если проблема — ссылки, медиа, стикер-флуд, повторяющиеся сообщения, edit abuse, сообщения от имени каналов или первые сообщения новичков.
Начните с настройки антирейда, если проблема — резкий массовый вход, bot waves, invite attacks, одинаковые первые сообщения, lockdown или восстановление после инцидента.
Откройте команды модерации, если админам нужны варн, мут, бан, кик, чистка, причины действий, доступ к командам, кейсы, апелляции и журнал действий.
Рекомендуемые документы:
- Настройка антиспама
- Настройка антирейда
- Проверка новичков
- Команды VibeGuard
- Кейсы и апелляции
- Центр безопасности
AI, сводки и квоты
VibeGuard поддерживает AI help/prompts и AI/ИИ-память группы, но AI usage должен оставаться понятным и контролируемым.
Каждый участник группы может использовать до 10 бесплатных AI help/prompts. Расширение нужно только сверх бесплатного использования или когда группе требуется больше AI-внимания, больше сводок, image usage, продвинутые правила, автоматизация или управление сеткой чатов.
Для ежедневной памяти группы используйте документы по AI/ИИ-сводкам: daily recap, best-of highlights, таймлайн обсуждений и голосовое резюме, если оно включено. Для интерактивной AI-помощи используйте документы по Telegram AI и AI-квотам.
Рекомендуемые документы:
- AI-квоты
- AI/ИИ-сводки
- Telegram AI
- Конфиденциальность и безопасность
- Тарифы и бесплатное использование
Центр безопасности и диагностика
Центр безопасности — это Mini App-админка VibeGuard внутри Telegram. В документации по Центру безопасности стоит начинать, если вы хотите понять, где смотреть правила, режим аудита, очередь новичков, инциденты, кейсы, threat signals, доступ к командам, AI usage и диагностику прав бота.
Для админов это главный troubleshooting-путь: если правило не сработало, команда не применилась или бот не смог удалить сообщение, сначала проверьте права, включённые функции и статус правила в Центре безопасности.
Рекомендуемые документы:
- Центр безопасности
- Диагностика прав
- Audit mode
- Журнал инцидентов
- Кейсы и апелляции
- Сетки чатов
Privacy, данные и trust
Если вопрос связан с данными группы, правами бота, Mini App auth, удалением данных или Responsible AI, начинайте с trust-документации.
VibeGuard построен вокруг group-scoped подхода: каждая Telegram-группа хранит свои настройки, профили, moderation state, AI usage, сводки и Mini App-контекст отдельно. Это важно учитывать при настройке нескольких групп, сеток чатов и privacy-запросов.
Рекомендуемые документы:
- Конфиденциальность и безопасность
- Удаление данных
- Responsible AI
- Acceptable Use
- Abuse Reporting
Если что-то не работает
Бот не удаляет спам. Проверьте, есть ли у VibeGuard право на удаление сообщений и включено ли правило не только в audit mode.
Мут, бан или кик не применяются. Проверьте права на ограничение участников и доступ модератора к командам.
Не работает проверка заявок. Проверьте, есть ли у бота права на обработку join requests и включена ли проверка новичков для этой группы.
AI-функция недоступна. Проверьте AI-квоты, feature flags группы и настройки Telegram AI или AI/ИИ-сводок.
Центр безопасности не открывается. Проверьте, что вы админ группы, что Mini App доступен и что функция включена для этого чата.
FAQ
С какой инструкции начать?
Начните с «Начало работы»: добавьте VibeGuard в группу, выдайте минимально нужные права, включите первые функции и запустите safety-правила в режиме аудита.
Какие права нужны VibeGuard в Telegram?
Зависит от функций. Удаление сообщений требует delete rights, муты и баны — прав ограничения участников, заявки — прав на join requests, invite actions — соответствующих admin rights. Диагностика в Центре безопасности помогает увидеть, чего не хватает.
Можно ли тестировать защиту без автоудаления?
Да. Для антиспама, антирейда и проверки новичков лучше начинать с режима аудита: VibeGuard покажет потенциальные срабатывания до удаления сообщений, мутов, банов или lockdown.
Где посмотреть AI/ИИ-квоты?
Откройте документ «AI-квоты». Каждый участник группы получает до 10 бесплатных AI help/prompts; расширение нужно только сверх бесплатного usage или при продвинутых потребностях группы.
Где читать про privacy и удаление данных?
Откройте «Конфиденциальность и безопасность» и «Удаление данных». Эти документы объясняют group-scoped данные, права бота, Mini App auth, privacy boundaries и запросы на удаление group-owned данных.
Настройте VibeGuard спокойно: начните с установки, прав и режима аудита, а затем включайте только те функции, которые нужны вашей группе.