Skip to main content

Проверка подписки (join) - Базовая

Проверка подписки (join): известный инструмент, который заставляет пользователей ботов оставаться в курсе событий происходящих в группах и каналах , а так же защищает боты от накруток роботов. Если юзер не подписан на указный канал или группу он не получит доступа к функционалу бота. В @MenuBuilderBot подписка может использоваться как для проверки новых пользователей, так и для защиты элементов меню.

В конструкторе @MenuBuilderBot проверка подписки может работать в двух режимах: БАЗОВЫЙ режим проверки и МУЛЬТИПОДПИСКА. Каждый из режимов имеет свои особенности. Базовый режим активен по умолчанию при подключении функции "Проверка Подписки".

Данное руководство посвящено Базовой проверке подписки. 

Базовая проверка подписки (в отличие от проверки Мультиподписки), подразумевает возможность проверить подписку на 1 группу или канал.


Особенности и Возможности Базовой проверки подписки

1. Приобретается один раз и не требует постоянной оплаты.
2. Нахождение бота в группе не требует наличия Токенов Групп.
3. Может проверять одну группу на наличие подписки.
4. Может устанавливаться как "на весь бот" и на отдельные кнопки меню.
5. При проверке на весть бот может проверять как "Только новых Рефералов", так и "Всех новых юзеров". 
6. При подключении плагинов может проверять подписку как "раз в неделю", так и "раз в день".
7. При включенных плагинах появляется режим проверки "Все" - который проверяет всех юзеров повторно с переодичностью активного плагина.
8. Активация Базовой Подписки дает возможность включить режим "Мультиподписки".

РЕЗЮМИРУЯ: функция "Базовой Подписки"  была создана специально для не больших проектов где она не является системообразующей функцией, а лишь представляет собой дополнение к основному функционалу бота, способом привлечь внимание пользователей бота к группе или каналу проекта, путем подписки на него. Функция не дорогая - оплачивается один раз и не требует постоянной оплаты. Частоту проверки, опционально, можно регулировать при помощи расширений с отдельной ежемесячной оплатой. Для более сложных и объёмных проектов всегда можно переключиться в режим "Мультиподписки".


Как включить опцию проверки подписки


Прежде чем вы сможете использовать возможности проверки подписки, вы должны включить ее.

Проверка Подписки.
Для подключения перейдите в свой бот:
☞ 🔐Админ | 🧩Расширения | 📂Защита Бота


Общие настройки Базовой Проверки подписки 


Чтобы бот мог проверить подписку пользователя, он должен быть добавлен в группу или канал, подписку на который вы хотите проверять и быть там Админом. Подробные инструкции о добавлении бота в канал или группу читайте в мануале по Группам. Сокращенный вариант смотрите ниже. Как мы указали ранее проверку можно установить как на весь бот, так и на отдельные кнопки меню.

Данные настройки являются общими и их необходимо выполнить вне зависимости от того какой вид проверки (на бот или на кнопку) вы собираетесь активировать в вашем боте.


Добавление группы для базовой проверки подписки

Перейдите в свой бот:
☞ 🔐Админ | 🚻 Проверка Подписки

IMG_20220415_002640.jpg


Работа бота в группе для проверки Базовой Подписки НЕ требует «Токенов Групп», поэтому группу мы настраиваем в самом разделе.


Настроить Группу / Канал

Нажмите «Настроить Группу/Канал».

Указанная здесь группа будет использована как для проверки на весь бот, так и на кнопках.

Данная настройка идентична той что мы используем при обычном добавлении бота в группу в разделе:
☞ 🔐Админ | 🧫 Каналы и Группы | Мои Группы
по ссылке выше. Поэтому для тех кто добавлял группу в том разделе - здесь сложностей не будет.

Для проверки подписки:
1. Бот должен быть добавлен в группу или канал, где вы хотите проверять подписку.
2. Бот в группе должен быть АДМИНОМ.

Если просто добавить бот в канал - то он, так же просто оттуда выйдет. Поэтому ПРЕЖДЕ ЧЕМ добавлять бот в группу или канал - нужно добавить данные группы в бот.

Используйте один из методов ниже:


IMG_20210922_113328.jpg


1. Для ПУБЛИЧНОГО канала/группы можно отправить боту их @ Имя.
2. Так же для добавления ПУБЛИЧНОГО канала/группы можно переслать одно из сообщений из этого канала/группы.
3. Для ПРИВАТНОГО канала/группы понадобится их ID. Чтобы получить ID (идентификатор) группы, используйте @RawDataBot. Добавьте его в группу с полными правами. Как только он будет добавлен, он отправит полный дамп данных:


49059f270c14c8f017412.jpg


Получите ID (идентификатор) из раздела «chat» и используйте его для добавления группы в бот. После этого вы можете удалить @RawDataBot из группы.


Задать ID Принудительно

Данная опция описана тут.

ВАЖНО: ID группы МОЖЕТ ИЗМЕНИТЬСЯ при изменении статуса группы с обычной, на Супергруппу. В связи с этим функции бота связанные с действиями в группе (подписка, триггеры, модерация и т.п.) перестанут работать. В этом случае группу нужно будет добавить заново с новым ID. Для этого повторите описанные выше шаги по добавлению бота в группу. Узнать больше: Если ваш бот перестал работать в группе через некоторое время.

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

ПОСЛЕ добавления данных группы в бот, можно пойти и добавить сам бот в группу.


Создание сообщений для пользователя

Указанные здесь сообщения будут использованы как для проверки на весь бот, так и на кнопках. Для кнопок можно будет задать и свои собственные при необходимости.

Сообщение о Подписке

Установите сообщение, которое будет показано пользователю, и сообщит ему о необходимости подписаться.


c9e28aee3427d90759606.jpg


Тут можно использовать любые типы сообщений которые используются в меню.

В сообщении ДОЛЖНЫ присутствовать ссылки на ваши группы (группу) подписку на которые вы организуете.

Для добавления ссылок на группы можно использовать Инлайн кнопки. Только кнопки в режиме URL.

Общее количество Инлайн кнопок которое можно добавить к сообщению будет зависеть от общего количества Инлайн кнопок которое доступно для одного сообщения в вашем боте - их количество увеличивается на общих основаниях.
Руководство по Инлайн кнопкам.


Сообщение если юзер НЕ подписан

В некотором смысле - сообщение об ошибке.

Добавляется аналогичным образом как и сообщение о необходимости подписаться в разделе выше. Это сообщение будет показано если юзер попытается воспользоваться защищенным функционалом не подписавшись на канал или группу.

Кнопка "Задать Пустым" очистит существующее сообщение, а юзеру будет показано сообщение по умолчанию.


Кнопка «Проверить»

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

 

❖ Включение подписки (на весь бот)


Включение проверки на весь бот происходит в:
☞ 🔐Админ | 🚻 Проверка Подписки

Проверка

Данная опция включает проверку подписки НА ВЕСЬ БОТ. Если вам нужна только проверка отдельных кнопок - то эту настройку можно оставить ВЫКЛЮЧЕННОЙ.

Проверка включается для "новых пользователей" - тех что пришел в бот первый раз.

Проверка в базовой подписки (без активных плагинов) имеет три режима:
Режимы:
Выкл ⏹️ - функция выключена.
🆕 Новые Реф. - включено только для пришедших по Реф. Ссылке.
🆕 Новые Все - включено для всех новых.
После подключения плагинов увеличивающих частоту проверки до "Раз в неделю" и "Раз в день" у кнопки появляется дополнительный режим:
🆕 Все - включено для всех юзеров и проверка происходит с частотой активного плагина.

Текущая настройка указана на кнопке, режимы переключатся по кольцу.

Режимы аналогичны тем что используются для Защиты Капчей, команды /start.

IMG_20220415_013730.jpg

❖ Режим мультиподписки


Включение режима Мультиподписки так же происходит в:
☞ 🔐Админ | 🚻 Проверка Подписки

Перейти в Режим: Мультиподписка

Находясь в режиме Базовой Подписки и нажав эту кнопку вы перейдёте в режим Мультиподписки.

ВАЖНО: Режим Мультиподписки это ОТДЕЛЬНЫЙ режим - он никак не связан с Базовой Проверкой Подписки. Данный режим ЗАМЕЩАЕТ собой её настройки - ничего из настроенного в Базовом Режиме в Мульти Режиме работать НЕ БУДЕТ. Ваш бот, в момент времени, может находится только в ОДНОМ из этих режимов.

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

На момент перехода из одного режима в другой - до полной настройки нового режима, ваш бот может находится без защиты подпиской. Если наличие защиты для вас является важным, то при переходе с Базового на Мульти режим либо заранее подключите, настройте и добавьте бот во все необходимые группы, либо переведите бот в "Режим Обслуживания".

Подробнее о настройке и работе режима Мультиподписки читайте в мануале.


❖ Проверка отдельного юзера по ID


Иногда юзеры испытывают затруднения с подпиской на каналы и группы, особенно в режиме Мультиподписки. Функция проверки конкретного юзера находится в:
☞ 🔐Админ | 🚻 Проверка Подписки

Проверить Юзера

Функция помогает по Телеграм ID или UserCode пользователя узнать на какие группы он фактически подписан.

Когда в проверке подписки "что-то не работает" и непонятно где проблема - это должно несколько помочь понять ситуацию. Проблемной скорее всего окажется группа на которую юзер не смог подписаться. Для начала проверьте наличие ссылки на нее в сообщении с просьбой о подписке. Если ссылка на месте - то проверь саму ссылку из сообщения на работоспособность. 


Включение подписки (на кнопке)


Если вы хотите заблокировать не весь бот, а только его часть, вы можете установить проверку подписки на любую кнопку.

Сделайте следующее:
1. Зайдите в "🎛 Редактор Кнопок"
2. Выберите кнопку и откройте "Настройки" кнопок


bf570c42869df64091a2c.jpg


3. Нажмите "Подписка (join)"


IMG_20211018_105415.jpg


4. Добавление сообщений в кнопках "Сообщение о Подписке" и "Сообщение если Юзер не Подписан" НЕ является обязательным. По умолчанию их значения будут взяты из общих настроек в Админке. Добавляйте их ТОЛЬКО если хотите присвоить кнопке сообщения отличные от тех что задали в "Общих настройках" в Админке. 


IMG_20220415_223744.jpg


5. Для включения проверки на кнопке нажмите "Проверка"
Это активирует для проверки группу  (или канал) настроенные вами ранее в Общих настройках Базовой Проверки Подписки.

Отдельно указывать группу для каждой кнопки в режиме Базовой Проверки подписки - нет необходимости.

IMG_20220415_223634.jpg


Включив эту опцию, вы поставите «защиту подпиской» на кнопку, и только пользователь, который подписался на канал/группу, сможет войти.

Ваш бот НЕ будет проверять подписку для владельца бота и его администраторов.

«Базовая проверка подписки» установленная НА ВЕСЬ БОТ, выполняет проверку для каждого нового пользователя только один раз: при первом запуске бота, для новых пользователей (или только для новых реферальных пользователей).

В случае если «Базовая проверка подписки» установлена НА КНОПКУ - проверка выполняется один раз в месяц: то есть следующая проверка будет осуществлена ещё раз - через месяц. Это не запланированная функция, а скорее особенность механики работы функции. Принимать её во внимание или нет - дело ваше.

Для периодических проверок используйте "Еженедельную" и "Ежедневную" проверки.


Еженедельная и Ежедневная проверки Подписки


«Еженедельная и ежедневная проверка подписки» могут быть подключены дополнительно если вам нужно проверять ваших пользователей чаще.

Еженедельная и Ежедневная проверка подписки.
Для подключения перейдите в вашем боте:
☞ 🔐Админ | 🧩Расширения | 📂Защита Бота

Данные функции оплачиваются ежемесячно  - в случае отсутствия оплаты бот возвращается в исходный режим одноразовой проверки. Они нужны ТОЛЬКО для режима Базовой проверки подписки. 

Вместе с этими расширениями вы получаете дополнительные опции (уже были указаны выше):


Проверка "Все"

1. В 🔐Админ | 🚻Проверка Подписки - вы получите доп. опцию "🆕 Все":

IMG_20220415_234233.jpg


Когда эта опция включена на ВЕСЬ БОТ, если любой пользователь (не только новый) нажимает любую кнопку, его подписка будет проверяться (один раз в неделю или один раз в день, в зависимости от типа приобретенной опции проверки).


Проверка на кнопке

Проверка Подписки на отдельной кнопке (если она уже была включена ранее) начнет автоматически проверять подписку в соответствии текущим режимом проверки (раз в неделю или раз в день) - ничего отдельно для этого делать не нужно.

На этом всё о проверке подписки.


Проблемы при проверке Подписки


Если у вас нет ошибок, и кажется, что ваш бот ничего не проверяет

Ваш бот НЕ будет проверять подписку для владельца бота и его администраторов.

Поэтому, если вы, как создатель (creator), хотите протестировать новую функцию подписки, сделайте это используя НОВЫЙ АККАУНТ TELEGRAM! НЕ ИСПОЛЬЗУЙТЕ учетную запись, которая является администратором, создателем, текущим пользователем бота или пользователем группы / канала.

Вы подписаны, а бот говорит что не подписаны

Вы для теста подписались на какой-то канал, но при проверке в Боте он говорит что вы не подписаны.
Проверьте что:
• Бот всё ещё является админом в группе.
• Бот имеет достаточно прав в группе.
• Сама Группа вообще активна и включена в настройках самого бота.

❖ Сообщения об ошибках


Если бот сталкивается с проблемами при попытке проверить подписку, он уведомит об этом владельца бота.

❌ Канал/группа, для проверки подписки (базовая настройка) - не указана.
Необходимо указать ID канала/группы.
ℹ️ Настройте канал/группу…

Если вы получаете такое или подобные уведомления:
1. Убедитесь, что группа указана в настройках
2. Бот добавлен в группу/канал как АДМИН
3. Убедитесь что ID  группы не изменился из-за статуса Супергруппы
4. Проверьте все настройки в «Каналы и Группы»
5. ПЕРЕЧИТАЙТЕ ЭТО РУКОВОДСТВО - перепроверьте настройки и устраните проблему.
6. Если поиск ошибок не помог - УДАЛИТЕ группу и добавьте её с нуля.

• • •

❗️ Подписка необходима, но не может быть проверена.
ℹ️ Свяжитесь с админами бота.

Сообщение предназначенное для пользователя бота - оно говорит о том что в Боте недостаточно «Токенов Функций» для проверки подписки.

Сообщение максимально нейтральное, потому как нет необходимости посвящать юзера в технические подробности происходящего.