Mag-log inMagsimula ng Libreng Trial
easyCoexistence Mga Official API

Messenger handover protocol: pagbabahagi ng inbox ng Page sa AI agent at sa mga tao

Pinalitan ng Meta ang Messenger handover protocol ng Conversation Routing, na pinapanatili ang mga thread control call nito: ang pass_thread_control ay naglilipat ng usapan sa ibang app, gaya ng Page inbox na may app ID 263902037430900; kinukuha ito ng take_thread_control, hinihiling ito ng request_thread_control, at ibinabalik sa idle ang usapan ng release_thread_control. Kapag naka-on ang routing, ang app na may kontrol sa thread ang tumatanggap ng mga mensahe; ang iba ay nakakatanggap nito sa standby channel.

Binibigyan ng easyCoexistence ng mga usapan sa Messenger ng Page ang iyong AI agent sa pamamagitan ng isang MCP connector: ang send_social_dm ay sumasagot sa loob ng 24-hour window at ang mga bagong mensahe ay ipinapasa sa iyong endpoint habang dumarating.

263902037430900

Ang target_app_id na ibinibigay ng Meta para ilipat ang kontrol ng usapan sa Page Inbox.

2018300

Subcode sa ilalim ng error 10, para sa mensaheng pumalya dahil may ibang app na may kontrol sa usapan.

24 hours

Kapag walang mensahe mula sa tao sa ganitong tagal, ang thread ay nagiging idle, at tanging ang default app na lang ang makapagpapadala.

Up to 7 days

Gaano kalayo mapapahaba ng extend_thread_control ang kontrol ng app lampas sa 24-hour response time frame.

Off by default

Kontrolin ang mga usapan gamit ang iyong Business AI; kapag naka-off, mabibigo ang mga untagged send sa usapan ng Business AI na may error 10, subcode 2018300.

Ano ang nangyari sa handover protocol?

Isinama ito ng Meta sa Conversation Routing. Sinasabi ng gabay nito na hindi na sinusuportahan ng Meta ang handover protocol para sa Messenger, na inilipat na ang mga negosyo sa Conversation Routing, at na ang routing ay backwards compatible sa karamihan ng handover protocol call, kaya inaasahang patuloy na gagana ang pass_thread_control, take_thread_control, at ang messaging_handovers webhook. Ang nagbago ay kung sino ang nagpapasya: itinatakda ng negosyo ang default app at mga routing rule sa Page settings, sa ilalim ng Conversation Routing.

Sino ang may kontrol sa usapan?

Isang app sa bawat pagkakataon, na tinatawag ng Meta na thread owner. Aktibo ang thread habang nag-uusap ang tao at ang app na may-ari, at idle kapag hindi pa sumusulat ang tao sa loob ng 24 na oras o binitawan na ng may-ari ang kontrol; sa idle na thread, tanging ang default app ang makapagpapadala, sa loob ng 24-hour window. Tinutukoy ng routing rules kung sino ang kukuha ng thread:

  • Default app: ang sumasagot kapag walang ibang app na naka-configure o sumasagot.
  • Social routing: ang app na kukuha ng kontrol kapag binuksan ng tao ang idle na thread o pinindot ang Get Started.
  • Link routing: app na itinalaga sa bawat m.me link.
  • Campaign routing: ang app na pinili para sa Click-to-Messenger ad, na may kontrol sa usapang iyon sa loob ng 24-hour window, hanggang 7 araw.

Aling mga call ang naglilipat ng kontrol sa pagitan ng mga app?

Bawat isa ay POST sa edge ng Page na may recipient na PSID ng tao, at bawat isa ay sumasagot ng success true; karamihan ay tumatanggap din ng metadata string na matatanggap ng susunod na app:

  • pass_thread_control: ililipat ang thread sa app sa target_app_id, na tatanggap ng messaging_handovers event.
  • release_thread_control: tinatapos ang kontrol ng app at ibinabalik ang thread sa idle.
  • take_thread_control: ginagawang owner ang tumatawag na app, para sa mga app na pinapayagan ng negosyo na kumuha ng kontrol.
  • request_thread_control: humihiling ng kontrol sa usapan.
  • extend_thread_control: pinananatili ang kontrol lampas sa 24-hour response time frame, hanggang 7 araw, na ang duration ay nasa segundo.
  • Maaaring ipasa o bitawan ng Send API ang kontrol kasama ang mismong mensahe, sa pamamagitan ng thread_control object.
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 }

Paano pumapasok ang mga tao sa Page inbox?

Sa pamamagitan ng pagsagot. Itinuturing ng Conversation Routing ang Meta Business Suite inbox bilang isa pang konektadong app, na maaari pang gawing default ng negosyo; kapag may sumagot doon sa usapang hindi kontrolado ng inbox, o inilipat ito sa Main folder, kukunin ng inbox ang kontrol. Inililipat ng isang app ang usapan sa mga tao gamit ang pass_thread_control at target_app_id 263902037430900, at ang app na nagpapasa ng sagot ng tao pagkatapos ng 24-hour window ay nagpapadala nito gamit ang HUMAN_AGENT tag, sa loob ng 7 araw mula sa huling mensahe ng tao.

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

Ano ang nangyayari kapag ang Business AI ng Meta ang may-ari ng usapan?

Tumatanggap ang ibang app ng mga mensahe ng tao sa standby channel at hindi dapat sumagot sa mga ito. Sinasabi ng gabay ng Meta na magsimulang sumagot pagkatapos ng messaging_handovers event na may pass_thread_control; maaaring may dalang admin_text at handoff_reason gaya ng human_requested o purchase_intent ang notification ng messages webhook, pero hindi nito inililipat ang pagmamay-ari. Kapag naka-off ang Take control of conversations with your Business AI, na default, nabibigo ang untagged send sa usapang iyon na may code 10, subcode 2018300.

Paano tinitingnan ng app kung sino ang may-ari ng thread?

Ibinabalik ng GET /{page-id}/thread_owner na may recipient na PSID ang app_id ng app na may-ari at kung kailan mag-e-expire ang kontrol nito, sa may-ari mismo o sa default app ng Page. Ang field na is_owner ng Conversations API ang sumasagot sa parehong tanong kada usapan kapag naka-on na ang routing, at ipinapakita ng GET /{page-id}?fields=messaging_feature_status ang status ng Conversation Routing ng Page sa mga field gaya ng msgr_multi_app.

Ano ang mangyayari kapag walang Conversation Routing?

Tinatawag ito ng Meta na default behavior, para sa Page na may isang konektadong app na tumatanggap at sumasagot ng mga mensahe nang mag-isa. Tumatanggap ng messaging webhook ang lahat ng konektadong app at maaaring sumagot sa iisang mensahe; hindi magagamit ang take_thread_control hangga't walang default app na naitakda, at tanging ang campaign routing lang ang available. Ang payo ng Meta para sa setup na ito ay i-coordinate ang app at ang Page inbox upang walang sumagot sa iisang mensahe nang dalawang beses.

Ano ang ginagawa ng easyCoexistence sa shared inbox?

Nagsa-subscribe ito sa bawat Page sa feed, messages, at mention, hindi sa messaging_handovers, standby, o message_echoes, kaya naipapasa nito ang mga mensahe ng tao habang tinatanggap ng app nito ang mga iyon, at hindi nito nakikita ang handover event o mga sagot na ipinadala mula sa Page inbox. Ang send_social_dm ay nagpapadala ng RESPONSE nang walang thread_control, at kapag tinanggihan ng Meta ang send dahil may ibang app na may hawak ng usapan, ibinabalik ng tool sa iyong AI ang code 10 at mensahe ng Meta. Hindi kabilang sa mga tool nito ang mga thread control call, thread_owner, at is_owner.

Mga karaniwang pagkakamali

  • Pagsagot sa standby na mga mensahe. Umaabot ang mga ito sa app na hindi nagmamay-ari ng thread; hintayin ang pass_thread_control bago sumagot.
  • Pagbasa sa admin_text bilang handover. Ang notification ng messages na may handoff context ay hindi naglilipat ng pagmamay-ari; ang messaging_handovers event ang gumagawa nito.
  • Pagpapatakbo ng AI at ng inbox nang magkatabi nang walang routing. Sa default behavior, parehong tumatanggap ng mensahe, at humihiling ang Meta ng coordination upang maiwasan ang dalawang sagot.
  • Pagpigil ng thread pagkatapos matapos ang flow. Inirerekomenda ng Meta na bitawan agad ang kontrol kapag tapos na ang app, sa halip na hintayin mag-expire ang response time.
Ginagawa ito gamit ang EasyCoexistence

Hindi kabilang sa mga tool nito ang mga thread control call ng Meta; kinukuha ng isang tao ang usapan sa pamamagitan ng pagsagot sa Page inbox. US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang dumarami ang koneksyon, na may free trial sa unang 3 araw.

Mga madalas itanong

Kailangan ba ng Conversation Routing ang dalawang app sa iisang Page?

Inirerekomenda ito ng Meta kapag maraming messaging app ang konektado at dapat sumagot ang bawat isa sa ilang usapan. Kapag iisang app lang ang tumatanggap at sumasagot, sapat na ang default behavior.

Gaano katagal nananatili sa isang app ang kontrol ng usapan?

Hanggang bitawan ito ng app o maging idle ang thread, 24 na oras matapos ang huling mensahe ng tao. Nagdadagdag ng oras ang extend_thread_control, hanggang 7 araw.

Umaabot ba sa ibang app ang sagot mula sa Page inbox?

Oo, tinatanggap ito ng mga app na naka-subscribe sa message_echoes bilang echo na ang app_id ay ang Page inbox, 263902037430900, ayon sa changelog ng Meta para sa Graph API v12.0 pataas.

Ano ang mangyayari sa mga sagot ng easyCoexistence kapag sumagot ang tao mula sa inbox?

Kapag naka-on ang Conversation Routing, kinukuha ng inbox ang kontrol, at hanggang maibalik ang kontrol, ang mga mensahe ng tao ay umaabot lang sa app ng easyCoexistence sa standby, na hindi ito naka-subscribe. Kapag walang routing, parehong patuloy na tumatanggap ng mga ito ang dalawa.

Magpatuloy sa pagbabasa

I-connect ang inyong unang channel sa loob ng dalawang minuto.

Walang review ng platform na hihintayin. I-connect ang WhatsApp, Instagram, TikTok o iba pang channel, pagkatapos ay utusan ang inyong AI na mag-post, mag-reply o gumawa ng report, at panoorin itong gumana.

  • 3 araw na libre
  • Mag-cancel anumang oras
  • Official API lang
  • Minomonitor 24/7

Na-verify noong