مرجع زر عنوان URL

يفتح زر URL صفحة ويب في طريقة عرض الويب في Messenger. ويمكن استخدام هذا الزر مع قالب الزر والقالب العام.

إذا كان الموقع يحتوي على روابط التطبيق، فسيتم النقر على الزر داخل تطبيق أصلي. إذا أجريت تغييرًا مؤخرًا، فيمكنك استخدام أداة تصحيح أخطاء المشاركة لطلب استخلاص بيانات جديدة من الموقع.

لمزيد من المعلومات عن استخدام زر عنوان URL، راجع زر عنوان URL.

بنية زر عنوان URL

مجموعة SDK لملحقات Messenger - تتطلب إضافة النطاق إلى القائمة البيضاء

لعرض صفحة ويب مع تمكين مجموعة SDK لملحقات Messenger في Messenger webview، يجب إضافة النطاق إلى القائمة البيضاء، بما في ذلك النطاق الفرعي في الخاصية whitelisted_domains للملف الشخصي للبرنامج التلقائي في Messenger. ويضمن هذا الأمر أن النطاقات الموثوقة فقط تتمتع بحق الوصول إلى معلومات المستخدم المتاحة عبر وظائف مجموعة SDK.

لمزيد من المعلومات حول إضافة نطاقات إلى القائمة البيضاء، يمكنك الرجوع إلى المرجع whitelisted_domains.

{
  "type":"web_url",
  "url":"

مثال على استخدام عنوان URL

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"<PSID>"
  },
  "message":{
    "attachment":{
      "type":"template",
      "payload":{
        "template_type":"button",
        "text":"Try the URL button!",
        "buttons":[
          {
            "type":"web_url",
            "url":"https://www.messenger.com/",
            "title":"URL Button",
            "webview_height_ratio": "full"
          }
        ]
      }
    }
  }
}' "https://graph.facebook.com/v21.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

مثال على استجابة عنوان URL

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

خصائص عنوان URL

الخاصية النوع الوصف

type

String (سلسلة)

نوع الزر. يجب أن يكون web_url.

title

String (سلسلة)

عنوان الزر. أقصى عدد للأحرف هو 20 حرفًا.

url

String (سلسلة)

يتم فتح عنوان URL هذا في متصفح الهاتف المحمول عند الضغط على الزر. يجب استخدام بروتوكول HTTPS إذا كان messenger_extensions بالقيمة true.

webview_height_ratio

String (سلسلة)

اختياري. ارتفاع طريقة عرض الويب. القيم الصالحة: compact وtall وfull. ويتم التعيين افتراضيًا على القيمة full.

messenger_extensions

Boolean (قيمة منطقية)

اختياري. يجب أن تكون القيمة true إذا كان يتم استخدام ملحقات Messenger.

fallback_url

String (سلسلة)

عنوان URL الذي يجب استخدامه على البرامج التي لا تدعم ملحقات Messenger. إذا لم يتم تحديد ذلك، فسيتم استخدام url كقيمة احتياطية. يمكن تحديده فقط إذا كان messenger_extensions بالقيمة true.

webview_share_button

String (سلسلة)

اختياري. يمكنك التعيين على hide لتعطيل الزر مشاركة في طريقة عرض الويب (بالنسبة للمعلومات الحساسة). هذا لا يؤثر على أي مشاركات بدأها المطوّر باستخدام الملحقات.