Статистика Сообщений

Реализация данного модуля в SOTE заметно отличается от привычных счётчиков сообщений в других ботах VK.
Здесь статистика гибкая, комбинируемая и работает не только по чатам, но и по сеткам и всему боту.

Внешний вид команды

Команда может быть вызвана в одним из трёх вариантов:

Стата [объект] [категория] [место] [период/дата]
Статистика [объект] [категория] [место] [период/дата]
Топ [объект] [категория] [место] [период/дата]

Любая из этих команд выведет один и тот же результат — разница лишь в названии команды.

Аргументы

Обычно полную и динамическую статистику принято просматривать только по пользователям.
Мы решили пойти дальше: в Боте доступен просмотр статистики не только по пользователям, но и по Чатам и Сеткам Бесед.

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

Рассмотрим же каждый Аргумент по отдельности.

Аргумент — `[объект]`

Аргумент [объект] определяет, по кому или по чему формируется статистика. Он имеет три возможных значения:

Пользователи
— выводит статистику по участникам.
Чаты
— выводит статистику по беседам.
Сетки
— выводит статистику по Сеткам Бесед.

Аргумент — `[категория]`

Аргумент [категория] определяет тип выводимых сообщений.

Возможные значения:

соо / сообщения
— все сообщения (включая текстовые и все остальные категории).
Является значением по умолчанию.
маты
— сообщения только с нецензурной лексикой.
гс
— отправленные голосовые сообщения.
стики / стикеры
— отправленные стикеры.
кружочки
— отправленные кружочки.

Все категории полностью поддерживают аргументы [место] и [период/дата].

Аргумент — `[место]`

Аргумент [место] определяет, откуда именно берётся статистика.
Он имеет три возможных значения:

Здесь
— выводит статистику сообщений текущей беседы, в которой была введена команда.
Сетка
— выводит статистику сообщений всех участников Сетки Бесед, в которую входит текущий чат.
Если один и тот же человек писал в нескольких чатах сетки, бот суммирует сообщения и выведет одно итоговое число.
Везде
— выводит статистику сообщений по всем беседам, где бот находится сейчас или находился ранее.
Аналогично, сообщения пользователя из разных чатов суммируются.

Аргумент — `[период/дата]`

Аргумент [период/дата] гораздо более гибкий. С его помощью можно указать время или период, за который нужно получить статистику.

Периоды

Статистика день / неделя / месяц
— выведет статистику сообщений за указанный промежуток времени.
Статистика 5 дней
Статистика 3 недели
Статистика месяц

Период по датам

Статистика с 01.01.2025 до 01.01.2026
— выведет статистику сообщений за указанный промежуток между двумя датами.
Даты в примере приведены условно — можно указать любой период.

Конкретная дата

Статистика 03.04.2022
— выведет статистику сообщений за указанную дату.

Быстрые команды

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

Однако следует учесть!

Вся статистика в боте разбита по календарным дням по МСК.
Команда Статистика сегодня не покажет последние 24 часа,
а покажет статистику именно за сегодняшнее число, начиная с 00:00 по МСК.

Комбинирование аргументов

Аргументы по-отдельности мы разобрали. Однако остановиться на этом было бы глупо, поэтому мы добавили возможность их объединять и комбинировать.

Примеры:

Топ Сетки 3 дня
— статистика сообщений всех участников Сетки Бесед за последние 3 дня.
Топ Матов Везде 01.04.2022
— статистика нецензурной лексики участников всех чатов бота за указанную дату.
Топ кружочки Здесь неделя
— кружочки текущей беседы за неделю.
Топ Здесь Вчера
— статистика сообщений текущего чата за вчерашний день.

Значения по умолчанию

Если аргументы не указаны явно, используются значения по умолчанию:

[объект] → Пользователи
[категория] → Сообщений
[место] → Здесь
[период/дата] → Сегодня

Примеры:

Топ Вчера → Топ Пользователи Сообщений Здесь Вчера
— Мы пропустили аргумент обьекта и места, и по умолчанию было взято значение [Пользователи] и [Здесь].
Топ Чатов Маты Сетка → Топ Чатов Матов Сетка Сегодня
— Мы пропустили аргумент времени, и по умолчанию было взято значение [Сегодня].
Топ → Топ Пользователи Сообщений Здесь Сегодня
— Мы пропустили четыре аргумента одновременно и по умолчанию были взяты значения [Здесь] и [Сегодня].

Дополнительные команды статистики

Повелители сообщений
— глобальный топ 30 пользователей бота по сообщениям за всё время.
Является ассоциацией команды Топ Пользователи Сообщений Везде Всего.

Обратите внимание

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

Вернуться к оглавлению