Kas ir pastāvīgā izvēlne
Pastāvīgā izvēlne ļauj izveidot un nosūtīt jūsu uzņēmuma galveno funkciju izvēlni, piemēram, darba laiku, veikalu atrašanās vietas un produktus. Tā vienmēr būs redzama personas sarunā ar jūsu uzņēmumu Messenger.
Atbalstītās pogas:
Pastāvīgā izvēlne sastāv no pogu kopas. Pastāvīgajā izvēlnē tiek atbalstīti šādi pogu veidi:
● URL pogas (web_url)
● Atgriezeniskās saites pogas (postback)
Kā pievienot pastāvīgo izvēlni
response = ig_set_persistent_menu(login, buttons), kur:
login - jūsu Instagram pieteikšanās vārds (atrodams "Kanāla" MaviBot izvēlnē)
buttons - vārdnīca, kas satur pogas
Piemērs, kā strukturēt pogu vārdnīcu:
buttons = {"default": [["postback", "Poga 1", "callback_text 1"], ["postback", "Poga 2", "callback_text 2"], ["web_url", "Vietnes saite", "https://mavibot.ai/"]]}\\
default - obligāta atslēga, kas nosaka izvēlnē pēc noklusējuma rādāmo pogu masīvu neatkarīgi no lietotāja lokalizācijas.
Vērtībai jābūt pogu masīvam. Katra poga ir aprakstīta kā atsevišķs masīvs šādā formātā:
["pogas_tips", "Pogas displeja teksts", "Atgriezeniskās saites teksts, kas nosūtīts robotam"]
Pogu veidi un to apraksts:
&#xNAN;- atgriezeniskās saites poga:
["postback", "Pogas displeja teksts", "Atgriezeniskās saites teksts, kas nosūtīts robotam"]
&#xNAN;- URL poga:
["web_url", "Saites displeja teksts", "https://example.com"]
Kā konfigurēt izvēlni, pamatojoties uz lietotāja lokalizāciju
Varat iestatīt pogas dažādiem reģioniem, pievienojot pogu vārdnīcai papildu atslēgas, kas atbilst konkrētām lokalēm.
Piemēram, lai pievienotu pogas angļu lokalizācijai:
buttons = {"default": [["postback", "Poga 1", "callback_text 1"], ["postback", "Poga 2", "callback_text 2"], ["web_url", "Vietnes saite", "https://mavibot.ai/"]], "en_EN": [["postback", "Poga", "callback_text 1"], ["postback", "Poga 2", "callback_text 2"], ["web_url", "Saite", "https://mavibot.ai/"]]}
Piezīme: Šajā gadījumā atslēga apzīmē lokalizāciju, kurai tiks rādītas pogas.
Atbalstītās lokalizācijas:
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
Pieprasījuma piemērs:
buttons = {"default": [["postback", "Poga 1", "callback_text 1"], ["postback", "Poga 2", "callback_text 2"], ["web_url", "Vietnes saite", "https://mavibot.ai/"]], "en_EN": [["postback", "Poga", "callback_text 1"], ["postback", "Poga 2", "callback_text 2"], ["web_url", "Saite", "https://mavibot.ai/"]]}
response = ig_set_persistent_menu('login', buttons)
Veiksmīgas izpildes gadījumā funkcija atgriež:
{"result":"success"}
Pretējā gadījumā tiek atgriezts kļūdas apraksts:
"Error parse buttons data" norāda uz kļūdu pogu vārdnīcā.
{"error":{"message":"(#100) param persistent_menu[0][call_to_actions] must be non-empty.","type":"OAuthException","code":100,"fbtrace_id":"AJtVczu7TEJJxbMfnO"}}
Kā dzēst pastāvīgo izvēlni
response = ig_delete_persistent_menu('login'), kur login - konta nosaukums
Veiksmīgas izpildes gadījumā funkcija atgriež:
{"result":"success"}
Pretējā gadījumā tiek atgriezts kļūdas apraksts:
"Bot not found"