Документация / HowTo / инструкция по настройке проверки новичков, CAPTCHA и join request review
Техническая документация

Проверка новичков Telegram: капча, заявки и правила при входе

Используйте эту инструкцию, чтобы настроить VibeGuard Join Gate для Telegram-группы: CAPTCHA, подтверждение правил, очередь заявок, формы, проверку первых сообщений и ограничения для новых участников. Начните с мягкого review, проверьте Telegram-права бота и включайте отклонение заявок, кик или ограничения только тогда, когда команда готова.

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

Для настройки проверки новичков нужен владелец группы или админ, который может управлять правами бота, заявками и safety-настройками.

VibeGuard Join Gate помогает проверять или оценивать новичков до того, как они начнут писать, публиковать ссылки, отправлять медиа или попадут в активную группу. Настройки работают на уровне конкретного Telegram-чата: у каждой группы свои join gate rules, newcomer policies, moderation state, профили, AI usage, сводки и Mini App-контекст.

Не включайте все проверки сразу. Безопасный первый запуск: открыть Центр безопасности, выбрать один метод проверки, оставить действия осторожными и посмотреть реальные события новичков перед усилением правил.

Шаг 1. Откройте Центр безопасности

Откройте Центр безопасности из Telegram и убедитесь, что вы смотрите правильную группу.

В разделе Join Gate / Проверка новичков / Safety setup проверьте:

Что проверитьЗачем это нужно
Активная группаЧтобы не менять правила не того чата.
Права ботаЧтобы понять, может ли VibeGuard работать с заявками, ограничениями и временными сообщениями.
Join requestsЕсли группа использует заявки, боту нужны соответствующие права на их обработку.
Restrict rightsНужны, если вы хотите ограничивать новичков до проверки.
Delete rightsНужны, если бот должен удалять временные challenge / greeting сообщения.
Audit / review modeПомогает начать без автоматических отклонений, киков или жёстких ограничений.

Если вы не уверены, какие права выдавать, начните с лёгкого сценария и оставьте действия review-only до проверки.

Шаг 2. Выберите метод проверки

VibeGuard может поддерживать разные стили Join Gate в зависимости от риска и культуры группы.

Подтверждение правил Самый мягкий вариант. Новичок нажимает кнопку, подтверждая, что прочитал правила. Подходит для авторских сообществ, небольших публичных чатов и групп, где нужен лёгкий вход без сложной капчи.

CAPTCHA Подходит для защиты от bot waves и автоматизированного входа. Новичок решает визуальную, текстовую или button challenge в заданное время. Fail / timeout можно отправлять на retry, admin review, kick или decline только если админы включили такое действие.

Мини-квиз по правилам Полезен, если группе важно, чтобы участники понимали базовые правила: ссылки, реклама, оффтоп, объявления, скам, вакансии или поведение в чате. Ошибки лучше сначала отправлять на retry или review.

Форма или анкета Подходит для маркетплейсов, вакансий, закрытых клубов, tenant groups, private communities и саппорт-групп. Новичок оставляет данные, а админы approve / decline из очереди.

Проверка подписки или внешнего условия Описывайте и используйте такие проверки только там, где Telegram API и права действительно позволяют их надёжно проверить. VibeGuard не должен обещать чтение приватных Telegram-сигналов, которых бот не получает.

Шаг 3. Настройте review заявок

Если группа использует Telegram join requests, VibeGuard может помочь админам разбирать новичков до входа или до активного участия.

Осторожный setup может отправлять рискованных новичков в очередь, давать CAPTCHA, просить подтвердить правила или требовать форму. Затем админ выбирает действие: approve, challenge, decline или open case, если нужна дополнительная проверка.

Для high-risk групп проверку заявок лучше связать с антиспамом, антирейдом и threat signals. Например, новичок с подозрительным first-message behavior, локальным risk signal или странным invite context может уйти на review вместо blind approval.

Важно: auto-approve и auto-decline должны быть понятными и управляемыми. Чем жёстче действие, тем важнее причина, audit event и возможность review.

Шаг 4. Поймите состояния новичка

Join Gate работает лучше, когда админы видят, где находится каждый новичок.

СостояниеЧто значит
PendingПользователь вступил или отправил заявку, но ещё не прошёл проверку.
ChallengedVibeGuard выдал CAPTCHA, подтверждение правил, квиз или форму.
VerifiedПользователь прошёл активную проверку и может жить по обычным правилам группы.
QuarantinedПользователь остаётся ограниченным или видимым в очереди до review.
RejectedЗаявка отклонена или участник удалён по разрешённому правилу.
BypassedПользователь пропустил проверку, потому что он админ, trusted member, allowlisted user или исключён политикой группы.

Bypass-правила держите узкими. Исключения нужны для владельцев, админов, проверенных модераторов или доверенных ролей, но широкие bypass-листы быстро делают Join Gate бесполезным.

Шаг 5. Настройте ограничения для новичков

Newcomer policy может быть строже, чем правила для старых участников. Во время configurable newcomer window можно ограничивать ссылки, медиа, форварды, bot-command noise, быстрые первые сообщения или подозрительные sender patterns.

Используйте это аккуратно.

Авторский фан-чат может нормально получать всплеск стикеров после поста или эфира. Маркетплейсу чаще нужны строгие first-post правила и формат объявления. Crypto/Web3-группе может понадобиться более строгая проверка ссылок, fake support и аирдроп-паттернов. Публичной группе важно отличать обычных новичков от bot waves.

Начните с review. Включайте delete, restrict, kick, decline или case creation только там, где правило уже проверено и у бота есть нужные Telegram-права.

Шаг 6. Разберите события и настройте правила

После запуска Join Gate откройте события в Центре безопасности.

Проверьте:

  • кто получил challenge;
  • кто прошёл CAPTCHA или правила;
  • кто не успел пройти проверку;
  • кто был approved, declined или sent to review;
  • какие действия не сработали из-за missing permissions;
  • где реальные участники застряли на проверке;
  • какие правила слишком строгие;
  • нужны ли исключения, retry или ручной review.

Если нормальные участники часто не проходят проверку, упростите CAPTCHA, увеличьте time limit, замените строгий decline на admin review или начните с button acknowledgement.

Join Gate должен снижать хаос, а не создавать вторую работу для модераторов.

Быстрая проверка после настройки

ПроверкаЧто должно быть понятно
Join Gate включён в нужной группеНастройки применяются к правильному Telegram-чату.
Метод проверки выбранCAPTCHA, правила, квиз, форма или очередь заявок.
Telegram-права провереныПонятно, может ли бот обрабатывать заявки, ограничивать участников и удалять временные сообщения.
Review mode работаетПервые события видны без жёстких действий.
Newcomer states видныPending, Challenged, Verified, Quarantined, Rejected и Bypassed понятны админам.
First-message policy настроенаСсылки, медиа, форварды и быстрый флад новичков уходят в review или audit.
False positives разбираютсяАдмины знают, где смягчить капчу, таймеры или правила.

Если что-то не работает

CAPTCHA появляется, но VibeGuard не удаляет или не ограничивает тех, кто не прошёл проверку. Проверьте, включены ли kick, decline или restriction actions, и есть ли у бота нужные Telegram-права.

Join request review не работает. Проверьте, что группа действительно использует Telegram join requests, а у VibeGuard есть права на обработку заявок.

Реальные участники часто проваливают проверку. Увеличьте время challenge, упростите CAPTCHA или подтверждение правил и отправляйте неудачные попытки на admin review до включения жёстких действий.

Проверка подписки на канал работает нестабильно. Проверьте, можно ли технически проверить нужный канал или группу через доступные Telegram API rights. Если нет, используйте подтверждение правил, CAPTCHA или форму.

В группу всё равно попадает first-message spam. Свяжите Join Gate с newcomer policy, настройкой антиспама, sender-chat guard и review первых сообщений.

Новички зависают в очереди. Проверьте, кто из админов имеет доступ к queue review, включены ли notifications и не слишком ли строгие критерии quarantine.

FAQ

Что такое проверка новичков Telegram?

Это набор правил входа и первых действий участника: CAPTCHA, подтверждение правил, очередь заявок, квиз, форма, first-message policy и ограничения для новых участников.

Можно ли добавить капчу в Telegram-группу через VibeGuard?

Да. VibeGuard Join Gate может использовать CAPTCHA как один из методов проверки. Для первого запуска лучше начать с review/audit, а не с автоматического кика или отклонения заявок.

Какие Telegram-права нужны для проверки новичков?

Зависит от сценария. Для join request review нужны права на обработку заявок. Для ограничения новичков — права restriction. Для удаления временных challenge или greeting сообщений — права удаления сообщений.

Можно ли использовать проверку правил без CAPTCHA?

Да. Для групп с низким риском можно начать с button acknowledgement: участник подтверждает правила, а VibeGuard записывает факт проверки.

VibeGuard видит дату создания Telegram-аккаунта?

Нет. Не стоит обещать то, чего Telegram Bot API не даёт. Проверка должна опираться на доступные Telegram-данные, поведение в группе, заявки, правила, first-message policy и review.

Можно ли автоматически одобрять или отклонять заявки?

Да, если такой сценарий настроен и у бота есть права, но для первого запуска лучше начинать с очереди review. Auto-approve и auto-decline должны быть понятными, логируемыми и управляемыми админами.

Проверка новичков бесплатная?

У VibeGuard есть бесплатная версия навсегда для каждой группы. Каждый участник группы может использовать до 10 бесплатных AI help/prompts. Платное расширение нужно только сверх бесплатного использования или когда группе требуется больше AI-внимания, продвинутые правила безопасности, автоматизация или управление сеткой чатов.

Настройте вход в группу без лишнего риска: выберите метод проверки, проверьте права, начните с review и включайте жёсткие действия только после реальных тестов.