Управление пользователями

Обзор раздела

Раздел Пользователи — центральное место для управления вашей клиентской базой. Здесь вы видите всех пользователей, которые взаимодействовали с вашим ботом: от тех, кто только зашёл, до активных подписчиков.

Над таблицей отображаются карточки с ключевыми метриками:

МетрикаОписание
ВсегоОбщее количество пользователей
ПлатящихПользователи с оплаченной подпиской
ПробныеПользователи с активным пробным периодом
Истекшие / Забл.Пользователи с истёкшей подпиской и заблокированные
В приложенииКоличество пользователей, сейчас находящихся в Mini App (обновляется в реальном времени)

Таблица пользователей

Столбцы таблицы

СтолбецОписание
ПользовательИмя, username (@), Telegram ID. Клик по иконке ссылки открывает профиль в Telegram
ИсточникОткуда пришёл пользователь: Органика, Реферал или Реклама
ScoreБот-скор — числовой показатель вероятности того, что аккаунт является ботом
ТарифТекущий тарифный план (Пробный, 1 месяц, 3 месяца и т.д.)
СтатусТекущее состояние: Активен, Истёк, Бан
ДатаДата регистрации
ДоходСуммарный доход от этого пользователя

Поиск и фильтрация

  • Поиск — строка поиска работает по имени, username и Telegram ID
  • Фильтры — доступны по столбцам:
    • Статус: Активен, Истёк, Заблокирован
    • Источник: Органика, Реферал, Реклама
    • Бот-скор: Боты (50+), Подозрительные (25+)
    • Тариф: Пробный, 1 месяц, 3 месяца, 6 месяцев, 1 год

Фильтры комбинируются между собой. Для сброса нажмите крестик рядом с активным фильтром.

Сортировка

Кликните по заголовку любого столбца для сортировки. Повторный клик меняет направление (по возрастанию / по убыванию). Стрелка рядом с заголовком показывает текущее направление сортировки.

Статусы пользователей

СтатусЗначение
АктивенУ пользователя есть действующая подписка
ИстёкПодписка была, но срок истёк
БанПользователь заблокирован вами — VPN не работает
— (прочерк)Пользователь зарегистрировался, но не оформлял подписку

Детальная карточка пользователя

Кликните по строке пользователя в таблице, чтобы открыть полноэкранную карточку с детальной информацией.

Шапка карточки

В шапке отображаются:

  • Имя пользователя и индикатор онлайн-статуса (зелёная пульсирующая точка)
  • Источник привлечения (бейдж)
  • Username (@) — клик копирует в буфер, ссылка ведёт в Telegram
  • Telegram ID — клик копирует в буфер

Кнопки действий

  • Тариф — назначить тарифный план (отображается только если у пользователя нет подписки)
  • Продлить — продлить текущую подписку на указанное количество дней (отображается, если подписка есть)
  • Забанить / Разбанить — заблокировать или разблокировать пользователя
  • Удалить — удалить пользователя со всеми данными (ключи, подписки, платежи, рефералы)

Удаление пользователя необратимо. Все данные будут потеряны.

Вкладки

Обзор

Основная информация:

  • Доход — суммарный доход от пользователя
  • Статус — текущее состояние (Активен, Забанен, Истёк, Нет)
  • Тариф — текущий тарифный план
  • Регистрация — дата первого входа
  • Активность — когда пользователь последний раз был в приложении (с автообновлением)
  • Подписок — количество активных подписок

Платежи

Список всех платежей пользователя:

  • Тарифный план
  • Дата оплаты
  • Сумма
  • Статус (Успешно, В обработке, Неуспешно, Возврат)

Рефералы

Список пользователей, привлечённых по реферальной ссылке:

  • Имя привлечённого пользователя
  • Дата привлечения
  • Начисленные бонусные дни

Подписки

История всех подписок пользователя, сгруппированная по токенам:

  • Название тарифа и статус (Активен / Истекает / Истёк)
  • Дата окончания и обратный отсчёт
  • Количество локаций в подписке
  • Токен подписки (клик копирует)
  • Список локаций, на которых созданы ключи

Назначение подписки вручную

Если вам нужно выдать подписку пользователю без оплаты (например, для тестирования или бонуса):

  1. Откройте карточку пользователя
  2. Нажмите кнопку Тариф (появляется, только если подписки нет)
  3. В модальном окне выберите тарифный план
  4. Нажмите Подключить

Ключи будут автоматически созданы на всех доступных локациях.

Продление подписки

  1. Откройте карточку пользователя
  2. Нажмите кнопку Продлить
  3. Выберите количество дней из быстрых кнопок (7, 14, 30, 90) или введите произвольное число
  4. Нажмите Продлить

Все активные ключи пользователя будут продлены на указанное количество дней.

Блокировка и разблокировка

Заблокировать пользователя

  1. Откройте карточку пользователя
  2. Нажмите Забанить
  3. Подтвердите действие в диалоговом окне

Заблокированный пользователь теряет доступ к VPN, но его ключи не удаляются.

Разблокировать пользователя

  1. Откройте карточку заблокированного пользователя
  2. Нажмите Разбанить
  3. Подтвердите действие

Если у пользователя осталась активная подписка, VPN начнёт работать снова.

Массовые действия

Для выполнения действий над несколькими пользователями одновременно:

  1. Отметьте нужных пользователей чекбоксами в первом столбце (или выберите всех на странице через чекбокс в шапке)
  2. Внизу экрана появится плавающая панель с количеством выбранных и доступными действиями

Доступные массовые действия

ДействиеОписание
ЗаблокироватьБлокирует всех выбранных незаблокированных пользователей. Показывает, сколько из выбранных будет заблокировано
РазблокироватьРазблокирует всех выбранных заблокированных пользователей
Подключить тарифНазначает тарифный план пользователям без активной подписки. Пользователи с подпиской пропускаются
Продлить подпискуПродлевает подписку пользователям с активной подпиской. Пользователи без подписки пропускаются

Панель массовых действий умно фильтрует: если вы выбрали 10 пользователей и нажали “Заблокировать”, но 3 из них уже заблокированы — будет заблокировано только 7.

Экспорт пользователей в CSV

Нажмите кнопку Экспорт над таблицей для скачивания данных в CSV-файл. Файл содержит полную информацию обо всех пользователях, включая ID, имена, статусы, тарифы и доход.

Экспорт полезен для:

  • Аналитики в Excel / Google Sheets
  • Резервного копирования клиентской базы
  • Импорта в другие системы (CRM, рассылочные сервисы)

Бот-скор и обнаружение ботов

Tunly автоматически анализирует поведение пользователей и присваивает каждому числовой бот-скор от 0 до 100.

Уровни бот-скора

СкорМеткаЦветОписание
0-24СерыйНормальный пользователь
25-49Подозр.ОранжевыйПодозрительное поведение — стоит обратить внимание
50-100БотКрасныйВысокая вероятность бота
50-100 + подтв.Бот (с галочкой)КрасныйПодтверждённый бот

Что учитывается

  • Паттерн открытия приложения
  • Скорость действий
  • Наличие username и фото профиля
  • Поведенческие аномалии

Рекомендации

  • Регулярно проверяйте пользователей с высоким бот-скором
  • Используйте фильтр Бот-скор в таблице для быстрого обзора
  • Блокируйте подтверждённых ботов через массовые действия, чтобы не занимать места на серверах