Protocolul de predare Messenger: partajarea inbox-ului unei Pagini între un agent AI și persoane
Meta a înlocuit protocolul de predare Messenger cu Conversation Routing, care păstrează apelurile de control al thread-urilor: pass_thread_control predă o conversație altei aplicații, cum este inbox-ul Paginii cu ID-ul de aplicație 263902037430900, take_thread_control o revendică, request_thread_control o solicită, iar release_thread_control returnează thread-ul în starea inactivă. Cu routing activat, aplicația care controlează un thread primește mesajele sale, iar celelalte le primesc pe canalul standby.
easyCoexistence îi oferă agentului dumneavoastră AI conversațiile Messenger ale unei Pagini printr-un singur conector MCP: send_social_dm răspunde în fereastra de 24 de ore, iar mesajele noi sunt transmise endpoint-ului dumneavoastră pe măsură ce sosesc.
target_app_id pe care Meta îl oferă pentru a preda controlul unei conversații inbox-ului Paginii.
Subcodul din eroarea 10, pentru un mesaj care a eșuat deoarece conversația este controlată de altă aplicație.
Fără un mesaj al persoanei în acest interval, thread-ul devine inactiv, iar atunci doar aplicația implicită poate trimite.
Cât de mult poate extinde extend_thread_control controlul unei aplicații dincolo de intervalul de răspuns de 24 de ore.
Preluați controlul conversațiilor cu Business AI; cât timp este dezactivat, trimiterile fără etichetă către o conversație Business AI eșuează cu 10, 2018300.
Ce s-a întâmplat cu protocolul de predare?
Meta l-a integrat în Conversation Routing. Ghidul său spune că Meta nu mai acceptă protocolul de predare pentru Messenger, că firmele au fost migrate la Conversation Routing și că routing-ul este compatibil cu majoritatea apelurilor din protocolul de predare, deci pass_thread_control, take_thread_control și webhook-ul messaging_handovers ar trebui să continue să funcționeze. Ce s-a schimbat este cine decide: firma stabilește o aplicație implicită și regulile de routing în setările Paginii, la Conversation Routing.
Cine controlează o conversație?
Câte o aplicație, pe care Meta o numește proprietarul thread-ului. Un thread este activ cât timp persoana și aplicația proprietară comunică și devine inactiv când persoana nu a scris timp de 24 de ore sau când proprietarul a eliberat controlul; într-un thread inactiv doar aplicația implicită poate trimite, în fereastra de mesagerie. Regulile de routing decid cine preia un thread:
- Aplicația implicită: cea care răspunde când nu este configurată sau nu răspunde nicio altă aplicație.
- Routing social: aplicația care preia controlul când persoana deschide un thread inactiv sau apasă Get Started.
- Routing după link: o aplicație atribuită fiecărui link m.me.
- Routing pe campanie: aplicația aleasă pentru o reclamă Click-to-Messenger, care controlează conversația pe durata ferestrei de mesagerie, de până la 7 zile.
Ce apeluri mută controlul între aplicații?
Fiecare este un POST către un edge al Paginii, cu recipient setat la PSID-ul persoanei, și fiecare răspunde cu success true; majoritatea acceptă și un șir de metadate pe care îl primește aplicația următoare:
pass_thread_control: predă thread-ul aplicației dintarget_app_id, care primește un evenimentmessaging_handovers.release_thread_control: încheie controlul aplicației și returnează thread-ul în starea inactivă.take_thread_control: face aplicația apelantă proprietar, pentru aplicațiile pe care firma le autorizează să preia controlul.request_thread_control: solicită controlul conversației.extend_thread_control: păstrează controlul dincolo de intervalul de răspuns de 24 de ore, până la 7 zile, cu durata în secunde.- Send API poate preda sau elibera controlul împreună cu mesajul, printr-un obiect
thread_control.
POST /{page-id}/pass_thread_control
?recipient={id:<PSID>}
&target_app_id=263902037430900
&metadata=Customer asked for a person
{ "success": true }Cum intervin persoanele în inbox-ul Paginii?
Prin răspuns. Conversation Routing tratează inbox-ul Meta Business Suite ca pe încă o aplicație conectată, pe care o firmă o poate chiar seta ca implicită; când cineva răspunde acolo într-o conversație pe care inbox-ul nu o controlează sau mută conversația în folderul Principal, inbox-ul preia controlul. O aplicație predă o conversație persoanelor cu pass_thread_control și target_app_id 263902037430900, iar o aplicație care transmite un răspuns al persoanei după fereastra de 24 de ore îl trimite cu eticheta HUMAN_AGENT, în termen de 7 zile de la ultimul mesaj al persoanei.
Ce se întâmplă când Business AI al Meta deține o conversație?
Celelalte aplicații primesc mesajele persoanei pe canalul standby și nu ar trebui să le răspundă. Ghidul Meta spune să începeți să răspundeți după un eveniment messaging_handovers cu pass_thread_control; o notificare messages poate conține admin_text și un handoff_reason, precum human_requested sau purchase_intent, dar nu transferă proprietatea. Cu Take control of conversations with your Business AI dezactivat, varianta implicită, o trimitere fără etichetă către acea conversație eșuează cu codul 10, subcodul 2018300.
Cum verifică o aplicație cine deține un thread?
GET /{page-id}/thread_owner cu recipient setat la PSID returnează app_id-ul aplicației proprietare și momentul în care expiră controlul său, către proprietar sau către aplicația implicită a Paginii. Câmpul is_owner din Conversations API răspunde la aceeași întrebare pentru fiecare conversație, odată ce routing-ul este activat, iar GET /{page-id}?fields=messaging_feature_status arată starea Conversation Routing a Paginii în câmpuri precum msgr_multi_app.
Ce se întâmplă fără Conversation Routing?
Meta îl numește comportament implicit, gândit pentru o Pagină cu o singură aplicație conectată care primește și răspunde singură la mesaje. Toate aplicațiile conectate primesc webhook-urile de mesagerie și pot răspunde același mesaj, take_thread_control este blocat până se setează o aplicație implicită, iar este disponibil doar routing-ul pe campanie. Sfatul Meta pentru această configurație este să coordonați aplicația și inbox-ul Paginii, ca nimeni să nu răspundă de două ori același mesaj.
Ce face easyCoexistence într-un inbox partajat?
Abonează fiecare Pagină la feed, messages și mention, nu la messaging_handovers, standby sau message_echoes, deci transmite mesajele persoanei în timp ce aplicația sa le primește, și nu vede nici evenimentele de predare, nici răspunsurile trimise din inbox-ul Paginii. send_social_dm trimite un RESPONSE fără thread_control, iar când Meta refuză o trimitere pentru că altă aplicație deține conversația, instrumentul returnează codul 10 și mesajul Meta către AI-ul dumneavoastră. Apelurile de control al thread-ului, thread_owner și is_owner nu se numără printre instrumentele sale.
Greșeli frecvente
- Răspunsul la mesajele standby. Ajung la o aplicație care nu deține thread-ul; așteptați pass_thread_control înainte de a răspunde.
- Citirea admin_text ca predare. O notificare messages cu context de predare nu transferă proprietatea; o face evenimentul messaging_handovers.
- Rularea unui AI și a inbox-ului în paralel fără routing. Cu comportamentul implicit, ambele primesc mesajul, iar Meta cere coordonare pentru a evita două răspunsuri.
- Păstrarea unui thread după ce fluxul s-a încheiat. Meta recomandă eliberarea controlului imediat ce aplicația a terminat, în loc să aștepte expirarea intervalului de răspuns.
Apelurile Meta de control al thread-ului nu se numără printre instrumentele sale; o persoană preia o conversație răspunzând în inbox-ul Paginii. De la US$ 9 până la US$ 0.75 pe conexiune pe lună, cu scădere pe măsură ce adăugați conexiuni, cu primele 3 zile gratuite.
Întrebări frecvente
Au nevoie două aplicații de pe aceeași Pagină de Conversation Routing?
Meta îl recomandă când mai multe aplicații de mesagerie sunt conectate și fiecare trebuie să răspundă la anumite conversații. Cu o singură aplicație care primește și răspunde, comportamentul implicit este suficient.
Cât timp păstrează o aplicație controlul unei conversații?
Până când eliberează controlul sau thread-ul devine inactiv, la 24 de ore de la ultimul mesaj al persoanei. extend_thread_control adaugă timp, până la 7 zile.
Ajunge un răspuns din inbox-ul Paginii la celelalte aplicații?
Aplicațiile abonate la message_echoes îl primesc ca echo al cărui app_id este cel al inbox-ului Paginii, 263902037430900, așa cum descrie changelog-ul Meta pentru Graph API v12.0 și versiunile ulterioare.
Ce se întâmplă cu răspunsurile easyCoexistence când o persoană răspunde din inbox?
Cu Conversation Routing activat, inbox-ul preia controlul, iar până la returnarea controlului mesajele persoanei ajung la aplicația easyCoexistence doar pe standby, la care nu este abonată. Fără routing, ambele continuă să le primească.
Continuați să citiți
Conectați primul canal în două minute.
Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.
- 3 zile gratuit
- Anulați oricând
- Doar API-uri oficiale
- Monitorizat 24/7
Verificat la