Messenger-luovutusprotokolla: Facebook-sivun Inboxin jakaminen tekoälyagentin ja ihmisten kesken
Meta korvasi Messenger-luovutusprotokollan Conversation Routingilla, joka säilyttää keskustelun hallintakutsut. pass_thread_control siirtää keskustelun toiselle sovellukselle, kuten sivun Inboxille sovelluksen tunnuksella 263902037430900, take_thread_control ottaa sen haltuunsa, request_thread_control pyytää sitä ja release_thread_control palauttaa sen lepotilaan. Kun reititys on päällä, keskustelun hallitseva sovellus saa sen viestit ja muut saavat ne standby-kanavalla.
easyCoexistence antaa tekoälyagentillesi Facebook-sivun Messenger-keskustelut yhden MCP-liittimen kautta: send_social_dm vastaa 24 tunnin ikkunan sisällä ja uudet viestit välitetään päätepisteeseesi niiden saapuessa.
target_app_id, jonka Meta antaa keskustelun hallinnan siirtämiseksi sivun Inboxille.
Alikoodi virheelle 10: viesti epäonnistui, koska toinen sovellus hallitsee keskustelua.
Jos henkilöltä ei tule viestiä tämän ajan kuluessa, keskustelu siirtyy lepotilaan, ja vain oletussovellus voi silloin lähettää.
Kuinka pitkälle extend_thread_control voi venyttää sovelluksen hallintaa 24 tunnin vastausajan ylitse.
Ota hallintaan keskustelut Business AI:llesi; kun asetus on pois päältä, merkitsemättömät lähetykset Business AI -keskusteluun epäonnistuvat koodilla 10, 2018300.
Mitä luovutusprotokollalle tapahtui?
Meta yhdisti sen Conversation Routingiin. Oppaan mukaan Meta ei enää tue luovutusprotokollaa Messengerille, yritykset on siirretty Conversation Routingiin, ja reititys on taaksepäin yhteensopiva useimpien luovutusprotokollan kutsujen kanssa. Siksi pass_thread_control, take_thread_control ja messaging_handovers-webhook oletetaan toimivan edelleen. Muuttunut on päätöksentekijä: yritys asettaa oletussovelluksen ja reitityssäännöt Facebook-sivun asetuksissa kohdassa Conversation Routing.
Kuka hallitsee keskustelua?
Kerrallaan yksi sovellus, jota Meta kutsuu keskustelun omistajaksi. Keskustelu on aktiivinen, kun henkilö ja omistajasovellus keskustelevat, ja lepotilassa, kun henkilö ei ole kirjoittanut 24 tuntiin tai omistaja on vapauttanut hallinnan. Lepotilassa vain oletussovellus voi lähettää viestejä viestintäikkunan sisällä. Reitityssäännöt päättävät, kuka ottaa keskustelun:
- Oletussovellus: se, joka vastaa, kun muuta sovellusta ei ole määritetty tai se ei vastaa.
- Sosiaalinen reititys: sovellus, joka ottaa hallinnan, kun henkilö avaa lepotilassa olevan keskustelun tai napauttaa Get Started -painiketta.
- Linkkireititys: jokaiselle m.me-linkille määritetty sovellus.
- Kampanjareititys: Click-to-Messenger -mainokseen valittu sovellus, joka hallitsee keskustelua kyseisen viestintäikkunan ajan, enintään 7 päivää.
Mitkä kutsut siirtävät hallintaa sovellusten välillä?
Jokainen on POST-kutsu sivun edge-kohteeseen, jonka recipient on henkilön PSID, ja jokainen vastaa success true. Useimmat ottavat myös metadata-merkkijonon, jonka seuraava sovellus vastaanottaa:
pass_thread_control: siirtää keskustelun sovellukselletarget_app_id:n mukaan, joka vastaanottaamessaging_handovers-tapahtuman.release_thread_control: lopettaa sovelluksen hallinnan ja palauttaa keskustelun lepotilaan.take_thread_control: tekee kutsuvasta sovelluksesta omistajan sovelluksille, joille yritys sallii hallinnan ottamisen.request_thread_control: pyytää hallintaa keskustelussa.extend_thread_control: pitää hallinnan yli 24 tunnin vastausajan, enintään 7 päivää; kesto sekunteina.- Send API voi siirtää tai vapauttaa hallinnan itse viestin mukana
thread_control-objektin kautta.
POST /{page-id}/pass_thread_control
?recipient={id:<PSID>}
&target_app_id=263902037430900
&metadata=Customer asked for a person
{ "success": true }Miten ihmiset astuvat mukaan sivun Inboxissa?
Vastaamalla. Conversation Routing käsittelee Meta Business Suite -Inboxia yhtenä lisäsovelluksena, jonka yritys voi jopa asettaa oletukseksi. Kun joku vastaa siellä keskustelussa, jota Inbox ei hallitse, tai siirtää sen Main-kansioon, Inbox ottaa hallinnan. Sovellus luovuttaa keskustelun ihmisille pass_thread_control-kutsulla ja target_app_id-arvolla 263902037430900. Sovellus, joka välittää henkilön vastauksen 24 tunnin ikkunan jälkeen, lähettää sen HUMAN_AGENT-tagilla, enintään 7 päivän kuluessa henkilön viimeisimmästä viestistä.
Mitä tapahtuu, kun Metan Business AI omistaa keskustelun?
Muut sovellukset saavat henkilön viestit standby-kanavalla eivätkä saa vastata niihin. Metan oppaan mukaan vastaaminen alkaa messaging_handovers-tapahtuman ja pass_thread_control-kutsun jälkeen. messages-ilmoitus voi sisältää admin_textin ja handoff_reason-kentän, kuten human_requested tai purchase_intent, mutta se ei siirrä omistajuutta. Kun ”Take control of conversations with your Business AI” on pois päältä, oletusarvo, merkitsemätön lähetys kyseiseen keskusteluun epäonnistuu koodilla 10, alikoodilla 2018300.
Miten sovellus tarkistaa, kuka omistaa keskustelun?
GET /{page-id}/thread_owner, jonka recipient on PSID, palauttaa omistavan sovelluksen app_id:n ja sen hallinnan päättymisajan omistajalle itselleen tai sivun oletussovellukselle. Conversations API:n is_owner-kenttä vastaa samaan kysymykseen keskustelu kerrallaan, kun reititys on päällä. GET /{page-id}?fields=messaging_feature_status näyttää sivun Conversation Routingin tilan kentissä, kuten msgr_multi_app.
Mitä tapahtuu ilman Conversation Routingia?
Meta kutsuu sitä oletuskäyttäytymiseksi. Se on tarkoitettu sivulle, jossa on yksi yhdistetty sovellus, joka vastaanottaa ja vastaa viesteihin itse. Kaikki yhdistetyt sovellukset saavat messaging-webhookit ja voivat vastata samaan viestiin, take_thread_control on estetty, kunnes oletussovellus on asetettu, ja vain kampanjareititys on käytettävissä. Metan neuvo tähän asetukseen on koordinoida sovellus ja sivun Inbox, jotta kukaan ei vastaa samaan viestiin kahdesti.
Mitä easyCoexistence tekee jaetussa Inboxissa?
Se tilaa jokaisen sivun feed-, messages- ja mention-tapahtumiin, ei messaging_handovers-, standby- tai message_echoes-tapahtumiin. Näin se välittää henkilön viestit, kun sen sovellus vastaanottaa ne, eikä se näe luovutustapahtumia eikä sivun Inboxista lähetettyjä vastauksia. send_social_dm lähettää RESPONSE-viestin ilman thread_control-kenttää. Kun Meta hylkää lähetyksen, koska toinen sovellus hallitsee keskustelua, työkalu palauttaa tekoälyllesi Metan koodin 10 ja viestin. thread_control-kutsut, thread_owner ja is_owner eivät kuulu sen työkaluihin.
Yleiset virheet
- Standby-viestien vastaaminen. Ne menevät sovellukseen, joka ei omista keskustelua. Odota pass_thread_control-kutsua ennen vastaamista.
- admin_textin lukeminen luovutukseksi. messages-ilmoitus, jossa on luovutuksen konteksti, ei siirrä omistajuutta; sen tekee messaging_handovers-tapahtuma.
- Tekoälyn ja Inboxin käyttö rinnakkain ilman reititystä. Oletuskäyttäytymisessä molemmat saavat viestin, ja Meta pyytää koordinointia, jotta vastauksia ei tule kahta.
- Keskustelun pitäminen hallussa prosessin päätyttyä. Meta suosittelee hallinnan vapauttamista heti, kun sovellus on valmis, sen sijaan että odottaisi vastausajan umpeutumista.
Metan keskustelun hallintakutsut eivät kuulu sen työkaluihin; ihminen ottaa keskustelun hoitaakseen vastaamalla sivun Inboxissa. US$ 9 yhteyttä kohden kuukaudessa, joka laskee US$ 0,75:een, kun lisäät yhteyksiä. Ensimmäiset 3 päivää ilmaisia.
Usein kysytyt kysymykset
Tarvitseeko kahden sovelluksen sivulla Conversation Routingia?
Meta suosittelee sitä, kun useampi viestisovellus on yhdistetty ja jokaisen pitäisi vastata tietyille keskusteluille. Kun yksi sovellus vastaanottaa ja vastaa, oletuskäyttäytyminen riittää.
Kuinka kauan sovellus pitää keskustelun hallinnan?
Kunnes se vapauttaa hallinnan tai keskustelu siirtyy lepotilaan, 24 tuntia henkilön viimeisimmästä viestistä. extend_thread_control lisää aikaa enintään 7 päivään.
Tavoittaako Inboxin vastaus muut sovellukset?
Sovellukset, jotka tilaavat message_echoes-tapahtumat, saavat sen echo-tapahtumana, jonka app_id on Inboxin tunnus 263902037430900, kuten Metan muutosloki kuvaa Graph API v12.0 -versiosta alkaen.
Mitä easyCoexistencen vastauksille tapahtuu, kun henkilö vastaa Inboxissa?
Kun Conversation Routing on päällä, Inbox ottaa hallinnan. Kunnes hallinta palautuu, henkilön viestit tavoittavat easyCoexistencen sovelluksen vain standby-kanavalla, jota se ei tilaa. Ilman reititystä molemmat saavat ne edelleen.
Lue lisää
Yhdistä ensimmäinen kanavasi kahdessa minuutissa.
Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.
- 3 päivää ilmaiseksi
- Peruuta milloin tahansa
- Vain viralliset API:t
- Valvottu 24/7
Vahvistettu