метод REST scope: imbot Устаревший

imbot.message.like

Установить «Мне нравится» для сообщения

Устаревший метод. Развитие метода остановлено. Используйте методы imbot.v2.Chat.Message.Reaction.add и imbot.v2.Chat.Message.Reaction.delete.

Кто может выполнять: авторизованный пользователь приложения, которое зарегистрировало чат-бота. Метод работает только с ботами этого приложения.

Описание

Метод imbot.message.like ставит или снимает отметку «Мне нравится» для сообщения.

Параметры

BOT_ID integer необязательный

Идентификатор чат-бота. Получить идентификатор бота можно с помощью метода imbot.bot.list.

Если параметр не передан, метод ищет первого бота, который зарегистрирован текущим приложением

MESSAGE_ID integer обязательный

Идентификатор сообщения в личных диалогах или в групповых чатах, где присутствует чат-бот. Значение должно быть больше 0.

Для сообщений, которые отправлены ботом через REST, идентификатор возвращает метод imbot.message.add.

Идентификаторы сообщений, которые отправили в чат пользователи, можно получить с помощью метода im.dialog.messages.get

ACTION string необязательный

Действие с реакцией на сообщение.

Допустимые значения:
- auto — автоматически переключить текущий статус: если реакции «Мне нравится» нет, она будет установлена, если реакция есть — снята
- plus — поставить «Мне нравится»
- minus — снять «Мне нравится»

Если параметр не передан, используется auto

CLIENT_ID string необязательный

Параметр обязателен только для вебхуков. Передавайте тот же CLIENT_ID, который был указан при регистрации чат-бота

Примеры запроса

curl -X POST /
  -H "Content-Type: application/json" /
  -H "Accept: application/json" /
  -d '{"BOT_ID":39,"MESSAGE_ID":19880117,"ACTION":"auto","CLIENT_ID":"**put_your_client_id_here**"}' /
  https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/imbot.message.like

Ответ

{
    "result": true,
    "time": {
        "start": 1728626400.123,
        "finish": 1728626400.234,
        "duration": 0.111,
        "processing": 0.045,
        "date_start": "2024-10-11T10:00:00+03:00",
        "date_finish": "2024-10-11T10:00:00+03:00",
        "operating_reset_at": 1762349466,
        "operating": 0
    }
}

Обработка ошибок

HTTP-статус: 400

{
    "error": "WITHOUT_CHANGES",
    "error_description": "Action completed without changes"
}
Код Описание Значение
BOT_ID_ERROR Bot not found Бот не найден или у приложения нет доступного бота для автоподстановки BOT_ID
APP_ID_ERROR Bot was installed by another rest application Переданный BOT_ID принадлежит другому приложению
MESSAGE_ID_ERROR Message ID can't be empty Не передан идентификатор сообщения
WITHOUT_CHANGES Action completed without changes Состояние реакции не изменилось после вызова

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.