مرجع `persistent_menu`

يمكن تعيين القائمة الثابتة في البرنامج التلقائي لمساعدة الأشخاص في اكتشاف الوظائف التي توفرها والوصول إليها بسهولة أكبر خلال المحادثة.

تتوفر القائمة الثابتة بشكل مستمر للمستخدم. ويجب أن تشتمل هذه القائمة على أبرز الإجراءات الأساسية التي يمكن للمستخدمين تنفيذها في أي وقت. كما يساعد وجود قائمة ثابتة في عرض الإمكانات الأساسية التي يوفرها البرنامج التلقائي بسهولة للمستخدمين الذي يراسلونك لأول مرة والآخرين الذين يعودون لاستكمال المحادثة. ستظهر القائمة تلقائيًا في سلسلة الرسائل إذا كان الشخص قد توقف عن المراسلة لفترة معينة من الوقت وعاد لاستكمال المحادثة. تُعد هذه الإعدادات جزءًا من مرجع API الملف الشخصي في Messenger

يمكن أيضًا تعيين القائمة الثابتة وتغييرها على مستوى المستخدم. لمزيد من المعلومات حول القائمة الثابتة، راجع القائمة على مستوى المستخدم.

المتطلبات

لاستخدام القائمة الثابتة، يجب إجراء ما يلي:

تعيين زر بدء الاستخدام.
الحصول على دور "المسؤول" في الصفحة المرتبطة بالبرنامج التلقائي.

تنسيق `persistent_menu`

مثال على القائمة الثابتة

{
    "persistent_menu": [
        {
            "locale": "default",
            "composer_input_disabled": false,
            "call_to_actions": [
                {
                    "type": "postback",
                    "title": "Talk to an agent",
                    "payload": "CARE_HELP"
                },
                {
                    "type": "postback",
                    "title": "Outfit suggestions",
                    "payload": "CURATION"
                },
                {
                    "type": "web_url",
                    "title": "Shop now",
                    "url": "https://www.originalcoastclothing.com/",
                    "webview_height_ratio": "full"
                }
            ]
        }
    ]
}

الخصائص

الخاصية	النوع	الوصف
`locale`	String (سلسلة)	مصفوفة من الكائنات التي تحدد القائمة الثابتة لإعدادات اللغات المحلية المختلفة. وسيتم عرض القائمة التي تحتوي على خاصية `locale` التي تتطابق مع لغة الشخص المحلية. يجب أن يعمل كائن واحد في المصفوفة `persistent_menu` على الأقل على تحديد `"locale": "default"`. هذه هي القائمة الاحتياطية التي سنعرضها إذا لم يحتوي أي كائن على الخاصية `locale` التي تطابق لغة المستخدمين المحلية. راجع قائمة اللغات المحلية المدعومة.
`composer_input_disabled`	Boolean (قيمة منطقية)	تعمل على تعطيل حقل أداة إنشاء Messenger في حالة التعيين على `true`. هذا يعني أنه لا يمكن التفاعل مع البرنامج التلقائي إلا من خلال القائمة الثابتة والردود الجاهزة والأزرار وطرق عرض الويب. علمًا بأنه يتم تعيين القيمة افتراضيًا على `false`.
`disabled_surfaces`	Array (مصفوفة)	مصفوفة تضم أسماء الواجهة التي تريد تعطيل القائمة الثابتة فيها. حاليًا لا يتم دعم سوى `customer_chat_plugin`.
`call_to_actions`	Array (مصفوفة)<`menu_item`>	مصفوفة تضم أبرز عناصر القائمة في القائمة الثابتة. يسمح بتضمين 3 عناصر كحد أقصى. مطلوب إذا كان `"composer_input_disabled": true`.

الكائن `menu_item`

الخاصية	النوع	الوصف
`type`	String (سلسلة)	نوع عنصر القائمة. وتكون القيم المدعومة هي: `web_url`: يحدد العنصر على أنه زر عنوان URL. `postback`: يحدد العنصر على أنه زر رد جاهز.
`title`	String (سلسلة)	العنوان المطلوب عرضه في عنصر القائمة. علمًا بأن أقصى عدد للأحرف هو 30 حرفًا.
`url`	String (سلسلة)	عنوان URL الذي سيتم فتحه عند الضغط على الزر. مطلوب إذا كان النوع `web_url`.
`payload`	String (سلسلة)	البيانات التي ستتم إعادة إرسالها إلى حدث webhook كحدث `messaging_postbacks`. مطلوب إذا كان النوع `postback`. علمًا بأن الحد الأقصى لعدد الأحرف هو 1000 حرف.
`webview_height_ratio`	String (سلسلة)	*اختياري.* ارتفاع طريقة عرض الويب. تتضمن القيم الصالحة `compact` و`tall` و`full`.
`messenger_extensions`	Boolean (قيمة منطقية)	*اختياري.* يجب أن تكون القيمة `true` إذا كان نوع العنصر `web_url` وسيتم استخدام مجموعة SDK لملحقات Messenger في طريقة عرض الويب.
`fallback_url`	String (سلسلة)	*اختياري.* عنوان URL المطلوب فتحه في طريقة عرض الويب للعملاء الذين لا يدعمون مجموعة SDK لملحقات Messenger. إذا لم يتم تحديد ذلك، فسيتم استخدام `url` كقيمة احتياطية. يمكن تحديده فقط إذا كان `"messenger_extensions": true`.
`webview_share_button`	String (سلسلة)	*اختياري.* يمكنك التعيين على `hide` لتعطيل المشاركة في طريقة عرض الويب (بالنسبة للمعلومات الحساسة).

تعطيل القائمة الثابتة

قد تتوفر بعض الحالات التي يكون من الأفضل فيها تعطيل القائمة الثابتة لبرنامجك التلقائي في المكون الإضافي للدردشة. ولإجراء ذلك، أضف "disabled_surfaces": ["CUSTOMER_CHAT_PLUGIN"] عند تعيين قائمتك الثابتة:

مثال على حمولة البيانات في API الملف الشخصي في Messenger

{
  "persistent_menu":[
    {
      "locale":"default",
      "disabled_surfaces": ["CUSTOMER_CHAT_PLUGIN"],
      "composer_input_disabled": false,      
      "call_to_actions":[
        {
          "title":"My Account",
          "type":"postback",
          "payload":"PAYBILL_PAYLOAD"
        }
      ]
    }
  ]
}

تقييد معدلات الاستدعاء

استدعاءات واجهة API الملف الشخصي في Messenger مقيدة إلى 10 استدعاءات واجهة API لكل فاصل زمني لمدة 10 دقائق. يتم تطبيق تقييد معدلات الاستدعاء هذا لكل صفحة.

لاحظ أنه يتم تقييد الاستدعاءات التي تتم إلى القائمة على مستوى المستخدم عند 10 استدعاءات API لكل مستخدم ضمن فاصل زمني مدته 10 دقائق. ويتم فرض تقييد معدلات الاستدعاء هذا لكل صفحة.

مرجع persistent_menu