---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://yandex.com/dev/messenger/doc/ru/api-requests/message-get-reactions.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/messenger/doc/ru/llms.txt

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

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

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](../data-types.md#messagereactionentry)##`[]` | Реакции с авторами |
| `reactions_count` | Для `private` | ##[ReactionCount](../data-types.md#reactioncount)##`[]` | Анонимные счетчики реакций |

## Пример ответа для чата
```json
{
  "ok": true,
  "reactions_type": "public",
  "reactions_list": [
    {
      "reaction": {"type": "default_reaction", "name": "like"},
      "timestamp": 1702323240544005,
      "user": {
        "login": "user@example.com",
        "display_name": "Anya"
      }
    }
  ]
}
```

## Пример ответа для канала
```json
{
  "ok": true,
  "reactions_type": "private",
  "reactions_count": [
    {"reaction": {"type": "default_reaction", "name": "like"}, "count": 12}
  ]
}
```