提及

識別其他人在哪些說明文字、留言和 Instagram 媒體中標註或 @ 提及 Instagram 商業或創作者帳戶的別名。

限制

• 不支援限時動態上的提及。
• 不支援在您獲標註的相片上留言。
• 如果收到留言或獲 @ 提及的媒體是由設定為不公開的帳戶所建立，則系統不會傳送 Webhooks。

端點

此 API 由以下端點組成：

• GET /{ig-user-id}/tags — 獲取已標註商業或創作者帳戶的媒體物件
• GET /{ig-user-id}?fields=mentioned_comment — 獲取以 @ 提及商業或創作者帳戶的留言之資料
• GET /{ig-user-id}?fields=mentioned_media — 獲取在說明文字中以 @ 提及商業或創作者帳戶的媒體物件之資料
• POST /{ig-user-id}/mentions — 回覆另一位 Instagram 用戶以 @ 提及商業或創作者帳戶的留言或媒體物件說明文字

有關使用說明，請參閱每個端點的參考文件。

Webhooks

訂閱 mentions 欄位，以在 Instagram 用戶提及 Instagram 商業或創作者帳戶時接收 Instagram Webhooks 通知。請注意，我們不會儲存 Webhooks 通知資料，因此如果您設定了 Webhook 以監聽提及，則應該儲存所有接收到的資料（如果打算日後使用）。

範例

監聽並回覆內有 @ 提及內容的留言

您可以監聽內有 @ 提及內容的留言，並回覆任何符合您條件的留言：

1. 設定已訂閱 mentions 欄位的 Instagram webhook。
2. 設定可以剖析 Webhooks 通知並識別留言編號的指令碼。
3. 使用編號來查詢 GET /{ig-user-id}/mentioned_comment 端點，以獲取有關每個留言的更多資訊。
4. 分析傳回的結果，以識別任何符合您條件的留言。
5. 使用 POST /{ig-user-id}/mentions 端點來回覆這些留言。

回覆將以子對話串留言的形式，出現在提及商業或創作者帳戶的留言中。

監聽並回覆內有 @ 提及內容的說明文字

您可以監聽內有 @ 提及內容的說明文字，並回覆任何符合您條件的說明文字：

1. 設定已訂閱 mentions 欄位的 Instagram webhook。
2. 設定可以剖析 Webhooks 通知並識別媒體編號的指令碼。
3. 使用編號來查詢 GET /{ig-user-id}/mentioned_media 端點，以獲取有關每個媒體物件的更多資訊。
4. 分析傳回的結果，以識別任何符合您條件的附說明文字媒體物件。
5. 使用 POST /{ig-user-id}/mentions 端點來對這些媒體物件留言。