Prijavite seZapočnite besplatno probno razdoblje
easyCoexistence Službeni API-ji

Messenger profil API: pozdrav, gumb Get Started, ledolomci i trajni izbornik

Messenger profil Facebook stranice postavlja se putem /{page-id}/messenger_profile uz pristupni token stranice i dopuštenje pages_messaging: POST zapisuje svojstva poput get_started, greeting, ice_breakers, persistent_menu i commands, GET ih čita uz parametar fields, a DELETE uklanja svojstva navedena u nizu fields. Meta dopušta 10 poziva u 10 minuta po stranici, a prepisuju se samo poslana svojstva.

easyCoexistence odgovara u Messenger razgovorima stranice pomoću send_social_dm unutar 24-satnog prozora, iz Claudea, ChatGPT-ja ili vlastitog koda, uz prosljeđivanje novih poruka vašem endpointu čim stignu.

10 per 10 min

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

4 questions

Najviše ledolomaca koje API postavlja; kada su postavljena oba, ledolomci iz API-ja imaju prednost nad gumbom Get Started.

20 items

Najviše stavki na najvišoj razini trajnog izbornika; naslov svake stavke ograničen je na 30 znakova.

24 hours

Koliko dugo može trajati ažuriranje trajnog izbornika na razini stranice; izbornik postavljen za jednu osobu ažurira se u stvarnom vremenu.

Deprecated

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

Što sadrži Messenger profil?

Postavke od kojih polazi Messenger iskustvo stranice. Metin Messenger Profile API navodi ta svojstva, a svako se postavlja i čita na istom endpointu. Za aplikaciju u Development Mode postavke su vidljive samo osobama s ulogom 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?

Trima metodama na jednom endpointu, pozivanim s tokenom stranice. POST prima JSON tijelo sa svojstvima i prepisuje samo ona koja navede, GET prima fields kao popis odvojen zarezima, a DELETE prima JSON tijelo čije polje fields navodi što treba ukloniti; POST i DELETE odgovaraju s result success. Postavljanje gumba Get Started i izbornika 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 gumb Get Started?

Nalazi se na zaslonu dobrodošlice, koji prikazuje naziv stranice, profilnu sliku i naslovnu fotografiju te koliko poduzeću obično treba za odgovor. Dodir šalje Get Started u razgovor, šalje get_started.payload aplikaciji kao događaj messaging_postbacks i otvara standardni prozor za poruke. Meta napominje da gumb nije podržan kada se Messenger pokreće u ugrađenom pregledniku Facebook aplikacije, a trajni izbornik zahtijeva da prvo bude postavljen.

Radi li još tekst pozdrava?

Ne na telefonima. Metina referenca sada nosi naslov [Deprecated] Greeting Text: značajka više ne radi na Messengeru za Android i iOS, a API možda i dalje prihvaća svojstvo greeting, ali ga korisnici neće vidjeti, pa Meta traži da ga programeri izbjegavaju. Kako je dokumentirano, greeting sadrži jedan tekst po lokalitetu, s obaveznim default, do 160 znakova, personaliziran s {{user_first_name}}, {{user_last_name}} ili {{user_full_name}}, a postavljanje zahtijeva ulogu administratora stranice.

Kako rade ledolomci?

Popisuju do 4 pitanja koja osoba može dodirnuti da bi otvorila razgovor; pitanje se objavljuje u niti kao da ga je osoba postavila, a njegov payload vraća se kao postback događaj. Od travnja 2022. lokalizirani su: svaki objekt u ice_breakers sadrži call_to_actions i locale, zadani lokalitet je obavezan, a DELETE nad ice_breakers uklanja sve ih. Meta rangira elemente koji se natječu za novi razgovor:

  • API ledolomci imaju prednost nad gumbom Get Started kada su postavljeni oba.
  • Oba dolaze prije prilagođenih pitanja postavljenih u ulaznom sandučiću stranice, čije je uređivanje onemogućeno dok su postavljeni API ledolomci.

Kako je izgrađen trajni izbornik?

Kao niz izbornika, po jedan za svaki lokalitet, s obaveznim default, pri čemu svaki sadrži do 20 call_to_actions tipa web_url ili postback. Naslov može imati do 30 znakova, a payload postbacka do 1.000, a composer_input_disabled postavljen na true ostavlja izbornik, gumbe i webviewe kao jedini način interakcije. Metini uvjeti prije prikazivanja:

  • Postavljen gumb Get Started i dopuštenje pages_messaging.
  • Objavljena stranica i aplikacija na javnoj postavci.
  • Uloga administratora stranice za onoga tko ga postavlja.
  • Messenger v106 ili noviji na iOS-u ili Androidu, izvan ugrađenog preglednika Facebook aplikacije.
  • Promjene na razini stranice mogu trajati do 24 sata; izbornik za jednu osobu, postavljen kroz custom_user_settings s PSID-om, ažurira se u stvarnom vremenu.

Što su naredbe?

Ključne riječi koje osoba može pozvati u bilo kojem trenutku, iz izbornika naredbi pored polja za unos, upisivanjem kose crte (/) ili znaka @, ili iz skočnog prozora kada upiše odgovarajuću riječ. Svaki lokalitet sadrži 1 do 100 naredbi, s nazivom od 1 do 32 znaka bez vodeće kose crte i opisom od 1 do 64; kada su naredbe postavljene, imaju prednost nad trajnim izbornikom. Pozvane naredbe stižu aplikaciji unutar događaja messages, u message.commands.

Što rade whitelisted_domains i account_linking_url?

Obje služe iskustvima izvan samog razgovora. whitelisted_domains navodi do 50 domena koje Messenger webview smije otvoriti za Messenger Extensions SDK i checkbox dodatak, svaki poslužen preko HTTPS-a pod potpuno kvalificiranim nazivom, nikada IP adresom ili localhostom, a postavljanje zahtijeva ulogu administratora stranice. account_linking_url je HTTPS povratni poziv koji povezuje Messenger račun osobe s njezinim računom kod poduzeća.

Kako easyCoexistence postavlja Messenger profil stranice?

Ne može: nijedan alat ne poziva {page-id}/messenger_profile, a tokeni stranice se ne daju, pa je postavljanje profila izvan ove veze. Naredbe koje korisnici pozivaju stižu u događaju messages koji easyCoexistence prosljeđuje i koji čitaju automatizacije; dodiri koje Meta prijavljuje kao događaje messaging_postbacks, iz gumba Get Started, stavki izbornika s postbackom i ledolomaca, ne prosljeđuju se jer su stranice pretplaćene na feed, messages i mention.

Uobičajene pogreške

  • Postavljanje trajnog izbornika prije gumba Get Started. Meta među zahtjevima navodi gumb Get Started, pa prvo postavite get_started.
  • Izostavljanje zadanog lokaliteta. Ledolomci, izbornici i naredbe svaki trebaju objekt s locale postavljenim na default kao rezervu.
  • Pozivanje API-ja profila u petlji. Meta dopušta 10 poziva u 10 minuta po stranici, pa više svojstava stavite u jedan POST.
  • Očekivanje trenutne promjene izbornika. Ažuriranje izbornika na razini stranice može trajati do 24 sata da dođe do korisnika.
Radite ovo uz EasyCoexistence

Postavljanje Messenger profila nije među njegovim alatima. US$ 9 do US$ 0,75 po vezi mjesečno, uz pad cijene kako dodajete veze, s besplatnim probnim razdobljem od 3 dana.

Često postavljana pitanja

Može li se trajni izbornik razlikovati po osobi?

Može. custom_user_settings s PSID-om osobe nadjačava izbornik stranice za tu osobu, ažurira se u stvarnom vremenu i dopušta 10 poziva po osobi u 10 minuta.

Koje lokalitete Messenger profil podržava?

One s Metinog popisa podržanih lokaliteta, npr. en_GB, pt_BR ili ja_JP, uz default kao rezervu kada nijedan lokalitet ne odgovara osobi.

Tko može mijenjati Messenger profil stranice?

Aplikacija s tokenom stranice koji ima pages_messaging. Trajni izbornik, pozdrav i popis domena također zahtijevaju ulogu administratora stranice.

Koliko košta easyCoexistence za Facebook stranicu?

Svaka stranica je jedna veza: od US$ 9 do US$ 0,75 po vezi mjesečno, uz pad cijene kako raste broj veza, a prva 3 dana su besplatna.

Nastavite čitati

Povežite svoj prvi kanal u dvije minute.

Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo službeni API-ji
  • Nadzor 24/7

Provjereno na