API de Instagram
Qué es un menú persistente
Un menú persistente te permite crear y enviar un menú de las funciones principales de tu negocio, como el horario comercial, las ubicaciones de las tiendas y los productos. Siempre estará visible durante la conversación de una persona con tu empresa en Messenger.
Botones compatibles:
El menú persistente consiste en un conjunto de botones. Los siguientes tipos de botones son compatibles en el menú persistente:
● Botones URL (web_url) ● Botones de devolución de llamada (postback)
Cómo añadir un menú persistente
response = ig_set_persistent_menu(login, buttons), donde: login - tu usuario de Instagram (se puede encontrar en el "Canal" menú de MaviBot) buttons - un diccionario que contiene botones
Ejemplo de cómo estructurar el diccionario de botones: buttons = {"default": [["postback", "Botón 1", "callback_text 1"], ["postback", "Botón 2", "callback_text 2"], ["web_url", "Enlace del sitio", "https://mavibot.ai/"]]} default - una clave obligatoria que define la matriz de botones que se mostrará en el menú de forma predeterminada, independientemente de la localización del usuario. El valor debe ser una matriz de botones. Cada botón se describe como una matriz separada en el siguiente formato:
["tipo_de_boton", "Texto visible del botón", "Texto de callback enviado al bot"]
Tipos de botones y su descripción: - botón de callback: ["postback", "Texto visible del botón", "Texto de callback enviado al bot"] - botón URL: ["web_url", "Texto visible del enlace", "https://example.com"]
Cómo configurar el menú según la localización del usuario
Puedes configurar botones para diferentes regiones añadiendo claves adicionales al diccionario de botones correspondientes a locales específicos.
Por ejemplo, para añadir botones para la configuración regional en inglés:
buttons = {"default": [["postback", "Botón 1", "callback_text 1"], ["postback", "Botón 2", "callback_text 2"], ["web_url", "Enlace del sitio", "https://mavibot.ai/"]], "en_EN": [["postback", "Botón", "callback_text 1"], ["postback", "Botón 2", "callback_text 2"], ["web_url", "Enlace", "https://mavibot.ai/"]]}
Nota: En este caso, la clave representa la configuración regional para la cual se mostrarán los botones.
Locales compatibles: 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
Ejemplo de una solicitud:
En caso de ejecución exitosa, la función devuelve: {"result":"success"}
De lo contrario, se devuelve una descripción del error:
"Error al analizar los datos de los botones" indica un error en el diccionario de botones. {"error":{"message":"(#100) param persistent_menu[0][call_to_actions] must be non-empty.","type":"OAuthException","code":100,"fbtrace_id":"AJtVczu7TEJJxbMfnO"}}
Cómo eliminar un menú permanente
response = ig_delete_persistent_menu('login'), donde login - nombre de la cuenta
En caso de ejecución exitosa, la función devuelve:
{"result":"success"}
De lo contrario, se devuelve una descripción del error:
"Bot no encontrado"
Última actualización