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

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.

10 per 10 min

Liczba wywołań Messenger Profile API dozwolonych na stronę w każdym 10-minutowym interwale.

4 questions

Maksymalna liczba lodołamaczy, jakie ustawia API; gdy ustawione są oba rodzaje, lodołamacze z API mają pierwszeństwo przed przyciskiem Get Started.

20 items

Maksymalna liczba elementów najwyższego poziomu w stałym menu; tytuł każdego elementu jest ograniczony do 30 znaków.

24 hours

Jak długo może trwać aktualizacja stałego menu na poziomie strony; menu ustawione dla jednej osoby aktualizuje się w czasie rzeczywistym.

Deprecated

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:

get_startedThe payload sent as a messaging_postbacks event when someone taps Get Started
greetingLocale-specific welcome screen text, which Meta marks deprecated as of November 2026
ice_breakersUp to 4 questions a person can tap to start the conversation
persistent_menuUp to 20 buttons kept in the conversation, per locale
commandsKeywords a person can tap or type, each with a description
whitelisted_domainsUp to 50 HTTPS domains for the Messenger Extensions SDK and the checkbox plugin
account_linking_urlThe HTTPS callback for linking a person's account with the business
subject_to_new_eu_privacy_rulesRead-only flag for Pages affected by Meta's Messenger API updates for Europe

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:

Get Started and a persistent menu in one POST
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_settings z 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.
Z EasyCoexistence zrobisz to

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