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

透過 API 的 Instagram 私訊與 24 小時訊息時段

透過 Instagram 的 API,專業帳戶可以回覆任何曾傳私訊給它的人,而大部分對話的標準訊息時段為 24 小時。對方必須先發出訊息,而且帳戶須先在 Instagram 應用程式中開啟「允許存取訊息」,應用程式才可讀取或發送其私訊。

easyCoexistence 讓 Claude、ChatGPT 或你自己的程式碼透過 send_social_dm 回覆 Instagram 私訊,並在 24 小時訊息時段內發送;新私訊到達時,會轉發至你的端點。

24 hours

大部分用戶操作適用的標準時段,用於回覆用戶的訊息。

7 days

Meta 獨立的 Human Agent 時段,適用於真人撰寫並標記 human_agent 的回覆。

1,000 bytes

一則私訊透過 API 可載入的最多文字量,以 UTF-8 編碼計算。

2534022

錯誤代碼 10 之下的錯誤子代碼,表示訊息在允許時段以外發送。

30 days

對話在「請求」文件夾中閒置達到一定時間後,便不再由 API 回傳。

API 可以向哪些人傳送訊息?

曾向帳戶傳送訊息的人。對話只會在對方主動傳訊給帳戶時開始,來源可以是動態消息、帖文、限時動態提及或其他途徑,之後應用程式便可回覆對方。留言帖文的人也可收到一則私人回覆,詳見下文。

API 無法發出首則訊息,亦不支援群組對話:每段對話都只限帳戶與一名用戶之間進行。

訊息時段有多長?

大部分對話為 24 小時。Meta 稱之為標準訊息時段,開啟時段的操作決定其長度:對方傳來的訊息會開啟 24 小時,對方下一則訊息會再次開啟。若首則訊息來自點擊過 Click-to-Direct 廣告的人,時段可長達 7 天。

Meta 另設獨立的 Human Agent 時段,為 7 天,適用於由具備此功能的應用程式以 human_agent 標記的真人回覆,用於標準時段無法涵蓋的問題。在任何開啟的時段以外發送會失敗,並返回代碼 10、子代碼 2534022。

什麼是「允許存取訊息」?

Instagram 應用程式中的一項設定,讓已連接的工具讀取及發送帳戶的私訊。Meta 的指南指出其位置為:設定、訊息和限時動態回覆、訊息控制、已連接的工具。帳戶須先開啟此設定,應用程式才能管理其私訊。設定關閉時,發送會失敗並返回代碼 200、子代碼 2534041:帳戶擁有者已停用 Instagram 私訊的存取權限。

私人回覆留言如何運作?

專業帳戶可以向在其帖文、Reels 或限時動態留言的人傳送一則訊息,限於留言後 7 天內;若為直播,則只限直播期間。若對方追蹤了帳戶,訊息會出現在其收件匣;若未追蹤,則會出現在訊息請求中,並附有帖文連結。跟進訊息必須等對方回覆後才能傳送,且須在對方回覆後 24 小時內發出。

API 對話在應用程式中會出現在哪裡?

會出現在帳戶一般的 Instagram 收件匣,但有幾點值得留意:

  • 追蹤者的新對話會列於「主要」;未追蹤帳戶的人的新對話則列於「請求」。
  • 透過應用程式回覆的對話,無論收件匣設定如何,都會移至「一般」文件夾。
  • 傳送至應用程式的訊息,在回覆發出前,不會在 Instagram 應用程式中標示為已讀。
  • 30 天沒有任何活動的請求,不再由 API 回傳。

帳戶可以發送得多快?

Meta 按每個 Instagram 專業帳戶設定訊息速率,獨立於應用程式的其他 API 呼叫:

  • 文字、連結、表情回應及貼圖:每秒 100 次呼叫。
  • 音訊或影片:每秒 10 次呼叫。
  • 對帖文及 Reels 留言的私人回覆:每小時 750 次呼叫。
  • Conversations API:每秒 2 次呼叫。

一則訊息可以包含什麼?

文字、連結、圖片、音訊、影片、PDF 檔案、貼圖、表情回應、訊息範本,以及帳戶擁有的帖文。文字須為 UTF-8 編碼,且不得超過 1,000 位元組,一旦包含重音符號或表情符號,可容納的字數便會減少。圖片可為 PNG 或 JPEG,最大 8 MB;音訊、影片及 PDF 檔案最大 25 MB。

常見錯誤

  • 未開啟「允許存取訊息」:發送會失敗並返回代碼 200、子代碼 2534041,直到帳戶在應用程式中將其開啟為止。
  • 以字元數而非位元組計算:重音字母在 UTF-8 中佔兩個位元組,大部分表情符號佔四個,因此通過 1,000 字元檢查的文字仍可能被拒絕。
  • 對同一則留言發送第二則私人回覆:Meta 只允許一則,下一則須等對方回覆後才能傳送。
  • 從對話的首則訊息起計算時段:時段應從對方最新一則訊息起計,因此對方每回覆一次,帳戶便多一段時間。
使用 EasyCoexistence 完成這項設定

自動化功能可用固定文字或 AI 自行回覆,留言轉私訊規則則全天候發送私人回覆。每個連接每月由 US$ 9 降至 US$ 0.75,隨連接增加而遞減,首 3 天免費。

常見問題

企業能否在 Instagram 上發出首則私訊?

不能透過 API。對方必須先傳訊息給帳戶,或在其帖文留言;留言後可在 7 天內收到一則私人回覆。

24 小時過後會怎樣?

API 會拒絕發送,直至對方再次傳訊,從而開啟新的時段。真人撰寫的回覆可使用 Meta 獨立的 7 天 Human Agent 時段,並加上 human_agent 標記。

透過 API 發送的 Instagram 私訊最長可以多長?

每則訊息最多 1,000 位元組的 UTF-8 文字。重音符號和表情符號各佔多於一個位元組,因此含有這些字符的訊息,所能容納的字數會少於 1,000 字。

透過 API 讀取的訊息,在應用程式中會顯示為已讀嗎?

不會。傳送至應用程式的訊息,在 Instagram 收件匣中會保持未讀,直至發出回覆為止。

繼續閱讀

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

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

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

驗證日期