ما هي القائمة الثابتة
تتيح لك القائمة الثابتة إنشاء وإرسال قائمة بالوظائف الرئيسية لنشاطك التجاري، مثل ساعات العمل ومواقع المتاجر والمنتجات. ستظل هذه القائمة مرئية دائمًا أثناء محادثة الشخص مع شركتك في Messenger.
الأزرار المدعومة:
تتكون القائمة الثابتة من مجموعة من الأزرار. أنواع الأزرار التالية مدعومة في القائمة الثابتة:
● أزرار URL (web_url)
● أزرار رد الاتصال (postback)
كيفية إضافة قائمة ثابتة لصفحة معينة
response = fb_set_persistent_menu("group_id", buttons)، حيث:
group_id - معرف بوت Facebook (يمكن العثور عليه في قائمة "القناة" في 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
كيفية إضافة قائمة ثابتة لمستخدم معين
للقيام بذلك، قم بتعيين المعامل الثالث لدالة fb_set_persistent_menu إلى 1، على النحو التالي: response = fb_set_persistent_menu('group_id', buttons, 1)
ستكون هذه القائمة متاحة للمستخدم الذي تم استدعاء الدالة من أجله.
ملاحظة . تحديث قائمة ثابتة على مستوى المستخدم يصبح ساري المفعول في الوقت الفعلي.
ومع ذلك، قد يستغرق تحديث قائمة ثابتة على مستوى الصفحة ما يصل إلى 24 ساعة.إعدادات مستوى المستخدم محدودة بمعدل 10 استدعاءات لكل مستخدم كل 10 دقائق.
كيفية تعطيل جميع وسائل الاتصال باستثناء القائمة الثابتة
لجعل القائمة الثابتة هي الطريقة الوحيدة التي يمكن للمستخدم من خلالها التفاعل مع بوت Messenger الخاص بك، تحتاج إلى تعطيل المحرر.
لماذا تفعل هذا؟
يكون هذا مفيدًا عندما يكون البوت الخاص بك مصممًا لغرض محدد أو مجموعة محددة مسبقًا من الخيارات.
كيف تفعل هذا؟
لتعطيل المحرر، قم بتمرير 1 كمعامل رابع في الدالة:
لتعطيل المحرر على مستوى الصفحة (لجميع المستخدمين):
response = fb_set_persistent_menu('group_id', buttons, '', 1)
لتعطيل المحرر للمستخدم الذي تم استدعاء الدالة من أجله:
response = fb_set_persistent_menu('group_id', buttons, 1, 1)
حيث:
group_id - معرف بوت Facebook (يمكن العثور عليه في قائمة "القناة" في MaviBot)
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"}}
أمثلة:
إضافة قائمة لجميع المستخدمين:
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 = fb_set_persistent_menu('123456789', buttons)
إضافة قائمة لجميع المستخدمين وجعل هذه القائمة هي وسيلة الاتصال الوحيدة للجميع:
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 = fb_set_persistent_menu('123456789', buttons, '', 1)
إضافة قائمة للمستخدم الذي دخل إلى الكتلة التي تستدعي الدالة:
buttons = {"default": [["postback", "الزر 1", "callback_text 1"], ["postback", "الزر 2", "callback_text 2"], ["web_url", "رابط الموقع", "https://mavibot.ai/"]]}
response = fb_set_persistent_menu('123456789', buttons, 1)
إضافة قائمة للمستخدم الذي دخل إلى الكتلة التي تستدعي الدالة، وجعل هذه القائمة هي وسيلة الاتصال الوحيدة لجميع المستخدمين:
buttons = {"default": [["postback", "الزر 1", "callback_text 1"], ["postback", "الزر 2", "callback_text 2"], ["web_url", "رابط الموقع", "https://mavibot.ai/"]]}
response = fb_set_persistent_menu('123456789', buttons, 1, 1)
حذف القائمة الثابتة على مستوى الصفحة (لجميع المستخدمين):
response = fb_delete_persistent_menu('group_id')
إذا نجحت العملية، تقوم الدالة بإرجاع:
{"result":"success"}
وإلا، فإنها تقوم بإرجاع وصف للخطأ.
'Bot not found'
حذف القائمة الثابتة على مستوى المستخدم:
response = fb_delete_persistent_menu('group_id', 1)
إذا نجحت العملية، تقوم الدالة بإرجاع:
{"result":"success"}
وإلا، فإنها تقوم بإرجاع وصف للخطأ.
"Bot not found"