القالب العام

القالب العام هو رسالة بسيطة ذات بنية محددة تتضمن عنوانًا وعنوانًا فرعيًا وصورة وما يصل إلى ثلاثة أزرار. يمكنك أيضًا تحديد كائن default_action ليقوم بتعيين عنوان URL الذي سيتم فتحه في طريقة عرض الويب في Messenger عند الضغط على القالب.

المحتويات

حمولة بيانات القالب

للحصول على قائمة كاملة بخصائص القالب، راجع مرجع القالب العام.

"payload": {
  "template_type":"generic",
  "elements":[
     {
      "title":"

تدعم منصة Messenger إمكانية إرسال عنصر دوّار قابل للتمرير أفقيًا للقوالب العامة.

ولإنشاء عنصر دوّار قابل للتمرير، يجب تضمين 10 قوالب عامة كحد أقصى في المصفوفة elements الموجودة في payload.

"payload": {
  "template_type":"generic",
  "elements":[

مثال على الطلب

للتعرف على تفاصيل وخصائص الطلب بشكل كامل، راجع مرجع القالب العام.

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"<PSID>"
  },
  "message":{
    "attachment":{
      "type":"template",
      "payload":{
        "template_type":"generic",
        "elements":[
           {
            "title":"Welcome!",
            "image_url":"https://petersfancybrownhats.com/company_image.png",
            "subtitle":"We have the right hat for everyone.",
            "default_action": {
              "type": "web_url",
              "url": "https://petersfancybrownhats.com/view?item=103",
              "messenger_extensions": false,
              "webview_height_ratio": "tall",
              "fallback_url": "https://petersfancybrownhats.com/"
            },
            "buttons":[
              {
                "type":"web_url",
                "url":"https://petersfancybrownhats.com",
                "title":"View Website"
              },{
                "type":"postback",
                "title":"Start Chatting",
                "payload":"DEVELOPER_DEFINED_PAYLOAD"
              }              
            ]      
          }
        ]
      }
    }
  }
}' "https://graph.facebook.com/v2.6/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

مثال على الاستجابة

{
  "recipient_id": "1254477777772919",
  "message_id": "AG5Hz2Uq7tuwNEhXfYYKj8mJEM_QPpz5jdCK48PnKAjSdjfipqxqMvK8ma6AC8fplwlqLP_5cgXIbu7I3rBN0P"
}  

أفضل الممارسات

الاستخدام للرسائل ذات التسلسل الهرمي الثابت للمعلومات (على سبيل المثال، معاينات المنتج أو المقالة، وتوقعات الطقس).

استخدام نسبة العرض إلى الارتفاع الصحيحة للصورة. سيتم تحجيم الصور الموجودة في القالب العام، والتي لديها نسبة عرض إلى ارتفاع بخلاف 1.91:1، أو اقتصاصها.

تجنب الاستخدام إذا لم تكن الرسالة تتضمن معلومات ذات بنية محددة أو كانت تتطلب تسلسلاً هرميًا.

تجنب الاستخدام إذا كنت تريد أن يتمكن الأشخاص من تكبير الصورة إلى وضع ملء الشاشة.

تجنب استخدام الصور بتنسيق gif في القالب إذا تمت إضافتها باعتبارها رسومًا متحركة. يتم دعم الصور بتنسيق Gif ولكن الصور لن تكون متحركة.

استخدم العنصر الدوّار عندما تريد ترتيب المحتوى الذي توفره بأولوية محددة، حيث يكون العنصر الأول هو الأكثر إثارة للاهتمام.

ضمان الاتساق. إذا كانت إحدى الفقاعات تحتوي على صورة، فاحرص على تضمين صورة في كل الفقاعات الأخرى.

قلّل عدد القوالب العامة في العنصر الدوّار. حيث تؤدي كثرة القوالب العامة إلى جعل من الصعب على الأشخاص تذكر كل الخيارات.

لا تخلط أنواع المحتوى. إذا قمت بتضمين مقالة ما بجوار قائمة المنتجات، فقد تسبب تجربتك ارتباكًا.

لا تستخدم العنصر الدوّار عندما يكون من الضروري أن يرى الأشخاص كل شيء في القائمة. فقد لا يقومون بالتمرير حتى النهاية. واستخدم قالب القائمة بدلاً من ذلك.