![Alex Smith](https://sun9-47.userapi.com/impg/A35h_vIDRgFwGs5UF5OOyeLIFU9Umqc725N-8A/XDbvKAKzYnY.jpg?size=1280x720&quality=95&sign=24c4ff95add1f2edea2079d86ed0a538&type=album)
z-lapik.ru
Программист
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 ф](/img/sudo.png)
✅ Понг!
Команда пинг используется для проверки работоспособности бота и получения времени обработки сообщений.
![г пинг](/img/пинг.png)
В боте можно назначать пользователей, которые будут иметь доступ почти ко всем командам бота от вашего профиля.
Для этого используются команды !+дов, -дов и дов, которые позволяют добавлять, удалять и просматривать список доверенных пользователей соответственно.
![г +дов @id1](/img/+дов.png)
Дополнительно существует команда довы, которая выводит список других пользователей бота, предоставивших вам доверенный доступ и которые присутствуют в беседе, либо глобально, дописав после команды слово все.
![г довы все](/img/довы_все.png)
Для работы повторялки необходимо выдать доверку другому пользователю, после чего он сможет писать сообщения в общих беседах через префикс повторялки.
⚠️ В личных сообщениях повторялка не работает!
![тролль автобус](/img/повторялка.png)
Существует возможность ограничивать фрагменты/фразы, при обнаружении которых повторялка не сработает. Для этого используются команды +запрет, запреты и -запрет, которые добавляют, выводят и удаляют запреты соответственно.
![г +запрет соси](/img/+запрет.png)
Работа запрета в действии:
![тролль сосиска](/img/запрет.png)
⚠️ Запреты на команды через префикс доверки установить пока нельзя!
Чтобы удалить запрет, нужно ввести номер запрета из списка запретов, либо текст запрета после команды -запрет.
![г -запрет 3](/img/-запрет.png)
В боте есть возможность назначать отложенную или циклическую отправку текста. Этот функционал реализуется через команды +таймер (+т), таймеры (т) и -таймер (-т), они добавляют, выводят список и удаляют таймеры соответственно.
🔹 Чтобы посмотреть инструкцию по установке таймеров, напиши команду +т
![г +т](/img/+т.png)
Реализация бота позволяет частично автоматизировать игровой процесс в таких ботах, как горилла, пума, недобот через функцию таймера, дополнительно реализован автоматический обход систем защит от автоматизации (капч). Стабильная работоспособность не гарантирована, есть огромный шанс получить блокировку в данных проектах при использовании какой-либо автоматизации в них.
🔹 Для некоторых настроек параметров автоматизации используется команда горилла
![г горилла](/img/горилла.png)
Нужно сохранить текст, картинки или даже голосовые сообщения собеседника? Это можно сделать через шаблоны.
Команда +шаб <имя> сохраняет все вложения отвеченного или пересланного сообщения в список шаблонов бота.
![г +шаб отвалился](/img/+шаб.png)
Команда шабы выводит список сохранённых шаблонов с сортировкой по времени сохранения
![г шабы](/img/шабы.png)
Для вывода сохранённого шаблона использовать команду шаб <имя>:
![г шаб отвалился](/img/шаб.png)
Удаление шаблона производится командой -шаб <имя>:
![г -шаб отвалился](/img/-шаб.png)
Есть возможность установить сюжеты на странице своего профиля в виде автоматически обновляющихся часов через команду +часы <число>.
Вместо <число> нужно вписать число своего часового пояса. Чтобы его получить, узнаём местное время по UTC, например, в Москве это UTC+3, поэтому вписываем число 3 после команды.
![скриншот сюжетов](/img/часы.png)
Бот помогает устанавливать на выбор несколько сотен эмодзи-статусов из нескольких десятков приложений, без захода в эти приложения и выполнения заданий.
![скриншот эмодзи статуса](/img/эмодзи_знак.png)
Это реализуется командой эмодзи. Для получения актуального списка значков используйте команду без указания номера эмодзи, для установки отправьте команду с номером после команды. (Изображение актуально на 05.10.2023, список доступных эмодзи для установки меняется со временем)
![г эмодзи](https://sun9-62.userapi.com/impg/bTwoNB0dK2dFKdJUovcre3yn9r76gNnp-DpV6g/zTkg3uP0SwQ.jpg?size=610x757&quality=96&sign=28f4b30c725a90bcf575aa01ae07e72a&type=album)
Автостатус — это автоматически изменяющийся ежеминутно статус в профиле по заданному шаблону.
![скриншот статуса](/img/статус_скрин.png)
Для настройки статусов используется команда статус. Это очень сложная команда, поэтому она содержит субкоманды.
![г статус](/img/статус.png)
Для изменения статуса используется команда статус установить, для очистки — статус удалить.
![г статус установить (текст)](/img/статус_установить.png)
Для установки автостатуса необходимо добавлять фильтры, их список на 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](/img/статус_инфо.png)
Для вашего удобства есть команда статус шаблоны для просмотра и установки готовых шаблонов статусов.
![г статус шаблоны](/img/статус_шаблоны.png)
После установки понравившегося статуса будет исходный текст строки с фильтрами, который можно изменять под себя.
![г статус шаблоны 10](/img/статус_шаблоны_10.png)
Чтобы предварительно посмотреть, какой статус получится после установки, можно выполнить команду статус тест с исходным текстом статуса после команды.
![г статус тест (текст)](/img/статус_тест.png)
Эта команда не редактирует сообщение с командой, чтобы можно было скопировать исходный текст статуса. Если вывод команды полностью устраивает, то можно установить новый статус через команду статус установить.
![г статус установить (текст)](/img/статус_установить_2.png)
По умолчанию в боте задан часовой пояс Москвы, будет выводить московское время в фильтрах времени. Чтобы задать другой часовой пояс, используйте команду статус время <число>. Здесь, как и в команде часы, число часового пояса получаем из местного времени по UTC. Например, в Новосибирске это UTC+7, поэтому для этого города следует указать число 7.
![г статус время 7](/img/статус_время.png)
Ура, мы научились настраивать автостатусы!
![новый скрин статуса](/img/статус_2.png)
Для этого существуют две команды: рег и профиль.
Команда рег выводит дату и время регистрации профиля, а также вечную ссылку с id пользователя.
![г рег @st380011a](/img/рег.png)
Команда профиль отрисовывает информацию о пользователе в похожем на старый стиль страниц ВКонтакте.
![г профиль @st380011a](/img/профиль.png)
Бот даёт возможность смотреть визуально списки стикеров у любых пользователей через команду стикеры [ссылка/реплай] [страница].
⚠️ Эта команда будет работать только с токеном VK Мессенджер.
![г стикеры](/img/стикеры.png)
Если стикеров у пользователя очень много, то разбивается по страницам, переключать страницы можно дописав после команды номер страницы.
![г стикеры 2](/img/стикеры_2.png)
Также можно написать вместо страницы слово все, тогда все стикеры пользователя отрисуется на одной картинке, но размер файла может достичь нескольких десятков мегабайт!
![г стикеры все](/img/стикеры_все.png)
Бот умеет генерировать очень качественные скриншоты сообщений.
Для этого нужно использовать команду скрин с ответом или пересылом сообщений.
![г скрин](/img/tmp_screenshot_391771562.png)
Эта команда генерирует изображение цитаты из текстового сообщения или стикера.
Если написать команду без прикреплённого сообщения, то вызовется подробная справка по использованию команды.
![г цитата](/img/цитата.png)
Чтобы сгенерировать цитату, нужно ответить или переслать любые сообщения с текстом или стикером этой же командой.
![г цитата <реплай/пересыл>](/img/цитата_2.png)
Также предусмотрена возможность сгенерировать цитату со своим фоном. Для этого нужно приложить вместе с командой изображение или файл изображения.
![г цитата <реплай/пересыл> <фотография>](/img/цитата_3.png)
Дополнительно предусмотрена возможность записать свой фон для будущих генераций цитат, чтобы не отправлять фотографию каждый раз при написании команды. Это делается через команду цитата +фон <фотография>:
![г цитата +фон <фотография>](/img/цитата_+фон.png)
Фотографии сгенерированных цитат имеют разную высоту, которая зависит от длины текста, используемого в отрисовке цитаты. Если текста немного, то цитата имеет горизонтальную ориентацию; если текста достаточно много, то высота изображения превышает ширину и цитата получает вертикальную ориентацию. Исходя из этого, бот использует горизонтальный, либо вертикальный фон. При сохранении пользовательского фона бот это тоже учитывает, поэтому желательно сохранить один горизонтальный и один вертикальный фон. При сохранении другого фона той же ориентации старый перезаписывается новым.
Все сохранённые фоны можно удалить командой цитата -фон. В этом случае бот будет использовать один из 200 случайных предустановленных фонов на тематику путешествий.
![г цитата -фон](/img/цитата_-фон.png)
Дополнительная фишка функции — поддержка анимированных стикеров. Результат выполнения — GIF анимация.
![г цитата <фотография>](/img/цитата_4.png)
Важно! Генерация GIF анимации занимает много времени, при этом получается файл очень большого размера. Если у вас не безлимитный доступ к сети Интернет и к ресурсам ВКонтакте, то лучше с этим не играться.
Есть возможность быстро узнать, есть ли подозрительные авторизации в ваш аккаунт. Для этого достаточно ввести команду сессии, она выведет информацию в точности, как в истории активности.
![г сессии](/img/сессии.png)
Необходимо учитывать, что бот при аварийных ситуациях выходит в интернет через мобильную сеть, ещё что при установке эмодзи статусов добавляется активность в приложениях.
Я интегрировал от стороннего сервиса возможность получать список публичных чатов любых пользователей, для этого нужно ввести команду чаты <ссылка/реплай> на интересующего пользователя.
![г чаты](/img/чаты.png)
⚠️ Функция работает как есть и её стабильная работа не гарантируется. Функция может быть удалена в любой момент времени.
Команда начало делает реплай на первое сообщение чата.
![г начало](/img/начало.png)
Команда инвайт позволяет добавлять пользователей или сообщества в чат. Добавление последних поддерживаются только через токен VK Мессенджер.
![г инвайт](/img/инвайт.png)
Команда кик удаляет участника из чата.
![г кик](/img/кик.png)
Команда админы выводит создателя и список администраторов беседы, если последние не скрыты настройками беседы.
![г админы](/img/админы.png)
Команды +админ и -админ выдают и забирают права администратора у указанного участника беседы, если у вас есть такие полномочия.
![г +админ](/img/+админ.png)
Команда сообщения подсчитывает количество сообщений во всех ваших чатах и показывает, сколько ещё осталось % до достижения лимита на сообщения на аккаунте. ВКонтакте удаляет старые сообщения без вашего спроса при достижении лимита, поэтому рекомендуется удалять историю сообщений в чатах с самым большим количеством сообщений, чтобы избежать утраты части сообщений на аккаунте.
![г сообщения](/img/сообщения.png)
Если нужно быстро удалить последние свои сообщения в чате, то можно использовать две команды: дд или дд-.
![г дд](/img/дд.png)
По умолчанию команды удаляют одно сообщение вместе с сообщением с командой. Чтобы удалить больше сообщений, нужно дописать число сообщений после команды (от 1 до 200).
![г дд 2](/img/дд_2.png)
Некоторые клиенты ВКонтакте логируют удалённые сообщения. Если важно удалить и для них, то нужно использовать команду дд-, которая сначала отредактирует каждое сообщение на пустое, затем удалит их.
![г дд- 2](/img/дд-_2.png)
Команда стата выводит техническую информацию о работе бота и хостинга.
![г стата](/img/стата.png)
Команды, помощь. Выводит список ваших префиксов и команд бота.
![г команды](/img/команды.png)
Префиксы. Это единственная команда, которая пишется без личного префикса! Выводит ваши префиксы, если вы вдруг забыли их.
![префиксы](/img/префиксы.png)
-уведы. Обнуляет счётчик уведомлений.
![г -уведы](/img/-уведы.png)
Игра. Выводит состояние холста из моей игры Табло. Подробнее об игре будет в скором будущем отдельная статья.
![г игра](/img/игра.png)