Messenger profile API: සුබපැතුම, Get Started බොත්තම, ice breakers සහ persistent menu
Facebook Page එකක Messenger profile එක /{page-id}/messenger_profile හරහා සකසනු ලබන්නේ Page access token එකක් සහ pages_messaging permission එක සමඟය: POST මගින් get_started, greeting, ice_breakers, persistent_menu සහ commands වැනි properties ලියයි, GET fields සමඟ ඒවා කියවයි, සහ DELETE, fields array එකේ නම් කළ ඒවා ඉවත් කරයි. Meta, Page එකකට මිනිත්තු 10කට calls 10ක් අනුමත කරන අතර, යවන properties පමණක් අධිලිවීම සිදු වේ.
easyCoexistence මගින් Claude, ChatGPT හෝ ඔබේම කේතයෙන් Page එකක Messenger සංවාද වලට send_social_dm සමඟ පැය 24ක කාල සීමාව තුළ පිළිතුරු දෙයි; නව පණිවිඩ පැමිණෙන විට ඔබේ endpoint එකට ඉදිරිපත් වේ.
එක් Page එකකට සෑම මිනිත්තු 10ක කාල පරතරයකම Messenger Profile API calls අනුමත ගණන.
API මගින් සැකසිය හැකි උපරිම ice breakers ගණන; දෙකම සකසා ඇති විට API ice breakers, Get Started බොත්තමට වඩා ප්රමුඛ වේ.
persistent menu එකක ඉහළ මට්ටමේ items උපරිම ගණන; සෑම item එකකම title එක අක්ෂර 30කට සීමා වේ.
Page-level persistent menu යාවත්කාලීනයක් ගත හැකි උපරිම කාලය; තනි පුද්ගලයෙකු සඳහා සකසන මෙනුවක් තත්ය කාලයේ යාවත්කාලීන වේ.
සුබපැතුම් පෙළ (Greeting text), Meta ගේ greeting යොමුව අනුව Messenger for Android සහ iOS මත තවදුරටත් ක්රියා නොකරයි.
Messenger profile එකේ කුමක් ඇතුළත් වේද?
Facebook Page එකක Messenger අත්දැකීම ආරම්භ වන සැකසුම් මේවාය. Meta හි Messenger Profile API මෙම properties ලැයිස්තු ගත කර ඇති අතර, ඒවා සියල්ලම එකම endpoint එකෙන් සකසා කියවිය හැක; Development Mode හි ඇති යෙදුමක් සඳහා මෙම සැකසුම් දිස්වන්නේ යෙදුමේ role ඇති අයට පමණි:
Properties කියවන, සකසන සහ මකන්නේ කෙසේද?
Page එකේ token එකෙන් ඇමතෙන, එක endpoint එකක ක්රම තුනකින්. POST මගින් JSON body එකක properties ලබා ගන්නා අතර ඒවා නම් කරන ඒවා පමණක් යලි ලියයි; GET fields comma-separated ලැයිස්තුවක් ලෙස ගනී; DELETE, මැකිය යුතු දේ fields array එකෙන් නම් කරන JSON body එකක් ගනී. POST සහ DELETE result success ලෙස පිළිතුරු දෙයි. Get Started බොත්තම සහ මෙනුව එක ඇමතුමකින් සැකසීම:
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" }Get Started බොත්තම ක්රියා කරන්නේ කෙසේද?
එය ආයුබෝවන් තිරයේ පිහිටයි; එහි Page එකේ නම, පැතිකඩ පින්තූරය, කවර් ඡායාරූපය සහ ව්යාපාරය සාමාන්යයෙන් පිළිතුරු දීමට ගන්නා කාලය පෙන්වයි. ටැප් කිරීමකින් Get Started සංවාදයට යවන අතර, get_started.payload යෙදුමට messaging_postbacks event එකක් ලෙස යවා සම්මත පණිවිඩ කවුළුව විවෘත කරයි. Messenger, Facebook යෙදුමේ in-app browser එකේ ක්රියා කරන විට බොත්තම සහාය නොදක්වන බව Meta සටහන් කරයි, සහ persistent menu එකක් සඳහා එය පළමුව සකසා තිබිය යුතුය.
සුබපැතුම් පෙළ තවමත් ක්රියා කරයිද?
දුරකථනවලට නොවේ. Meta ගේ යොමුව දැන් [Deprecated] Greeting Text ලෙස නම් කර ඇත: මෙම විශේෂාංගය Messenger for Android සහ iOS මත තවදුරටත් ක්රියා නොකරන අතර, API මගින් greeting property තවමත් පිළිගනු ඇතත්, පාරිභෝගිකයින් එය නොදකිනු ඇත; එබැවින් එය භාවිත නොකරන ලෙස Meta සංවර්ධකයින්ගෙන් ඉල්ලයි. ලේඛනගත ආකාරයට, greeting හි locale එකකට එක් පෙළක් ඇති අතර default අනිවාර්ය වේ, අක්ෂර 160 දක්වා, {{user_first_name}}, {{user_last_name}} හෝ {{user_full_name}} සමඟ පුද්ගලීකරණය කළ හැක, සහ එය සැකසීමට Page එකේ Administrator role එක අවශ්ය වේ.
Ice breakers ක්රියා කරන්නේ කෙසේද?
පුද්ගලයෙකුට සංවාදයක් ආරම්භ කිරීමට ටැප් කළ හැකි ප්රශ්න 4ක් දක්වා ලැයිස්තු ගත කරයි; ප්රශ්නය පුද්ගලයා එය ඇසුවා සේ නූල තුළ පළ වන අතර, එහි payload postback event එකක් ලෙස ආපසු ලැබේ. 2022 අප්රේල් සිට ඒවා දේශීයකරණය කර ඇත: ice_breakers හි සෑම object එකකම call_to_actions සහ locale ඇතුළත් වන අතර, default locale එක අනිවාර්ය වන අතර, ice_breakers හි DELETE මගින් ඒවා සියල්ල ඉවත් කරයි. නව සංවාදයක් සඳහා තරග කරන elements Meta ශ්රේණිගත කරන ආකාරය:
- දෙකම සකසා ඇති විට API ice breakers, Get Started බොත්තමට වඩා ප්රමුඛ වේ.
- දෙකම Page inbox හි සකසන custom questions වලට පෙර පිහිටයි; ඒවායේ සංස්කරණය API ice breakers සකසා ඇති අතරතුර අක්රීය වේ.
Persistent menu ගොඩනඟන්නේ කෙසේද?
locale එකකට එක් මෙනුවක් ලෙස menus අරාවක් ලෙස, default අනිවාර්ය වන අතර, සෑම එකකම web_url හෝ postback වර්ගයේ call_to_actions 20ක් දක්වා ඇත. title එකකට අක්ෂර 30ක් දක්වා ඉඩ ඇති අතර postback payload එකකට 1,000ක් දක්වා, සහ composer_input_disabled true ලෙස සැකසූ විට මෙනුව, බොත්තම් සහ webview පමණක් අන්තර්ක්රියා කිරීමේ එකම ක්රමය වේ. දිස්වීමට පෙර Meta ගේ අවශ්යතා:
- Get Started බොත්තම දැනටමත් සකසා ඇති අතර
pages_messagingpermission ඇත. - Published Page එකක්, සහ යෙදුම public ලෙස සකසා ඇත.
- එය සකසන පුද්ගලයා සඳහා Page එකේ Administrator role එක.
- iOS හෝ Android මත Messenger v106 හෝ ඊට පසු, Facebook යෙදුමේ in-app browser එකෙන් පිටත.
- Page-level වෙනස්කම්වලට පැය 24ක් දක්වා ගත විය හැක; තනි පුද්ගලයෙකු සඳහා මෙනුව, PSID සහිත
custom_user_settingsහරහා සකසූ විට, තත්ය කාලයේ යාවත්කාලීන වේ.
Commands යනු කුමක්ද?
පුද්ගලයෙකුට ඕනෑම වේලාවක ආයාචනා කළ හැකි මූල පද, composer අසල commands මෙනුවෙන්, slash හෝ at sign එකක් ටයිප් කිරීමෙන්, හෝ ගැලපෙන වචනයක් ටයිප් කරන විට popover එකෙන්. සෑම locale එකකම නම අක්ෂර 1 සිට 32 දක්වා, ආරම්භක slash නොමැතිව, සහ විස්තරය 1 සිට 64 දක්වා වූ commands 1 සිට 100 දක්වා ඇත; commands සකසා ඇති විට ඒවාට persistent menu ට වඩා ප්රමුඛතාව ඇත. ආයාචනා කළ commands, messages event එක තුළ message.commands ලෙස යෙදුමට ළඟා වේ.
whitelisted_domains සහ account_linking_url කරන්නේ කුමක්ද?
දෙකම සංවාදයෙන් පිටත අත්දැකීම් සේවා කරයි. whitelisted_domains මගින් Messenger webview එකට Messenger Extensions SDK සහ checkbox plugin සඳහා විවෘත කළ හැකි domains 50ක් දක්වා ලැයිස්තු ගත කරන අතර, සෑම එකක්ම සම්පූර්ණ නම සහිත HTTPS හරහා සේවා කළ යුතුය, කිසි විටෙක IP ලිපිනයක් හෝ localhost නොවිය යුතුය, සහ එය සැකසීමට Page එකේ Administrator role එක අවශ්ය වේ. account_linking_url යනු පුද්ගලයෙකුගේ Messenger ගිණුම ව්යාපාරය සමඟ ඔවුන්ගේ ගිණුමට සම්බන්ධ කරන HTTPS callback එකයි.
easyCoexistence Page එකක Messenger profile එක සකසන්නේ කෙසේද?
එය නොකරයි: {page-id}/messenger_profile ඇමතීමට කිසිදු tool එකක් නැත, සහ Page tokens ලබා දෙන්නේ නැත, එබැවින් profile එක සැකසීම මෙම සම්බන්ධතාවෙන් පිටත වේ. පුද්ගලයින් ආයාචනා කරන commands, easyCoexistence ඉදිරියට යවන සහ automations කියවන messages event එකට ළඟා වේ; Meta messaging_postbacks events ලෙස වාර්තා කරන, Get Started, postback menu items සහ ice breakers වලින් ලැබෙන tap, ඉදිරියට යවනු නොලැබේ, මන්ද Pages feed, messages සහ mention වෙත දායකත්වය ලබා ඇත.
සාමාන්ය වැරදි
- Persistent menu එක Get Started ට පෙර සැකසීම. Meta ගේ අවශ්යතා අතර Get Started බොත්තමක් ඇතුළත් වන බැවින්, පළමුව get_started සකසන්න.
- Default locale එක මඟ හැරීම. Ice breakers, මෙනු සහ commands සෑම එකකටම fallback ලෙස locale එක default ලෙස සහිත object එකක් අවශ්ය වේ.
- Profile API එක loop එකක ඇමතීම. Meta සෑම Page එකකටම මිනිත්තු 10කට calls 10ක් අනුමත කරන බැවින්, POST එකකට properties කිහිපයක් දමන්න.
- මෙනු වෙනසක් වහාම දකිනු ඇතැයි අපේක්ෂා කිරීම. Page-level මෙනු යාවත්කාලීනයකට පුද්ගලයින් වෙත ළඟා වීමට පැය 24ක් දක්වා ගත විය හැක.
Messenger profile එක සැකසීම එහි tools අතර නැත. සම්බන්ධතාවයකට මාසිකව US$ 9 සිට US$ 0.75 දක්වා, සම්බන්ධතා එකතු කරන විට මිල පහත වැටේ, පළමු දින 3ක් නොමිලේ trial කාලය.
නිතර අසන ප්රශ්න
පුද්ගලයෙකුට අනුව persistent menu වෙනස් විය හැකිද?
ඔව්. පුද්ගලයාගේ PSID සහිත custom_user_settings මගින් ඒ පුද්ගලයා සඳහා Page එකේ මෙනුව අභිබවයි, තත්ය කාලයේ යාවත්කාලීන වන අතර පුද්ගලයෙකුට මිනිත්තු 10කට calls 10ක් අනුමත කරයි.
Messenger profile එක කුමන locales සඳහා සහාය දක්වයිද?
Meta ගේ සහාය දක්වන locales ලැයිස්තුවේ ඇති ඒවා, උදාහරණ ලෙස en_GB, pt_BR හෝ ja_JP, සහ default, පුද්ගලයාගේ locale එකට ගැලපීමක් නොමැති විට භාවිත වන fallback එක.
Page එකක Messenger profile එක කාට වෙනස් කළ හැකිද?
pages_messaging ඇති Page token එකක් සහිත යෙදුමක්. persistent menu, සුබපැතුම සහ domain ලැයිස්තුවටද Page එකේ Administrator role එක අවශ්ය වේ.
Facebook Page එකක් සඳහා easyCoexistence කොපමණ වියදම් වේද?
සෑම Page එකක්ම එක සම්බන්ධතාවයකි: සම්බන්ධතාවයකට මාසිකව US$ 9 සිට US$ 0.75 දක්වා, ඔබේ සම්බන්ධතා ගණන වැඩි වන විට මිල පහත වැටේ, සහ පළමු දින 3 නොමිලේ.
තවදුරටත් කියවන්න
ඔබේ පළමු channel එක මිනිත්තු දෙකකින් සම්බන්ධ කරන්න.
වේදිකා සමාලෝචන සඳහා බලා සිටීමට අවශ්ය නැත. WhatsApp, Instagram, TikTok හෝ වෙනත් channel එකක් සම්බන්ධ කර, පසුව ඔබේ AI හට පළ කිරීමට, ප්රතිචාර දැක්වීමට හෝ වාර්තා කිරීමට පවසා එය වැඩ කරන ආකාරය බලන්න.
- දින 3ක් නොමිලේ
- ඕනෑම වේලාවක අවලංගු කරන්න
- නිල API පමණි
- 24/7 නිරීක්ෂණය කෙරේ
සත්යාපනය කළේ