透過 API 查看 Instagram 提及:找出並回覆 @提及
Instagram 的 API 會回報專業帳戶在公開媒體的留言和帖文說明中被 @提及的情況,並讓帳戶直接在原處回覆。使用 Instagram Login 時,提及會透過留言 Webhook 送達,回覆則經 POST /<IG_ID>/mentions 發出,附上媒體 ID;若提及位於留言中,還需附上留言 ID,回覆會以留言形式發布在該處。
easyCoexistence 會在提及、留言和私訊到達時,將 Instagram 帳戶的內容轉發至您的端點,並以該帳戶專屬的密鑰簽署,前提是您已透過 set_social_webhook_destination 設定密鑰。
供使用 Instagram Login 的應用程式接收、包含提及的 Webhook 通知。
用於回覆留言或帖文說明的端點,該內容中有其他 Instagram 用戶 @提及了該帳戶。
私人帳戶擁有的媒體,其留言或 @提及不會觸發任何 Webhook。
使用 Instagram Login 取得提及所需的權限:instagram_business_basic 和 instagram_business_manage_comments。
提及如何送達?
透過 Webhook,在提及發生時即時送達。使用 Instagram Login 時,Meta 會把提及包含在留言通知中,而不是另外發送 mentions 欄位,因此處理程式會從與新留言相同的事件中讀取提及。Meta 不保留過往通知的記錄,所以請在通知到達時儲存所需資料。
API 涵蓋哪些提及?
Meta 的提及 API 會識別商業或創作者帳戶被 @提及或標記的帖文說明、留言和媒體:
- 留言中的 @提及。
- 帖文說明中的 @提及。
- 帳戶被標記的媒體,可透過 GET /<
IG_ID>/tags 列出;但不支援對帳戶僅被標記其中的相片留言。 - 不包括限時動態:提及 API 不支援限時動態,而限時動態提及會以私訊送達帳戶,其附件類型為
story_mention。 - 不包括私人帳戶:其擁有的媒體不會發送提及 Webhook。
如何回覆提及?
使用 POST /<IG_ID>/mentions。若提及位於留言中,請隨訊息送出 media_id 和 comment_id,回覆會出現在該留言的對話串中;若提及位於帖文說明中,請送出 media_id 和訊息,回覆會以留言形式發布在該媒體上。兩個 ID 都來自 Webhook 通知。
POST https://graph.instagram.com/<IG_ID>/mentions
?media_id=<MEDIA_ID>
&comment_id=<COMMENT_ID>
&message=<REPLY_TEXT>提及需要什麼?
使用 Instagram Login 時,需要 instagram_business_basic 和 instagram_business_manage_comments 這兩項權限,與留言管理所用的權限相同,呼叫會發送至 graph.instagram.com。若要服務開發者不擁有或管理的專業帳戶,應用程式還需要 Advanced Access。
常見錯誤
- 在 Instagram Login 下等待獨立的提及事件。Meta 會把提及放在留言通知之中送達。
- 像回覆自己帖文的留言一樣,回覆另一帳戶帖文中的提及。Meta 的做法是 POST /<IG_ID>/mentions,附上媒體 ID;若是留言,還要附上留言 ID。
- 期望提及 API 能收到限時動態提及。Meta 在該處不支援,這些提及會以私訊送達。
- 指望 Webhook 重播過往的提及。Meta 不保留通知記錄,因此請在每則提及到達時加以儲存。
其工具可用 reply_to_comment 回覆您自己貼文上的留言;回覆他人貼文上的提及(須使用 Meta 的提及端點)則不在其中。每個連接每月 US$ 9 至 US$ 0.75,連接越多越便宜,首 3 日免費試用。
常見問題
我可以在帳戶僅被標記其中的相片上留言嗎?
不可以。GET /<IG_ID>/tags 會列出帳戶被標記的媒體,但 Meta 不支援對帳戶僅被標記其中的相片留言。
我可以回覆別人帖文中的提及嗎?
可以。使用 POST /<IG_ID>/mentions 並附上媒體 ID;若提及位於留言中,再附上留言 ID,回覆便會以該帳戶的身份發布在該處。
限時動態提及可以透過提及 API 取得嗎?
不可以。限時動態提及會以私訊送達帳戶,附件類型為 story_mention,並可在該對話中獲得回覆。
為什麼一直收不到某則提及?
該媒體可能屬於私人帳戶,而私人帳戶不會發送提及通知;或該提及位於限時動態中,而提及 API 不涵蓋限時動態。
繼續閱讀
兩分鐘內連接您的第一個頻道。
無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。
- 免費試用 3 天
- 隨時取消
- 只用官方 API
- 24/7 監察
驗證日期