Список пользователей
Все клиенты сервиса в одной таблице: поиск, фильтры по статусу, тарифу, источнику и бот-скору, массовая выдача и продление доступа, блокировка, выгрузка в CSV и создание клиента вручную.
Раздел Пользователи — все, кто запускал бота, входил на сайт или кого вы добавили сами. Отсюда открывается карточка клиента, а выдача доступа описана на странице «Выдача и продление доступа».
Что здесь есть
Под заголовком — короткая сводка: сколько всего пользователей, сколько платят и, если есть связь с сервером, «N сейчас в приложении» — сколько человек прямо сейчас открыли Mini App или кабинет.
Справа две кнопки:
- «Экспорт CSV» — выгрузить список в файл;
- «Создать пользователя» — добавить человека без бота.
Список обновляется сам: новые регистрации, оплаты и изменения подписок появляются без перезагрузки, изменённая строка на секунду подсвечивается.
Плитки сверху
| Плитка | Что считает |
|---|---|
| Всего | Все пользователи без удалённых. Ниже — сколько пришло за 30 дней |
| Платят | У кого действует подписка, это не пробный период и человек хоть раз оплатил подписку. Ниже — доля от всех. Считается так же, как на дашборде |
| Пробный период | У кого прямо сейчас идёт пробный |
| Истекли | У кого подписка была, но закончилась. Ниже — сколько заблокировано |
Поиск и фильтры
Поиск ищет по метке администратора, имени в Telegram, @username и Telegram ID. Знак @ можно не ставить. Пример: ivan, @ivan_petrov, 123456789.
Фильтры — кнопки рядом с поиском. В каждом можно отметить несколько значений, рядом с каждым значением видно, сколько таких строк.
| Фильтр | Значения |
|---|---|
| Статус | Активен — подписка действует, в том числе пробная. Истёк — подписка была и закончилась. Без подписки — подписки никогда не было. Заблокирован |
| Тариф | Пробный, Лайт, Плюс, Ультима |
| Источник | Органика, Реферал, Реклама, Вручную (созданы в админке), Сайт (зарегистрировались на сайте по почте, через Google или Яндекс) |
| Бот-скор | Боты, от 50 и Подозрительные, от 25. Второй фильтр показывает и подозрительных, и ботов |
«Сбросить» снимает все фильтры и поиск.
«Скрыть неактивных» оставляет в списке только активных и заблокированных: истёкшие и те, у кого подписки не было, прячутся. Этот переключатель запоминается в браузере и не сбрасывается кнопкой «Сбросить».
На телефоне фильтры собраны в одну кнопку «Фильтры». Внутри те же группы и переключатель «Скрыть неактивных», внизу — «Сбросить» и «Показать N».
Колонки таблицы
| Колонка | Что в ней |
|---|---|
| Пользователь | Аватар, имя, @username и Telegram ID. Если задана метка администратора, вместо имени показывается она. Зелёная точка на аватаре — человек сейчас в приложении. Метка «бот» или «бот?» — подозрение на бота |
| Статус | Активен, Истёк, Заблокирован или прочерк, если подписки не было |
| Тариф | Пакет (Лайт, Плюс, Ультима) или «Пробный», под ним — дата окончания. У старых подписок может стоять название старого тарифа или «Активна» |
| Источник | Откуда пришёл человек. У реферала ниже — Telegram ID пригласившего, у рекламы — название рекламной ссылки |
| Бот-скор | Оценка от 0 до 100. От 25 — оранжевым, от 50 — красным. Галочка — бот подтверждён |
| Регистрация | Дата первого входа |
| Доход | Сколько человек заплатил за VPN за всё время, без магазина Stars/Premium и за вычетом возвратов |
Нажмите на заголовок колонки, чтобы отсортировать по ней. Повторное нажатие меняет направление.
Внизу — сколько строк найдено, выбор «Строк на странице» (10–50, по умолчанию 20) и страницы. На телефоне вместо страниц кнопка «Показать ещё».
Нажмите на строку, чтобы открыть карточку клиента. Ссылка на карточку вида /admin/users/123456789 открывается напрямую — её можно сохранить или переслать другому администратору.
Что такое бот-скор
Панель сама оценивает пользователей по признакам накрутки: ключ есть, а трафика нет; приложение ни разу не открывали; молодой Telegram-аккаунт без активности; у пришедших по одной рекламной ссылке совпадают подсети или браузер. Оценка пересчитывается каждые 30 минут для тех, кто пришёл за последние 90 дней. Это подсказка, а не приговор: перед блокировкой загляните в карточку.
Массовые действия
Отметьте галочками нужные строки. Галочка в заголовке отмечает всех на текущей странице. Внизу экрана появится панель с действиями. Массовые действия доступны на широком экране, в узкой версии для телефона галочек нет.
| Кнопка | К кому применяется | Что делает |
|---|---|---|
| «Выдать доступ» | Ко всем выбранным, у кого нет действующей подписки | Выдаёт пакет на месяц, год, свои дни или пробный |
| «Продлить» | Только к выбранным с действующей подпиской | Добавляет срок. По умолчанию 30 дней на текущем пакете каждого |
| «Разблокировать» | Только к заблокированным | Снимает блокировку |
| «Заблокировать» | Ко всем, кто ещё не заблокирован | Блокирует |
Если действие подходит не всем выбранным, рядом с кнопкой видно, скольким оно подходит. Остальные будут пропущены, окно подтверждения это напишет.
Подробно о выдаче и продлении — на странице «Выдача и продление доступа».
Блокировка обрывает подписку
При блокировке срок подписки заканчивается в ту же минуту, ключи отключаются. Разблокировка срок не возвращает. Если блокировали по ошибке, после разблокировки выдайте доступ заново или поставьте дату через «Изменить дату» в карточке.
«Выдать доступ» не смотрит на блокировку
Заблокированные тоже считаются «без подписки», поэтому массовая выдача достанется и им. Если не хотите этого, снимите с них галочки или сначала включите фильтр Статус → Истёк и Без подписки.
Экспорт CSV
Кнопка «Экспорт CSV» скачивает файл users_export_ГГГГ-ММ-ДД.csv. В нём все пользователи без удалённых, колонки:
ID, Telegram ID, Username, Fullname, Created At, Banned.
Фильтры на выгрузку не влияют
В файл всегда попадают все пользователи, даже если в таблице включены поиск или фильтры. Статуса подписки, тарифа и дохода в файле нет. Полную выгрузку базы можно сделать в Настройки → База данных.
Создать пользователя
Для тех, кто не пользуется ботом: родственники, сотрудники, клиенты, которым вы продаёте доступ сами. Подписка и VPN-ключи выпускаются сразу и бесплатно.
Нажмите «Создать пользователя».
Заполните блок «Кто это»:
- Имя — например,
Иван. - Username — Telegram username без @, без пробелов. Например,
ivan_petrov. - Нужно заполнить хотя бы одно из двух полей, иначе панель напишет «Нужно имя или username — хотя бы одно».
- Метка администратора — необязательно, до 500 символов. Например,
бабушка бухгалтера. Видно только в админке. Если задана, в списке показывается вместо имени.
В блоке «Доступ» выберите Срок и Пакет. Всё как при обычной выдаче: Месяц, Год (если годовая оплата включена в тарифах), Свои дни от 1 до 3650 или Пробный. Подробно — в разделе «Выдача и продление доступа».
Нажмите «Создать».
Что будет после создания:
- в списке появится строка с источником «Вручную»;
- у пользователя будет внутренний отрицательный ID, например
-1000000001, потому что настоящего Telegram ID панель не знает; - ключи выпустятся на всех локациях. Если какая-то локация не ответила, появится предупреждение «Не все локации приняли клиента» со списком;
- ссылку подписки для клиента возьмите в разделе «Ключи»: найдите ключ по имени и нажмите «Скопировать ссылку».
Если человек потом придёт в бота
Узнайте его настоящий Telegram ID и впишите его в карточке: «Изменить данные» → поле Telegram ID. Тогда бот узнает клиента, и подписка останется при нём. Менять Telegram ID можно только у пользователей, созданных вручную.
Нюансы
- Удалённых в списке нет. Если у удалённого были платежи, их обезличенная история остаётся в разделе «Платежи».
- Доход в списке и в карточке может отличаться. В списке — только VPN за вычетом возвратов. В карточке плитка «Доход» складывает все оплаченные платежи клиента, включая покупки в магазине.
- Номер платежа вида
7K3F-9QMZищите в разделе «Платежи», а не здесь.