提及

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

限制

• 不支援限時動態上的提及。
• 不支援在標註了您的相片上留言。
• 如果顯示留言或加 @ 提及內容的影音內容是由設為不公開的帳號所建立，系統將不會傳送 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 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 端點在這些影音內容物件留言。