ما هي القائمة الثابتة
تتيح لك القائمة الثابتة إنشاء وإرسال قائمة بالوظائف الرئيسية لنشاطك التجاري، مثل ساعات العمل، مواقع المتاجر، والمنتجات. ستظل هذه القائمة مرئية دائمًا أثناء محادثة الشخص مع شركتك في Messenger.
الأزرار المدعومة:
تتكون القائمة الثابتة من مجموعة من الأزرار. الأنواع التالية من الأزرار مدعومة في القائمة الثابتة:
● أزرار URL (web_url)
● أزرار رد الاتصال (postback)
كيفية إضافة قائمة ثابتة
response = ig_set_persistent_menu(login, buttons), حيث:
login - اسم مستخدم Instagram الخاص بك (يمكن العثور عليه في قائمة "القناة" في MaviBot)
buttons - قاموس يحتوي على الأزرار
مثال على كيفية هيكلة قاموس الأزرار:
buttons = {"default": [["postback", "الزر 1", "نص_الرد 1"], ["postback", "الزر 2", "نص_الرد 2"], ["web_url", "رابط الموقع", "<https://mavibot.ai/"]]}\
default - مفتاح إلزامي يحدد مصفوفة الأزرار التي سيتم عرضها في القائمة افتراضيًا، بغض النظر عن إعدادات اللغة للمستخدم.
يجب أن تكون القيمة مصفوفة من الأزرار. يتم وصف كل زر كمصفوفة منفصلة بالتنسيق التالي:
["نوع_الزر", "نص عرض الزر", "نص رد الاتصال المرسل إلى البوت"]
أنواع الأزرار ووصفها:
&#xNAN;- زر رد الاتصال:
["postback", "نص عرض الزر", "نص رد الاتصال المرسل إلى البوت"]
&#xNAN;- زر URL:
["web_url", "نص عرض الرابط", "https://example.com"]
كيفية تكوين القائمة بناءً على إعدادات اللغة للمستخدم
يمكنك إعداد أزرار لمناطق مختلفة عن طريق إضافة مفاتيح إضافية إلى قاموس الأزرار تتوافق مع لغات محددة.
على سبيل المثال، لإضافة أزرار للغة الإنجليزية:
buttons = {"default": [["postback", "الزر 1", "نص_الرد 1"], ["postback", "الزر 2", "نص_الرد 2"], ["web_url", "رابط الموقع", "https://mavibot.ai/"]], "en_EN": [["postback", "زر", "نص_الرد 1"], ["postback", "الزر 2", "نص_الرد 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"