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

response = ig_set_persistent_menu(login, buttons), di mana:
login - log masuk Instagram anda (boleh didapati dalam menu "Saluran" MaviBot)
buttons - kamus yang mengandungi butang

Contoh cara menstruktur kamus butang:
buttons = {"default": [["postback", "Butang 1", "teks_panggil_balik 1"], ["postback", "Butang 2", "teks_panggil_balik 2"], ["web_url", "Pautan laman", "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:

["jenis_butang", "Teks paparan butang", "Teks panggil balik yang dihantar ke bot"]

Jenis butang dan penerangannya:
&#xNAN;- butang panggil balik:
["postback", "Teks paparan butang", "Teks panggil balik yang dihantar ke bot"]
&#xNAN;- butang URL:
["web_url", "Teks paparan pautan", "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", "Butang 1", "teks_panggil_balik 1"], ["postback", "Butang 2", "teks_panggil_balik 2"], ["web_url", "Pautan laman", "https://mavibot.ai/"]], "en_EN": [["postback", "Butang", "teks_panggil_balik 1"], ["postback", "Butang 2", "teks_panggil_balik 2"], ["web_url", "Pautan", "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

Contoh permintaan:

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 = ig_set_persistent_menu('login', buttons)

Sekiranya berjaya dilaksanakan, fungsi mengembalikan:
{"result":"success"}

Jika tidak, penerangan ralat dikembalikan:

"Error parse buttons data" menunjukkan 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"}}

Cara memadam menu kekal

response = ig_delete_persistent_menu('login'), di mana login - nama akaun

Sekiranya berjaya dilaksanakan, fungsi mengembalikan:

{"result":"success"}

Jika tidak, penerangan ralat dikembalikan:

"Bot not found"