Вебхук message_reactions в Instagram: тело запроса при реакции и снятии реакции
Поле вебхука message_reactions уведомляет приложение, когда человек ставит реакцию на сообщение в своей переписке с профессиональным аккаунтом или убирает её. Событие находится в массиве messaging и содержит объект reaction: mid, ID сообщения, на которое поставлена реакция; action, react или unreact; а при react также reaction, например love, и emoji, сам эмодзи.
easyCoexistence подписывает каждый подключённый аккаунт Instagram на comments, messages и mentions и передаёт эти события на ваш HTTPS-эндпоинт по мере их поступления, подписанными секретом этого аккаунта, с mid каждого сообщения.
Два значения reaction.action: реакция добавлена или реакция удалена.
Версия Graph API, начиная с которой Meta поддерживает в этом вебхуке реакции angry, sad, wow, love, like, laugh и другие.
Meta не отправляет уведомление, когда сам аккаунт ставит реакцию на сообщение человека или снимает её.
message_reactions входит в поля, на которые по умолчанию подписан новый Instagram-продукт в App Dashboard.
Вызовы Send API в секунду на аккаунт для текста, ссылок, реакций и стикеров.
Когда срабатывает message_reactions?
Когда человек ставит реакцию на сообщение в своей переписке с профессиональным аккаунтом и когда снимает эту реакцию, после того как приложение и аккаунт подписаны на это поле. Руководство Meta по Instagram Messaging однозначно о противоположном направлении: когда сам аккаунт ставит реакцию или снимает её, уведомление не отправляется, и messages для неё тоже не присылает echo.
Как выглядит уведомление о реакции?
POST с object, равным instagram, в entry которого находится массив messaging. В отличие от личного сообщения, событие не содержит объекта message: реакция находится в собственном объекте reaction, рядом с sender, recipient и timestamp. Пример Meta для Instagram Login:
{
"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 и удалите реакцию этого человека с сообщения в своих записях.
"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 её удаляет. Ни один из этих вызовов не создаёт вебхук.
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.
Ваш агент отвечает человеку через 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.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на