API profilu Messengera: powitanie, przycisk Get Started, lodołamacze i stałe menu
Profil Messengera strony na Facebooku ustawia się przez /{page-id}/messenger_profile, z tokenem dostępu strony i uprawnieniem pages_messaging. POST zapisuje właściwości, takie jak get_started, greeting, ice_breakers, persistent_menu i commands, GET odczytuje je przez parametr fields, a DELETE usuwa te wymienione w tablicy fields. Meta zezwala na 10 wywołań na 10 minut na stronę, a nadpisywane są tylko przesłane właściwości.
easyCoexistence odpowiada w rozmowach Messengera strony przez send_social_dm w 24-godzinnym oknie, z Claude, ChatGPT lub własnego kodu, a nowe wiadomości są przekazywane na Twój endpoint w miarę ich nadchodzenia.
Liczba wywołań Messenger Profile API dozwolonych na stronę w każdym 10-minutowym interwale.
Maksymalna liczba lodołamaczy, jakie ustawia API; gdy ustawione są oba rodzaje, lodołamacze z API mają pierwszeństwo przed przyciskiem Get Started.
Maksymalna liczba elementów najwyższego poziomu w stałym menu; tytuł każdego elementu jest ograniczony do 30 znaków.
Jak długo może trwać aktualizacja stałego menu na poziomie strony; menu ustawione dla jednej osoby aktualizuje się w czasie rzeczywistym.
Tekst powitania, który według dokumentacji powitań Meta nie działa już w Messengerze na Androidzie i iOS.
Co zawiera profil Messengera?
Ustawienia, od których zaczyna się doświadczenie Messengera strony. Messenger Profile API firmy Meta wymienia te właściwości; każdą ustawia się i odczytuje na tym samym endpointcie. W aplikacji w trybie deweloperskim ustawienia są widoczne tylko dla osób z rolą w aplikacji:
Jak odczytuje się, ustawia i usuwa właściwości?
Trzema metodami na jednym endpointcie, wywoływanymi tokenem strony. POST przyjmuje treść JSON z właściwościami i nadpisuje tylko te, które wskazuje; GET przyjmuje fields jako listę oddzieloną przecinkami, a DELETE przyjmuje treść JSON, w której tablica fields wskazuje, co usunąć. POST i DELETE odpowiadają result success. Ustawienie przycisku Get Started i menu jednym wywołaniem:
POST /{page-id}/messenger_profile
{
"get_started": { "payload": "GET_STARTED" },
"persistent_menu": [
{
"locale": "default",
"composer_input_disabled": false,
"call_to_actions": [
{ "type": "postback", "title": "Talk to an agent", "payload": "AGENT" },
{ "type": "web_url", "title": "Shop now", "url": "https://example.com/shop" }
]
}
]
}
{ "result": "success" }Jak działa przycisk Get Started?
Pojawia się na ekranie powitalnym, który pokazuje nazwę strony, zdjęcie profilowe i zdjęcie w tle oraz to, jak długo firma zwykle odpowiada. Kliknięcie wysyła Get Started do rozmowy, przekazuje get_started.payload do aplikacji jako zdarzenie messaging_postbacks i otwiera standardowe okno wiadomości. Meta zaznacza, że przycisk nie jest obsługiwany, gdy Messenger działa w przeglądarce wbudowanej w aplikację Facebook, a stałe menu wymaga, by najpierw był ustawiony.
Czy tekst powitania nadal działa?
Nie na telefonach. Dokumentacja Meta nosi teraz tytuł [Deprecated] Greeting Text: funkcja nie działa już w Messengerze na Androidzie i iOS. API może nadal przyjmować właściwość greeting, ale klienci jej nie zobaczą, dlatego Meta prosi deweloperów, by z niej nie korzystali. Zgodnie z dokumentacją greeting przechowuje jeden tekst na lokalizację, z wymaganą wartością default, do 160 znaków, personalizowany przez {{user_first_name}}, {{user_last_name}} lub {{user_full_name}}, a ustawienie wymaga roli Administratora strony.
Jak działają lodołamacze?
Zawierają do 4 pytań, które osoba może kliknąć, by rozpocząć rozmowę. Pytanie pojawia się w wątku tak, jakby zadała je ta osoba, a jego payload wraca jako zdarzenie postback. Od kwietnia 2022 są lokalizowane: każdy obiekt w ice_breakers zawiera call_to_actions i locale, wymagana jest lokalizacja default, a DELETE dla ice_breakers usuwa wszystkie z nich. Meta ustala kolejność elementów konkurujących o nową rozmowę:
- Lodołamacze z API mają pierwszeństwo przed przyciskiem Get Started, gdy ustawione są oba.
- Oba pojawiają się przed niestandardowymi pytaniami ustawionymi w skrzynce strony, których edycja jest wyłączona, gdy ustawione są lodołamacze z API.
Jak zbudowane jest stałe menu?
Jako tablica menu, po jednym na lokalizację, z wymaganym domyślnym, z których każde zawiera do 20 call_to_actions typu web_url lub postback. Tytuł może mieć do 30 znaków, a payload postback do 1 000, a ustawienie composer_input_disabled na true sprawia, że menu, przyciski i webviewy są jedynym sposobem interakcji. Wymagania Meta, zanim menu się pojawi:
- Ustawiony przycisk Get Started oraz uprawnienie
pages_messaging. - Opublikowana strona i aplikacja ustawiona jako publiczna.
- Rola Administratora strony dla osoby, która ją ustawia.
- Messenger w wersji v106 lub nowszej na iOS lub Androidzie, poza przeglądarką wbudowaną w aplikację Facebook.
- Zmiany na poziomie strony mogą trwać do 24 godzin; menu dla jednej osoby, ustawione przez
custom_user_settingsz PSID, aktualizuje się w czasie rzeczywistym.
Czym są polecenia?
Słowa kluczowe, które osoba może wywołać w dowolnym momencie z menu poleceń obok pola wiadomości, wpisując ukośnik lub znak @, albo z wyskakującego okna, gdy wpisze pasujące słowo. Każda lokalizacja zawiera od 1 do 100 poleceń, z nazwą od 1 do 32 znaków bez wiodącego ukośnika i opisem od 1 do 64 znaków; gdy polecenia są ustawione, mają pierwszeństwo przed stałym menu. Wywołane polecenia trafiają do aplikacji w zdarzeniu messages, w message.commands.
Do czego służą whitelisted_domains i account_linking_url?
Oba obsługują doświadczenia poza samą rozmową. whitelisted_domains wymienia do 50 domen, które webview Messengera może otworzyć dla SDK Messenger Extensions i wtyczki checkbox; każda musi być obsługiwana przez HTTPS pod w pełni kwalifikowaną nazwą, nigdy adresem IP ani localhost, a ustawienie wymaga roli Administratora strony. account_linking_url to adres callback HTTPS, który łączy konto osoby w Messengerze z jej kontem u firmy.
Jak easyCoexistence ustawia profil Messengera strony?
Nie: żadne narzędzie nie wywołuje {page-id}/messenger_profile, a tokeny strony nie są wydawane, więc ustawienie profilu leży poza tym połączeniem. Polecenia, które osoby wywołują, trafiają w zdarzeniu messages, które easyCoexistence przekazuje, a automatyzacje odczytują; kliknięcia, które Meta raportuje jako zdarzenia messaging_postbacks, z Get Started, pozycji menu postback i lodołamaczy, nie są przekazywane, ponieważ strony są zasubskrybowane do feed, messages i mention.
Typowe błędy
- Ustawienie stałego menu przed Get Started. Wymagania Meta obejmują przycisk Get Started, więc najpierw ustaw get_started.
- Pominięcie domyślnej lokalizacji. Lodołamacze, menu i polecenia wymagają obiektu z locale ustawionym na default jako zapasowym.
- Wywoływanie API profilu w pętli. Meta zezwala na 10 wywołań na 10 minut na stronę, więc umieść kilka właściwości w jednym POST.
- Oczekiwanie natychmiastowej zmiany menu. Aktualizacja menu na poziomie strony może dotrzeć do ludzi nawet po 24 godzinach.
Ustawienie profilu Messengera nie należy do jego narzędzi. Od US$ 9 do US$ 0,75 za połączenie miesięcznie, przy czym cena spada wraz z liczbą połączeń, a pierwsze 3 dni są bezpłatne.
Najczęściej zadawane pytania
Czy stałe menu może różnić się dla każdej osoby?
Tak. custom_user_settings z PSID danej osoby nadpisuje menu strony dla tej osoby, aktualizuje się w czasie rzeczywistym i zezwala na 10 wywołań na osobę w ciągu 10 minut.
Jakie lokalizacje obsługuje profil Messengera?
Te z listy obsługiwanych lokalizacji Meta, na przykład en_GB, pt_BR czy ja_JP, plus default, czyli wartość zapasowa używana, gdy żadna lokalizacja nie pasuje do lokalizacji osoby.
Kto może zmieniać profil Messengera strony?
Aplikacja z tokenem strony z uprawnieniem pages_messaging. Stałe menu, powitanie i lista domen wymagają też roli Administratora strony.
Ile kosztuje easyCoexistence dla strony na Facebooku?
Każda strona to jedno połączenie: od US$ 9 do US$ 0,75 za połączenie miesięcznie, przy czym cena spada wraz ze wzrostem liczby połączeń, a pierwsze 3 dni są bezpłatne.
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