Получение реакций на сообщение

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

HTTP метод: POST

URL: https://botapi.messenger.yandex.net/bot/v1/messages/getReactions/

Заголовки

Authorization: OAuth <токен>
Content-Type: application/json

Тело запроса (JSON)

Имя параметра Обязательный Тип Описание Ограничения, значение по умолчанию
chat_id Нет* string ID группового чата или канала Бот должен состоять в чате или канале
login Нет* string Логин пользователя для приватного чата —
message_id Да integer ID сообщения —
thread_id Нет integer ID треда Для сообщений в тредах
limit Нет integer Максимальное количество реакций в ответе Только для public. По умолчанию: 100, максимум: 1000
offset Нет integer ID последней полученной реакции для пагинации Только для public

(*) Параметры chat_id и login являются необязательными, но необходимо заполнить один из двух.

Результат

Результатом успешного запроса является ответ с кодом 200. Поле reactions_type определяет формат ответа:

  • public — реакции с авторами в личных и групповых чатах;
  • private — анонимные счетчики реакций в каналах.
Имя параметра Обязательный Тип Описание
ok Да boolean Флаг успешности выполнения
reactions_type Да string Тип ответа: public или private
reactions_list Для public MessageReactionEntry[] Реакции с авторами
reactions_count Для private ReactionCount[] Анонимные счетчики реакций

Пример ответа для чата

{
  "ok": true,
  "reactions_type": "public",
  "reactions_list": [
    {
      "reaction": {"type": "default_reaction", "name": "like"},
      "timestamp": 1702323240544005,
      "user": {
        "login": "user@example.com",
        "display_name": "Anya"
      }
    }
  ]
}

Пример ответа для канала

{
  "ok": true,
  "reactions_type": "private",
  "reactions_count": [
    {"reaction": {"type": "default_reaction", "name": "like"}, "count": 12}
  ]
}
Предыдущая
Установка или удаление реакции
Следующая
Создание опроса