提及

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

限制

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

端點

此 API 由以下端點組成:

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

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 端點來對這些媒體物件留言