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

Messenger 轉交協議:在 AI 代理與真人之間共用專頁收件箱

Meta 以 Conversation Routing 取代 Messenger 轉交協議,但保留其對話控制呼叫:pass_thread_control 將對話交予另一個應用程式,例如應用程式 ID 為 263902037430900 的專頁收件箱;take_thread_control 認領對話;request_thread_control 請求控制權;release_thread_control 將對話交還,使其回到閒置狀態。啟用路由後,控制對話的應用程式會收到其訊息,其他應用程式則透過 standby 頻道接收。

easyCoexistence 透過一個 MCP 連接器,讓你的 AI 代理取得專頁的 Messenger 對話:send_social_dm 會在 24 小時時限內回覆;新訊息抵達時會轉發至你的端點。

263902037430900

Meta 用於將對話控制權交予專頁收件箱的 target_app_id。

2018300

錯誤 10 之下的子代碼,表示訊息因對話已由另一應用程式控制而發送失敗。

24 hours

若對方在這段時間內沒有發出訊息,對話便會進入閒置狀態,之後只有預設應用程式可以發送訊息。

Up to 7 days

extend_thread_control 最多可將應用程式的控制權延長至超出 24 小時回應時限的時長。

Off by default

接管你的 Business AI 對話;關閉時,未加標籤直接發送至 Business AI 對話的訊息會以錯誤 10,子代碼 2018300 失敗。

轉交協議發生了什麼變化?

Meta 已將其併入 Conversation Routing。其指南表示,Meta 不再支援 Messenger 的轉交協議,業務已遷移至 Conversation Routing,且路由功能大致向後兼容轉交協議呼叫,因此 pass_thread_control、take_thread_control 及 messaging_handovers Webhook 預計仍可正常運作。改變的是決策權:業務需在專頁設定的 Conversation Routing 中,設定預設應用程式及路由規則。

誰控制對話?

同一時間只有一個應用程式,Meta 稱之為對話擁有者(thread owner)。當對方與擁有者應用程式互動時,對話為活躍狀態;若對方 24 小時未發出訊息,或擁有者已釋放控制權,對話便會進入閒置狀態。閒置對話中,只有預設應用程式可在訊息時限內發送訊息。路由規則決定由誰接管對話:

  • 預設應用程式:在未設定其他應用程式,或其他應用程式沒有回應時接手的應用程式。
  • 社交路由:當對方開啟閒置對話或點擊 Get Started 按鈕時取得控制權的應用程式。
  • 連結路由:指派給每個 m.me 連結的應用程式。
  • 廣告路由:為點擊式 Messenger 廣告指定的應用程式,在該對話的訊息時限內(最長 7 天)持有控制權。

哪些呼叫可以在應用程式之間轉移控制權?

每個呼叫都是向專頁的邊緣節點發出的 POST 請求,recipient 設為對方的 PSID,且每個呼叫都會回傳 success true;大多數呼叫還可帶入一個 metadata 字串,由下一個應用程式接收:

  • pass_thread_control:將對話交予 target_app_id 所指的應用程式,該應用程式會收到 messaging_handovers 事件。
  • release_thread_control:結束應用程式的控制權,並使對話回到閒置狀態。
  • take_thread_control:讓發出呼叫的應用程式成為擁有者,適用於業務允許接管控制權的應用程式。
  • request_thread_control:請求取得對話的控制權。
  • extend_thread_control:將控制權延長至超出 24 小時回應時限,最長 7 天,時長以秒為單位。
  • Send API 可透過 thread_control 物件,隨訊息本身轉交或釋放控制權。
Handing a conversation to the Page Inbox
POST /{page-id}/pass_thread_control
  ?recipient={id:<PSID>}
  &target_app_id=263902037430900
  &metadata=Customer asked for a person

{ "success": true }

真人如何在專頁收件箱介入?

透過直接回覆。Conversation Routing 將 Meta Business Suite 收件箱視為另一個已連接的應用程式,業務甚至可將其設為預設。當有人在收件箱中回覆一個並非由收件箱控制的對話,或將其移至主要資料夾時,收件箱即取得控制權。應用程式可使用 pass_thread_control,並將 target_app_id 設為 263902037430900,把對話交予真人;而在 24 小時時限之後轉發對方回覆的應用程式,須以 HUMAN_AGENT 標籤發送,且必須在對方最後一則訊息後 7 天內。

1AI agentThe app that owns the thread replies to the person
2Hand overpass_thread_control to 263902037430900
3Page inboxPeople answer; a reply there also takes control
4IdleReleased, or 24 hours without a message from the person

當 Meta 的 Business AI 擁有對話時會怎樣?

其他應用程式會透過 standby 頻道接收對方的訊息,且不應回覆。Meta 指南建議,應在收到 pass_thread_control 的 messaging_handovers 事件後才開始回應;messages 通知可能附帶 admin_text 及 handoff_reason(例如 human_requested 或 purchase_intent),但它不會轉移擁有權。在預設的「接管你的 Business AI 對話」關閉狀態下,發送至該對話且未加標籤的訊息,會以錯誤代碼 10、子代碼 2018300 失敗。

應用程式如何查詢對話的擁有者?

以 recipient 設為 PSID 呼叫 GET /{page-id}/thread_owner,會回傳擁有者應用程式的 app_id 及其控制權到期時間,回傳對象為擁有者本身,或專頁的預設應用程式。啟用路由後,Conversations API 的 is_owner 欄位會按每個對話回答相同問題;而 GET /{page-id}?fields=messaging_feature_status 會以 msgr_multi_app 等欄位,顯示專頁的 Conversation Routing 狀態。

沒有 Conversation Routing 會怎樣?

Meta 稱之為預設行為,適用於只有一個已連接應用程式,並會自行接收及回覆訊息的專頁。所有已連接應用程式都會收到訊息 Webhook,且都可以回覆同一則訊息;在設定預設應用程式之前,take_thread_control 會被封鎖,且只提供廣告路由。Meta 對此設定的建議是協調應用程式與專頁收件箱,以免有人重複回覆同一則訊息。

easyCoexistence 在共用收件箱中做什麼?

它會為每個專頁訂閱 feed、messages 及 mention,而非 messaging_handovers、standby 或 message_echoes。因此,在其應用程式接收對方訊息時,它會將訊息轉發,但看不到轉交事件,也看不到從專頁收件箱發出的回覆。send_social_dm 會在沒有 thread_control 的情況下發送 RESPONSE;當 Meta 因對話已由另一應用程式持有而拒絕發送時,該工具會將 Meta 的錯誤代碼 10 及訊息回傳給你的 AI。轉交控制權的各項呼叫、thread_owner 及 is_owner 不在其工具之列。

常見錯誤

  • 回覆 standby 訊息。這些訊息會送達不擁有該對話的應用程式,應等待 pass_thread_control 後再回覆。
  • 將 admin_text 誤認為轉交。附帶轉交內容的 messages 通知並不會轉移擁有權,只有 messaging_handovers 事件才會。
  • 在沒有路由的情況下同時運行 AI 與收件箱。在預設行為下兩者都會收到訊息,而 Meta 要求協調以避免兩次回覆。
  • 流程結束後仍持有對話。Meta 建議應用程式完成工作後立即釋放控制權,而非等待回應時限到期。
使用 EasyCoexistence 完成這項設定

Meta 的對話控制呼叫不在其工具之列;對話由真人在專頁收件箱中回覆來接手。每個連接每月 US$ 9 至 US$ 0.75,連接越多,費用越低,首 3 天免費。

常見問題

同一專頁上的兩個應用程式需要 Conversation Routing 嗎?

當多個訊息應用程式已連接,且各自應回覆特定對話時,Meta 建議使用。若只有一個應用程式負責接收及回覆,預設行為已經足夠。

應用程式會持續控制一段對話多久?

直至其釋放控制權,或對話進入閒置狀態為止,即對方最後一則訊息後 24 小時。extend_thread_control 可增加時間,最長 7 天。

專頁收件箱的回覆會傳送給其他應用程式嗎?

訂閱 message_echoes 的應用程式會以 echo 形式收到該回覆,其 app_id 為專頁收件箱的 263902037430900,如 Meta 的更新紀錄所述,適用於 Graph API v12.0 及之後版本。

當對方從收件箱回覆時,easyCoexistence 的回覆會怎樣?

啟用 Conversation Routing 後,收件箱會取得控制權;在控制權歸還之前,對方的訊息只會以 standby 形式送達 easyCoexistence 的應用程式,而該應用程式並未訂閱此項。沒有路由時,兩者都會繼續接收訊息。

繼續閱讀

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

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

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

驗證日期