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

讀取 Instagram 私訊紀錄:Conversations API

Instagram 的 Conversations API 透過 graph.instagram.com 讀取專業帳戶的私訊紀錄。GET /me/conversations?platform=instagram 會列出各對話及其 updated_time;GET /<CONVERSATION_ID>?fields=messages 依 ID 和時間列出一段對話的訊息;GET /<MESSAGE_ID>?fields=id,created_time,from,to,message 則返回單則訊息。每段對話只有最近 20 則訊息可取得詳細資料。

easyCoexistence 會在新 Instagram 私訊到達時轉送至您的端點,並在 24 小時回覆時限內以 send_social_dm 回覆。

20

每段對話中,API 返回詳細資料的只有最近的訊息;較舊的訊息會返回錯誤,指明已被刪除。

30 days

經過一段時間沒有活動後,「請求」資料夾中的對話將不再返回。

2/sec

每個 Instagram 專業帳戶每秒可向 Conversations API 發出的呼叫次數上限。

2 permissions

instagram_business_basic 與 instagram_business_manage_messages 權限,並需使用由可管理帳戶訊息的人員取得的存取權杖。

如何列出帳戶的對話?

使用 GET /me/conversations,或 /<IG_ID>/conversations,並加上 platform=instagram,搭配可管理帳戶訊息之人員的 Instagram 使用者存取權杖。data 陣列中的每個項目即一段對話,包含其 id 及 updated_time。

Listing conversations
GET https://graph.instagram.com/me/conversations
  ?platform=instagram
  &access_token=<ACCESS_TOKEN>

{
  "data": [
    { "id": "<CONVERSATION_ID>", "updated_time": "<UPDATED_TIME>" }
  ]
}

如何找出與某人的對話?

加入 user_id,填入該人的 Instagram 範圍 ID,即對方向帳戶傳訊時以 sender.id 傳來的 IGSID,回應便會返回該段對話的 id。如此無需翻查整份清單,即可將 webhook 事件對應到其對話串。

One person's conversation
GET https://graph.instagram.com/me/conversations
  ?user_id=<IGSID>
  &access_token=<ACCESS_TOKEN>

如何讀取訊息?

分兩步進行。GET /<CONVERSATION_ID>?fields=messages 會依 id 及 created_time 列出該對話的訊息,這是預設欄位。之後以 fields=id,created_time,from,to,message 呼叫 GET /<MESSAGE_ID>,即可返回單則訊息:包括發送者及收件者(各附 username 及 ID),以及其文字內容。

A conversation's messages, then one message
GET https://graph.instagram.com/<CONVERSATION_ID>
  ?fields=messages
  &access_token=<ACCESS_TOKEN>

GET https://graph.instagram.com/<MESSAGE_ID>
  ?fields=id,created_time,from,to,message
  &access_token=<ACCESS_TOKEN>

最多可回溯多遠?

Meta 的指南及概覽對返回內容設有四項限制:

  • 訊息詳細資料:每段對話只有最近 20 則訊息;索取較舊的訊息會返回錯誤,指明已被刪除。
  • 請求:「請求」資料夾中,連續 30 天沒有活動的對話不會返回。
  • 分享內容:分享的貼文或 Reel 只會以其圖片或影片 URL 返回。
  • 頻率:每個 Instagram 專業帳戶每秒 2 次呼叫。

需要什麼?

使用 Instagram 登入時,需要 instagram_business_basic 與 instagram_business_manage_messages 權限,以及可管理帳戶訊息之人員的存取權杖。擁有或管理、並已加入應用程式的帳戶,使用標準存取即可;為其他帳戶提供服務則需要進階存取。此外,該帳戶須在其 Instagram 應用程式設定中開啟「允許存取訊息」。

為什麼要從 webhook 保存紀錄?

由於 API 只返回每段對話最新 20 則訊息的詳細資料,完整紀錄須在訊息發生時即時保存。messages webhook 會在私訊到達時送出,並附上對方的 IGSID 作為 sender.id;帳戶發出的訊息也會送達,其 ID 角色則相反,因此對話雙方都能被記錄下來。

如何透過 easyCoexistence 讀取私訊紀錄?

它是轉送私訊,而不是讀取歷史紀錄。使用 set_social_webhook_destination 設定端點後,新私訊一到達便會直接轉送至您的端點,轉送後不保留副本;send_social_dm 則可在 24 小時回覆時限內作出回覆;您可從 Claude、ChatGPT 或自家程式碼中呼叫。沒有任何工具會呼叫 me/conversations,因此較早的訊息須在 Instagram 應用程式中讀取,或由您自己的系統在訊息到達時保存。

常見錯誤

  • 以為 API 會返回整段對話串。詳細資料只到最近 20 則訊息為止,因此應在 messages webhook 送達私訊時即時保存。
  • 輪詢對話以查找新私訊。API 每個帳戶每秒只允許 2 次呼叫,而 messages webhook 會在每則私訊到達時即時送出。
  • 尋找舊的訊息請求。「請求」資料夾中閒置 30 天的對話已不再返回。
  • 將 deleted 錯誤當作對方刪除了訊息。Meta 對於任何早於最近 20 則的訊息都會如此回覆。
使用 EasyCoexistence 完成這項設定

您可從 Claude、ChatGPT 或自家程式碼使用,採用 Meta 官方 API;它沒有用於 Conversations API 對話紀錄的工具。每個連接每月 US$ 9 起,連接越多越便宜,最低降至 US$ 0.75,並提供首 3 天免費試用。

常見問題

能否完整匯出 Instagram 帳戶的私訊紀錄?

不能透過 API 完整匯出:它會列出對話,但每段對話只返回最近 20 則訊息的詳細資料。完整紀錄需從 webhook 送達時即時保存私訊。

透過 API 讀取訊息會將其標示為已讀嗎?

不會。Meta 表示,透過 API 送達的訊息在回覆之前,不會在 Instagram 應用程式中標示為已讀。

Conversations API 可與 Instagram 登入搭配使用嗎?

可以。Meta 的相關指南即以 Instagram 登入為基礎撰寫,呼叫 graph.instagram.com 並使用 instagram_business_* 權限。

如何從對話中取得某人的使用者名稱?

對訊息請求 from 欄位,即可返回發送者的 username 及 ID。User Profile API 則可在對方向帳戶傳訊後,以其 IGSID 返回更多資料,例如姓名。

繼續閱讀

兩分鐘內連接您的第一個頻道。

無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。

  • 免費試用 3 天
  • 隨時取消
  • 只用官方 API
  • 24/7 監察

驗證日期