Protokol preuzimanja Messengera: dijeljenje inboxa stranice između AI agenta i ljudi
Protokol preuzimanja za Messenger zamijenjen je funkcijom Conversation Routing, koja zadržava pozive za upravljanje razgovorima: pass_thread_control predaje razgovor drugoj aplikaciji, primjerice inboxu stranice s ID-om aplikacije 263902037430900, take_thread_control ga preuzima, request_thread_control traži njegovo preuzimanje, a release_thread_control ga vraća u mirovanje. Kad je routing uključen, aplikacija koja upravlja razgovorom prima njegove poruke, a ostale ih dobivaju na standby kanalu.
easyCoexistence daje vašem AI agentu razgovore Messengera stranice putem jednog MCP konektora: send_social_dm odgovara unutar 24-satnog prozora, a nove poruke prosljeđuju se vašem endpointu čim stignu.
target_app_id koji Meta dodjeljuje za predaju kontrole nad razgovorom inboxu stranice.
Podkod pod pogreškom 10 za poruku koja nije uspjela jer razgovor kontrolira druga aplikacija.
Ako osoba ne pošalje poruku 24 sata, razgovor prelazi u mirovanje, a tada može slati samo zadana aplikacija.
Koliko daleko extend_thread_control može produljiti kontrolu aplikacije izvan vremenskog okvira za odgovor od 24 sata.
Preuzmite kontrolu nad razgovorima s vašom Business AI; dok je to isključeno, slanje bez oznake u razgovor Business AI ne uspijeva s pogreškom 10, 2018300.
Što se dogodilo s protokolom preuzimanja?
Protokol je ugrađen u Conversation Routing. U vodiču stoji da Meta više ne podržava protokol preuzimanja za Messenger, da su tvrtke prebačene na Conversation Routing i da je routing unatrag kompatibilan s većinom poziva protokola preuzimanja, pa se očekuje da pass_thread_control, take_thread_control i webhook messaging_handovers i dalje rade. Promijenilo se tko odlučuje: tvrtka u postavkama stranice, pod Conversation Routing, određuje zadanu aplikaciju i pravila usmjeravanja.
Tko kontrolira razgovor?
Jedna aplikacija u isto vrijeme, koju Meta naziva vlasnikom razgovora. Razgovor je aktivan dok osoba i vlasnička aplikacija razgovaraju, a prelazi u mirovanje kad osoba 24 sata ništa ne napiše ili vlasnik otpusti kontrolu. U razgovoru u mirovanju samo zadana aplikacija može slati, unutar prozora za slanje poruka. Pravila usmjeravanja odlučuju tko preuzima razgovor:
- Zadana aplikacija: ona koja odgovara kad nijedna druga nije konfigurirana ili ne odgovara.
- Društveno usmjeravanje: aplikacija koja preuzima kontrolu kad osoba otvori neaktivan razgovor ili pritisne Get Started.
- Usmjeravanje putem linka: aplikacija dodijeljena svakom m.me linku.
- Usmjeravanje kampanje: aplikacija odabrana za oglas Click-to-Messenger, koja ima kontrolu nad razgovorom tijekom prozora za poruke, do 7 dana.
Koji pozivi premještaju kontrolu između aplikacija?
Svaki je POST na edge stranice, pri čemu je recipient postavljen na PSID osobe, i svaki vraća success true. Većina također prima niz metapodataka koji sljedeća aplikacija dobiva:
pass_thread_control: predaje razgovor aplikaciji utarget_app_id, koja prima događajmessaging_handovers.release_thread_control: završava kontrolu aplikacije i vraća razgovor u mirovanje.take_thread_control: aplikaciju koja poziva čini vlasnikom, za aplikacije kojima tvrtka dopušta preuzimanje kontrole.request_thread_control: traži kontrolu nad razgovorom.extend_thread_control: zadržava kontrolu nakon vremenskog okvira za odgovor od 24 sata, do 7 dana, pri čemu je trajanje u sekundama.- Send API može predati ili otpustiti kontrolu zajedno s porukom, putem objekta
thread_control.
POST /{page-id}/pass_thread_control
?recipient={id:<PSID>}
&target_app_id=263902037430900
&metadata=Customer asked for a person
{ "success": true }Kako se ljudi uključuju u inbox stranice?
Odgovaranjem. Conversation Routing tretira Meta Business Suite inbox kao još jednu povezanu aplikaciju, koju tvrtka može čak postaviti kao zadanu. Kad netko u njemu odgovori u razgovoru koji inbox ne kontrolira ili ga premjesti u mapu Main, inbox preuzima kontrolu. Aplikacija predaje razgovor ljudima pomoću pass_thread_control i target_app_id 263902037430900, a aplikacija koja prosljeđuje odgovor osobe nakon 24-satnog prozora šalje ga s oznakom HUMAN_AGENT, unutar 7 dana od posljednje poruke osobe.
Što se događa kad Business AI tvrtke posjeduje razgovor?
Ostale aplikacije primaju poruke osobe na standby kanalu i ne bi im trebale odgovarati. U vodiču stoji da treba početi odgovarati nakon događaja messaging_handovers s pass_thread_control. Obavijest messages može sadržavati admin_text i handoff_reason, poput human_requested ili purchase_intent, ali ne prenosi vlasništvo. Uz isključenu opciju Take control of conversations with your Business AI, koja je zadana, slanje bez oznake u taj razgovor ne uspijeva s kodom 10, podkodom 2018300.
Kako aplikacija provjerava tko posjeduje razgovor?
GET /{page-id}/thread_owner s recipient postavljenim na PSID vraća app_id vlasničke aplikacije i trenutak kad joj kontrola istječe, i to vlasniku ili zadanoj aplikaciji stranice. Polje is_owner u Conversations API odgovara na isto pitanje za svaki razgovor kad je routing uključen, a GET /{page-id}?fields=messaging_feature_status pokazuje status Conversation Routing stranice u poljima poput msgr_multi_app.
Što se događa bez Conversation Routing?
Meta to naziva zadanim ponašanjem, namijenjenim stranici s jednom povezanom aplikacijom koja sama prima i odgovara na poruke. Sve povezane aplikacije primaju webhookove za poruke i mogu odgovoriti na istu poruku. take_thread_control je blokiran dok se ne postavi zadana aplikacija, a dostupno je samo usmjeravanje kampanje. Savjet tvrtke Meta za ovu postavu jest da se aplikacija i inbox stranice usklade kako nitko ne bi dvaput odgovorio na istu poruku.
Što easyCoexistence radi u zajedničkom inboxu?
Svaku stranicu pretplaćuje na feed, messages i mention, a ne na messaging_handovers, standby ili message_echoes. Tako prosljeđuje poruke osobe dok njegova aplikacija ih prima, ali ne vidi ni događaje preuzimanja ni odgovore poslane iz inboxa stranice. send_social_dm šalje RESPONSE bez thread_control. Kad Meta odbije slanje jer drugu aplikaciju drži razgovor, alat vašem AI agentu vraća kôd 10 i poruku tvrtke Meta. Pozivi za upravljanje kontrolom, thread_owner i is_owner nisu među njegovim alatima.
Uobičajene pogreške
- Odgovaranje na poruke u standby kanalu. Stižu aplikaciji koja ne posjeduje razgovor, pa pričekajte pass_thread_control prije odgovora.
- Čitanje admin_text kao predaje. Obavijest messages s kontekstom predaje ne prenosi vlasništvo; to čini događaj messaging_handovers.
- Pokretanje AI agenta i inboxa jedno uz drugo bez usmjeravanja. Uz zadano ponašanje obje aplikacije primaju poruku, a Meta traži usklađivanje kako bi se izbjegla dva odgovora.
- Zadržavanje razgovora nakon završetka toka. Meta preporučuje otpuštanje kontrole čim aplikacija završi, umjesto čekanja da istekne vrijeme za odgovor.
Metini pozivi za upravljanje kontrolom nisu među njegovim alatima; osoba preuzima razgovor odgovorom u inboxu stranice. Od US$ 9 do US$ 0,75 po vezi mjesečno, uz sniženje kako dodajete veze, a prva 3 dana su besplatna.
Često postavljana pitanja
Trebaju li dvije aplikacije na istoj stranici Conversation Routing?
Meta ga preporučuje kad je povezano više aplikacija za razmjenu poruka i kad svaka treba odgovarati na određene razgovore. Uz jednu aplikaciju koja prima i odgovara, dovoljno je zadano ponašanje.
Koliko dugo aplikacija zadržava kontrolu nad razgovorom?
Dok ne otpusti kontrolu ili razgovor ne pređe u mirovanje, 24 sata nakon posljednje poruke osobe. extend_thread_control dodaje vrijeme, do 7 dana.
Dolazi li odgovor iz inboxa stranice do ostalih aplikacija?
Aplikacije pretplaćene na message_echoes primaju ga kao echo čiji je app_id inboxa stranice, 263902037430900, kako to opisuje changelog Meta za Graph API v12.0 i novije.
Što se događa s odgovorima easyCoexistence kad osoba odgovori iz inboxa?
Uz uključen Conversation Routing inbox preuzima kontrolu. Dok kontrola ne bude vraćena, poruke osobe stižu aplikaciji easyCoexistence samo na standby kanalu, na koji se ona ne pretplaćuje. Bez usmjeravanja obje aplikacije i dalje ih primaju.
Nastavite čitati
Povežite svoj prvi kanal u dvije minute.
Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo službeni API-ji
- Nadzor 24/7
Provjereno na