Bot API

Изменения в Bot API

Внимание! Данная реализация Bot API функционально соответствует предыдущей реализации Bot API, но есть некоторые отличия:

  • изменился адрес API. Был https://botapi.ok.ru, теперь - https://api.ok.ru/graph;
  • изменился формат токенов доступа к API. Вам необходимо обязательно переполучить токен на странице группы;
  • изменился формат ошибки, отдаваемой API. Новый формат аналогичен традиционному формату API Одноклассников, подробнее по ссылке;
  • изменился формат ID объектов (пользователи, группы, чаты, сообщения) и сами ID объектов. Их надо переполучить;
  • срок жизни токена ограничен 30 днями, но продляется автоматически каждый раз при вызове метода API и аналогичен LONG_ACCESS_TOKEN.

Сообщения в группах

Сообщения групп — сервис для прямого общения между пользователем и группой ОК, реализованный в рамках Graph API.

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

Модераторы групп могут отвечать пользователям в полной версии сайта, либо с помощью автоматизированного бота, используя Bot API.

Все методы, реализованные на данный момент в Graph API, доступны для использования в качестве Bot API. То есть с помощью бота вы можете:

  • следить за новыми сообщениями в ваших групповых чатах с помощью специальных Webhook’ов;
  • отвечать пользователям на их сообщения в групповых чатах.

Получение ключа доступа

Для работы с Bot API от имени группы необходимо получить специальный ключ доступа.

Ключ доступа (или токен) — это строка, включающая латинские буквы, цифры и специальные символы. Ее необходимо передавать в параметре “access_token”, обращаясь к методам Bot API от имени группы.

Администратор группы может получить ключ доступа (токен) в разделе Настройки группы на полной версии сайта.

Чтобы получить ключ, надо:

  1. Открыть раздел «Настройки»

  2. Выбрать вкладку «Управление»

  3. В строчке «Работа с API» нажать на кнопку «Получить ключ доступа»

  4. Подтвердить ваш выбор

  5. Скопировать токен и использовать его при работе с API

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

Доступные методы

Bot API реализовано на основе Graph API

С помощью Bot API вы можете:

  • получать информацию о всех чатах группы с помощью метода graph.user.chats;
  • получать информацию о конкретном чате группы с помощью метода graph.user.chat;
  • получать сообщения конкретного чата группы с помощью метода GET graph.user.messages;
  • писать новые сообщения в конкретный чата группы с помощью метода POST graph.user.messages;
  • подписаться на новые события в чатах группы с помощью метода graph.user.subscribe;
  • отписаться от получения новых событий в чатах группы с помощью метода graph.user.unsubscribe;
  • просмотреть список Webhook’ов, на которые отсылаются новые события в чатах с помощью метода graph.user.subscriptions.