Messenger-Handover-Protokoll: Posteingang einer Facebook-Seite zwischen KI-Agent und Personen teilen
Meta hat das Messenger-Handover-Protokoll durch Conversation Routing ersetzt, das dessen Thread-Steuerungsaufrufe beibehält: pass_thread_control übergibt ein Gespräch an eine andere App, etwa den Posteingang der Seite mit der App-ID 263902037430900, take_thread_control übernimmt es, request_thread_control fordert es an und release_thread_control gibt es in den Ruhezustand zurück. Ist das Routing aktiv, erhält die App, die einen Thread steuert, dessen Nachrichten, die anderen erhalten sie über den Standby-Kanal.
easyCoexistence gibt Ihrem KI-Agenten die Messenger-Gespräche einer Seite über einen einzigen MCP-Connector: send_social_dm antwortet innerhalb des 24-Stunden-Fensters, und neue Nachrichten werden an Ihren Endpoint weitergeleitet, sobald sie eintreffen.
Die target_app_id, die Meta für die Übergabe der Steuerung eines Gesprächs an den Posteingang der Seite vergibt.
Subcode unter Fehler 10 für eine Nachricht, deren Versand fehlschlug, weil eine andere App das Gespräch steuert.
Ohne eine Nachricht der Person für diese Dauer wird ein Thread inaktiv, und dann kann nur die Standard-App senden.
Wie weit extend_thread_control die Steuerung einer App über das 24-Stunden-Antwortfenster hinaus verlängern kann.
Übernehmen Sie die Steuerung von Gesprächen mit Ihrer Business AI; ist sie deaktiviert, schlagen ohne Tag gesendete Nachrichten an ein Business-AI-Gespräch mit 10, 2018300 fehl.
Was ist mit dem Handover-Protokoll geschehen?
Meta hat es in Conversation Routing aufgenommen. Laut dem Leitfaden unterstützt Meta das Handover-Protokoll für Messenger nicht mehr, Unternehmen wurden auf Conversation Routing umgestellt, und das Routing ist mit den meisten Handover-Protokoll-Aufrufen abwärtskompatibel. Daher sollen pass_thread_control, take_thread_control und der Webhook messaging_handovers weiter funktionieren. Geändert hat sich, wer entscheidet: Das Unternehmen legt eine Standard-App und Routing-Regeln in den Seiteneinstellungen unter Conversation Routing fest.
Wer steuert ein Gespräch?
Immer eine App, die Meta als Thread-Owner bezeichnet. Ein Thread ist aktiv, während die Person und die steuernde App miteinander kommunizieren, und inaktiv, wenn die Person 24 Stunden nicht geschrieben hat oder der Owner die Steuerung abgegeben hat; in einem inaktiven Thread kann innerhalb des Nachrichtenfensters nur die Standard-App senden. Routing-Regeln entscheiden, wer einen Thread übernimmt:
- Standard-App: diejenige, die antwortet, wenn keine andere App konfiguriert ist oder antwortet.
- Social Routing: die App, die die Steuerung übernimmt, wenn die Person einen inaktiven Thread öffnet oder auf Get Started tippt.
- Link-Routing: eine App, die jedem m.me-Link zugewiesen ist.
- Kampagnen-Routing: die App für eine Click-to-Messenger-Anzeige, die für das Nachrichtenfenster dieses Gesprächs bis zu 7 Tage die Steuerung hat.
Welche Aufrufe verschieben die Steuerung zwischen Apps?
Jeder ist ein POST an einen Edge der Seite mit recipient auf die PSID der Person gesetzt, und jeder liefert success true zurück; die meisten akzeptieren außerdem einen metadata-String, den die nächste App erhält:
pass_thread_control: übergibt den Thread an die App intarget_app_id, die einmessaging_handovers-Ereignis erhält.release_thread_control: beendet die Steuerung der App und setzt den Thread in den Ruhezustand zurück.take_thread_control: macht die aufrufende App zum Owner, für Apps, die das Unternehmen zur Übernahme zulässt.request_thread_control: fordert die Steuerung des Gesprächs an.extend_thread_control: behält die Steuerung über das 24-Stunden-Antwortfenster hinaus, bis zu 7 Tage, mit duration in Sekunden.- Die Send API kann die Steuerung mit der Nachricht selbst übergeben oder freigeben, über ein
thread_control-Objekt.
POST /{page-id}/pass_thread_control
?recipient={id:<PSID>}
&target_app_id=263902037430900
&metadata=Customer asked for a person
{ "success": true }Wie treten Personen im Posteingang der Seite ein?
Indem sie antworten. Conversation Routing behandelt den Posteingang von Meta Business Suite wie eine weitere verbundene App, die ein Unternehmen sogar zur Standard-App machen kann. Antwortet dort jemand in einem Gespräch, das der Posteingang nicht steuert, oder verschiebt er es in den Hauptordner, übernimmt der Posteingang die Steuerung. Eine App übergibt ein Gespräch an Personen mit pass_thread_control und target_app_id 263902037430900, und eine App, die die Antwort einer Person nach dem 24-Stunden-Fenster weiterleitet, sendet sie mit dem Tag HUMAN_AGENT innerhalb von 7 Tagen nach der letzten Nachricht der Person.
Was passiert, wenn die Business AI von Meta ein Gespräch besitzt?
Andere Apps erhalten die Nachrichten der Person über den Standby-Kanal und sollten sie nicht beantworten. Laut Leitfaden von Meta beginnt man erst nach einem messaging_handovers-Ereignis mit pass_thread_control zu antworten; eine messages-Benachrichtigung kann admin_text und ein handoff_reason wie human_requested oder purchase_intent enthalten, überträgt aber keine Owner-Rechte. Ist die Einstellung Gespräche mit Ihrer Business AI steuern übernehmen deaktiviert, was die Standardeinstellung ist, schlägt ein ohne Tag gesendeter Versand an dieses Gespräch mit Fehlercode 10, Subcode 2018300 fehl.
Wie prüft eine App, wem ein Thread gehört?
GET /{page-id}/thread_owner mit recipient auf die PSID gesetzt liefert die app_id der steuernden App und den Zeitpunkt, zu dem ihre Steuerung abläuft, an den Owner selbst oder an die Standard-App der Seite. Das Feld is_owner der Conversations API beantwortet dieselbe Frage pro Gespräch, sobald Routing aktiv ist, und GET /{page-id}?fields=messaging_feature_status zeigt den Status von Conversation Routing der Seite in Feldern wie msgr_multi_app.
Was passiert ohne Conversation Routing?
Meta nennt es das Standardverhalten, gedacht für eine Seite mit einer verbundenen App, die Nachrichten selbstständig empfängt und beantwortet. Alle verbundenen Apps erhalten Messaging-Webhooks und können dieselbe Nachricht beantworten, take_thread_control ist blockiert, bis eine Standard-App gesetzt ist, und nur Kampagnen-Routing steht zur Verfügung. Metas Empfehlung für diese Konfiguration lautet, die App und den Posteingang der Seite abzustimmen, damit niemand dieselbe Nachricht zweimal beantwortet.
Was macht easyCoexistence in einem gemeinsamen Posteingang?
Es abonniert jede Seite für feed, messages und mention, nicht für messaging_handovers, standby oder message_echoes. So leitet es die Nachrichten der Person weiter, während seine App sie empfängt, und sieht weder Handover-Ereignisse noch Antworten aus dem Posteingang der Seite. send_social_dm sendet eine RESPONSE ohne thread_control, und wenn Meta einen Versand ablehnt, weil eine andere App das Gespräch hält, gibt das Tool den Code 10 und die Nachricht von Meta an Ihre KI zurück. Die Aufrufe zur Thread-Steuerung, thread_owner und is_owner gehören nicht zu den Tools.
Häufige Fehler
- Auf Standby-Nachrichten antworten. Sie erreichen eine App, die den Thread nicht besitzt; warten Sie auf pass_thread_control, bevor Sie antworten.
- admin_text als Übergabe lesen. Eine messages-Benachrichtigung mit Übergabekontext überträgt keine Owner-Rechte; das tut nur das Ereignis messaging_handovers.
- Eine KI und den Posteingang ohne Routing parallel betreiben. Im Standardverhalten erhalten beide die Nachricht, und Meta verlangt Abstimmung, um zwei Antworten zu vermeiden.
- Einen Thread nach Ende des Ablaufs halten. Meta empfiehlt, die Steuerung freizugeben, sobald die App fertig ist, statt auf das Ablaufen der Antwortzeit zu warten.
Die Thread-Steuerungsaufrufe von Meta gehören nicht zu den Tools; eine Person übernimmt ein Gespräch, indem sie im Posteingang der Seite antwortet. US$ 9 bis US$ 0.75 pro Verbindung und Monat, mit sinkendem Preis je weiterer Verbindung, die ersten 3 Tage kostenlos.
Häufig gestellte Fragen
Brauchen zwei Apps auf einer Seite Conversation Routing?
Meta empfiehlt es, wenn mehrere Messaging-Apps verbunden sind und jede bestimmte Gespräche beantworten soll. Mit einer App, die empfängt und antwortet, reicht das Standardverhalten.
Wie lange behält eine App die Steuerung eines Gesprächs?
Bis sie die Steuerung freigibt oder der Thread inaktiv wird, 24 Stunden nach der letzten Nachricht der Person. extend_thread_control verlängert die Zeit, bis zu 7 Tage.
Erreicht eine Antwort aus dem Posteingang andere Apps?
Apps, die message_echoes abonniert haben, erhalten sie als Echo, dessen app_id der Posteingang der Seite ist, 263902037430900, wie es das Changelog von Meta für Graph API v12.0 und später beschreibt.
Was geschieht mit den Antworten von easyCoexistence, wenn eine Person aus dem Posteingang antwortet?
Mit aktivem Conversation Routing übernimmt der Posteingang die Steuerung, und bis die Steuerung zurückkehrt, erreichen Nachrichten der Person die App von easyCoexistence nur im Standby, das sie nicht abonniert. Ohne Routing erhalten beide sie weiterhin.
Weiterlesen
Verbinden Sie Ihren ersten Kanal in zwei Minuten.
Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.
- 3 Tage kostenlos
- Jederzeit kündbar
- Nur offizielle APIs
- Überwacht rund um die Uhr (24/7)
Verifiziert am