Facebook API

20.07.2026

Осы бетте

Тұрақты мәзір дегеніміз не?

Тұрақты мәзір бизнесіңіздің негізгі әрекеттерін, мысалы, жұмыс уақыты, дүкен мекенжайлары, өнімдер немесе басқа жиі қолданылатын опцияларды көрсетуге мүмкіндік береді. Мәзір Facebook Messenger ботыңызбен сөйлесу кезінде әрқашан көрінеді.

Қолдау көрсетілетін батырма түрлері

Тұрақты мәзір келесі батырма түрлерін қолдайды:

URL батырмалары (web_url)
Кері шақыру батырмалары (postback)

Тұрақты мәзірді құру

Facebook парақшасы үшін Тұрақты мәзірді құру үшін келесі функцияны пайдаланыңыз:

response = fb_set_persistent_menu(group_id, buttons)

Параметрлер

Параметр	Сипаттама
group_id	Facebook Bot ID. Оны MaviBot жобаңыздың Арна бөлімінен таба аласыз.
buttons	Мәзір батырмаларын сипаттайтын сөздік.

Батырма сөздігінің құрылымы

buttons = {
    "default": [
        ["postback", "Button 1", "callback_text 1"],
        ["postback", "Button 2", "callback_text 2"],
        ["web_url", "Website", "https://mavibot.ai/"]
    ]
}

default кілті міндетті. Ол тіліне арнайы мәзір жоқ пайдаланушыларға көрсетілетін батырмаларды анықтайды.

Әрбір батырма массив арқылы сипатталады:

["button_type", "Button text", "Value"]

Қолдау көрсетілетін батырма пішімдері

Кері шақыру батырмасы

["postback", "Button text", "callback_text"]

Мән	Сипаттама
postback	Батырма түрі.
Button text	Батырмада көрсетілетін мәтін.
callback_text	Батырманы басқан кезде ботқа жіберілетін мәтін.

URL батырмасы

["web_url", "Button text", "https://example.com"]

Мән	Сипаттама
web_url	Батырма түрі.
Button text	Батырмада көрсетілетін мәтін.
URL	Батырманы басқан кезде ашылатын веб-сайт.

Локализация

Пайдаланушының тіліне байланысты әртүрлі мәзірлерді көрсете аласыз.

Батырма сөздігіне қосымша кілттерді қосу жеткілікті.

Мысал:

buttons = {
    "default": [
        ["postback", "Button 1", "callback_text 1"],
        ["postback", "Button 2", "callback_text 2"],
        ["web_url", "Website", "https://mavibot.ai/"]
    ],
    "en_EN": [
        ["postback", "Button", "callback_text 1"],
        ["postback", "Button 2", "callback_text 2"],
        ["web_url", "Website", "https://mavibot.ai/"]
    ]
}

Бұл мысалда en_EN тіліндегі пайдаланушылар басқа мәзірді алады.

Қолдау көрсетілетін тілдер

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

Белгілі бір пайдаланушыға арналған Тұрақты мәзірді құру

Функция шақырылған пайдаланушыға ғана көрінетін мәзірді құру үшін үшінші параметр ретінде 1 мәнін беріңіз.

response = fb_set_persistent_menu(group_id, buttons, 1)

Ескерту

Пайдаланушы деңгейіндегі Тұрақты мәзірлер дереу жаңартылады.

Парақша деңгейіндегі Тұрақты мәзірлердің жаңартылуы 24 сағатқа дейін созылуы мүмкін.

Facebook сонымен қатар пайдаланушы деңгейіндегі мәзір жаңартуларын 10 минут ішінде бір пайдаланушыға 10 сұрау шектейді.

Композиторды өшіру

Messenger композиторын өшіруге болады, осылайша пайдаланушылар ботпен тек Тұрақты мәзір арқылы әрекеттесе алады.

Бұл бот тек алдын ала анықталған әрекеттерге рұқсат беруі керек болғанда пайдалы.

Барлық пайдаланушылар үшін композиторды өшіру

response = fb_set_persistent_menu(group_id, buttons, "", 1)

Белгілі бір пайдаланушы үшін композиторды өшіру

response = fb_set_persistent_menu(group_id, buttons, 1, 1)

Параметрлер

Параметр	Сипаттама
group_id	Facebook Bot ID.
buttons	Батырма сөздігі.
3-ші параметр	Мәзірді тек ағымдағы пайдаланушыға қолдану үшін `1` мәнін орнатыңыз. Парақшаға қолдану үшін бос қалдырыңыз.
4-ші параметр	Messenger композиторын өшіру үшін `1` мәнін орнатыңыз.

Қайтарылатын мәндер

Егер функция сәтті аяқталса:

{"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", "Website", "https://mavibot.ai/"]
    ],
    "en_EN": [
        ["postback", "Button", "callback_text 1"],
        ["postback", "Button 2", "callback_text 2"],
        ["web_url", "Website", "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", "Website", "https://mavibot.ai/"]
    ],
    "en_EN": [
        ["postback", "Button", "callback_text 1"],
        ["postback", "Button 2", "callback_text 2"],
        ["web_url", "Website", "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", "Website", "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", "Website", "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