قالب الوسائط

يتيح لك قالب الوسائط إمكانية إرسال صور وصور GIF ومقاطع فيديو كرسالة ذات بنية محددة تحتوي على زر اختياري. تكون مقاطع الفيديو وصور GIF المتحركة التي يتم إرسالها باستخدام قالب الوسائط قابلة للتشغيل في المحادثة.

يمكنك إرسال قالب الوسائط عبر واجهة API الإرسال ومن Messenger webview باستخدام وظيفة beginShareFlow() في مجموعة SDK لملحقات Messenger.

المحتويات

• إرسال الوسائط باستخدام معرف المرفق
• إرسال الوسائط باستخدام عنوان URL لفيسبوك

  • الحصول على عنوان URL لفيسبوك
• إضافة زر
• استجابة API

إرسال الوسائط باستخدام معرف المرفق

لإرسال صورة، قم بإرسال طلب POST إلى واجهة API الإرسال، يحتوي على الخاصية payload التالية في نص الطلب، حيث attachment_id يمثل معرّفًا تم إنشاؤه من واجهة API تحميل المرفقات. بالنسبة إلى الطلبات التي تستخدم الخاصية attachment_id، يتم دعم الصور ومقاطع الفيديو.

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

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"<PSID>"
  },
  "message":{
    "attachment": {
      "type": "template",
      "payload": {
         "template_type": "media",
         "elements": [
            {
               "media_type": "<image|video>",
               "attachment_id": "<ATTACHMENT_ID>"
            }
         ]
      }
    }    
  }
}' "https://graph.facebook.com/v2.6/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

إرسال الوسائط باستخدام عنوان URL لفيسبوك

يتيح لك قالب الوسائط إمكانية إرسال مقاطع الفيديو والصور التي يتم تحميلها إلى فيسبوك من خلال إرسال طلب POST إلى نقطة نهاية /messages مع عنوان URL لفيسبوك في خاصية url بالطلب:

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

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"<PSID>"
  },
  "message":{
    "attachment": {
      "type": "template",
      "payload": {
         "template_type": "media",
         "elements": [
            {
               "media_type": "<image|video>",
               "url": "<FACEBOOK_URL>"
            }
         ]
      }
    }    
  }
}' "https://graph.facebook.com/v2.6/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

الحصول على عنوان URL لفيسبوك

للحصول على عنوان URL لفيسبوك لصورة أو مقطع فيديو، يمكنك القيام بما يلي:

1. انقر على الصورة أو الصورة المصغّرة لمقطع الفيديو لفتح عرض بالحجم الكامل.
2. انسخ عنوان URL من شريط عنوان المتصفح لديك.

يجب أن تكون عناوين URL لفيسبوك بالتنسيق الأساسي التالي:

إضافة زر

بشكل اختياري، يمكن إضافة الأزرار إلى قالب الوسائط. يختلف عدد وأنواع الأزرار المدعومة تبعًا لما إذا كنت تستخدم قالب الوسائط مع beginShareFlow() لمجموعة SDK لملحقات Messenger، أو تقوم بإرساله باستخدام واجهة API الإرسال:

• Send API: يمكن إرفاق 3 أزرار من أي نوع.
• beginShareFlow(): يمكن إرفاق زر واحد فقط من نوع عنوان URL.

لإضافة زر إلى قالب الوسائط الذي تستخدمه، قم بإضافة مصفوفة buttons إلى تعريف القالب في نص الطلب.

للتعرف على المزيد عن الأزرار المتوفرة، راجع الأزرار.

"elements": [
   {
      "media_type": "image",
      "url": "<MEDIA_URL>",
      "buttons": [
         {
            "type": "web_url",
            "url": "<WEB_URL>",
            "title": "View Website",
         }
      ]
   }
]

استجابة API

عند النجاح، تقوم منصة Messenger بإرسال استجابة تحتوي على recipient_id وmessage_id الخاصة بالرسالة التي تم إرسالها:

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