透過 API 的 Instagram 私訊與 24 小時訊息時段
透過 Instagram 的 API,專業帳戶可以回覆任何曾傳私訊給它的人,而大部分對話的標準訊息時段為 24 小時。對方必須先發出訊息,而且帳戶須先在 Instagram 應用程式中開啟「允許存取訊息」,應用程式才可讀取或發送其私訊。
easyCoexistence 讓 Claude、ChatGPT 或你自己的程式碼透過 send_social_dm 回覆 Instagram 私訊,並在 24 小時訊息時段內發送;新私訊到達時,會轉發至你的端點。
大部分用戶操作適用的標準時段,用於回覆用戶的訊息。
Meta 獨立的 Human Agent 時段,適用於真人撰寫並標記 human_agent 的回覆。
一則私訊透過 API 可載入的最多文字量,以 UTF-8 編碼計算。
錯誤代碼 10 之下的錯誤子代碼,表示訊息在允許時段以外發送。
對話在「請求」文件夾中閒置達到一定時間後,便不再由 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 只允許一則,下一則須等對方回覆後才能傳送。
- 從對話的首則訊息起計算時段:時段應從對方最新一則訊息起計,因此對方每回覆一次,帳戶便多一段時間。
自動化功能可用固定文字或 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 監察
驗證日期