Упоминания и ответы на сторис в вебхуке Instagram
Instagram доставляет упоминания и ответы на сторис как личные сообщения в поле messages вебхука. Упоминание приходит как сообщение, в вложениях которого есть элемент типа story_mention с CDN-URL сторис в payload.url. Ответ содержит текст человека и reply_to.story с url и id сторис, а для сторис со стикером-ссылкой также link_sticker_url.
easyCoexistence подписывает каждый подключённый аккаунт Instagram на messages, поэтому упоминания в сторис и ответы на них приходят на ваш HTTPS-эндпоинт вместе с остальными DM по мере поступления; каждое событие подписано секретом аккаунта, копия не сохраняется.
Тип вложения в событии messages, которое Meta отправляет, когда кто-то упоминает аккаунт в своей сторис.
Поле, которое Meta добавила в reply_to.story 12 декабря 2025 г.: в нём URL стикера-ссылки сторис, на которую ответили.
Срок жизни сторис. После истечения срока или удаления URL упоминания перестаёт отображаться.
Аккаунты, для которых приходят упоминания в сторис. Упоминание от закрытого аккаунта приходит, только если он подписан на профессиональный аккаунт.
Ответы на сторис, которые вебхук не поддерживает, по данным руководства Meta по обмену сообщениями в Instagram.
Как приходит упоминание в сторис?
Как личное сообщение. Когда человек упоминает профессиональный аккаунт в своей сторис, Instagram помещает во входящие аккаунта сообщение со ссылкой на эту сторис, и Meta отправляет для него событие messages. sender.id это Instagram-scoped ID человека, а message.attachments содержит один элемент типа story_mention, у которого payload.url является CDN-URL сторис. В примерах Meta текста нет, поэтому читайте вложение:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000512,
"messaging": [
{
"sender": { "id": "<IGSID>" },
"recipient": { "id": "<IG_ID>" },
"timestamp": 1793447999874,
"message": {
"mid": "<MESSAGE_ID>",
"attachments": [
{
"type": "story_mention",
"payload": { "url": "<CDN_URL>" }
}
]
}
}
]
}
]
}Как приходит ответ на сторис?
Тоже как личное сообщение: с текстом человека и объектом reply_to, который указывает на сторис аккаунта. reply_to.story содержит CDN-URL сторис и её id. В справочнике вебхука Meta указан также link_sticker_url, который добавили в декабре 2025 г. для ответов на сторис со стикером-ссылкой; Meta советует использовать его для маршрутизации автоматизаций по ссылке. Встроенный ответ на более раннее сообщение использует reply_to.mid.
"message": {
"mid": "<MESSAGE_ID>",
"text": "<MESSAGE_TEXT>",
"reply_to": {
"story": {
"url": "<CDN_URL>",
"id": "<STORY_ID>"
}
}
}Что означает каждое поле?
Поля, которые Meta документирует для этих двух событий, сверху вниз:
- entry[].id и recipient.id: профессиональный аккаунт. sender.id: Instagram-scoped ID человека, на который уходит ответ.
- timestamp: время отправки сообщения в миллисекундах в примерах Meta; entry[].time: момент, когда Meta отправила уведомление.
- message.mid: ID сообщения, нужен для дедупликации повторов и для ответа через
reply_to.mid. - attachments[].type
story_mentionи payload.url: упоминание и CDN-URL сторис, которая его создала. reply_to.story.url иreply_to.story.id: сторис аккаунта, на которую ответил человек.reply_to.story.link_sticker_url: URL на стикере-ссылке этой сторис.- message.text: слова ответа, есть, когда сообщение содержит текст.
Сколько времени работает URL сторис?
Столько же, сколько сама сторис. Сторис исчезает через 24 часа или когда её автор удаляет её; руководство Meta по упоминаниям в сторис говорит, что после этого URL перестаёт отображаться. В обзоре сказано, что CDN-URL Instagram учитывают приватность и не возвращают ничего для удалённого или истёкшего контента. То же руководство разрешает сохранять CDN-URL, но не медиа: приложение не должно хранить или кэшировать содержимое сторис на своих серверах и должно показывать заглушку, когда сторис больше нет.
Когда не срабатывает ни одно событие?
Руководства Meta называют эти случаи, когда обработчик, ожидающий событие сторис, ничего не получает:
- Упоминание в сторис от закрытого аккаунта, который не подписан на профессиональный аккаунт.
- Отметка в обычной публикации: Meta говорит, что вебхук messages срабатывает только на упоминания в сторис, а не на отметки в публикациях.
- Ответ на сторис с GIF или стикером, который вебхук не поддерживает.
- Сторис через API упоминаний: GET /<
IG_ID>/tags и POST /<IG_ID>/mentions их не поддерживают, поэтому упоминание в сторис приходит через DM.
Открывают ли упоминания и ответы на сторис окно сообщений?
Ответ представляет собой сообщение от человека, а Meta относит упоминания в сторис к каналам, через которые человек начинает диалог. Окно, которое открывает его действие, для большинства действий длится 24 часа, поэтому пока оно открыто, аккаунт может ответить через POST /<IG_ID>/messages, указав recipient.id равным sender.id события. Ответ аккаунта возвращается в messages как echo, где is_echo равно true.
Как easyCoexistence передаёт их дальше?
По полю messages, на которое подписан каждый подключённый аккаунт, поэтому упоминания в сторис и ответы на них приходят на ваш эндпоинт вместе с остальными DM аккаунта: каждая запись внутри конверта с полями platform, account_id, external_id и entry; подпись в X-EC-Signature делается секретом аккаунта; отправляется один раз, копия не хранится. send_social_dm отвечает человеку, передавая sender.id события как recipient_id, в пределах 24-часового окна.
POST <YOUR_ENDPOINT>
Content-Type: application/json
X-EC-Signature: t=1793448001,v1=<HEX_HMAC_SHA256>
{
"platform": "instagram",
"account_id": "<ACCOUNT_ID>",
"external_id": "<IG_ID>",
"entry": {
"id": "<IG_ID>",
"time": 1793448000512,
"messaging": [
{
"sender": { "id": "<IGSID>" },
"recipient": { "id": "<IG_ID>" },
"timestamp": 1793447999874,
"message": {
"mid": "<MESSAGE_ID>",
"attachments": [
{ "type": "story_mention", "payload": { "url": "<CDN_URL>" } }
]
}
}
]
}
}Распространённые ошибки
- Хранение медиа сторис. Руководство Meta по упоминаниям в сторис разрешает сохранять CDN-URL, но не содержимое, которое нельзя хранить или кэшировать на ваших серверах.
- Чтение только message.text. Упоминание в сторис несёт вложение типа story_mention и, в примерах Meta, без текста, поэтому обработчик, который читает только текст, видит пустое сообщение.
- Отображение URL сторис спустя дни. Он перестаёт работать, когда сторис истекает через 24 часа или удаляется, поэтому с этого момента показывайте заглушку.
- Поиск упоминаний в сторис в поле comments или в API упоминаний. Meta доставляет их как DM в поле messages.
send_social_dm отвечает человеку в пределах 24-часового окна из Claude, ChatGPT или вашего кода. От US$ 9 до US$ 0,75 за подключение в месяц, цена снижается по мере добавления подключений; первые 3 дня пробного периода бесплатны.
Часто задаваемые вопросы
Есть ли текст в событии упоминания в сторис в Instagram?
В примерах Meta текста нет. Упоминание в сторис несёт вложение типа story_mention с CDN-URL сторис, поэтому обработчик, который читает только message.text, видит пустое сообщение.
Что такое link_sticker_url в ответе на сторис Instagram?
URL на стикере-ссылке сторис, на которую ответил человек, в reply_to.story.link_sticker_url. Meta добавила его 12 декабря 2025 г. и советует использовать для маршрутизации автоматизаций по ссылке.
Срабатывает ли вебхук на ответы на сторис с GIF или стикером?
Нет. Руководство Meta по обмену сообщениями в Instagram говорит, что вебхук не поддерживает ответы на сторис, сделанные с GIF или стикером.
Срабатывают ли вебхуки на упоминания в сторис от закрытых аккаунтов?
Только если закрытый аккаунт подписан на профессиональный аккаунт. Упоминания из открытых аккаунтов приходят по мере их появления.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на