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 (повторялка). Для изменения префикса следует ввести после команды через пробел номер префикса и новый префикс.
✅ Понг!
Команда пинг используется для проверки работоспособности бота и получения времени обработки сообщений.
В боте можно назначать пользователей, которые будут иметь доступ почти ко всем командам бота от вашего профиля.
Для этого используются команды !+дов, -дов и дов, которые позволяют добавлять, удалять и просматривать список доверенных пользователей соответственно.
Дополнительно существует команда довы, которая выводит список других пользователей бота, предоставивших вам доверенный доступ и которые присутствуют в беседе, либо глобально, дописав после команды слово все.
Для работы повторялки необходимо выдать доверку другому пользователю, после чего он сможет писать сообщения в общих беседах через префикс повторялки.
⚠️ В личных сообщениях повторялка не работает!
Существует возможность ограничивать фрагменты/фразы, при обнаружении которых повторялка не сработает. Для этого используются команды +запрет, запреты и -запрет, которые добавляют, выводят и удаляют запреты соответственно.
Работа запрета в действии:
⚠️ Запреты на команды через префикс доверки установить пока нельзя!
Чтобы удалить запрет, нужно ввести номер запрета из списка запретов, либо текст запрета после команды -запрет.
В боте есть возможность назначать отложенную или циклическую отправку текста. Этот функционал реализуется через команды +таймер (+т), таймеры (т) и -таймер (-т), они добавляют, выводят список и удаляют таймеры соответственно.
🔹 Чтобы посмотреть инструкцию по установке таймеров, напиши команду +т
Реализация бота позволяет частично автоматизировать игровой процесс в таких ботах, как горилла, пума, недобот через функцию таймера, дополнительно реализован автоматический обход систем защит от автоматизации (капч). Стабильная работоспособность не гарантирована, есть огромный шанс получить блокировку в данных проектах при использовании какой-либо автоматизации в них.
🔹 Для некоторых настроек параметров автоматизации используется команда горилла
Нужно сохранить текст, картинки или даже голосовые сообщения собеседника? Это можно сделать через шаблоны.
Команда +шаб <имя> сохраняет все вложения отвеченного или пересланного сообщения в список шаблонов бота.
Команда шабы выводит список сохранённых шаблонов с сортировкой по времени сохранения
Для вывода сохранённого шаблона использовать команду шаб <имя>:
Удаление шаблона производится командой -шаб <имя>:
Есть возможность установить сюжеты на странице своего профиля в виде автоматически обновляющихся часов через команду +часы <число>.
Вместо <число> нужно вписать число своего часового пояса. Чтобы его получить, узнаём местное время по 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} — примеры использования пробелов
Для вашего удобства есть команда статус шаблоны для просмотра и установки готовых шаблонов статусов.
После установки понравившегося статуса будет исходный текст строки с фильтрами, который можно изменять под себя.
Чтобы предварительно посмотреть, какой статус получится после установки, можно выполнить команду статус тест с исходным текстом статуса после команды.
Эта команда не редактирует сообщение с командой, чтобы можно было скопировать исходный текст статуса. Если вывод команды полностью устраивает, то можно установить новый статус через команду статус установить.
По умолчанию в боте задан часовой пояс Москвы, будет выводить московское время в фильтрах времени. Чтобы задать другой часовой пояс, используйте команду статус время <число>. Здесь, как и в команде часы, число часового пояса получаем из местного времени по UTC. Например, в Новосибирске это UTC+7, поэтому для этого города следует указать число 7.
Ура, мы научились настраивать автостатусы!
Для этого существуют две команды: рег и профиль.
Команда рег выводит дату и время регистрации профиля, а также вечную ссылку с id пользователя.
Команда профиль отрисовывает информацию о пользователе в похожем на старый стиль страниц ВКонтакте.
Бот даёт возможность смотреть визуально списки стикеров у любых пользователей через команду стикеры [ссылка/реплай] [страница].
⚠️ Эта команда будет работать только с токеном VK Мессенджер.
Если стикеров у пользователя очень много, то разбивается по страницам, переключать страницы можно дописав после команды номер страницы.
Также можно написать вместо страницы слово все, тогда все стикеры пользователя отрисуется на одной картинке, но размер файла может достичь нескольких десятков мегабайт!
Бот умеет генерировать очень качественные скриншоты сообщений.
Для этого нужно использовать команду скрин с ответом или пересылом сообщений.
Эта команда генерирует изображение цитаты из текстового сообщения или стикера.
Если написать команду без прикреплённого сообщения, то вызовется подробная справка по использованию команды.
Чтобы сгенерировать цитату, нужно ответить или переслать любые сообщения с текстом или стикером этой же командой.
Также предусмотрена возможность сгенерировать цитату со своим фоном. Для этого нужно приложить вместе с командой изображение или файл изображения.
Дополнительно предусмотрена возможность записать свой фон для будущих генераций цитат, чтобы не отправлять фотографию каждый раз при написании команды. Это делается через команду цитата +фон <фотография>:
Фотографии сгенерированных цитат имеют разную высоту, которая зависит от длины текста, используемого в отрисовке цитаты. Если текста немного, то цитата имеет горизонтальную ориентацию; если текста достаточно много, то высота изображения превышает ширину и цитата получает вертикальную ориентацию. Исходя из этого, бот использует горизонтальный, либо вертикальный фон. При сохранении пользовательского фона бот это тоже учитывает, поэтому желательно сохранить один горизонтальный и один вертикальный фон. При сохранении другого фона той же ориентации старый перезаписывается новым.
Все сохранённые фоны можно удалить командой цитата -фон. В этом случае бот будет использовать один из 200 случайных предустановленных фонов на тематику путешествий.
Дополнительная фишка функции — поддержка анимированных стикеров. Результат выполнения — GIF анимация.
Важно! Генерация GIF анимации занимает много времени, при этом получается файл очень большого размера. Если у вас не безлимитный доступ к сети Интернет и к ресурсам ВКонтакте, то лучше с этим не играться.
Есть возможность быстро узнать, есть ли подозрительные авторизации в ваш аккаунт. Для этого достаточно ввести команду сессии, она выведет информацию в точности, как в истории активности.
Необходимо учитывать, что бот при аварийных ситуациях выходит в интернет через мобильную сеть, ещё что при установке эмодзи статусов добавляется активность в приложениях.
Я интегрировал от стороннего сервиса возможность получать список публичных чатов любых пользователей, для этого нужно ввести команду чаты <ссылка/реплай> на интересующего пользователя.
⚠️ Функция работает как есть и её стабильная работа не гарантируется. Функция может быть удалена в любой момент времени.
Команда начало делает реплай на первое сообщение чата.
Команда инвайт позволяет добавлять пользователей или сообщества в чат. Добавление последних поддерживаются только через токен VK Мессенджер.
Команда кик удаляет участника из чата.
Команда админы выводит создателя и список администраторов беседы, если последние не скрыты настройками беседы.
Команды +админ и -админ выдают и забирают права администратора у указанного участника беседы, если у вас есть такие полномочия.
Команда сообщения подсчитывает количество сообщений во всех ваших чатах и показывает, сколько ещё осталось % до достижения лимита на сообщения на аккаунте. ВКонтакте удаляет старые сообщения без вашего спроса при достижении лимита, поэтому рекомендуется удалять историю сообщений в чатах с самым большим количеством сообщений, чтобы избежать утраты части сообщений на аккаунте.
Если нужно быстро удалить последние свои сообщения в чате, то можно использовать две команды: дд или дд-.
По умолчанию команды удаляют одно сообщение вместе с сообщением с командой. Чтобы удалить больше сообщений, нужно дописать число сообщений после команды (от 1 до 200).
Некоторые клиенты ВКонтакте логируют удалённые сообщения. Если важно удалить и для них, то нужно использовать команду дд-, которая сначала отредактирует каждое сообщение на пустое, затем удалит их.
Команда стата выводит техническую информацию о работе бота и хостинга.
Команды, помощь. Выводит список ваших префиксов и команд бота.
Префиксы. Это единственная команда, которая пишется без личного префикса! Выводит ваши префиксы, если вы вдруг забыли их.
-уведы. Обнуляет счётчик уведомлений.
Игра. Выводит состояние холста из моей игры Табло. Подробнее об игре будет в скором будущем отдельная статья.