Что такое постоянное меню
Постоянное меню позволяет создать и отправить меню основных функций вашего бизнеса, таких как часы работы, расположение магазинов и товары. Оно всегда будет отображаться во время общения человека с вашей компанией в Messenger.
Поддерживаемые кнопки:
Постоянное меню состоит из набора кнопок. В постоянном меню поддерживаются следующие типы кнопок:
● Кнопки URL (web_url)
● Кнопки обратного вызова (postback)
Как добавить постоянное меню
response = ig_set_persistent_menu(login, buttons), где:
login - ваш логин Instagram (можно найти в меню "Канал" MaviBot)
buttons - словарь, содержащий кнопки
Пример структуры словаря кнопок:
buttons = {"default": [["postback", "Кнопка 1", "callback_text 1"], ["postback", "Кнопка 2", "callback_text 2"], ["web_url", "Ссылка на сайт", "https://mavibot.ai/"]]}\\
default - обязательный ключ, определяющий массив кнопок, которые будут отображаться в меню по умолчанию, независимо от локализации пользователя.
Значение должно быть массивом кнопок. Каждая кнопка описывается как отдельный массив в следующем формате:
["button_type", "Текст кнопки", "Текст обратного вызова, отправляемый боту"]
Типы кнопок и их описание:
&#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
Пример запроса:
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/"]]}
response = ig_set_persistent_menu('login', 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"}}
Как удалить постоянное меню
response = ig_delete_persistent_menu('login'), где login - имя аккаунта
В случае успешного выполнения функция возвращает:
{"result":"success"}
В противном случае возвращается описание ошибки:
"Bot not found"