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

Упоминания в Instagram через API: поиск и ответы на @упоминания

API Instagram сообщает о @упоминаниях профессионального аккаунта в комментариях и подписях к публичным публикациям и позволяет ответить на них на месте. С Instagram Login упоминания приходят через вебхук комментариев, а ответ отправляется через POST /<IG_ID>/mentions с ID медиа и, для комментария, с ID комментария, и публикуется там же в виде комментария.

easyCoexistence пересылает комментарии, упоминания и DM аккаунта Instagram на ваш эндпоинт по мере поступления, подписанные секретом для этого аккаунта, после того как вы задаёте его через set_social_webhook_destination.

comments

Уведомление вебхука, которое включает упоминания для приложений с Instagram Login.

POST /mentions

Эндпоинт, который отвечает на комментарий или подпись, где другой пользователь Instagram упомянул аккаунт через @.

Private

Медиа закрытого аккаунта не вызывает вебхук для комментария или @упоминания под ним.

2

Разрешения для упоминаний с 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 берутся из уведомления вебхука.

Replying to a mention in a comment
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 не хранит историю уведомлений, поэтому сохраняйте каждое при поступлении.
Настройка с EasyCoexistence

Его инструменты отвечают на комментарии к вашим собственным постам через 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 упоминаний не охватывает.

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

API приватных ответов в Instagram: ответ на комментарий личным сообщениемОтправьте приватный ответ в Instagram через API Meta: POST /<IG_ID>/messages с ID комментария, один на комментарий в течение 7 дней, ошибка 2534025.Разрешения Instagram API: области доступа для каждой функцииРазрешения, которые API Instagram использует с Instagram Login: от instagram_business_basic до manage_insights и что нужно каждой функции.События вебхука Instagram: комментарии, упоминания и личные сообщения (DM)Как комментарии, упоминания и DM из Instagram доходят до вашего эндпоинта: что содержит каждое событие, как подписываются доставки и что проверить.Модерация комментариев в Instagram через APIКак API Instagram читает комментарии, отвечает на них, скрывает и удаляет: публичные ответы, один личный ответ на комментарий в течение 7 дней и правила.Instagram DM через API и 24-часовое окноКак работают личные сообщения Instagram через API: кому может писать аккаунт, окно 24 часа, приватные ответы и настройка «Allow access to messages».Вебхук комментариев Instagram: полезная нагрузка поле за полемЧто вебхук комментариев Instagram присылает при комментарии к постам и Reels аккаунта: поля полезной нагрузки, чего в ней нет и ловушки.

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

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

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

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