Упоминания в Instagram через API: поиск и ответы на @упоминания
API Instagram сообщает о @упоминаниях профессионального аккаунта в комментариях и подписях к публичным публикациям и позволяет ответить на них на месте. С Instagram Login упоминания приходят через вебхук комментариев, а ответ отправляется через POST /<IG_ID>/mentions с ID медиа и, для комментария, с ID комментария, и публикуется там же в виде комментария.
easyCoexistence пересылает комментарии, упоминания и DM аккаунта Instagram на ваш эндпоинт по мере поступления, подписанные секретом для этого аккаунта, после того как вы задаёте его через set_social_webhook_destination.
Уведомление вебхука, которое включает упоминания для приложений с Instagram Login.
Эндпоинт, который отвечает на комментарий или подпись, где другой пользователь Instagram упомянул аккаунт через @.
Медиа закрытого аккаунта не вызывает вебхук для комментария или @упоминания под ним.
Разрешения для упоминаний с Instagram Login: instagram_business_basic и instagram_business_manage_comments.
Как приходят упоминания?
Через вебхук, по мере появления. С Instagram Login Meta включает упоминания в уведомление о комментариях, а не отправляет отдельное поле mentions, поэтому обработчик читает их из тех же событий, что и новые комментарии. Meta не хранит историю прошлых уведомлений, поэтому сохраняйте нужные данные из каждого, как только оно придёт.
Какие упоминания охватывает API?
API упоминаний Meta определяет подписи, комментарии и медиа, в которых аккаунт бизнеса или автора был упомянут через @ или отмечен:
- @упоминания в комментариях.
- @упоминания в подписи к публикации.
- Медиа, на которых отмечен аккаунт, список по GET /<
IG_ID>/tags; комментировать фото, где аккаунт только отмечен, не поддерживается. - Не Stories: API упоминаний их не поддерживает, а упоминание в Stories приходит аккаунту как DM с типом вложения
story_mention. - Не закрытые аккаунты: их медиа не отправляют вебхуки упоминаний.
Как ответить на упоминание?
POST /<IG_ID>/mentions. Для упоминания в комментарии отправьте media_id и comment_id вместе с текстом сообщения, и ответ появится в ветке этого комментария; для упоминания в подписи отправьте media_id и текст сообщения, и оно опубликуется как комментарий к медиа. Оба ID берутся из уведомления вебхука.
POST https://graph.instagram.com/<IG_ID>/mentions
?media_id=<MEDIA_ID>
&comment_id=<COMMENT_ID>
&message=<REPLY_TEXT>Что нужно для упоминаний?
С Instagram Login разрешения instagram_business_basic и instagram_business_manage_comments, та же пара, которую использует модерация комментариев, с запросами на graph.instagram.com. Чтобы обслуживать профессиональные аккаунты, которыми разработчик не владеет и не управляет, приложению также нужен Advanced Access.
Распространённые ошибки
- Ожидание отдельного события упоминаний при Instagram Login. Meta доставляет упоминания внутри уведомления о комментариях.
- Ответ на упоминание в публикации другого аккаунта как на комментарий к собственной. Маршрут Meta для этого: POST /<IG_ID>/mentions, с ID медиа и, для комментария, с ID комментария.
- Ожидание упоминаний в Stories через API упоминаний. Meta их там не поддерживает; они приходят аккаунту как DM.
- Расчёт на то, что вебхук повторно пришлёт старые упоминания. Meta не хранит историю уведомлений, поэтому сохраняйте каждое при поступлении.
Его инструменты отвечают на комментарии к вашим собственным постам через reply_to_comment; ответ на упоминание в чужом посте, для которого используется эндпоинт упоминаний Meta, среди них не предусмотрен. От US$ 9 до US$ 0,75 за подключение в месяц, цена снижается по мере добавления подключений, первые 3 дня бесплатно.
Часто задаваемые вопросы
Могу ли я комментировать фото, на котором отмечен мой аккаунт?
Нет. GET /<IG_ID>/tags показывает медиа, где отмечен аккаунт, но Meta не поддерживает комментарии к фото, где аккаунт только отмечен.
Могу ли я ответить на упоминание в публикации другого человека?
Да. POST /<IG_ID>/mentions с ID медиа, а также с ID комментария, если упоминание в комментарии, публикует ответ там от имени аккаунта.
Доступны ли упоминания в Stories через API упоминаний?
Нет. Упоминание в Stories приходит аккаунту как DM с типом вложения story_mention и может получить ответ в этой переписке.
Почему упоминание так и не пришло?
Медиа может принадлежать закрытому аккаунту, который не отправляет уведомления об упоминаниях, или упоминание может быть в Stories, которые API упоминаний не охватывает.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на