FAQ по командам юзербота ВК

Юзербот — это бот, который взаимодействует напрямую с аккаунтом пользователя ВКонтакте через VK API методы. Он нужен для удобства, облегчения жизни в соцсети. Для подключения юзербота требуется токен, а не телефон и пароль.

Токен - это ключ доступа к аккаунту через VK API, обычно состоит из 198-251 символов и начинается с фрагмента «vk1.a.». Токены доступа привязываются к приложению, для которых они получаются, и к сессии. Доступ к личным сообщениям имеют токены всего нескольких приложений, среди которых: Kate Mobile, XVII, VK Admin, VK Me (ныне VK Мессенджер). Первые два не являются официальными и имеют дополнительные ограничения на количество вызовов методов, поэтому они не рекомендуются для использования. Последние два — официальные и работают более стабильно, также имеют доступ к «скрытым» (недокументированным) методам VK API, что позволяет использовать методы публикации историй и другой функционал, который нельзя официально реализовать.

📌 Основной список команд

Главная страница команд:

🍪 пинг — проверка реакции бота
🍪 дов — вывод списка доверенных пользователей
🍪 довы — вывод списка доверивших участников беседы
🍪 +дов, -дов — добавить или удалить пользователя из доверки
🍪 !+дов — выдать полный дов с повторялкой
🍪 sudo <число> <префикс> — смена префикса: 1 — личный, 2 — доверенный, 3 — повторялка
🍪 стата — просмотр статистики работы бота
🍪 запреты [страница] — просмотр запретов для повторялки
🍪 +запрет <фраза> — добавить запрет для повторялки
🍪 -запрет <фраза или номер> — удалить запрет
🍪 горилла — настройки для Bot Gorilla
🍪 профиль — отрендерить страницу пользователя
🍪 скрин — отрендерить приложенные сообщения
🍪 +часы <пояс> — сделать сюжет в виде часов
🍪 -часы — удалить сюжет с часами
🍪 статус — установка автостатуса
🍪 эмодзи — установки эмодзи (справа от имени в профиле)
🍪 сессии — показывает историю активности на аккаунте
🍪 стикеры — выводит все стикеры указанного пользователя
🍪 чаты — выводит чаты указанного пользователя
🍪 цитата — сгенерировать цитату на сообщение

Страница команд для чатов:

🍪 таймеры [страница], т — просмотр списка таймеров
🍪 +таймер, +т — помощь по установке таймера
🍪 -таймер <имя или номер>, -т — удаление таймера
🍪 дд — удаление последних сообщений
🍪 дд- — скрытие и удаление последних сообщений
🍪 рег — узнать дату регистрации пользователя
🍪 +шаб <имя> — добавляет шаблон
🍪 шаб <имя> — выводит шаблон
🍪 шабы [страница] — выводит список шаблонов
🍪 -шаб <имя> — удаляет шаблон
🍪 прочитать — отметить все чаты прочитанными
🍪 -прочитать — сделать все чаты непрочитанными
🍪 начало — показать первое сообщение чата
🍪 +админ, -админ — выдать/забрать админку в беседе
🍪 инвайт — добавить пользователя в беседу
🍪 кик — удалить пользователя из беседы
🍪 админы — вывести список администраторов беседы
🍪 -уведы — сбросить счётчик уведомлений
🍪 сообщения — выводит число сообщений всех чатов

Как ими пользоваться?
Написать личный префикс (по умолчанию — буква «г») и через пробел команду, отправить в любой чат. Бот отредактирует сообщение на результат выполнения команды.

Далее детальное описание каждой команды с иллюстрациями.

🗺 Редактирование префиксов

Команда sudo. Это слово означает команду в системе Linux для запуска команд от имени другого пользователя. В боте оно позволяет изменять личный префикс, доверенный префикс и префикс повторялки.

Для обозначения типа префикса используются цифры: 1 (личный), 2 (доверенный) и 3 (повторялка). Для изменения префикса следует ввести после команды через пробел номер префикса и новый префикс.

г sudo 1 ф
🗺 Пинг

✅ Понг!

Команда пинг используется для проверки работоспособности бота и получения времени обработки сообщений.

г пинг
🗺 Система доверок

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

Для этого используются команды !+дов, -дов и дов, которые позволяют добавлять, удалять и просматривать список доверенных пользователей соответственно.

г +дов @id1

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

г довы все
🗺 Повторялка

Для работы повторялки необходимо выдать доверку другому пользователю, после чего он сможет писать сообщения в общих беседах через префикс повторялки.
⚠️ В личных сообщениях повторялка не работает!

тролль автобус

Существует возможность ограничивать фрагменты/фразы, при обнаружении которых повторялка не сработает. Для этого используются команды +запрет, запреты и -запрет, которые добавляют, выводят и удаляют запреты соответственно.

г +запрет соси

Работа запрета в действии:

тролль сосиска

⚠️ Запреты на команды через префикс доверки установить пока нельзя!

Чтобы удалить запрет, нужно ввести номер запрета из списка запретов, либо текст запрета после команды -запрет.

г -запрет 3
🗺 Таймеры

В боте есть возможность назначать отложенную или циклическую отправку текста. Этот функционал реализуется через команды +таймер (+т), таймеры (т) и -таймер (-т), они добавляют, выводят список и удаляют таймеры соответственно.

🔹 Чтобы посмотреть инструкцию по установке таймеров, напиши команду +т

г +т
🗺 Автоматизация игр (горилла, пума, недобот)

Реализация бота позволяет частично автоматизировать игровой процесс в таких ботах, как горилла, пума, недобот через функцию таймера, дополнительно реализован автоматический обход систем защит от автоматизации (капч). Стабильная работоспособность не гарантирована, есть огромный шанс получить блокировку в данных проектах при использовании какой-либо автоматизации в них.

🔹 Для некоторых настроек параметров автоматизации используется команда горилла

г горилла
🗺 Шаблоны

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

Команда +шаб <имя> сохраняет все вложения отвеченного или пересланного сообщения в список шаблонов бота.

г +шаб отвалился

Команда шабы выводит список сохранённых шаблонов с сортировкой по времени сохранения

г шабы

Для вывода сохранённого шаблона использовать команду шаб <имя>:

г шаб отвалился

Удаление шаблона производится командой -шаб <имя>:

г -шаб отвалился
🗺 Часы

Есть возможность установить сюжеты на странице своего профиля в виде автоматически обновляющихся часов через команду +часы <число>.

Вместо <число> нужно вписать число своего часового пояса. Чтобы его получить, узнаём местное время по UTC, например, в Москве это UTC+3, поэтому вписываем число 3 после команды.

скриншот сюжетов
🗺 Эмодзи (справа от имени профиля)

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

скриншот эмодзи статуса

Это реализуется командой эмодзи. Для получения актуального списка значков используйте команду без указания номера эмодзи, для установки отправьте команду с номером после команды. (Изображение актуально на 05.10.2023, список доступных эмодзи для установки меняется со временем)

г эмодзи
🗺 Автостатус

Автостатус — это автоматически изменяющийся ежеминутно статус в профиле по заданному шаблону.

скриншот статуса

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

г статус

Для изменения статуса используется команда статус установить, для очистки — статус удалить.

г статус установить (текст)

Для установки автостатуса необходимо добавлять фильтры, их список на 7 страниц можно просмотреть через команду статус инфо с указанием номера страницы после команды, либо здесь в следующем абзаце.

📃 Список поддерживаемых фильтров:

✨ Твой аккаунт
🔹 {uid} — ID аккаунта
🔹 {online} — графическое отображение онлайна
🔹 {first_name} — имя
🔹 {last_name} — фамилия

✨ Дата регистрации
🔹 {reg_day} — день регистрации
🔹 {reg_month} — месяц регистрации (число)
🔹 {reg_month_letter} — месяц регистрации (словом)
🔹 {reg_year} — год регистрации
🔹 {reg_hour} — время регистрации (часы)
🔹 {reg_min} — время регистрации (минуты)
🔹 {reg_sec} — время регистрации (секунды)
🔹 {reg_days_count} — количество дней с регистрации

✨ Твои друзья
🔹 {friends} — количество друзей
🔹 {online_friends} — количество друзей онлайн
🔹 {offline_friends} — количество друзей оффлайн
🔹 {banned_friends} — количество «собачек» в друзьях
🔹 {new_friends} — количество заявок в друзья
🔹 {followers} — количество подписчиков

✨ Твои диалоги
с кем был последний диалог:
🔹 {last_dialog_nom} — в именительном падеже
🔹 {last_dialog_gen} — в родительном падеже
🔹 {last_dialog_dat} — в дательном падеже
🔹 {last_dialog_acc} — в винительном падеже
🔹 {last_dialog_ins} — в творительном падеже
🔹 {last_dialog_abl} — в предложном падеже
🔹 {dialogs} — общее количество диалогов
🔹 {unread_dialogs} — непрочитанных диалогов

✨ Твоя статистика
🔹 {likes} — количество лайков на аватарке
🔹 {photos} — количество фотографий
🔹 {groups} — подписки на сообщества
🔹 {audios} — количество сохранённой музыки
🔹 {videos} — количество сохранённых видео
🔹 {gifts} — количество подарков
🔹 {bans} — количество пользователей в чс
🔹 {notifications} — количество уведомлений

✨ Посты
🔹 {post_likes:ID_записи} — лайки поста
🔹 {post_reposts:ID_записи} — репосты
🔹 {post_views:ID_записи} — просмотры

📝 После двоеточия пишется ID записи.

💬 Кликаем по записи с нашей страницы, в адресной строке получаем примерно такую ссылку — https://vk.com/lapik_bot?w=wall-211072257_1

-211072257_1 - Это и есть ID нашей записи.
Пример - {post_likes:-211072257_1}

✨ Дата, время
{hour}, {min}, {sec} — часы, минуты и секунды
{day}, {month}, {year_full}, {year} — день, месяц, год (4 цифры) и год (2 цифры)

✨ Обратный отсчёт
🔹 {total_days_to:01.01.2025 00:00:00} — количество дней до указанной даты
🔹 {total_hours_to:01.01.2025 00:00:00} — количество часов до указанной даты
🔹 {total_minutes_to:01.01.2025 00:00:00} — количество минут до указанной даты
🔹 {total_seconds_to:01.01.2025 00:00:00} — количество секунд до указанной даты

✨ Календарный отсчёт
🔹 {years_to:01.01.2025 00:00:00} — количество лет до указанной даты
🔹 {months_to:01.01.2025 00:00:00} — количество месяцев
🔹 {days_to:01.01.2025 00:00:00} — количество дней
🔹 {hours_to:01.01.2025 00:00:00} — количество часов
🔹 {minutes_to:01.01.2025 00:00:00} — количество минут
🔹 {seconds_to:01.01.2025 00:00:00} — количество секунд

📃 Список поддерживаемых фильтров:
✨ Рандомные фразы, смайлы
🔹 {rand:❤,💜,💛,💚,💙},
🔹 {rand:тадам,ТАДАМ} — выводит случайно элемент

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

🔹 {facts} — случайный факт

✨ Курсы валют
🔹 {curs:код} — текущий курс с сайта ЦБ РФ

📝 Список кодов смотреть на сайте ЦБ РФ:
https://www.cbr.ru/currency_base/daily

✨ Вывод данных с другого сайта
🔹 {url:ссылка} — выводит ответ сайта

✨ Steam
🔹 {steam_level:nick} — уровень аккаунта
🔹 {steam_online:nick} — статус онлайна
🔹 {steam_ingame:nick} — в игре или нет
🔹 {steam_game:nick} — текущая игра

📝 Вместо nick подставить ID (буквенный ник), либо SteamID (число) своего аккаунта.
💬 Разделы «Мой профиль» и «Доступ в игровой информации» должны быть открыты

✨ Кол-во игроков онлайн серверов
🔹 {getonline_game:IP:PORT} — выводит количество игроков указанного игрового сервера

📝 Если сервер недоступен, то выводит 0.
Вместо IP:PORT указывается адрес сервера, например, 10.0.0.10:27015.
Поддерживаемые игры: все серверы с Source-Query

📃 Список поддерживаемых фильтров:
✨ Обработка текста
🔹 <шаблон:blue> — сделать цифры в синих рамках
(1⃣, 2⃣, 3⃣...)
🔹 {incline:число,юзер,юзера,юзеров} — склонение слов
🔹 {tab:1} — большой пробел
🔹 {mini_tab:1} — маленький пробел

📝 Примеры: <{unread_dialogs}:blue> — выводит красиво количество непрочитанных диалогов.
«Сейчас {min} {incline:{min},минута,минуты,минут}» — выводит минуты
{tab:10}, {mini_tab:25} — примеры использования пробелов

г статус инфо 7

Для вашего удобства есть команда статус шаблоны для просмотра и установки готовых шаблонов статусов.

г статус шаблоны

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

г статус шаблоны 10

Чтобы предварительно посмотреть, какой статус получится после установки, можно выполнить команду статус тест с исходным текстом статуса после команды.

г статус тест (текст)

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

г статус установить (текст)

По умолчанию в боте задан часовой пояс Москвы, будет выводить московское время в фильтрах времени. Чтобы задать другой часовой пояс, используйте команду статус время <число>. Здесь, как и в команде часы, число часового пояса получаем из местного времени по UTC. Например, в Новосибирске это UTC+7, поэтому для этого города следует указать число 7.

г статус время 7

Ура, мы научились настраивать автостатусы!

новый скрин статуса
🗺 Просмотр профилей

Для этого существуют две команды: рег и профиль.

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

г рег @st380011a

Команда профиль отрисовывает информацию о пользователе в похожем на старый стиль страниц ВКонтакте.

г профиль @st380011a
🗺 Стикеры

Бот даёт возможность смотреть визуально списки стикеров у любых пользователей через команду стикеры [ссылка/реплай] [страница].

⚠️ Эта команда будет работать только с токеном VK Мессенджер.

г стикеры

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

г стикеры 2

Также можно написать вместо страницы слово все, тогда все стикеры пользователя отрисуется на одной картинке, но размер файла может достичь нескольких десятков мегабайт!

г стикеры все
🗺 Скрин

Бот умеет генерировать очень качественные скриншоты сообщений.

Для этого нужно использовать команду скрин с ответом или пересылом сообщений.

г скрин
🗺 Цитата

Эта команда генерирует изображение цитаты из текстового сообщения или стикера.

Если написать команду без прикреплённого сообщения, то вызовется подробная справка по использованию команды.

г цитата

Чтобы сгенерировать цитату, нужно ответить или переслать любые сообщения с текстом или стикером этой же командой.

г цитата <реплай/пересыл>

Также предусмотрена возможность сгенерировать цитату со своим фоном. Для этого нужно приложить вместе с командой изображение или файл изображения.

г цитата <реплай/пересыл> <фотография>

Дополнительно предусмотрена возможность записать свой фон для будущих генераций цитат, чтобы не отправлять фотографию каждый раз при написании команды. Это делается через команду цитата +фон <фотография>:

г цитата +фон <фотография>

Фотографии сгенерированных цитат имеют разную высоту, которая зависит от длины текста, используемого в отрисовке цитаты. Если текста немного, то цитата имеет горизонтальную ориентацию; если текста достаточно много, то высота изображения превышает ширину и цитата получает вертикальную ориентацию. Исходя из этого, бот использует горизонтальный, либо вертикальный фон. При сохранении пользовательского фона бот это тоже учитывает, поэтому желательно сохранить один горизонтальный и один вертикальный фон. При сохранении другого фона той же ориентации старый перезаписывается новым.

Все сохранённые фоны можно удалить командой цитата -фон. В этом случае бот будет использовать один из 200 случайных предустановленных фонов на тематику путешествий.

г цитата -фон

Дополнительная фишка функции — поддержка анимированных стикеров. Результат выполнения — GIF анимация.

г цитата <фотография>

Важно! Генерация GIF анимации занимает много времени, при этом получается файл очень большого размера. Если у вас не безлимитный доступ к сети Интернет и к ресурсам ВКонтакте, то лучше с этим не играться.

🗺 Сессии

Есть возможность быстро узнать, есть ли подозрительные авторизации в ваш аккаунт. Для этого достаточно ввести команду сессии, она выведет информацию в точности, как в истории активности.

г сессии

Необходимо учитывать, что бот при аварийных ситуациях выходит в интернет через мобильную сеть, ещё что при установке эмодзи статусов добавляется активность в приложениях.

🗺 Чаты

Я интегрировал от стороннего сервиса возможность получать список публичных чатов любых пользователей, для этого нужно ввести команду чаты <ссылка/реплай> на интересующего пользователя.

г чаты

⚠️ Функция работает как есть и её стабильная работа не гарантируется. Функция может быть удалена в любой момент времени.

🗺 Работа с чатами

Команда начало делает реплай на первое сообщение чата.

г начало

Команда инвайт позволяет добавлять пользователей или сообщества в чат. Добавление последних поддерживаются только через токен VK Мессенджер.

г инвайт

Команда кик удаляет участника из чата.

г кик

Команда админы выводит создателя и список администраторов беседы, если последние не скрыты настройками беседы.

г админы

Команды +админ и -админ выдают и забирают права администратора у указанного участника беседы, если у вас есть такие полномочия.

г +админ

Команда сообщения подсчитывает количество сообщений во всех ваших чатах и показывает, сколько ещё осталось % до достижения лимита на сообщения на аккаунте. ВКонтакте удаляет старые сообщения без вашего спроса при достижении лимита, поэтому рекомендуется удалять историю сообщений в чатах с самым большим количеством сообщений, чтобы избежать утраты части сообщений на аккаунте.

г сообщения
🗺 Удаление сообщений

Если нужно быстро удалить последние свои сообщения в чате, то можно использовать две команды: дд или дд-.

г дд

По умолчанию команды удаляют одно сообщение вместе с сообщением с командой. Чтобы удалить больше сообщений, нужно дописать число сообщений после команды (от 1 до 200).

г дд 2

Некоторые клиенты ВКонтакте логируют удалённые сообщения. Если важно удалить и для них, то нужно использовать команду дд-, которая сначала отредактирует каждое сообщение на пустое, затем удалит их.

г дд- 2
🗺 Статистика бота

Команда стата выводит техническую информацию о работе бота и хостинга.

г стата
🗺 Прочие команды

Команды, помощь. Выводит список ваших префиксов и команд бота.

г команды

Префиксы. Это единственная команда, которая пишется без личного префикса! Выводит ваши префиксы, если вы вдруг забыли их.

префиксы

-уведы. Обнуляет счётчик уведомлений.

г -уведы

Игра. Выводит состояние холста из моей игры Табло. Подробнее об игре будет в скором будущем отдельная статья.

г игра