Сообщения в группах
Сообщения групп — сервис для прямого общения между пользователем и группой ОК, реализованный в рамках 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.chat.messages;
- писать новые сообщения в конкретный чата группы с помощью метода POST graph.chat.messages;
- подписаться на новые события в чатах группы с помощью метода POST graph.user.subscribe;
- отписаться от получения новых событий в чатах группы с помощью метода POST graph.user.unsubscribe;
- просмотреть список Webhook’ов, на которые отсылаются новые события в чатах с помощью метода GET graph.user.subscriptions.
- получать обновления в чатах при наличии long polling-подписки с помощью метода GET graph.user.updates.