Тұрақты мәзір дегеніміз не
Тұрақты мәзір сізге бизнесіңіздің негізгі функцияларының мәзірін жасауға және жіберуге мүмкіндік береді, мысалы, жұмыс уақыты, дүкендердің орналасқан жері және өнімдер. Ол адамның Messenger-дегі компанияңызбен әңгімелесуі кезінде әрқашан көрінетін болады.
Қолдау көрсетілетін батырмалар:
Тұрақты мәзір батырмалар жиынтығынан тұрады. Тұрақты мәзірде батырмалардың келесі түрлеріне қолдау көрсетіледі:
● URL батырмалары (web_url)
● Кері шақыру батырмалары (postback)
Белгілі бір парақ үшін тұрақты мәзірді қалай қосуға болады
response = fb_set_persistent_menu("group_id", buttons), мұндағы:
group_id - Facebook ботының идентификаторы, (оны "Арна" MaviBot мәзірінен табуға болады)
buttons - батырмаларды қамтитын сөздік
Батырмалар сөздігін құрылымдау мысалы:
buttons = {"default": [["postback", "Батырма 1", "callback_text 1"], ["postback", "Батырма 2", "callback_text 2"], ["web_url", "Сайт сілтемесі", "https://mavibot.ai/"]]}
default - пайдаланушының локализациясына қарамастан, мәзірде әдепкі бойынша көрсетілетін батырмалар массивін анықтайтын міндетті кілт.
Мән батырмалар массиві болуы керек. Әрбір батырма келесі пішімдегі жеке массив ретінде сипатталады:
["батырма_түрі", "Батырманың көрсетілетін мәтіні", "Ботқа жіберілетін кері шақыру мәтіні"]
Батырма түрлері және олардың сипаттамасы:
&#xNAN;- кері шақыру батырмасы:
["postback", "Батырманың көрсетілетін мәтіні", "Ботқа жіберілетін кері шақыру мәтіні"]
&#xNAN;- URL батырмасы:
["web_url", "Сілтеменің көрсетілетін мәтіні", "https://example.com"]
Мәзірді пайдаланушының локализациясына қарай қалай конфигурациялауға болады
Сіз белгілі бір аймақтарға сәйкес келетін қосымша кілттерді батырмалар сөздігіне қосу арқылы әртүрлі аймақтар үшін батырмаларды орната аласыз.
Мысалы, ағылшын тілінің аймағы үшін батырмаларды қосу:
buttons = {"default": [["postback", "Батырма 1", "callback_text 1"], ["postback", "Батырма 2", "callback_text 2"], ["web_url", "Сайт сілтемесі", "https://mavibot.ai/"]], "en_EN": [["postback", "Батырма", "callback_text 1"], ["postback", "Батырма 2", "callback_text 2"], ["web_url", "Сілтеме", "https://mavibot.ai/"]]}
Ескерту: Бұл жағдайда кілт батырмалар көрсетілетін аймақты білдіреді.
Қолдау көрсетілетін аймақтар:
af_ZA, ar_AR, as_IN, az_AZ, be_BY, bg_BG, bn_IN, br_FR, bs_BA, ca_ES, cb_IQ, co_FR, cs_CZ, cx_PH, cy_GB, da_DK, de_DE, el_GR, en_GB, en_UD, en_US, es_ES, es_LA, et_EE, eu_ES, fa_IR, ff_NG, fi_FI, fo_FO, fr_CA, fr_FR, fy_NL, ga_IE, gl_ES, gn_PY, gu_IN, ha_NG, he_IL, hi_IN, hr_HR, hu_HU, hy_AM, id_ID, is_IS, it_IT, ja_JP, ja_KS, jv_ID, ka_GE, kk_KZ, km_KH, kn_IN, ko_KR, ku_TR, lt_LT, lv_LV, mg_MG, mk_MK, ml_IN, mn_MN, mr_IN, ms_MY, mt_MT, my_MM, nb_NO, ne_NP, nl_BE, nl_NL, nn_NO, or_IN, pa_IN, pl_PL, ps_AF, pt_BR, pt_PT, qz_MM, ro_RO, ru_RU, rw_RW, sc_IT, si_LK, sk_SK, sl_SI, so_SO, sq_AL, sr_RS, sv_SE, sw_KE, sz_PL, ta_IN, te_IN, tg_TJ, th_TH, tl_PH, tr_TR, tz_MA, uk_UA, ur_PK, uz_UZ, vi_VN, zh_CN, zh_HK, zh_TW
Белгілі бір пайдаланушы үшін тұрақты мәзірді қалай қосуға болады
Ол үшін fb_set_persistent_menu функциясының үшінші параметрін 1 мәніне орнатыңыз, мысалы: response = fb_set_persistent_menu('group_id', buttons, 1)
Бұл мәзір функция шақырылған пайдаланушыға қолжетімді болады.
ЕСКЕРТУ . Пайдаланушы деңгейіндегі тұрақты мәзірді жаңарту нақты уақыт режимінде күшіне енеді.
Дегенмен, парақ деңгейіндегі тұрақты мәзірді жаңарту 24 сағатқа дейін созылуы мүмкін.Пайдаланушы деңгейіндегі параметрлер шектеулі және әрбір 10 минут сайын бір пайдаланушыға 10 шақырудан аспауы керек.
Тұрақты мәзірден басқа барлық байланыстарды қалай өшіруге болады
Тұрақты мәзірді пайдаланушының Messenger ботыңызбен әрекеттесуінің жалғыз жолы ету үшін композиторды өшіру қажет.
Неліктен мұны істеу керек?
Бұл сіздің ботыңыз белгілі бір мақсатқа немесе алдын ала анықталған опциялар жиынтығына арналған кезде пайдалы.
Мұны қалай істеуге болады?
Композиторды өшіру үшін функцияның төртінші параметрі ретінде 1 мәнін беріңіз:
композиторды парақ деңгейінде (барлық пайдаланушылар үшін) өшіру:
response = fb_set_persistent_menu('group_id', buttons, '', 1)
композиторды функция шақырылған пайдаланушы үшін өшіру:
response = fb_set_persistent_menu('group_id', buttons, 1, 1)
мұндағы:
group_id - Facebook ботының идентификаторы, (оны "Арна" MaviBot мәзірінен табуға болады)
buttons - батырмаларды қамтитын сөздік
Сәтті орындалған жағдайда функция келесіні қайтарады:
{"result":"success"}
Әйтпесе, қате сипаттамасын қайтарады.
'Error parse buttons data' - батырмалар сөздігіндегі қате
{"error":{"message":"(#100) param persistent_menu[0][call_to_actions] must be non-empty.","type":"OAuthException","code":100,"fbtrace_id":"AJtVczu7TEJJxbMfnO"}}
МЫСАЛДАР:
Барлық пайдаланушылар үшін мәзірді қосу:
buttons = {"default": [["postback", "Button 1", "callback_text 1"], ["postback", "Button 2", "callback_text 2"], ["web_url", "Site link", "https://mavibot.ai/"]], "en_EN": [["postback", "Button", "callback_text 1"], ["postback", "Button 2", "callback_text 2"], ["web_url", "Link", "https://mavibot.ai/"]]}
response = fb_set_persistent_menu('123456789', buttons)
Барлық пайдаланушылар үшін мәзірді қосу және бұл мәзірді барлығы үшін жалғыз байланыс әдісі ету:
buttons = {"default": [["postback", "Button 1", "callback_text 1"], ["postback", "Button 2", "callback_text 2"], ["web_url", "Site link", "https://mavibot.ai/"]], "en_EN": [["postback", "Button", "callback_text 1"], ["postback", "Button 2", "callback_text 2"], ["web_url", "Link", "https://mavibot.ai/"]]}
response = fb_set_persistent_menu('123456789', buttons, '', 1)
Функцияны шақыратын блокқа кірген пайдаланушы үшін мәзірді қосу:
buttons = {"default": [["postback", "Button 1", "callback_text 1"], ["postback", "Button 2", "callback_text 2"], ["web_url", "Site link", "https://mavibot.ai/"]]}
response = fb_set_persistent_menu('123456789', buttons, 1)
Функцияны шақыратын блокқа кірген пайдаланушы үшін мәзірді қосу және бұл мәзірді барлық пайдаланушылар үшін жалғыз байланыс әдісі ету:
buttons = {"default": [["postback", "Button 1", "callback_text 1"], ["postback", "Button 2", "callback_text 2"], ["web_url", "Site link", "https://mavibot.ai/"]]}
response = fb_set_persistent_menu('123456789', buttons, 1, 1)
Парақ деңгейіндегі тұрақты мәзірді жою (барлық пайдаланушылар үшін):
response = fb_delete_persistent_menu('group_id')
Сәтті орындалған жағдайда функция келесіні қайтарады:
{"result":"success"}
Әйтпесе, қате сипаттамасын қайтарады.
'Bot not found'
Пайдаланушы деңгейіндегі тұрақты мәзірді жою:
response = fb_delete_persistent_menu('group_id', 1)
Сәтті орындалған жағдайда функция келесіні қайтарады:
{"result":"success"}
Әйтпесе, қате сипаттамасын қайтарады.
"Bot not found"