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.
Broj poziva Messenger Profile API-ja po stranici u svakom intervalu od 10 minuta.
Najviše ledolomaca koje API postavlja; kada su postavljena oba, ledolomci iz API-ja imaju prednost nad gumbom Get Started.
Najviše stavki na najvišoj razini trajnog izbornika; naslov svake stavke ograničen je na 30 znakova.
Koliko dugo može trajati ažuriranje trajnog izbornika na razini stranice; izbornik postavljen za jednu osobu ažurira se u stvarnom vremenu.
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:
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:
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_settingss 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.
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