Apakah itu menu kekal

Menu kekal membolehkan anda mencipta dan menghantar menu fungsi utama perniagaan anda, seperti waktu perniagaan, lokasi kedai, dan produk. Ia akan sentiasa kelihatan semasa perbualan seseorang dengan syarikat anda di Messenger.

Butang yang disokong:

Menu kekal terdiri daripada satu set butang. Jenis butang berikut disokong dalam menu kekal:

● Butang URL (web_url)
● Butang panggil balik (postback)

Cara menambah menu kekal untuk halaman tertentu

response = fb_set_persistent_menu("group_id", buttons), di mana:
group_id - ID bot Facebook, (boleh didapati dalam menu "Channel" MaviBot)
buttons - kamus yang mengandungi butang

Contoh cara menstruktur kamus butang:
buttons = {"default": [["postback", "Button 1", "callback_text 1"], ["postback", "Button 2", "callback_text 2"], ["web_url", "Site link", "https://mavibot.ai/"]]}

default - kunci wajib yang mentakrifkan tatasusunan butang yang akan dipaparkan dalam menu secara lalai, tanpa mengira penyetempatan pengguna.
Nilai hendaklah berupa tatasusunan butang. Setiap butang diterangkan sebagai tatasusunan berasingan dalam format berikut:
["button_type", "Button display text", "Callback text sent to the bot"]

Jenis butang dan penerangannya:
&#xNAN;- butang panggil balik:
["postback", "Button display text", "Callback text sent to the bot"]
&#xNAN;- butang URL:
["web_url", "Link display text", "https://example.com"]

Cara mengkonfigurasi menu berdasarkan penyetempatan pengguna

Anda boleh menyediakan butang untuk kawasan yang berbeza dengan menambah kunci tambahan pada kamus butang yang sepadan dengan locale tertentu.

Sebagai contoh, untuk menambah butang untuk locale Inggeris:

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

Nota: Dalam kes ini, kunci mewakili locale yang mana butang akan dipaparkan.

Locale yang disokong:
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

Cara menambah menu kekal untuk pengguna tertentu

Untuk melakukan ini, tetapkan parameter ketiga fungsi fb_set_persistent_menu kepada 1, seperti berikut: response = fb_set_persistent_menu('group_id', buttons, 1)

Menu ini akan tersedia untuk pengguna yang fungsi itu dipanggil.

NOTA . Mengemas kini menu kekal peringkat pengguna berkuat kuasa dalam masa nyata.

Walau bagaimanapun, mengemas kini menu kekal peringkat halaman mungkin mengambil masa sehingga 24 jam.

Tetapan peringkat pengguna terhad kepada kadar 10 panggilan setiap pengguna setiap 10 minit.

Cara melumpuhkan semua komunikasi kecuali menu kekal

Untuk menjadikan menu kekal sebagai satu-satunya cara pengguna boleh berinteraksi dengan bot Messenger anda, anda perlu melumpuhkan komposer.

Mengapa anda perlu melakukan ini?

Ia berguna apabila bot anda direka untuk tujuan tertentu atau set pilihan yang telah ditetapkan.

Bagaimana untuk melakukannya?

Untuk melumpuhkan komposer, hantar 1 sebagai parameter keempat dalam fungsi:

untuk melumpuhkan komposer di peringkat halaman (untuk semua pengguna):
response = fb_set_persistent_menu('group_id', buttons, '', 1)
untuk melumpuhkan komposer untuk pengguna yang fungsi itu dipanggil:
response = fb_set_persistent_menu('group_id', buttons, 1, 1)
di mana:
group_id - ID bot Facebook, (boleh didapati dalam menu "Channel" MaviBot)
buttons - kamus yang mengandungi butang

Jika berjaya, fungsi mengembalikan:
{"result":"success"}

Jika tidak, ia mengembalikan penerangan ralat.
'Error parse buttons data' - ralat dalam kamus butang
{"error":{"message":"(#100) param persistent_menu[0][call_to_actions] must be non-empty.","type":"OAuthException","code":100,"fbtrace_id":"AJtVczu7TEJJxbMfnO"}}

CONTOH:

Menambah menu untuk semua pengguna:

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)

Menambah menu untuk semua pengguna dan menjadikan menu ini sebagai satu-satunya kaedah komunikasi untuk semua orang:

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)

Menambah menu untuk pengguna yang memasuki blok yang memanggil fungsi:

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)

Menambah menu untuk pengguna yang memasuki blok yang memanggil fungsi, dan menjadikan menu ini sebagai satu-satunya kaedah komunikasi untuk semua pengguna:

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)

Padamkan menu kekal di peringkat halaman (untuk semua pengguna):

response = fb_delete_persistent_menu('group_id')

Jika berjaya, fungsi mengembalikan:
{"result":"success"}

Jika tidak, ia mengembalikan penerangan ralat.
'Bot not found'

Padamkan menu kekal di peringkat pengguna:

response = fb_delete_persistent_menu('group_id', 1)

Jika berjaya, fungsi mengembalikan:
{"result":"success"}

Jika tidak, ia mengembalikan penerangan ralat.

"Bot not found"