Bot API

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

Сообщения групп — сервис для прямого общения между пользователем и группой ОК, реализованный в рамках 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 вы можете:

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