API Instagram
Qu’est-ce qu’un menu persistant
Un menu persistant vous permet de créer et d’envoyer un menu des principales fonctions de votre entreprise, telles que les horaires d’ouverture, les emplacements des magasins et les produits. Il sera toujours visible pendant la conversation d’une personne avec votre entreprise dans Messenger.
Boutons pris en charge :
Le menu persistant se compose d’un ensemble de boutons. Les types de boutons suivants sont pris en charge dans le menu persistant :
● Boutons URL (web_url) ● Boutons de rappel (postback)
Comment ajouter un menu persistant
response = ig_set_persistent_menu(login, buttons), où : login - votre identifiant Instagram (peut être trouvé dans le "Channel" menu MaviBot) buttons - un dictionnaire contenant des boutons
Exemple de structure du dictionnaire de boutons : buttons = {"default": [["postback", "Button 1", "callback_text 1"], ["postback", "Button 2", "callback_text 2"], ["web_url", "Site link", "https://mavibot.ai/"]]} default - une clé obligatoire qui définit le tableau de boutons à afficher par défaut dans le menu, quelle que soit la localisation de l’utilisateur. La valeur doit être un tableau de boutons. Chaque bouton est décrit comme un tableau séparé au format suivant :
["button_type", "Texte affiché du bouton", "Texte de rappel envoyé au bot"]
Types de boutons et leur description : - bouton de rappel : ["postback", "Texte affiché du bouton", "Texte de rappel envoyé au bot"] - bouton URL : ["web_url", "Texte affiché du lien", "https://example.com"]
Comment configurer le menu en fonction de la localisation de l’utilisateur
Vous pouvez configurer des boutons pour différentes régions en ajoutant des clés supplémentaires au dictionnaire de boutons correspondant à des paramètres régionaux spécifiques.
Par exemple, pour ajouter des boutons pour la locale anglaise :
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/"]]}
Remarque : dans ce cas, la clé représente la locale pour laquelle les boutons seront affichés.
Locales prises en charge: 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
Exemple de requête :
En cas d’exécution réussie, la fonction renvoie : {"result":"success"}
Sinon, une description de l’erreur est renvoyée :
"Error parse buttons data" indique une erreur dans le dictionnaire des boutons. {"error":{"message":"(#100) param persistent_menu[0][call_to_actions] must be non-empty.","type":"OAuthException","code":100,"fbtrace_id":"AJtVczu7TEJJxbMfnO"}}
Comment supprimer un menu permanent
response = ig_delete_persistent_menu('login'), où login - nom du compte
En cas d’exécution réussie, la fonction renvoie :
{"result":"success"}
Sinon, une description de l’erreur est renvoyée :
"Bot not found"
Mis à jour