Упоминания

Выявление подписей, комментариев и объектов 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 для упоминаний, сохраняйте полученные данные, которые нужно использовать в дальнейшем.

Примеры

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

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

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

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

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

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

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