登入開始免費試用
easyCoexistence 官方 API

透過 API 查看 Instagram 提及:找出並回覆 @提及

Instagram 的 API 會回報專業帳戶在公開媒體的留言和帖文說明中被 @提及的情況,並讓帳戶直接在原處回覆。使用 Instagram Login 時,提及會透過留言 Webhook 送達,回覆則經 POST /<IG_ID>/mentions 發出,附上媒體 ID;若提及位於留言中,還需附上留言 ID,回覆會以留言形式發布在該處。

easyCoexistence 會在提及、留言和私訊到達時,將 Instagram 帳戶的內容轉發至您的端點,並以該帳戶專屬的密鑰簽署,前提是您已透過 set_social_webhook_destination 設定密鑰。

comments

供使用 Instagram Login 的應用程式接收、包含提及的 Webhook 通知。

POST /mentions

用於回覆留言或帖文說明的端點,該內容中有其他 Instagram 用戶 @提及了該帳戶。

Private

私人帳戶擁有的媒體,其留言或 @提及不會觸發任何 Webhook。

2

使用 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 通知。

Replying to a mention in a comment
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 不保留通知記錄,因此請在每則提及到達時加以儲存。
使用 EasyCoexistence 完成這項設定

其工具可用 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 監察

驗證日期