Prijavite seZapočnite besplatni probni period
easyCoexistence Zvanični API-ji

Messenger profile API: pozdrav, dugme Get Started, ledolomci i trajni meni

Messenger profil Facebook stranice postavlja se preko /{page-id}/messenger_profile uz token stranice i dozvolu pages_messaging: POST upisuje svojstva kao što su get_started, greeting, ice_breakers, persistent_menu i commands, GET ih čita uz fields, a DELETE uklanja one navedene u nizu fields. Meta dozvoljava 10 poziva na 10 minuta po stranici, a prepisuju se samo poslata svojstva.

easyCoexistence odgovara na Messenger razgovore stranice preko send_social_dm unutar 24-časovnog prozora, iz Claude-a, ChatGPT-ja ili vašeg koda, dok nove poruke stižu na vaš endpoint čim pristignu.

10 per 10 min

Broj poziva Messenger Profile API-ja dozvoljen po stranici u svakom intervalu od 10 minuta.

4 questions

Maksimalan broj ledolomaca koje API postavlja; kada su oba postavljena, ledolomci iz API-ja imaju prednost nad dugmetom Get Started.

20 items

Maksimalan broj stavki najvišeg nivoa u trajnom meniju; naslov svake stavke ograničen je na 30 karaktera.

24 hours

Koliko može da traje ažuriranje trajnog menija na nivou stranice; meni postavljen za jednu osobu ažurira se u realnom vremenu.

Deprecated

Tekst pozdrava, za koji Metina referenca kaže da više ne radi u Messengeru na Android i iOS uređajima.

Šta sadrži Messenger profil?

Podešavanja od kojih počinje Messenger iskustvo stranice. Metin Messenger Profile API navodi ta svojstva, a svako se postavlja i čita preko istog endpointa; za aplikaciju u razvojnom režimu (Development Mode) podešavanja su vidljiva samo osobama koje imaju ulogu u aplikaciji:

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

Kako se svojstva čitaju, postavljaju i brišu?

Tri metode na jednom endpointu, pozivaju se tokenom stranice. POST uzima JSON telo sa svojstvima i prepisuje samo ona koja navede, GET uzima fields kao listu odvojenu zarezima, a DELETE uzima JSON telo čiji niz fields navodi šta se uklanja; POST i DELETE odgovaraju sa result success. Postavljanje dugmeta Get Started i menija u jednom pozivu:

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" }

Kako radi dugme Get Started?

Nalazi se na ekranu dobrodošlice, koji prikazuje ime stranice, profilnu sliku i naslovnu fotografiju, kao i koliko firmi obično treba da odgovori. Dodir šalje Get Started u razgovor, prosleđuje get_started.payload aplikaciji kao događaj messaging_postbacks i otvara standardni prozor za razgovor. Meta napominje da dugme nije podržano kada se Messenger otvara u ugrađenom pregledaču aplikacije Facebook, a trajni meni prvo zahteva da ovo dugme bude postavljeno.

Da li pozdravni tekst i dalje radi?

Ne na telefonima. Metina referenca sada nosi naslov [Deprecated] Greeting Text: funkcija više ne radi u Messengeru na Android i iOS uređajima, a iako API možda još prihvata svojstvo greeting, kupci ga neće videti, pa Meta traži da ga developeri izbegavaju. Prema dokumentaciji, greeting sadrži jedan tekst po jeziku, sa obaveznim podrazumevanim jezikom, do 160 karaktera, personalizovan sa {{user_first_name}}, {{user_last_name}} ili {{user_full_name}}, a za postavljanje je potrebna uloga Administrator na stranici.

Kako rade ledolomci?

Nude do 4 pitanja na koja osoba može da dodirne da bi otvorila razgovor; pitanje se objavljuje u niti kao da ga je osoba postavila, a njegov payload stiže nazad kao događaj postback. Od aprila 2022. lokalizovani su: svaki objekat u ice_breakers sadrži call_to_actions i locale, podrazumevani jezik je obavezan, a DELETE nad ice_breakers uklanja sve njih. Meta rangira elemente koji se takmiče za novi razgovor:

  • API ledolomci imaju prednost nad dugmetom Get Started kada su oba postavljena.
  • Oba dolaze pre prilagođenih pitanja postavljenih u inboxu stranice, čije je uređivanje onemogućeno dok su API ledolomci postavljeni.

Kako je izgrađen trajni meni?

Kao niz menija, jedan po jeziku sa obaveznim podrazumevanim jezikom, pri čemu svaki sadrži do 20 call_to_actions tipa web_url ili postback. Naslov može imati do 30 karaktera, a postback payload do 1.000, a composer_input_disabled postavljen na true ostavlja meni, dugmad i webview-ove kao jedini način interakcije. Metini uslovi pre nego što se prikaže:

  • Već postavljeno dugme Get Started i dozvola pages_messaging.
  • Objavljena stranica, a aplikacija postavljena na javnu.
  • Uloga Administrator na stranici za onoga ko ga postavlja.
  • Messenger v106 ili noviji na iOS ili Android uređajima, van ugrađenog pregledača aplikacije Facebook.
  • Promene na nivou stranice mogu trajati do 24 sata; meni za jednu osobu, postavljen kroz custom_user_settings sa PSID-om, ažurira se u realnom vremenu.

Šta su komande?

Ključne reči koje osoba može da pozove bilo kada, iz menija komandi pored polja za unos, kucanjem kose crte ili znaka @, ili iz iskačućeg prozora kada otkuca odgovarajuću reč. Svaki jezik sadrži od 1 do 100 komandi, sa imenom od 1 do 32 karaktera bez vodeće kose crte i opisom od 1 do 64; kada su komande postavljene, imaju prioritet nad trajnim menijem. Pozvane komande stižu aplikaciji unutar događaja messages, u message.commands.

Šta rade whitelisted_domains i account_linking_url?

Oba služe iskustvima van samog razgovora. whitelisted_domains navodi do 50 domena koje Messenger webview može da otvori za Messenger Extensions SDK i checkbox plugin, a svaki mora biti servisiran preko HTTPS-a pod potpuno kvalifikovanim imenom, nikada IP adresom ili localhost-om; za postavljanje je potrebna uloga Administrator na stranici. account_linking_url je HTTPS povratni poziv (callback) koji povezuje Messenger nalog osobe sa njenim nalogom kod firme.

Kako easyCoexistence postavlja Messenger profil stranice?

Ne: nijedan alat ne poziva {page-id}/messenger_profile, a tokeni stranice se ne dele, pa je postavljanje profila van ove veze. Komande koje ljudi pozivaju stižu u događaju messages koji easyCoexistence prosleđuje i koji čitaju automatizacije; dodiri koje Meta prijavljuje kao događaje messaging_postbacks, iz Get Started, stavki menija sa postback-om i ledolomaca, ne prosleđuju se, jer su stranice pretplaćene na feed, messages i mention.

Česte greške

  • Postavljanje trajnog menija pre Get Started. Metini uslovi uključuju dugme Get Started, zato prvo postavite get_started.
  • Izostavljanje podrazumevanog jezika. Ledolomci, meniji i komande svaki treba objekat sa locale postavljenim na default kao rezervu.
  • Pozivanje API-ja profila u petlji. Meta dozvoljava 10 poziva na 10 minuta po stranici, zato više svojstava stavite u jedan POST.
  • Očekivanje da se promena menija odmah primeni. Ažuriranje menija na nivou stranice može trajati do 24 sata da stigne do ljudi.
Ovo radite uz EasyCoexistence

Postavljanje Messenger profila nije među njegovim alatima. Od US$ 9 do US$ 0,75 po vezi mesečno, a cena pada kako dodajete veze, uz prva 3 dana besplatno.

Često postavljana pitanja

Može li trajni meni da se razlikuje za svaku osobu?

Da. custom_user_settings sa PSID-om te osobe nadjačava meni stranice za nju, ažurira se u realnom vremenu i dozvoljava 10 poziva po osobi za 10 minuta.

Koje jezike Messenger profil podržava?

One sa Metine liste podržanih jezika, poput en_GB, pt_BR ili ja_JP, uz podrazumevani jezik, rezervu koja se koristi kada nijedan ne odgovara jeziku osobe.

Ko može da menja Messenger profil stranice?

Aplikacija sa tokenom stranice koji nosi dozvolu pages_messaging. Trajni meni, pozdrav i lista domena zahtevaju i ulogu Administrator na stranici.

Koliko košta easyCoexistence za Facebook stranicu?

Svaka stranica je jedna veza: od US$ 9 do US$ 0,75 po vezi mesečno, pri čemu cena pada kako raste broj veza, a prva 3 dana su besplatna.

Nastavite sa čitanjem

Povežite prvi kanal za dva minuta.

Bez čekanja na odobrenja platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoj AI da objavi, odgovori ili napravi izveštaj, i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo zvanični API-ji
  • Nadzor 24/7

Provereno na