Zaloguj sięRozpocznij bezpłatny okres próbny
easyCoexistence Oficjalne API

Protokół przekazania Messengera: udostępnianie skrzynki Strony między agentem AI a ludźmi

Meta zastąpiła protokół przekazania Messengera funkcją Conversation Routing, która zachowuje wywołania kontroli wątku: pass_thread_control przekazuje konwersację innej aplikacji, na przykład skrzynce odbiorczej Strony z ID aplikacji 263902037430900, take_thread_control ją przejmuje, request_thread_control o nią prosi, a release_thread_control zwraca ją do stanu bezczynności. Gdy routing jest włączony, aplikacja kontrolująca wątek otrzymuje jego wiadomości, a pozostałe dostają je na kanale standby.

easyCoexistence daje Twojemu agentowi AI konwersacje Messengera Strony przez jeden łącznik MCP: send_social_dm odpowiada w 24-godzinnym oknie, a nowe wiadomości są przekazywane na Twój endpoint w miarę ich napływania.

263902037430900

target_app_id, który Meta podaje do przekazania kontroli nad konwersacją do Page Inbox.

2018300

Podkod błędu 10 dla wiadomości, która się nie udała, bo inna aplikacja kontroluje konwersację.

24 hours

Jeśli osoba nie napisze przez tyle czasu, wątek przechodzi w stan bezczynności i tylko domyślna aplikacja może wtedy wysyłać.

Up to 7 days

Jak daleko extend_thread_control może rozciągnąć kontrolę aplikacji poza 24-godzinne okno czasu odpowiedzi.

Off by default

Przejmij kontrolę nad konwersacjami z Twoim Business AI; gdy opcja jest wyłączona, wysyłki bez tagu do konwersacji Business AI kończą się błędem 10, 2018300.

Co się stało z protokołem przekazania?

Meta włączyła go do Conversation Routing. Jej przewodnik mówi, że Meta nie obsługuje już protokołu przekazania dla Messengera, firmy zostały przeniesione do Conversation Routing, a routing jest zgodny wstecz z większością wywołań protokołu przekazania. Dlatego pass_thread_control, take_thread_control i webhook messaging_handovers mają nadal działać. Zmieniło się to, kto decyduje: firma ustawia domyślną aplikację i reguły routingu w ustawieniach Strony, w sekcji Conversation Routing.

Kto kontroluje konwersację?

Jedna aplikacja naraz, którą Meta nazywa właścicielem wątku. Wątek jest aktywny, gdy osoba i aplikacja-właściciel rozmawiają, a bezczynny, gdy osoba nie pisała przez 24 godziny albo właściciel zwolnił kontrolę. W bezczynnym wątku wysyłać może tylko domyślna aplikacja, w ramach okna wiadomości. Reguły routingu decydują, kto przejmuje wątek:

  • Domyślna aplikacja: ta, która odpowiada, gdy nie skonfigurowano innej aplikacji lub ona nie odpowiada.
  • Routing społecznościowy: aplikacja, która przejmuje kontrolę, gdy osoba otwiera bezczynny wątek albo klika Get Started.
  • Routing linków: aplikacja przypisana do każdego linku m.me.
  • Routing kampanii: aplikacja wybrana dla reklamy Click-to-Messenger, która kontroluje tę konwersację w oknie wiadomości, do 7 dni.

Które wywołania przenoszą kontrolę między aplikacjami?

Każde jest żądaniem POST do krawędzi Strony z recipient ustawionym na PSID osoby, a każde zwraca success true. Większość przyjmuje też ciąg metadata, który otrzymuje następna aplikacja:

  • pass_thread_control: przekazuje wątek aplikacji z target_app_id, która otrzymuje zdarzenie messaging_handovers.
  • release_thread_control: kończy kontrolę aplikacji i zwraca wątek do bezczynności.
  • take_thread_control: czyni wywołującą aplikację właścicielem, dla aplikacji, którym firma pozwala przejąć kontrolę.
  • request_thread_control: prosi o kontrolę nad konwersacją.
  • extend_thread_control: utrzymuje kontrolę poza 24-godzinnym oknem czasu odpowiedzi, do 7 dni, z czasem trwania w sekundach.
  • Send API może przekazać lub zwolnić kontrolę razem z wiadomością, przez obiekt thread_control.
Handing a conversation to the Page Inbox
POST /{page-id}/pass_thread_control
  ?recipient={id:<PSID>}
  &target_app_id=263902037430900
  &metadata=Customer asked for a person

{ "success": true }

Jak ludzie wchodzą do skrzynki Strony?

Odpowiadając. Conversation Routing traktuje skrzynkę Meta Business Suite jak kolejną podłączoną aplikację, którą firma może nawet ustawić jako domyślną. Gdy ktoś odpowie tam w konwersacji, której skrzynka nie kontroluje, albo przeniesie ją do folderu Main, skrzynka przejmuje kontrolę. Aplikacja przekazuje rozmowę ludziom przez pass_thread_control z target_app_id 263902037430900, a aplikacja, która przekazuje odpowiedź osoby po 24-godzinnym oknie, wysyła ją z tagiem HUMAN_AGENT, w ciągu 7 dni od ostatniej wiadomości osoby.

1AI agentThe app that owns the thread replies to the person
2Hand overpass_thread_control to 263902037430900
3Page inboxPeople answer; a reply there also takes control
4IdleReleased, or 24 hours without a message from the person

Co się dzieje, gdy Business AI Mety jest właścicielem konwersacji?

Inne aplikacje otrzymują wiadomości osoby na kanale standby i nie powinny na nie odpowiadać. Przewodnik Mety mówi, by zacząć odpowiadać po zdarzeniu messaging_handovers z pass_thread_control. Powiadomienie messages może zawierać admin_text i handoff_reason, np. human_requested lub purchase_intent, ale nie przenosi własności. Gdy opcja Take control of conversations with your Business AI jest wyłączona (domyślnie), wysyłka bez tagu do tej konwersacji kończy się błędem o kodzie 10, podkodzie 2018300.

Jak aplikacja sprawdza, kto jest właścicielem wątku?

GET /{page-id}/thread_owner z recipient ustawionym na PSID zwraca app_id aplikacji-właściciela i czas wygaśnięcia jej kontroli; odpowiedź dostaje sama aplikacja-właściciel albo domyślna aplikacja Strony. Pole is_owner w Conversations API odpowiada na to samo pytanie dla każdej konwersacji po włączeniu routingu, a GET /{page-id}?fields=messaging_feature_status pokazuje status Conversation Routing Strony w polach takich jak msgr_multi_app.

Co się dzieje bez Conversation Routing?

Meta nazywa to domyślnym zachowaniem, przeznaczonym dla Strony z jedną podłączoną aplikacją, która sama odbiera i odpowiada na wiadomości. Wszystkie podłączone aplikacje otrzymują webhooki wiadomości i mogą odpowiedzieć na tę samą wiadomość, take_thread_control jest zablokowane, dopóki nie ustawiono domyślnej aplikacji, a dostępny jest tylko routing kampanii. Zalecenie Mety dla tej konfiguracji to koordynacja aplikacji ze skrzynką Strony, tak aby nikt nie odpowiadał dwa razy na tę samą wiadomość.

Co easyCoexistence robi we wspólnej skrzynce?

Subskrybuje każdą Stronę na feed, messages i mention, a nie na messaging_handovers, standby ani message_echoes. Dzięki temu przekazuje wiadomości osoby, które jego aplikacja odbiera, i nie widzi zdarzeń przekazania ani odpowiedzi wysłanych ze skrzynki Strony. send_social_dm wysyła RESPONSE bez thread_control. Gdy Meta odrzuca wysyłkę, bo konwersację trzyma inna aplikacja, narzędzie zwraca kod 10 i komunikat Mety do Twojego agenta AI. Wywołania kontroli wątku, thread_owner i is_owner nie należą do jego narzędzi.

Typowe błędy

  • Odpowiadanie na wiadomości standby. Trafiają one do aplikacji, która nie jest właścicielem wątku; poczekaj na pass_thread_control przed odpowiedzią.
  • Traktowanie admin_text jako przekazania. Powiadomienie messages z kontekstem przekazania nie przenosi własności; robi to zdarzenie messaging_handovers.
  • Uruchamianie AI i skrzynki obok siebie bez routingu. Przy domyślnym zachowaniu oba otrzymują wiadomość, a Meta prosi o koordynację, by uniknąć dwóch odpowiedzi.
  • Trzymanie wątku po zakończeniu przepływu. Meta zaleca zwolnienie kontroli, gdy aplikacja skończy, zamiast czekać, aż wygaśnie czas odpowiedzi.
Z EasyCoexistence zrobisz to

Wywołania kontroli wątku Mety nie należą do jego narzędzi; osoba przejmuje konwersację, odpowiadając w skrzynce Strony. Od US$ 9 do US$ 0.75 za połączenie miesięcznie, spadając w miarę dodawania połączeń, z bezpłatnym okresem próbnym przez pierwsze 3 dni.

Najczęściej zadawane pytania

Czy dwie aplikacje na jednej Stronie potrzebują Conversation Routing?

Meta zaleca go, gdy podłączonych jest kilka aplikacji do wiadomości i każda ma odpowiadać na określone konwersacje. Przy jednej aplikacji, która odbiera i odpowiada, wystarczy domyślne zachowanie.

Jak długo aplikacja utrzymuje kontrolę nad konwersacją?

Do momentu zwolnienia kontroli albo przejścia wątku w stan bezczynności, czyli 24 godziny od ostatniej wiadomości osoby. extend_thread_control dodaje czas, do 7 dni.

Czy odpowiedź ze skrzynki Strony trafia do innych aplikacji?

Aplikacje subskrybujące message_echoes otrzymują ją jako echo, którego app_id to ID skrzynki Strony, 263902037430900, zgodnie z changelogiem Mety dla Graph API v12.0 i nowszych.

Co dzieje się z odpowiedziami easyCoexistence, gdy osoba odpowie ze skrzynki?

Po włączeniu Conversation Routing skrzynka przejmuje kontrolę, a do chwili jej zwrotu wiadomości osoby docierają do aplikacji easyCoexistence tylko na standby, którego ona nie subskrybuje. Bez routingu oba nadal je otrzymują.

Czytaj dalej

Połącz pierwszy kanał w dwie minuty.

Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.

  • 3 dni za darmo
  • Rezygnacja w każdej chwili
  • Tylko oficjalne API
  • Monitorowanie 24/7

Zweryfikowano w