跳转到主要内容
GET
取得訊息平台上的訊息或對話。 各社群網路的擷取時效不同。在 Facebook 與 Instagram 上,訊息可透過 Ayrshare 即時取得。在 X/Twitter 上,看到新訊息更新最多會有 3 分鐘的延遲。若您需要 X/Twitter 訊息的即時存取,請聯絡我們了解 Enterprise Plan 的更多資訊。
回應快取: GET 訊息的回應會被快取以最佳化效能。FacebookInstagram 的回應會快取 60 秒X/Twitter 的回應會快取 15 秒,以便更好地支援輪詢 (polling)。回應中的 lastUpdatednextUpdate 欄位會指出資料最後擷取的時間,以及下次可以取得新資料的時間。
Facebook 與 Instagram 的初始訊息歷程擷取上限為 最後 20 則訊息。詳細資訊請參閱 Facebook 與 Instagram 的訊息歷程擷取章節。

標頭參數

路徑參數

platform
string
必填
用來取得訊息的平台:facebookinstagramtwitter

查詢參數

status
string
默认值:"active"
必填
回傳活躍或已封存的對話。值:activearchived
conversationId
string
只回傳特定對話。
conversationsOnly
boolean
默认值:false
回傳所有對話。若為 true,則忽略 conversationId 欄位。
limit
integer
僅 X/Twitter。 限制每次請求回傳的訊息數 (1–100)。可有效輪詢而不需完整同步歷史資料。與 next 搭配使用以進行分頁。若省略,則使用預設行為(完整訊息擷取)。
next
string
僅 X/Twitter。 從前一次請求 meta.pagination.next 欄位取得的加密分頁游標。與 limit 搭配使用以擷取下一頁結果。