Модуль управление юзерами
Раздел содержит все инструменты по управлению юзерами вашей группы - как новыми, так и уже присутствующими в группе.
Для работы представленного функционала вам понадобится:
• Публичная Группа
• Включённая опция «Заявки на вступление».
Чтобы включить опцию «Заявки на вступление» перейдите в вашей ПУБЛИЧНОЙ группе:Настройки группы > Тип группы > Заявки на вступление
Принимать Запросы
При включении бот будет автоматически принимать запросы на присоединение в группах, для которых установлено требование отправлять запросы на присоединение, прежде чем пользователь сможет попасть в группу.
Режимы:Выкл ⏹️
- функция выключена.Вкл ▶️
- функция включена.
Условие Вступления
Позволяет вам назначить Условие которому должен соответствовать пользователь, чтобы быть допущенным в группу (чтобы его запрос на вступление был принят ботом автоматически).
Например Условием может являться наличие нужного количества рефералов или наличие Баланса в боте.
Наличие в интерфейсе этой настройки будет зависеть от того, активно ли расширение:
Условие для Запроса на Вступление.
Для подключения перейдите в вашем боте:☞ 🔐Админ | 🧩Расширения | 📂Группы
Вам потребуется:
• Ввести само Условие (на основе данных бота).
• (ОБЯЗАТЕЛЬНО) Добавить сообщение об ошибке (придёт в сам бот)
В Сообщении об Ошибке - вы должны проинформировать юзера - каким Условиям он должен соответствовать для вступления в группу, а так же указать куда и как он должен перейти чтобы выполнить эти Условия в боте.
Опционально можно поместить Команду того раздела меню где это условие можно выполнить - чтобы облегчить юзеру поиск места и само выполнение.
Платная Подписка (В РАЗРАБОТКЕ)
Функция позволяет удалять из группы пользователей время подписки которых на группу закончилось. А также предупреждать их об окончании срока платной подписки на группу.
Наличие в интерфейсе этой настройки будет зависеть от того, активно ли расширение:
Платная Подписка на Группу.
Для подключения перейдите в вашем боте:☞ 🔐Админ | 🧩Расширения | 📂Группы
Для работы представленного функционала вам ОБЯЗАТЕЛЬНО понадобится:
• Публичная Группа (без неё нельзя включить следующий параметр).
• Включённая опция «Заявки на вступление».Настройки группы > Тип группы > Заявки на вступление
Проверка платной подписки через "Заявку" - это самый надёжный способ, потому как со 100% уверенностью, технически, нельзя гарантировать что бот не пропустит нелегальный вход по ссылке без запроса.
ВНИМАНИЕ: функция потребляет 1 "Токен Функций" за проверку одного юзера. Оплата производится при каждой проверке, по количеству юзеров с данными Даты и Времени сохранёнными в переменной, которая указана в настройках функции. После Кика из группы переменная юзера очищается (деинициализируется).
Переменная Даты
Указать Переменную (Даты и Времени) в которой хранится дата окончания "платной подписки" юзера на группу.
Удалите указанную тут ранее переменную чтобы отключить саму функцию Платной Подписки.
Хранящиеся в переменной данные вы пишете сами средствами конструктора, создавая в боте нужный вам интерфейс и на нужных вам условиях - бот только сравнивает текущую дату с сохранённой ВАМИ в переменной.
Задать Сообщение об Ошибке
Тут необходимо задать сообщение которое будет показано пользователю в боте, если он пытается получить доступ в платную группу не оплатив своё в ней пребывание. В сообщении добавьте инструкции которые позволят пользователю оплатить подписку.
Задать предупреждение
Задать сообщение с предупреждением юзера об окончании срока подписки и сам срок - за какое время (в днях) начинать предупреждать юзера.
Задать Кик
Задать сообщение информирующее юзера о Кике из Группы по истечении срока подписки с опцией «Исключать при Активности» - позволяющей очищать "старых" или нелегальных юзеров из групп на основании их активности (например при попытке написать сообщение в группе).
Примерный механизм организации Тарифа платной подписки в боте:
1. Создайте переменную дату и времени.
Например: date_var
2. Создайте кнопку для приобретения юзером нужного тарифа.
2.1 На кнопку поставьте Условие которое будет проверять достаточно ли средств на Балансе пользователя.
Например: {%balance% >= 100}
2.2 В самой кнопке добавьте «Action Чисел» который будет списывать указанную вами сумму с Баланса.
2.3 Добавьте второй «Action Чисел» который будет устанавливать дату, на месяц большую чем записано в созданной вами переменной Даты и Времени.
Например: {dt_add("%date_var%", 1, "m")}
2.4 Добавьте сообщение которое показывает новую дату подписки.
Например: Новая дата подписки: %date_var%.
Сообщение После Вступления
Добавленное тут сообщение будет показано пользователю который (отправив запрос на присоединение) успешно присоединился к чату. При этом пользователю будет показана кнопка для (пере)запуска бота.
ВАЖНО: Данное сообщение будет показано юзеру если все остальные проверки уже пройдены (либо отсутствуют) и юзер допущен в группу.
Данное сообщение является НЕОБЯЗАТЕЛЬНЫМ и его можно не использовать.
В сообщении можно использовать картинку.
Удалите добавленное ранее сообщение чтобы бот перестал связываться с новыми пользователями.
ПОЯСНЕНИЯ: Единого сценария или контекста применения для этого сообщения - не существует. Например при отсутствии дополнительных проверок (когда бот просто автоматически подтверждает все заявки) данное сообщение будет показано НОВОМУ пользователю - содержание данного сообщения при этом может быть соответствующим контексту "нового пользователя" - например описание преимуществ стать юзером бота. Если в боте присутствуют какие-то дополнительные проверки, например «Условие Вступления» либо «Платная Подписка», в этом случае надо полагать пользователь УЖЕ является юзером бота, в той или иной степени понимания этого факта - поэтому содержание сообщения, по идее, должно отличаться от показываемого новому пользователю, кроме того, данное сообщение имеет смысл показывать если после прохождения проверок, в вашем сценарии, юзер (по каким-то причинам) так и не получил доступа к меню, либо вы хотите принудительно перенести его в Главное Меню.
Поэтому для осмысленного использования данной функции важно понимать механику её работы.
МЕХАНИКА РАБОТЫ: Бот имеет возможность отправить сообщение пользователям, которые отправили запрос на присоединение к чату (где бот является администратором), даже если пользователь никогда раньше не взаимодействовал с этим ботом. При этом, в нижнем меню пользователь увидит кнопку присоединения к боту, после нажатия на которую он окажется в Главном Меню бота, (в общем случае) став его юзером. Изначально данное сообщение задумывалось как приветственное, для новых пользователей, однако, с появлением дополнительных функций проверки, его работа стала неочевидной и более сложной.
ВАЖНО: Аккаунт пользователя НЕ станет юзером бота автоматически при получении сообщения. Пользователь должен будет либо запустить бота самостоятельно и осмысленно, используя кнопку показанную ботом в нижнем меню, либо ранее - другим способом отправить боту Сообщение или Команду. Добавлять юзера в бот автоматически - НЕЛЬЗЯ (было нельзя, нельзя сейчас и нельзя будет в будущем, ни платно, ни если очень нужно, а по ЭТИЧЕСКИМ соображениям).
❖ Общая последовательность работы функций
Для лучшего понимания механики работы функций данного раздела нужно иметь ввиду следующие моменты:
1. Единственным условием работы функционала данного раздела является включённая опция «Принимать Запросы». Без её включения остальные функции работать не будут.
2. Функции не связаны между собой и имеют свои собственные отдельные настройки не влияющие друг на друга.
3. Срабатывание данного функционала происходит в момент когда пользователь отправляет запрос на вступление в группу - при КАЖДОМ подобном запросе бот проверяет настройки функций этого раздела, при этом, ЗАНОВО происходит полная валидация ВСЕХ активных функций (все их условия должны соблюдаться).
4. Функции имеют определённую последовательность срабатывания друг относительно друга:
- При запросе на вступление проверяем включена ли функция «Принимать Запросы» (если НЕ включена - дальнейшие проверки не проводятся).
- Проверяем задано ли «Условие Вступления». Проводим проверки, показываем сообщения ошибок при необходимости (заданное вами или системное по умолчанию).
- Проверяем активна ли функция «Платная Подписка». Проводим проверки, показываем сообщения ошибок при необходимости (заданное вами или системное по умолчанию).
- Проверяем задано ли «Сообщение После Вступления». Если задано - показываем его в боте.
ВАЖНО: При создании функционала Управления Юзерами в группе (в частности при добавлении «Условия Вступления» либо «Платной Подписки»), важно понимать что конструктор позволяет вашему боту иметь ещё и СВОИ СОБСТВЕННЫЕ условия проверки пользователей, такие например как «Капча», «Подписка на Канал», «Вступление только по Реф. ссылке», «Наличие Юзернейма» и прочее. При этом работа всех этих проверок может порождать сложно предсказуемые взаимодействия. В частности проверки самого бота могут (и чаще всего - будут) ПРЕРЫВАТЬ линейный сценарий проверки вступления юзера в группу. Поэтому тестируйте ваши настройки и продумывайте все возможные варианты развития событий ЗАРАНЕЕ, имейте представление в каком разделе меню будет находиться юзер на каждой стадии его проверки. В общем случае, можно порекомендовать отключить проверки бота если вы используете функции группы по Управлению Юзерами, либо продумывайте ваши сообщения так чтобы юзер мог чётко понимать что он делает в каждый момент времени, А ТАКЖЕ имел возможность перейти к следующему этапу после завершения предыдущего.
❖ Сообщения об ошибках
❌ Ваш запрос на вступление в Группу или Канал - не был подтверждён.
Подписка на данную Группу или Каналу имеет Условия входа или Платную Подписку.
ℹ️ Обратитесь к администратору проекта чтобы узнать Условия входа.
Это системное сообщение по умолчанию для пользователя, оформлено в максимально нейтральном стиле. Сообщение говорит о том что вы (как создатель бота) забыли указать "Сообщение об Ошибке" либо в Условиях Вступления в группу либо в Платной Подписке. Задайте нужные сообщения и бот будет показывать их вместо системного.