Mag-log inMagsimula ng Libreng Trial
easyCoexistence Mga Official API

Messenger profile API: greeting, Get Started button, ice breakers at persistent menu

Itinatakda ang Messenger profile ng isang Facebook Page sa /{page-id}/messenger_profile gamit ang Page access token at pages_messaging: ang POST ay nagsusulat ng mga property tulad ng get_started, greeting, ice_breakers, persistent_menu at commands, ang GET ay bumabasa sa mga ito gamit ang fields, at ang DELETE ay nag-aalis ng mga property na nakalista sa fields array. Pinapayagan ng Meta ang 10 call kada 10 minuto kada Page, at tanging yung mga property na ipinadala ang na-o-overwrite.

Sumasagot ang easyCoexistence sa mga usapan sa Messenger ng isang Page gamit ang send_social_dm sa loob ng 24-oras na window, mula sa Claude, ChatGPT o sarili ninyong code, habang ipinapasa sa endpoint ninyo ang mga bagong mensahe habang dumarating.

10 per 10 min

Bilang ng mga tawag sa Messenger Profile API na pinapayagan kada Page sa bawat 10-minutong interval.

4 questions

Pinakamaraming ice breakers na maitatakda ng API; kapag parehong naka-set, mas nauuna ang API ice breakers kaysa sa Get Started button.

20 items

Pinakamaraming top-level na item sa persistent menu; limitado sa 30 character ang title ng bawat item.

24 hours

Gaano katagal maaaring abutin ang update ng menu sa antas ng Page; ang menu na naka-set para sa isang tao ay nag-a-update nang real time.

Deprecated

Teksto ng greeting, na ayon sa reference ng Meta ay hindi na gumagana sa Messenger para sa Android at iOS.

Ano ang laman ng Messenger profile?

Ang mga setting na pinagsisimulan ng Messenger experience ng isang Page. Inilista ng Messenger Profile API ng Meta ang mga property na ito, bawat isa ay natatakda at nababasa sa parehong endpoint; para sa app na nasa Development Mode, nakikita lang ang mga setting ng mga taong may role sa app:

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

Paano binabasa, itinatakda at binubura ang mga property?

Sa tatlong method sa iisang endpoint, tinatawag gamit ang token ng Page. Kinukuha ng POST ang JSON body ng mga property at ina-overwrite lamang ang mga pinangalanan nito, kinukuha ng GET ang fields bilang comma-separated list, at kinukuha ng DELETE ang JSON body na ang fields array ang nagpapangalan kung ano ang aalisin; parehong sumasagot ang POST at DELETE ng result success. Pagtatakda ng Get Started button at menu sa iisang call:

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

Paano gumagana ang Get Started button?

Nasa welcome screen ito, na nagpapakita ng pangalan ng Page, profile picture at cover photo, at kung gaano katagal karaniwang sumasagot ang negosyo. Kapag na-tap, ipo-post ang Get Started sa usapan, ipapadala ang get_started.payload sa app bilang messaging_postbacks event, at magbubukas ang karaniwang messaging window. Sinasabi ng Meta na hindi suportado ang button kapag tumatakbo ang Messenger sa in-app browser ng Facebook app, at kailangan muna itong naka-set bago gumana ang persistent menu.

Gumagana pa ba ang greeting text?

Hindi sa mga telepono. May titulong [Deprecated] Greeting Text ang reference ng Meta: hindi na gumagana ang feature sa Messenger para sa Android at iOS, at kahit tanggapin pa ng API ang greeting property, hindi ito makikita ng mga customer, kaya hinihiling ng Meta sa mga developer na iwasan ito. Ayon sa dokumentasyon, may isang teksto ang greeting kada locale, kailangang may default, hanggang 160 character, puwedeng lagyan ng {{user_first_name}}, {{user_last_name}} o {{user_full_name}}, at ang pagtatakda nito ay nangangailangan ng Administrator role sa Page.

Paano gumagana ang ice breakers?

Naglilista ito ng hanggang 4 na tanong na puwedeng i-tap ng isang tao para magbukas ng usapan; ipinopost ang tanong sa thread na parang tinanong ito ng tao, at ang payload nito ay bumabalik bilang postback event. Mula Abril 2022, may localization na ang mga ito: ang bawat object sa ice_breakers ay may call_to_actions at locale, kailangan ng default locale, at ang DELETE ng ice_breakers ay nag-aalis ng lahat ng ito. Niraranggo ng Meta ang mga elementong nag-aagawan para sa bagong usapan:

  • Nauuna ang API ice breakers kaysa sa Get Started button kapag parehong naka-set.
  • Parehong nauuna bago ang custom questions na naka-set sa Page inbox, na hindi maa-edit habang may naka-set na API ice breakers.

Paano binubuo ang persistent menu?

Bilang array ng menus, isa kada locale na kailangang may default, bawat isa ay may hanggang 20 call_to_actions na uri ng web_url o postback. Hanggang 30 character ang title at hanggang 1,000 ang postback payload, at kapag naka-true ang composer_input_disabled, ang menu, mga button at webview na lang ang paraan ng pakikipag-ugnayan. Mga kinakailangan ng Meta bago ito lumitaw:

  • May Get Started button na naka-set at ang pages_messaging permission.
  • Naka-publish na Page, at naka-public ang app.
  • Administrator role sa Page para sa nagtatakda nito.
  • Messenger v106 pataas sa iOS o Android, labas sa in-app browser ng Facebook app.
  • Ang mga pagbabago sa antas ng Page ay aabutin ng hanggang 24 oras; ang menu para sa isang tao, na itinakda sa pamamagitan ng custom_user_settings gamit ang PSID, ay nag-a-update nang real time.

Ano ang commands?

Mga keyword na magagamit ng isang tao anumang oras, mula sa commands menu sa tabi ng composer, sa pamamagitan ng pag-type ng slash o at sign, o mula sa popover kapag nag-type ng katugmang salita. Bawat locale ay may 1 hanggang 100 commands, na may pangalang 1 hanggang 32 character na walang leading slash at paglalarawang 1 hanggang 64; kapag may naka-set na commands, mas nauuna ang mga ito kaysa sa persistent menu. Ang mga command na ginamit ay umaabot sa app sa loob ng messages event, sa message.commands.

Ano ang ginagawa ng whitelisted_domains at account_linking_url?

Parehong para sa mga karanasang nasa labas mismo ng usapan. Naglilista ang whitelisted_domains ng hanggang 50 domain na puwedeng buksan ng Messenger webview para sa Messenger Extensions SDK at checkbox plugin; bawat isa ay dapat naka-serve sa HTTPS sa ilalim ng fully qualified name, hindi kailanman IP address o localhost, at ang pagtatakda nito ay nangangailangan ng Administrator role sa Page. Ang account_linking_url naman ang HTTPS callback na nag-uugnay ng Messenger account ng isang tao sa account niya sa negosyo.

Paano itinatakda ng easyCoexistence ang Messenger profile ng Page?

Hindi: walang tool na tumatawag sa {page-id}/messenger_profile, at hindi ibinibigay ang mga Page token, kaya labas sa koneksyong ito ang pagtatakda ng profile. Ang mga command na ginagamit ng mga tao ay dumarating sa messages event na ipinapasa ng easyCoexistence at binabasa ng mga automation; ang mga tap na iniuulat ng Meta bilang messaging_postbacks events, mula sa Get Started, postback menu item at ice breakers, ay hindi naipapasa, dahil naka-subscribe ang mga Page sa feed, messages at mention.

Mga karaniwang pagkakamali

  • Pagtatakda ng persistent menu bago ang Get Started. Kasama sa kinakailangan ng Meta ang Get Started button, kaya itakda muna ang get_started.
  • Pag-iwan sa default locale. Kailangan ng bawat ice breakers, menu at commands ng object na may locale na naka-set sa default bilang fallback.
  • Pagtawag sa profile API sa loob ng loop. Pinapayagan ng Meta ang 10 call kada 10 minuto kada Page, kaya ilagay ang maraming property sa iisang POST.
  • Pag-asang agad magbabago ang menu. Ang update sa menu sa antas ng Page ay aabutin ng hanggang 24 oras bago makarating sa mga tao.
Ginagawa ito gamit ang EasyCoexistence

Hindi kabilang sa mga tool nito ang pagtatakda ng Messenger profile. US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang dumarami ang koneksyon, at libre ang unang 3 araw.

Mga madalas itanong

Pwede bang magkaiba ang persistent menu kada tao?

Oo. Ang custom_user_settings na may PSID ng tao ay nag-o-override sa menu ng Page para sa taong iyon, nag-a-update nang real time, at pinapayagan ang 10 call kada tao sa loob ng 10 minuto.

Aling mga locale ang sinusuportahan ng Messenger profile?

Yung mga nasa listahan ng suportadong locale ng Meta, gaya ng en_GB, pt_BR o ja_JP, kasama ang default, ang fallback na ginagamit kapag walang tumutugma sa locale ng tao.

Sino ang puwedeng magpalit ng Messenger profile ng Page?

Ang app na may Page token na may pages_messaging. Kailangan din ng Administrator role sa Page para sa persistent menu, greeting at listahan ng domain.

Magkano ang halaga ng easyCoexistence para sa Facebook Page?

Bawat Page ay isang koneksyon: US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang lumalaki ang bilang ng koneksyon, at libre ang unang 3 araw.

Magpatuloy sa pagbabasa

I-connect ang inyong unang channel sa loob ng dalawang minuto.

Walang review ng platform na hihintayin. I-connect ang WhatsApp, Instagram, TikTok o iba pang channel, pagkatapos ay utusan ang inyong AI na mag-post, mag-reply o gumawa ng report, at panoorin itong gumana.

  • 3 araw na libre
  • Mag-cancel anumang oras
  • Official API lang
  • Minomonitor 24/7

Na-verify noong