透過 API 讀取 Messenger 對話記錄
專頁的 Messenger 記錄可透過 GET /{page-id}/conversations?platform=messenger 讀取,此端點會列出對話 ID 及其最後更新時間;再以 GET /{conversation-id}?fields=messages 取得訊息 ID,並以 GET /{message-id} 取得每則訊息的發送者、接收者、文字與附件。Meta 只會返回對話中最近 20 則訊息的詳細資料,而呼叫時需要具備 pages_messaging 權限的專頁存取權杖。
easyCoexistence 會在新的 Messenger 訊息到達時,將專頁的訊息轉送至您的端點,而 send_social_dm 會在 24 小時回覆時限內發送回覆,可由 Claude、ChatGPT 或您自己的程式使用。
只有對話中最近 20 則訊息會返回詳細資料;較舊的訊息會返回一則錯誤,指出該訊息已被刪除。
應用程式每個 Facebook 專頁可進行的 Conversations API 呼叫次數。
「請求」資料夾中,未活躍達此時長的對話不會列入 API 結果。
讀取對話時,持有權杖者必須能夠執行的專頁任務。
專頁帳戶的 Messenger API 呼叫次數過多時所返回的錯誤;Meta 建議稍後重試。
如何列出專頁的對話?
使用 GET /{page-id}/conversations,並將 platform 設為 messenger。結果包含 data 陣列,內有對話 ID,每項附有 updated_time(最後一則訊息加入的時間)及 paging 物件。Meta 的參考文件指出,此端點不支援以時間為基礎的分頁,因此請跟隨 paging 物件逐頁瀏覽列表。
GET /{page-id}/conversations?platform=messenger
{
"data": [
{ "id": "<CONVERSATION_ID>", "updated_time": "<TIME>" },
{ "id": "<CONVERSATION_ID>", "updated_time": "<TIME>" }
],
"paging": { ... }
}如何找出單一用戶的對話?
在同一請求中加入 user_id,並設為該用戶的專頁範圍 ID(Page-scoped ID)。Meta 會返回該專頁與此用戶之間的對話 ID。當 messages Webhook 以 sender.id 傳來 PSID 時,這是從 Webhook 查閱背後歷史記錄的最直接途徑:
GET /{page-id}/conversations?platform=messenger&user_id=<PSID>
{ "data": [ { "id": "<CONVERSATION_ID>" } ] }如何讀取對話中的訊息?
分兩步進行。使用 GET /{conversation-id} 並設 fields=messages,會返回對話的訊息 ID,每個附有 created_time,由最新排列至最舊;然後以所需欄位(例如 id、created_time、from、to、message 與 reply_to)呼叫 GET /{message-id},即可返回單則訊息的內容。預設欄位為 id 與 created_time,沒有資料的欄位會從回應中略去。
可以讀取哪些欄位?
對話與訊息所提供的欄位各不相同。以下為 Meta 參考文件所列出,適用於專頁訊息傳遞的欄位:
- 對話:id、
updated_time、participants(包括其 ID、name 與 email)、messages,並在開啟 Conversation Routing 後提供is_owner。 - 訊息:id、
created_time、from 與 to(各含 ID、name 與 email),以及 message,即文字內容,若無文字則為空。 - attachments:檔案、圖片與影片及其 CDN URL;只有當訊息包含不支援的內容時,才會返回
is_unsupported。 - reactions、
reply_to(含所回覆的 mid 及is_self_reply),以及 shares(分享的貼文與 Reels)。 - tags:訊息所屬的資料夾與來源,例如 inbox、read 或 source:chat。
可以讀取多久以前的內容?
就 ID 而言,可以讀取整段對話;但內容方面則不然。Meta 的指南指出,對話端點會返回對話中所有訊息 ID,而詳細資料只會返回最近 20 則訊息;若要求較舊的訊息,會返回訊息已被刪除的錯誤。「請求」資料夾中超過 30 天未有活動的對話,則完全不會返回。
需要哪些權限與任務?
需要來自可執行專頁 MESSAGING 或 MODERATE 任務者的專頁存取權杖,並具備 pages_manage_metadata、pages_read_engagement 及 pages_messaging 權限。若要讀取與應用程式、專頁或業務沒有任何角色的人之對話,則需要 Advanced Access,須經 App Review 由 Meta 授予。
呼叫有哪些限制?
Meta 的速率限制為每個專頁每秒 2 次 Conversations API 呼叫;超出上限的呼叫會返回 613 或 80006,錯誤訊息為「There have been too many messenger api calls to this Page account」。達到 Meta 高流量上限的專頁(例如每秒發送超過 40 則訊息),在流量下降前無法列出對話,不過仍可讀取單一對話的新訊息。
何時應改用 API,而非 Webhook?
用於取得過去的訊息。Webhook 會即時傳送新訊息,而 Meta 指出過去的通知之後無法查詢,因此 Conversations API 是整合用來讀取其開始監聽前的訊息,或在停機後補回資料的途徑。開啟 Conversation Routing 後,is_owner 欄位會把列表縮小至應用程式負責回覆的對話,Meta 建議在停機後以此方式復原。
easyCoexistence 如何讀取 Messenger 記錄?
此功能不讀取歷史記錄。專頁連接時會授予 pages_messaging、pages_manage_metadata 與 pages_read_engagement 權限,但沒有任何工具會呼叫 Conversations API,專頁權杖也不會交出。新訊息會在到達時經由 set_social_webhook_destination 轉送至您的端點,轉送時不保留副本,讓您自己的系統保存所需的歷史記錄。
常見錯誤
- 期望在列表呼叫中取得訊息內容。對話端點只返回訊息 ID;應從 /{message-id} 讀取每則訊息的欄位。
- 依賴完整的歷史記錄。詳細資料只限最近 20 則訊息,因此應在訊息經 Webhook 到達時,儲存所需的資料。
- 輪詢新訊息。每個專頁每秒只允許 2 次呼叫,輪詢迴圈很快便會觸及速率限制;而 messages Webhook 會在訊息發生時即時傳送。
- 以 since 與 until 按日期分頁讀取對話。對話端點不支援以時間為基礎的分頁,請改為跟隨 paging 物件。
它沒有 Conversations API 的工具,因此較早的歷史記錄須在專頁收件箱中閱讀。每個連接每月 US$ 9 至 US$ 0.75,連接越多,費用越低,首 3 天免費。
常見問題
Conversations API 是否包括專頁本身的訊息?
包括。訊息的 from 與 to 欄位會列出用戶或專頁,因此對話中的訊息會同時包括雙方。
無需 App Review 也能讀取 Messenger 對話嗎?
對於在應用程式或專頁中具有角色的人,Standard Access 已足夠。與其他人的對話則需要 Advanced Access,須經 App Review 批准授予。
Conversations API 可以發送回覆嗎?
不可以。Meta 的對話參考文件指出,此端點無法發布;回覆必須透過位於 /{page-id}/messages 的 Send API 發送。
easyCoexistence 會儲存我的 Messenger 對話嗎?
預設不會。轉送事件時不保留副本;開啟自動化後,訊息文字保留 7 天,自動化執行記錄則保留 30 天。
繼續閱讀
兩分鐘內連接您的第一個頻道。
無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。
- 免費試用 3 天
- 隨時取消
- 只用官方 API
- 24/7 監察
驗證日期