ВойтиНачать бесплатный пробный период
easyCoexistence Официальные API

Вебхук message_reactions в Instagram: тело запроса при реакции и снятии реакции

Поле вебхука message_reactions уведомляет приложение, когда человек ставит реакцию на сообщение в своей переписке с профессиональным аккаунтом или убирает её. Событие находится в массиве messaging и содержит объект reaction: mid, ID сообщения, на которое поставлена реакция; action, react или unreact; а при react также reaction, например love, и emoji, сам эмодзи.

easyCoexistence подписывает каждый подключённый аккаунт Instagram на comments, messages и mentions и передаёт эти события на ваш HTTPS-эндпоинт по мере их поступления, подписанными секретом этого аккаунта, с mid каждого сообщения.

react / unreact

Два значения reaction.action: реакция добавлена или реакция удалена.

v12.0

Версия Graph API, начиная с которой Meta поддерживает в этом вебхуке реакции angry, sad, wow, love, like, laugh и другие.

No echo

Meta не отправляет уведомление, когда сам аккаунт ставит реакцию на сообщение человека или снимает её.

Default

message_reactions входит в поля, на которые по умолчанию подписан новый Instagram-продукт в App Dashboard.

100/sec

Вызовы Send API в секунду на аккаунт для текста, ссылок, реакций и стикеров.

Когда срабатывает message_reactions?

Когда человек ставит реакцию на сообщение в своей переписке с профессиональным аккаунтом и когда снимает эту реакцию, после того как приложение и аккаунт подписаны на это поле. Руководство Meta по Instagram Messaging однозначно о противоположном направлении: когда сам аккаунт ставит реакцию или снимает её, уведомление не отправляется, и messages для неё тоже не присылает echo.

Как выглядит уведомление о реакции?

POST с object, равным instagram, в entry которого находится массив messaging. В отличие от личного сообщения, событие не содержит объекта message: реакция находится в собственном объекте reaction, рядом с sender, recipient и timestamp. Пример Meta для Instagram Login:

A message_reactions notification, as Meta sends it
{
  "object": "instagram",
  "entry": [
    {
      "id": "<IG_ID>",
      "time": 1793448000512,
      "messaging": [
        {
          "sender": { "id": "<IGSID>" },
          "recipient": { "id": "<IG_ID>" },
          "timestamp": 1793447999874,
          "reaction": {
            "mid": "<MESSAGE_ID>",
            "action": "react",
            "reaction": "love",
            "emoji": "\u{2764}\u{FE0F}"
          }
        }
      ]
    }
  ]
}

Что означает каждое поле?

Поля, которые Meta описывает для события реакции, от внешних к внутренним:

  • entry[].id и recipient.id: профессиональный аккаунт. sender.id: Instagram-scoped ID человека, который поставил реакцию.
  • timestamp: момент, когда было запущено событие, в миллисекундах в примерах Meta; entry[].time: момент, когда Meta отправила уведомление.
  • reaction.mid: ID сообщения, на которое поставлена реакция, тот же mid, который это сообщение имело в своём событии messages.
  • reaction.action: react, когда реакция добавлена, unreact, когда она удалена.
  • reaction.reaction: название реакции, например love; Meta перечисляет angry, sad, wow, love, like, laugh и other.
  • reaction.emoji: эмодзи в виде строки Unicode, например \u{2764}\u{FE0F} для love.
  • При unreact поля reaction и emoji не передаются.

Как выглядит снятие реакции?

То же событие с action, равным unreact, без reaction и emoji, поскольку называть больше нечего. Сопоставьте его с удаляемой реакцией по reaction.mid и sender.id и удалите реакцию этого человека с сообщения в своих записях.

The reaction object of an unreact
"reaction": {
  "mid": "<MESSAGE_ID>",
  "action": "unreact"
}

На какое сообщение указывает mid?

На сообщение, на которое ответил человек, с тем же mid, что оно имело в событии messages, включая echo собственных сообщений аккаунта. Обработчик, который сохраняет mid, может привязать реакцию к нужной строке переписки. Meta отмечает одно ограничение: реакция на одно из изображений карусели указывает на её первое изображение, которое может быть не тем, что выбрал человек.

Как аккаунт ставит реакцию на сообщение?

Запросом POST /<IG_ID>/messages: recipient.id равен Instagram-scoped ID человека, sender_action равен react, а payload содержит message_id и reaction, эмодзи или его форму UTF-8. Повторный вызов с другим эмодзи меняет реакцию, а sender_action, равный unreact, с одним только message_id её удаляет. Ни один из этих вызовов не создаёт вебхук.

Reacting to a person's message
POST https://graph.instagram.com/<IG_ID>/messages
Authorization: Bearer <INSTAGRAM_USER_ACCESS_TOKEN>
Content-Type: application/json

{
  "recipient": { "id": "<IGSID>" },
  "sender_action": "react",
  "payload": {
    "message_id": "<MESSAGE_ID>",
    "reaction": "<EMOJI>"
  }
}

Что нужно для message_reactions?

При Instagram Login: instagram_business_basic и instagram_business_manage_messages, а также Advanced Access для аккаунтов, которыми разработчик не владеет и которые не управляет. Новый Instagram-продукт в App Dashboard по умолчанию подписан на message_reactions, а каждый аккаунт подписывается через POST /<IG_ID>/subscribed_apps. Руководство Meta по отправке сообщений называет поле messaging_reactions, но его таблица полей, настройки по умолчанию в панели и справочник вебхуков используют message_reactions.

Передаёт ли easyCoexistence реакции?

Нет. Приложение easyCoexistence и каждый подключённый аккаунт подписаны только на comments, messages и mentions, поэтому события message_reactions на ваш эндпоинт не пересылаются. Личные сообщения и echo, на которые реакции указывают по mid, доходят до него, подписанные секретом аккаунта.

Распространённые ошибки

  • Поиск реакции внутри message. Событие реакции не содержит объекта message: читайте объект reaction рядом с sender и recipient.
  • Чтение reaction или emoji без проверки action. При unreact оба поля не передаются, поэтому код, который на них рассчитывает, ломается при удалении реакции.
  • Ожидание вебхука после того, как аккаунт поставил реакцию. Meta не присылает ничего для собственных реакций аккаунта, даже echo, поэтому записывайте их, когда их отправляет ваше приложение.
  • Копирование названия messaging_reactions из руководства Meta по отправке сообщений. В таблице полей, настройках по умолчанию и справочнике вебхуков поле называется message_reactions.
Настройка с EasyCoexistence

Ваш агент отвечает человеку через send_social_dm в окне 24 часа. От US$ 9 до US$ 0,75 за подключение в месяц, снижается по мере добавления подключений, с бесплатным пробным периодом в первые 3 дня.

Часто задаваемые вопросы

Почему реакция на пост карусели указывает на первое изображение?

Meta указывает первое изображение карусели, когда человек ставит реакцию на одно из её изображений. Это может быть не то изображение, которое выбрал человек.

Отправляет ли Instagram вебхук, когда бизнес ставит реакцию на сообщение?

Нет. Meta не присылает уведомление message_reactions и echo, когда аккаунт ставит реакцию на сообщение или снимает её.

Какие реакции может передавать вебхук Instagram?

Руководство Meta по Instagram Messaging перечисляет angry, sad, wow, love, like, laugh и other, начиная с Graph API v12.0. Сам эмодзи передаётся в reaction.emoji.

Поле вебхука называется message_reactions или messaging_reactions?

message_reactions. Руководство Meta по отправке сообщений пишет messaging_reactions, но таблица полей, настройки по умолчанию в App Dashboard и справочник вебхуков используют message_reactions.

Читайте дальше

Вебхук сообщений Instagram: тело DM, эхо и поляЧто вебхук сообщений Instagram передаёт для DM: IGSID отправителя, текст, вложения, ответы на сторис и эхо, поле за полем, и окно 24 часа.Вложения DM Instagram в вебхуке messagesКакие типы вложений может нести событие DM Instagram: изображения, видео, аудио, ig_post, ig_reel и story_mention, с полями payload, URL и пропусками.Вебхук Instagram messaging_postbacks: айсбрейкеры и кнопкиЧто отправляет вебхук messaging_postbacks Instagram при нажатии айсбрейкера, кнопки или пункта меню: title, payload, mid и как настроить.Вебхук live_comments в Instagram: комментарии во время LiveЧто вебхук live_comments присылает в Instagram, пока аккаунт ведёт прямой эфир: данные, отличия от комментариев и ответ на комментарий Live.Поля вебхуков Instagram: полный списокПоля вебхука, которые Meta перечисляет для Instagram API с Instagram Login: что запускает каждое, какое разрешение нужно и какие остались за Facebook Login.Instagram DM через API и 24-часовое окноКак работают личные сообщения Instagram через API: кому может писать аккаунт, окно 24 часа, приватные ответы и настройка «Allow access to messages».

Подключите первый канал за две минуты.

Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.

  • 3 дня бесплатно
  • Отмена в любой момент
  • Только официальные API
  • Мониторинг 24/7

Проверено по состоянию на