Боты

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

Ограничения методов HTTP API

Боты не могут вызывать все методы HTTP API подряд. Кроме открытых методов (которые не требуют авторизации), боты имеют право вызывать следующие методы API:

РазделМетоды
Друзьяfriends.add friends.delete friends.getRequests
Общий чатgchat.send
Инвентарьinventory.craft
Обменыtrades.accept trades.cancel trades.create trades.decline trades.getIncome trades.getOutbound trades.history

Ограничения в общем чате

Боты могут писать в общий чат два типа сообщений:

  1. «непубличные»: такие сообщения увидят только те пользователи, которые упомянуты в тексте сообщения. Кроме этого, такие сообщения не сохраняются в логе общего чата, а только рассылаются через вебсокеты.
  2. «публичные»: такие сообщения сохраняются в логе общего чата, и их видят все желающие. Бот может отправить только пять «публичных» сообщений за час, и при этом все такие сообщения должны быть разными.

При вызове метода gchat.send сервер считает сообщение «публичным», когда значение параметра is_public установлено в 1 либо в сообщении нет ни одного упоминания пользователей.

Обратите внимание, что сообщения пользователей, начинающиеся с !, не сохраняются в логе общего чата, как и «персональные» сообщения от бота. Информацию о таких сообщениях можно получить только через вебсокет.

Создание бота

Чтобы создать бота, вызовите от имени своего аккаунта метод bots.create. После этого получите токен бота методом bots.getToken, и всё готово!

Домены (адреса страниц) в данный момент ботам не присваиваются.