Управление пользователями
Обзор раздела
Раздел Пользователи — центральное место для управления вашей клиентской базой. Здесь вы видите всех пользователей, которые взаимодействовали с вашим ботом: от тех, кто только зашёл, до активных подписчиков.
Над таблицей отображаются карточки с ключевыми метриками:
| Метрика | Описание |
|---|---|
| Всего | Общее количество пользователей |
| Платящих | Пользователи с оплаченной подпиской |
| Пробные | Пользователи с активным пробным периодом |
| Истекшие / Забл. | Пользователи с истёкшей подпиской и заблокированные |
| В приложении | Количество пользователей, сейчас находящихся в Mini App (обновляется в реальном времени) |
Таблица пользователей
Столбцы таблицы
| Столбец | Описание |
|---|---|
| Пользователь | Имя, username (@), Telegram ID. Клик по иконке ссылки открывает профиль в Telegram |
| Источник | Откуда пришёл пользователь: Органика, Реферал или Реклама |
| Score | Бот-скор — числовой показатель вероятности того, что аккаунт является ботом |
| Тариф | Текущий тарифный план (Пробный, 1 месяц, 3 месяца и т.д.) |
| Статус | Текущее состояние: Активен, Истёк, Бан |
| Дата | Дата регистрации |
| Доход | Суммарный доход от этого пользователя |
Поиск и фильтрация
- Поиск — строка поиска работает по имени, username и Telegram ID
- Фильтры — доступны по столбцам:
- Статус: Активен, Истёк, Заблокирован
- Источник: Органика, Реферал, Реклама
- Бот-скор: Боты (50+), Подозрительные (25+)
- Тариф: Пробный, 1 месяц, 3 месяца, 6 месяцев, 1 год
Фильтры комбинируются между собой. Для сброса нажмите крестик рядом с активным фильтром.
Сортировка
Кликните по заголовку любого столбца для сортировки. Повторный клик меняет направление (по возрастанию / по убыванию). Стрелка рядом с заголовком показывает текущее направление сортировки.
Статусы пользователей
| Статус | Значение |
|---|---|
| Активен | У пользователя есть действующая подписка |
| Истёк | Подписка была, но срок истёк |
| Бан | Пользователь заблокирован вами — VPN не работает |
| — (прочерк) | Пользователь зарегистрировался, но не оформлял подписку |
Детальная карточка пользователя
Кликните по строке пользователя в таблице, чтобы открыть полноэкранную карточку с детальной информацией.
Шапка карточки
В шапке отображаются:
- Имя пользователя и индикатор онлайн-статуса (зелёная пульсирующая точка)
- Источник привлечения (бейдж)
- Username (@) — клик копирует в буфер, ссылка ведёт в Telegram
- Telegram ID — клик копирует в буфер
Кнопки действий
- Тариф — назначить тарифный план (отображается только если у пользователя нет подписки)
- Продлить — продлить текущую подписку на указанное количество дней (отображается, если подписка есть)
- Забанить / Разбанить — заблокировать или разблокировать пользователя
- Удалить — удалить пользователя со всеми данными (ключи, подписки, платежи, рефералы)
Удаление пользователя необратимо. Все данные будут потеряны.
Вкладки
Обзор
Основная информация:
- Доход — суммарный доход от пользователя
- Статус — текущее состояние (Активен, Забанен, Истёк, Нет)
- Тариф — текущий тарифный план
- Регистрация — дата первого входа
- Активность — когда пользователь последний раз был в приложении (с автообновлением)
- Подписок — количество активных подписок
Платежи
Список всех платежей пользователя:
- Тарифный план
- Дата оплаты
- Сумма
- Статус (Успешно, В обработке, Неуспешно, Возврат)
Рефералы
Список пользователей, привлечённых по реферальной ссылке:
- Имя привлечённого пользователя
- Дата привлечения
- Начисленные бонусные дни
Подписки
История всех подписок пользователя, сгруппированная по токенам:
- Название тарифа и статус (Активен / Истекает / Истёк)
- Дата окончания и обратный отсчёт
- Количество локаций в подписке
- Токен подписки (клик копирует)
- Список локаций, на которых созданы ключи
Назначение подписки вручную
Если вам нужно выдать подписку пользователю без оплаты (например, для тестирования или бонуса):
- Откройте карточку пользователя
- Нажмите кнопку Тариф (появляется, только если подписки нет)
- В модальном окне выберите тарифный план
- Нажмите Подключить
Ключи будут автоматически созданы на всех доступных локациях.
Продление подписки
- Откройте карточку пользователя
- Нажмите кнопку Продлить
- Выберите количество дней из быстрых кнопок (7, 14, 30, 90) или введите произвольное число
- Нажмите Продлить
Все активные ключи пользователя будут продлены на указанное количество дней.
Блокировка и разблокировка
Заблокировать пользователя
- Откройте карточку пользователя
- Нажмите Забанить
- Подтвердите действие в диалоговом окне
Заблокированный пользователь теряет доступ к VPN, но его ключи не удаляются.
Разблокировать пользователя
- Откройте карточку заблокированного пользователя
- Нажмите Разбанить
- Подтвердите действие
Если у пользователя осталась активная подписка, VPN начнёт работать снова.
Массовые действия
Для выполнения действий над несколькими пользователями одновременно:
- Отметьте нужных пользователей чекбоксами в первом столбце (или выберите всех на странице через чекбокс в шапке)
- Внизу экрана появится плавающая панель с количеством выбранных и доступными действиями
Доступные массовые действия
| Действие | Описание |
|---|---|
| Заблокировать | Блокирует всех выбранных незаблокированных пользователей. Показывает, сколько из выбранных будет заблокировано |
| Разблокировать | Разблокирует всех выбранных заблокированных пользователей |
| Подключить тариф | Назначает тарифный план пользователям без активной подписки. Пользователи с подпиской пропускаются |
| Продлить подписку | Продлевает подписку пользователям с активной подпиской. Пользователи без подписки пропускаются |
Панель массовых действий умно фильтрует: если вы выбрали 10 пользователей и нажали “Заблокировать”, но 3 из них уже заблокированы — будет заблокировано только 7.
Экспорт пользователей в CSV
Нажмите кнопку Экспорт над таблицей для скачивания данных в CSV-файл. Файл содержит полную информацию обо всех пользователях, включая ID, имена, статусы, тарифы и доход.
Экспорт полезен для:
- Аналитики в Excel / Google Sheets
- Резервного копирования клиентской базы
- Импорта в другие системы (CRM, рассылочные сервисы)
Бот-скор и обнаружение ботов
Tunly автоматически анализирует поведение пользователей и присваивает каждому числовой бот-скор от 0 до 100.
Уровни бот-скора
| Скор | Метка | Цвет | Описание |
|---|---|---|---|
| 0-24 | — | Серый | Нормальный пользователь |
| 25-49 | Подозр. | Оранжевый | Подозрительное поведение — стоит обратить внимание |
| 50-100 | Бот | Красный | Высокая вероятность бота |
| 50-100 + подтв. | Бот (с галочкой) | Красный | Подтверждённый бот |
Что учитывается
- Паттерн открытия приложения
- Скорость действий
- Наличие username и фото профиля
- Поведенческие аномалии
Рекомендации
- Регулярно проверяйте пользователей с высоким бот-скором
- Используйте фильтр Бот-скор в таблице для быстрого обзора
- Блокируйте подтверждённых ботов через массовые действия, чтобы не занимать места на серверах