Protocollo handover Messenger: condividere la casella di una Pagina tra un agente AI e le persone
Meta ha sostituito il protocollo handover di Messenger con Conversation Routing, che mantiene le sue chiamate di controllo della conversazione: pass_thread_control passa una conversazione a un'altra app, come la casella della Pagina con app ID 263902037430900, take_thread_control la rivendica, request_thread_control la richiede e release_thread_control la restituisce allo stato inattivo. Con il routing attivo, l'app che controlla una conversazione riceve i suoi messaggi e le altre li ricevono sul canale standby.
easyCoexistence dà al tuo agente AI le conversazioni Messenger di una Pagina tramite un unico connettore MCP: send_social_dm risponde entro la finestra di 24 ore e i nuovi messaggi vengono inoltrati al tuo endpoint man mano che arrivano.
Il target_app_id che Meta fornisce per passare il controllo di una conversazione alla Page Inbox.
Sottocodice, sotto l'errore 10, per un messaggio non riuscito perché un'altra app controlla la conversazione.
Se per questo tempo la persona non scrive, una conversazione passa allo stato inattivo e solo l'app predefinita può inviare.
Di quanto extend_thread_control può estendere il controllo di un'app oltre la finestra di risposta di 24 ore.
Assumi il controllo delle conversazioni con la tua Business AI; se è disattivato, gli invii senza tag verso una conversazione con Business AI falliscono con 10, 2018300.
Che fine ha fatto il protocollo handover?
Meta lo ha integrato in Conversation Routing. La sua guida dice che Meta non supporta più il protocollo handover per Messenger, che le aziende sono state migrate a Conversation Routing e che il routing è retrocompatibile con la maggior parte delle chiamate del protocollo handover, quindi pass_thread_control, take_thread_control e il webhook messaging_handovers dovrebbero continuare a funzionare. Ciò che cambia è chi decide: l'azienda imposta un'app predefinita e le regole di routing nelle impostazioni della Pagina, alla voce Conversation Routing.
Chi controlla una conversazione?
Una sola app alla volta, che Meta chiama proprietario della conversazione. Una conversazione è attiva mentre la persona e l'app proprietaria comunicano, e inattiva quando la persona non ha scritto per 24 ore o il proprietario ha rilasciato il controllo; in una conversazione inattiva solo l'app predefinita può inviare, entro la finestra di messaggistica. Le regole di routing decidono chi prende una conversazione:
- App predefinita: quella che risponde quando non è configurata o non risponde nessun'altra app.
- Social routing: l'app che prende il controllo quando la persona apre una conversazione inattiva o tocca Get Started.
- Link routing: un'app assegnata a ciascun link m.me.
- Campaign routing: l'app scelta per un annuncio Click-to-Messenger, che ne mantiene il controllo per la finestra di messaggistica di quella conversazione, fino a 7 giorni.
Quali chiamate spostano il controllo tra le app?
Ciascuna è una POST verso un edge della Pagina con recipient impostato sul PSID della persona, e ciascuna risponde success true; la maggior parte accetta anche una stringa metadata che l'app successiva riceve:
pass_thread_control: passa la conversazione all'app intarget_app_id, che riceve un eventomessaging_handovers.release_thread_control: termina il controllo dell'app e riporta la conversazione allo stato inattivo.take_thread_control: rende l'app chiamante proprietaria, per le app che l'azienda consente di prendere il controllo.request_thread_control: chiede il controllo della conversazione.extend_thread_control: mantiene il controllo oltre la finestra di risposta di 24 ore, fino a 7 giorni, con duration in secondi.- La Send API può passare o rilasciare il controllo insieme al messaggio stesso, tramite un oggetto
thread_control.
POST /{page-id}/pass_thread_control
?recipient={id:<PSID>}
&target_app_id=263902037430900
&metadata=Customer asked for a person
{ "success": true }Come intervengono le persone nella casella della Pagina?
Rispondendo. Conversation Routing tratta la casella di Meta Business Suite come un'app collegata in più, che un'azienda può perfino rendere predefinita; quando qualcuno risponde lì in una conversazione che la casella non controlla, o la sposta nella cartella Main, la casella ne prende il controllo. Un'app consegna una conversazione alle persone con pass_thread_control e target_app_id 263902037430900, e un'app che inoltra la risposta di una persona dopo la finestra di 24 ore la invia con il tag HUMAN_AGENT, entro 7 giorni dall'ultimo messaggio della persona.
Cosa succede quando la Business AI di Meta possiede una conversazione?
Le altre app ricevono i messaggi della persona sul canale standby e non dovrebbero rispondere. La guida di Meta dice di iniziare a rispondere dopo un evento messaging_handovers con pass_thread_control; una notifica messages può contenere admin_text e un handoff_reason come human_requested o purchase_intent, ma non trasferisce la proprietà. Con Assumi il controllo delle conversazioni con la tua Business AI disattivato, l'impostazione predefinita, un invio senza tag verso quella conversazione fallisce con codice 10, sottocodice 2018300.
Come fa un'app a sapere chi possiede una conversazione?
GET /{page-id}/thread_owner con recipient impostato sul PSID restituisce l'app_id dell'app proprietaria e quando scade il suo controllo, al proprietario stesso o all'app predefinita della Pagina. Il campo is_owner dell'API Conversations risponde alla stessa domanda per ogni conversazione una volta attivato il routing, e GET /{page-id}?fields=messaging_feature_status mostra lo stato di Conversation Routing della Pagina in campi come msgr_multi_app.
Cosa succede senza Conversation Routing?
Meta lo chiama comportamento predefinito, pensato per una Pagina con una sola app collegata che riceve e risponde ai messaggi da sola. Tutte le app collegate ricevono i webhook dei messaggi e possono rispondere allo stesso messaggio, take_thread_control è bloccato finché non è impostata un'app predefinita, e resta disponibile solo il campaign routing. Il consiglio di Meta per questa configurazione è coordinare l'app e la casella della Pagina, così che nessuno risponda due volte allo stesso messaggio.
Cosa fa easyCoexistence in una casella condivisa?
Iscrive ogni Pagina a feed, messages e mention, non a messaging_handovers, standby o message_echoes, quindi inoltra i messaggi della persona mentre la sua app li riceve, e non vede né gli eventi di handover né le risposte inviate dalla casella della Pagina. send_social_dm invia una RESPONSE senza thread_control e, quando Meta rifiuta un invio perché un'altra app detiene la conversazione, lo strumento restituisce alla tua AI il codice 10 di Meta e il suo messaggio. Le chiamate di controllo della conversazione, thread_owner e is_owner non rientrano tra i suoi strumenti.
Errori comuni
- Rispondere ai messaggi in standby. Arrivano a un'app che non possiede la conversazione; attendi pass_thread_control prima di rispondere.
- Leggere admin_text come un handover. Una notifica messages con contesto di handoff non trasferisce la proprietà; la trasferisce l'evento messaging_handovers.
- Gestire un'AI e la casella in parallelo senza routing. Con il comportamento predefinito ricevono entrambe il messaggio, e Meta chiede di coordinarsi per evitare due risposte.
- Tenere una conversazione dopo la fine del flusso. Meta consiglia di rilasciare il controllo appena l'app ha finito, invece di attendere che scada il tempo di risposta.
Le chiamate di controllo della conversazione di Meta non rientrano tra i suoi strumenti; una persona prende in carico una conversazione rispondendo nella casella della Pagina. Da US$ 9 a US$ 0,75 per connessione al mese, con il prezzo che scende man mano che aggiungi connessioni, con i primi 3 giorni di prova gratuita.
Domande frequenti
Due app su una stessa Pagina hanno bisogno di Conversation Routing?
Meta lo consiglia quando sono collegate più app di messaggistica e ognuna deve rispondere a determinate conversazioni. Con una sola app che riceve e risponde, il comportamento predefinito basta.
Per quanto tempo un'app mantiene il controllo di una conversazione?
Finché rilascia il controllo o la conversazione diventa inattiva, 24 ore dopo l'ultimo messaggio della persona. extend_thread_control aggiunge tempo, fino a 7 giorni.
Una risposta dalla casella della Pagina raggiunge le altre app?
Le app iscritte a message_echoes la ricevono come eco il cui app_id è quello della casella della Pagina, 263902037430900, come descrive il changelog di Meta per la Graph API v12.0 e successive.
Cosa succede alle risposte di easyCoexistence quando una persona risponde dalla casella?
Con Conversation Routing attivo la casella prende il controllo, e finché il controllo non torna, i messaggi della persona raggiungono l'app di easyCoexistence solo sul canale standby, a cui non è iscritta. Senza routing, entrambe continuano a riceverli.
Continua a leggere
Collega il tuo primo canale in due minuti.
Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.
- 3 giorni gratis
- Disdici quando vuoi
- Solo API ufficiali
- Monitorato 24/7
Verificato il