Упоминания

Выявление подписей, комментариев и объектов IG Media, в которых отмечено или @упомянуто имя аккаунта Instagram Business или аккаунта автора.

Ограничения

  • Упоминания в историях не поддерживаются.
  • Возможность оставлять комментарии к фото, в которых отмечен ваш аккаунт, не поддерживается.
  • Webhooks не отправляется, если медиафайл, на который оставлен комментарий или @упоминание, создан владельцем закрытого аккаунта.

Конечные точки

Этот API включает следующие конечные точки:

  • GET /{ig-user-id}/tags — получает медиаобъекты, в которых отмечен аккаунт Instagram Business или аккаунт автора;
  • GET /{ig-user-id}?fields=mentioned_comment — получает данные о комментарии, в котором @упомянут аккаунт Instagram Business или аккаунт автора;
  • GET /{ig-user-id}?fields=mentioned_media — получает данные о медиаобъекте, в подписи к которому @упомянут аккаунт Instagram Business или аккаунт автора;
  • POST /{ig-user-id}/mentions — позволяет ответить на комментарий или подпись к фото или видео, где аккаунт Instagram Business или аккаунт автора @упомянул другой пользователь.

Информацию об ограничениях при использовании конечной точки см. в соответствующей документации.

Webhooks

Подпишитесь на поле mentions, чтобы получать уведомления Instagram Webhooks каждый раз, когда пользователь Instagram упоминает аккаунт Instagram Business или аккаунт автора. Обратите внимание: мы не сохраняем данные уведомлений Webhooks. Если вы настроите Webhooks для упоминаний, сохраняйте полученные данные, которые нужно использовать в дальнейшем.

Примеры

Мониторинг и ответы на @упоминания в комментариях

Вы можете отслеживать @упоминания в комментариях и отвечать на те, которые соответствуют заданным вами критериям. Для этого необходимо:

  1. Настроить Webhook Instagram, подписанный на поле mentions.
  2. Настроить скрипт, который может обрабатывать уведомления Webhooks и определять ID комментариев.
  3. Запросить конечную точку GET /{ig-user-id}/mentioned_comment с указанием ID и получить подробную информацию о каждом комментарии.
  4. Проанализировать полученные результаты и найти комментарии, отвечающие вашим критериям.
  5. Ответить на комментарии, используя конечную точку POST /{ig-user-id}/mentions.

Эти ответы будут отображаться как комментарии второго уровня по отношению к комментарию, в котором был упомянут аккаунт Instagram Business или аккаунт автора.

Мониторинг и ответы на @упоминания в подписях

Вы можете отслеживать @упоминания в подписях и отвечать на те, которые соответствуют заданным вами критериям. Для этого необходимо:

  1. Настроить Webhook для Instagram, подписанный на поле mentions.
  2. Настроить скрипт, который может обрабатывать уведомления Webhooks и определять ID медиафайлов.
  3. Запросить конечную точку GET /{ig-user-id}/mentioned_media с указанием ID и получить подробную информацию о каждом медиаобъекте.
  4. Проанализировать полученные результаты и найти подписи, отвечающие вашим критериям.
  5. Прокомментировать эти медиаобъекты, используя конечную точку POST /{ig-user-id}/mentions.