提及

识别其他用户标记或 @ 提及相关 Instagram Business 或创作者别名的图说、评论和 Instagram 媒体。

限制

• 不支持在快拍上提及。
• 不支持在带有您标记的照片上发表评论。
• 如果出现评论或 @ 提及的媒体是由设置为非公开的帐户所创建，则系统不会向其发送 Webhooks。

端点

此 API 包含以下端点：

• GET /{ig-user-id}/tags — 获取已标记的 Business 或创作者帐户的媒体对象
• GET /{ig-user-id}?fields=mentioned_comment — 获取在评论中 @ 提及的 Business 或创作者帐户的数据
• GET /{ig-user-id}?fields=mentioned_media — 获取在图说中 @ 提及的 Business 或创作者帐户的媒体对象数据
• POST /{ig-user-id}/mentions — 回复评论或媒体对象图说，另一位 Instagram 用户已在其中 @ 提及 Business 或创作者帐户

如需了解使用说明，请参阅各个端点的参考文档。

Webhooks

订阅 mentions 字段，以在 Instagram 用户提及 Instagram Business 或创作者帐户时接收 Instagram Webhook 通知。请注意，我们不存储 Webhook 通知数据，因此，如果您设置了一个用于监听提及的 Webhook，并打算以后使用，则应该存储所有接收到的数据。

示例

监听并回复带有“@ 提及”内容的评论

您可以监听带有“@ 提及”内容的评论并回复任何符合您条件的评论：

1. 设置已订阅 mentions 字段的 Instagram Webhook。
2. 设置可以解析 Webhook 通知并标识评论编号的脚本。
3. 使用编号来查询 GET /{ig-user-id}/mentioned_comment 端点，以获取有关每个评论的更多信息。
4. 分析返回的结果，以确定任何符合您条件的评论。
5. 使用 POST /{ig-user-id}/mentions 端点来回复这些评论。

回复将以子对话评论的形式出现在提及 Business 或创作者帐户的评论中。

监听并回复带有“@ 提及”内容的图说

您可以监听带有“@ 提及”内容的图说并回复任何符合您条件的图说：

1. 设置已订阅 mentions 字段的 Instagram Webhook。
2. 设置可以解析 Webhook 通知并标识媒体编号的脚本。
3. 使用编号查询 GET /{ig-user-id}/mentioned_media 端点，以获取有关每个媒体对象的更多信息。
4. 分析返回的结果，以确定任何符合您条件的带有图说的媒体对象。
5. 使用 POST /{ig-user-id}/mentions 端点评论这些媒体对象。