Prijavite seZapočnite besplatni probni period
easyCoexistence Zvanični API-ji

Protokol predaje u Messengeru: deljenje Page inboxa između AI agenta i ljudi

Meta je zamenila protokol predaje Messengera sa Conversation Routing, koji zadržava pozive za kontrolu niti: pass_thread_control predaje razgovor drugoj aplikaciji, na primer inboxu stranice sa ID-jem aplikacije 263902037430900, take_thread_control ga preuzima, request_thread_control ga traži, a release_thread_control ga vraća u neaktivno stanje. Kada je routing uključen, aplikacija koja kontroliše nit prima njene poruke, a ostale ih dobijaju na kanalu standby.

easyCoexistence daje vašem AI agentu Messenger razgovore stranice kroz jedan MCP konektor: send_social_dm odgovara unutar 24-satnog prozora, a nove poruke se prosleđuju vašem endpointu čim stignu.

263902037430900

target_app_id koji Meta daje za predaju kontrole nad razgovorom inboxu stranice.

2018300

Podkod pod greškom 10, za poruku koja nije uspela jer razgovor kontroliše druga aplikacija.

24 hours

Ako osoba ne pošalje poruku ovoliko dugo, nit prelazi u neaktivno stanje i tada samo podrazumevana aplikacija može da šalje.

Up to 7 days

Koliko daleko extend_thread_control može da produži kontrolu aplikacije preko vremenskog okvira za odgovor od 24 sata.

Off by default

Preuzmite kontrolu nad razgovorima sa vašim Business AI; dok je isključeno, poslate poruke bez oznake u razgovor Business AI ne uspevaju sa greškom 10, 2018300.

Šta se dogodilo sa protokolom predaje?

Meta ga je uklopila u Conversation Routing. Njeno uputstvo kaže da Meta više ne podržava protokol predaje za Messenger, da su firme prebačene na Conversation Routing i da je routing unazad kompatibilan s većinom poziva protokola predaje, pa se očekuje da pass_thread_control, take_thread_control i webhook messaging_handovers i dalje rade. Promenilo se ko odlučuje: firma u podešavanjima stranice, pod Conversation Routing, postavlja podrazumevanu aplikaciju i pravila usmeravanja.

Ko kontroliše razgovor?

Jedna aplikacija u jednom trenutku, koju Meta naziva vlasnikom niti. Nit je aktivna dok osoba i aplikacija vlasnik razgovaraju, a neaktivna kada osoba nije pisala 24 sata ili je vlasnik oslobodio kontrolu; u neaktivnoj niti samo podrazumevana aplikacija može da šalje, unutar prozora za poruke. Pravila usmeravanja određuju ko preuzima nit:

  • Podrazumevana aplikacija: ona koja odgovara kada nijedna druga nije podešena ili ne odgovara.
  • Društveno usmeravanje: aplikacija koja preuzima kontrolu kada osoba otvori neaktivnu nit ili klikne Get Started.
  • Usmeravanje linkova: aplikacija dodeljena svakom m.me linku.
  • Usmeravanje kampanja: aplikacija izabrana za oglas Click-to-Messenger, koja ima kontrolu nad razgovorom u prozoru za poruke, do 7 dana.

Koji pozivi premeštaju kontrolu između aplikacija?

Svaki je POST zahtev ka edge-u stranice, s recipient postavljenim na PSID osobe, i svaki vraća success true; većina prima i string metadata koji sledeća aplikacija dobija:

  • pass_thread_control: predaje nit aplikaciji iz target_app_id, koja dobija događaj messaging_handovers.
  • release_thread_control: završava kontrolu aplikacije i vraća nit u neaktivno stanje.
  • take_thread_control: čini aplikaciju koja poziva vlasnikom, za aplikacije kojima firma dozvoljava preuzimanje kontrole.
  • request_thread_control: traži kontrolu nad razgovorom.
  • extend_thread_control: zadržava kontrolu posle vremenskog okvira za odgovor od 24 sata, do 7 dana, s trajanjem u sekundama.
  • Send API može da predaje ili oslobađa kontrolu zajedno s samom porukom, preko objekta 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 }

Kako ljudi ulaze u inbox stranice?

Odgovorom. Conversation Routing tretira Meta Business Suite inbox kao još jednu povezanu aplikaciju, koju firma može čak i da postavi kao podrazumevanu; kada neko odgovori tamo u razgovoru koji inbox ne kontroliše, ili ga prebaci u glavnu fasciklu (Main), inbox preuzima kontrolu. Aplikacija predaje razgovor ljudima pozivom pass_thread_control i target_app_id 263902037430900, a aplikacija koja prosleđuje odgovor osobe posle 24-satnog prozora šalje ga uz oznaku HUMAN_AGENT, u roku od 7 dana od poslednje poruke osobe.

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

Šta se dešava kada Business AI kompanije Meta poseduje razgovor?

Ostale aplikacije primaju poruke osobe na kanalu standby i ne bi trebalo da odgovaraju na njih. Metino uputstvo kaže da treba da počnete da odgovarate posle događaja messaging_handovers sa pass_thread_control; obaveštenje messages može da nosi admin_text i handoff_reason, kao što su human_requested ili purchase_intent, ali ne prenosi vlasništvo. Kada je Take control of conversations with your Business AI isključeno, što je podrazumevano, poslata poruka bez oznake u taj razgovor ne uspeva uz kod 10, podkod 2018300.

Kako aplikacija proverava ko poseduje nit?

GET /{page-id}/thread_owner, s recipient postavljenim na PSID, vraća app_id aplikacije vlasnika i kada joj ističe kontrola, vlasniku samom ili podrazumevanoj aplikaciji stranice. Polje is_owner u Conversations API odgovara na isto pitanje po razgovoru kada je routing uključen, a GET /{page-id}?fields=messaging_feature_status pokazuje status Conversation Routing stranice u poljima kao što je msgr_multi_app.

Šta se dešava bez Conversation Routing?

Meta to naziva podrazumevanim ponašanjem, namenjenim stranici s jednom povezanom aplikacijom koja sama prima i odgovara na poruke. Sve povezane aplikacije primaju webhook događaje za poruke i mogu da odgovore na istu poruku, take_thread_control je blokiran dok se ne postavi podrazumevana aplikacija, a dostupno je samo usmeravanje kampanja. Metin savet za ovakvo podešavanje je da se aplikacija i inbox stranice usklade, da niko ne bi dvaput odgovorio na istu poruku.

Šta easyCoexistence radi u zajedničkom inboxu?

Pretplaćuje svaku stranicu na feed, messages i mention, a ne na messaging_handovers, standby ili message_echoes, pa prosleđuje poruke osobe dok njena aplikacija ih prima, i ne vidi ni događaje predaje ni odgovore poslate iz inboxa stranice. send_social_dm šalje RESPONSE bez thread_control, a kada Meta odbije slanje jer druga aplikacija drži razgovor, alat vraća Metin kod 10 i poruku vašem AI-ju. Pozivi za kontrolu niti, thread_owner i is_owner nisu među njegovim alatima.

Česte greške

  • Odgovaranje na standby poruke. Stižu aplikaciji koja ne poseduje nit; sačekajte pass_thread_control pre odgovora.
  • Tumačenje admin_text kao predaje. Obaveštenje messages sa kontekstom predaje ne prenosi vlasništvo; to radi događaj messaging_handovers.
  • Rad AI-ja i inboxa jedno uz drugo bez usmeravanja. Uz podrazumevano ponašanje oboje primaju poruku, a Meta traži koordinaciju da se izbegnu dva odgovora.
  • Zadržavanje niti po završetku toka. Meta preporučuje oslobađanje kontrole čim aplikacija završi, umesto čekanja da istekne vreme za odgovor.
Ovo radite uz EasyCoexistence

Metini pozivi za kontrolu niti nisu među njegovim alatima; osoba preuzima razgovor tako što odgovori u inboxu stranice. Od US$ 9 do US$ 0,75 po vezi mesečno, a cena pada kako dodajete veze, uz prva 3 dana besplatno.

Često postavljana pitanja

Da li dve aplikacije na jednoj stranici treba Conversation Routing?

Meta ga preporučuje kada je povezano više aplikacija za poruke i svaka treba da odgovara na određene razgovore. Uz jednu aplikaciju koja prima i odgovara, podrazumevano ponašanje je dovoljno.

Koliko dugo aplikacija zadržava kontrolu nad razgovorom?

Dok ne oslobodi kontrolu ili nit ne pređe u neaktivno stanje, 24 sata posle poslednje poruke osobe. extend_thread_control dodaje vreme, do 7 dana.

Da li odgovor iz inboxa stranice stiže do drugih aplikacija?

Aplikacije pretplaćene na message_echoes primaju ga kao echo čiji je app_id inboxa stranice, 263902037430900, kako opisuje Metin changelog za Graph API v12.0 i noviji.

Šta se dešava s odgovorima easyCoexistence kada osoba odgovori iz inboxa?

Uz uključen Conversation Routing, inbox preuzima kontrolu, a dok se kontrola ne vrati, poruke osobe stižu aplikaciji easyCoexistence samo na standby kanalu, na koji nije pretplaćena. Bez usmeravanja, obe aplikacije ih i dalje primaju.

Nastavite sa čitanjem

Povežite prvi kanal za dva minuta.

Bez čekanja na odobrenja platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoj AI da objavi, odgovori ili napravi izveštaj, i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo zvanični API-ji
  • Nadzor 24/7

Provereno na