提及

識別其中標註或加 @ 提及了 Instagram Business 或創作者帳號別名的文字、留言和 IG 影音內容。

限制

  • 不支援限時動態上的提及。
  • 不支援在標註了您的相片上留言。
  • 如果顯示留言或加 @ 提及內容的影音內容是由設為不公開的帳號所建立,系統將不會傳送 Webhooks

端點

API 包含以下端點:

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

Webhooks

訂閱 mentions 欄位,可在 Instagram 用戶提及 Instagram Business 或創作者帳號時收到 Instagram Webhooks 通知。請注意,我們不會儲存 Webhooks 通知資料,因此如果您設定會接聽提及的 Webhook,則應儲存您所收到的任何資料(如果您預計之後會用到)。

範例

接聽及回覆留言提及

您可以接聽留言提及並回覆任何符合條件的項目:

  1. 設定訂閱 mentions 欄位的 Instagram Webhook
  2. 設定可以剖析 Webhooks 通知及識別留言編號的指令碼。
  3. 使用編號查詢 GET /{ig-user-id}/mentioned_comment 端點,取得每則留言的詳細資訊。
  4. 分析傳回的結果,用於識別符合條件的任何留言。
  5. 使用 POST /{ig-user-id}/mentions 端點回覆這些留言

回覆會在提及了 Business 或創作者帳號的留言中以子對話串留言形式顯示。

接聽及回覆文字提及

您可以接聽文字提及並回覆任何符合條件的項目:

  1. 設定訂閱 mentions 欄位的 Instagram Webhook
  2. 設定可以剖析 Webhooks 通知及識別影音內容編號的指令碼。
  3. 使用編號查詢 GET /{ig-user-id}/mentioned_media 端點,取得每個影音內容物件的詳細資訊。
  4. 分析傳回的結果,用於識別含有符合條件之文字的影音內容物件。
  5. 請用 POST /{ig-user-id}/mentions 端點在這些影音內容物件留言