Messenger-overdrachtprotocol: de inbox van een Pagina delen tussen een AI-agent en mensen
Meta verving het Messenger-overdrachtprotocol door Conversation Routing, dat de calls voor gesprekscontrole behoudt: pass_thread_control geeft een gesprek door aan een andere app, zoals de Pagina-inbox met app-ID 263902037430900, take_thread_control neemt het over, request_thread_control vraagt er om, en release_thread_control zet het gesprek terug op inactief. Met routing aan ontvangt de app die een gesprek beheert de berichten, en de andere apps ontvangen ze via het standby-kanaal.
easyCoexistence geeft je AI-agent de Messenger-gesprekken van een Pagina via één MCP-connector: send_social_dm antwoordt binnen het 24-uursvenster en nieuwe berichten worden naar je endpoint doorgestuurd zodra ze binnenkomen.
Het target_app_id dat Meta geeft om de controle over een gesprek door te geven aan de Pagina-inbox.
Subcode, onder fout 10, voor een bericht dat mislukte omdat een andere app het gesprek beheert.
Zonder bericht van de persoon gedurende deze tijd wordt een gesprek inactief, en dan kan alleen de standaardapp verzenden.
Hoe ver extend_thread_control de controle van een app kan verlengen voorbij het responstijdvenster van 24 uur.
Neem de controle over gesprekken met je Business AI; staat dit uit, dan mislukken niet-gelabelde verzendingen naar een Business AI-gesprek met 10, 2018300.
Wat is er met het overdrachtprotocol gebeurd?
Meta heeft het samengevoegd met Conversation Routing. In de gids staat dat Meta het overdrachtprotocol voor Messenger niet langer ondersteunt, dat bedrijven zijn overgezet naar Conversation Routing, en dat routing grotendeels achterwaarts compatibel is met de meeste overdrachtprotocol-calls. Daardoor zouden pass_thread_control, take_thread_control en de messaging_handovers-webhook moeten blijven werken. Wat veranderd is, is wie beslist: het bedrijf stelt een standaardapp en routingregels in via de Pagina-instellingen, onder Conversation Routing.
Wie beheert een gesprek?
Eén app tegelijk, wat Meta de gesprekseigenaar noemt. Een gesprek is actief terwijl de persoon en de eigenaar-app met elkaar praten, en inactief wanneer de persoon 24 uur niet heeft geschreven of de eigenaar de controle heeft losgelaten. In een inactief gesprek kan alleen de standaardapp verzenden, binnen het berichtenvenster. Routingregels bepalen wie een gesprek overneemt:
- Standaardapp: degene die antwoordt wanneer geen andere app is ingesteld of reageert.
- Sociale routing: de app die de controle overneemt wanneer de persoon een inactief gesprek opent of op Get Started tikt.
- Linkrouting: een app die aan elke m.me-link is toegewezen.
- Campagnerouting: de app die is gekozen voor een Click-to-Messenger-advertentie, die de controle heeft voor het berichtenvenster van dat gesprek, tot 7 dagen.
Welke calls verplaatsen de controle tussen apps?
Elk is een POST naar een edge van de Pagina, met recipient ingesteld op de PSID van de persoon, en elk antwoordt met success true. De meeste accepteren ook een metadata-string die de volgende app ontvangt:
pass_thread_control: geeft het gesprek door aan de app intarget_app_id, die eenmessaging_handovers-event ontvangt.release_thread_control: beëindigt de controle van de app en zet het gesprek terug op inactief.take_thread_control: maakt de aanroepende app de eigenaar, voor apps die het bedrijf toestaat de controle over te nemen.request_thread_control: vraagt om de controle over het gesprek.extend_thread_control: houdt de controle langer dan het responstijdvenster van 24 uur, tot 7 dagen, met duur in seconden.- De Send API kan de controle met het bericht zelf doorgeven of loslaten, via een
thread_control-object.
POST /{page-id}/pass_thread_control
?recipient={id:<PSID>}
&target_app_id=263902037430900
&metadata=Customer asked for a person
{ "success": true }Hoe stappen mensen in de Pagina-inbox in?
Door te antwoorden. Conversation Routing behandelt de Meta Business Suite-inbox als nog een verbonden app, die een bedrijf zelfs als standaard kan instellen. Wanneer iemand daar antwoordt in een gesprek dat de inbox niet beheert, of het naar de map Main verplaatst, neemt de inbox de controle over. Een app geeft een gesprek aan mensen door met pass_thread_control en target_app_id 263902037430900. Een app die het antwoord van een persoon doorstuurt na het 24-uursvenster, verzendt het met de HUMAN_AGENT-tag, binnen 7 dagen na het laatste bericht van de persoon.
Wat gebeurt er wanneer Meta's Business AI een gesprek beheert?
Andere apps ontvangen de berichten van de persoon via het standby-kanaal en moeten die niet beantwoorden. De gids van Meta zegt dat je moet beginnen met reageren na een messaging_handovers-event met pass_thread_control. Een messages-notificatie kan admin_text en een handoff_reason bevatten, zoals human_requested of purchase_intent, maar die draagt de eigendom niet over. Met de instelling Neem de controle over gesprekken met je Business AI uit, de standaard, mislukt een niet-gelabelde verzending naar dat gesprek met code 10, subcode 2018300.
Hoe ziet een app wie een gesprek beheert?
GET /{page-id}/thread_owner met recipient ingesteld op de PSID geeft de app_id van de beheerende app terug, en wanneer de controle verloopt, aan de eigenaar zelf of aan de standaardapp van de Pagina. Het veld is_owner van de Conversations API beantwoordt dezelfde vraag per gesprek zodra routing aan staat. GET /{page-id}?fields=messaging_feature_status toont de status van Conversation Routing van de Pagina, in velden zoals msgr_multi_app.
Wat gebeurt er zonder Conversation Routing?
Meta noemt dit het standaardgedrag, bedoeld voor een Pagina met één verbonden app die berichten zelf ontvangt en beantwoordt. Alle verbonden apps ontvangen messaging-webhooks en kunnen op hetzelfde bericht antwoorden. take_thread_control is geblokkeerd tot er een standaardapp is ingesteld, en alleen campagnerouting is beschikbaar. Het advies van Meta voor deze opzet is de app en de Pagina-inbox op elkaar af te stemmen, zodat niemand hetzelfde bericht twee keer beantwoordt.
Wat doet easyCoexistence in een gedeelde inbox?
Het abonneert elke Pagina op feed, messages en mention, niet op messaging_handovers, standby of message_echoes. Zo stuurt het de berichten van de persoon door terwijl de app ze ontvangt, en ziet het noch overdrachtevents noch antwoorden die vanuit de Pagina-inbox zijn verstuurd. send_social_dm stuurt een RESPONSE zonder thread_control. Wanneer Meta een verzending weigert omdat een andere app het gesprek beheert, geeft de tool de code 10 en het bericht van Meta terug aan je AI. De calls voor gesprekscontrole, thread_owner en is_owner horen niet bij de tools.
Veelgemaakte fouten
- Standby-berichten beantwoorden. Die komen bij een app die het gesprek niet beheert; wacht op pass_thread_control voordat je antwoordt.
- admin_text lezen als overdracht. Een messages-notificatie met overdrachtscontext draagt de eigendom niet over; het messaging_handovers-event wel.
- Een AI en de inbox naast elkaar draaien zonder routing. Bij standaardgedrag ontvangen beide het bericht, en Meta vraagt om afstemming om twee antwoorden te voorkomen.
- Een gesprek vasthouden nadat de flow is afgelopen. Meta raadt aan de controle los te laten zodra de app klaar is, in plaats van te wachten tot de responstijd verloopt.
De calls voor gesprekscontrole van Meta horen niet bij de tools; een persoon neemt een gesprek over door te antwoorden in de Pagina-inbox. Van US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je verbindingen toevoegt, met de eerste 3 dagen gratis.
Veelgestelde vragen
Hebben twee apps op één Pagina Conversation Routing nodig?
Meta raadt het aan wanneer meerdere berichten-apps zijn verbonden en elk bepaalde gesprekken moet beantwoorden. Met één app die ontvangt en antwoordt is het standaardgedrag voldoende.
Hoe lang houdt een app de controle over een gesprek?
Tot die de controle loslaat of het gesprek inactief wordt, 24 uur na het laatste bericht van de persoon. extend_thread_control voegt tijd toe, tot 7 dagen.
Bereikt een antwoord uit de Pagina-inbox andere apps?
Apps die zijn geabonneerd op message_echoes ontvangen het als echo met als app_id die van de Pagina-inbox, 263902037430900, zoals de changelog van Meta beschrijft voor Graph API v12.0 en later.
Wat gebeurt er met de antwoorden van easyCoexistence wanneer een persoon vanuit de inbox antwoordt?
Met Conversation Routing aan neemt de inbox de controle over. Tot de controle terugkeert, bereiken de berichten van de persoon de app van easyCoexistence alleen op standby, waarop die niet is geabonneerd. Zonder routing blijven beide ze ontvangen.
Lees verder
Koppel je eerste kanaal in twee minuten.
Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.
- 3 dagen gratis
- Op elk moment opzegbaar
- Alleen officiële API's
- 24/7 bewaakt
Geverifieerd op