مرجع API تحميل المرفقات

تتيح لك API تحميل المرفقات، تحميل الأصول التي يمكن إرسالها في الرسائل في وقت لاحق. وهذا يسمح لك بتجنُّب الحاجة إلى تحميل الملفات شائعة الاستخدام عدة مرات. تدعم واجهة API حفظ الأصول من عنوان URL، ومن نظام الملفات المحلي الخاص بك.

يمكنك أيضًا استخدام Send API؛ لإرسال رسالة بها مرفق وحفظ المرفق للاستخدام لاحقًا في الوقت نفسه. لمزيد من المعلومات، راجع قسم التحميل والإرسال أدناه.

تحميل مرفق

لتحميل مرفق، أرسل طلب POST إلى نقطة النهاية /Your-page-id/message_attachments مع message.attachment مع type وpayload. لتتمكن من استخدام الأصل في رسائل متعددة، يمكنك تعيين payload.is_reusable إلى true.

مثال على طلب للتحميل من عنوان URL

تم التنسيق لإمكانية القراءة. استبدل القيم الغامقة والمائلة، مثل page_access_token، بقيمك.

curl -X POST "https://graph.facebook.com/v21.0/Your-page-id/message_attachments" \
     -H "Content-Type: application/json" \
     -d '{
           "access_token":"Your_page_access_token",
           "message":{
             "attachment":{
               "type":"image", 
               "payload":{
                 "url":"https://your-url.com/image.jpg",
                 "is_reusable": true
               }
             }
           }
         }'

مثال على طلب للتحميل من ملف

تم التنسيق لإمكانية القراءة. استبدل القيم الغامقة والمائلة، مثل page_access_token، بقيمك.

curl -X POST -H "Content-Type: application/json" -d '{
   "message": {
     "attachment": {
       "type": "image"
     }
   },
   "filedata": "@/path-to-your-file/image.jpg",
   "type": "image/png"
  }' "https://graph.facebook.com/v21.0/{PAGE_ID}/message_attachments?access_token={PAGE_ACCESS_TOKEN}"

عند نجاح العملية، سيتلقى التطبيق كائن JSON مع تعيين attachment_id على معرف المرفق لاستخدامه في الرسائل.

{"attachment_id": "Your-attachment-ID"}

إرسال رسالة مع أصل تم تحميله

لإرسال رسالة بأصل قمت بتحميله مسبقًا، وتم تحميله مع message.attachment.payload.is_reusable مع تعيينه إلى true، أرسل طلب POST إلى نقطة النهاية /Your-page-id/messages مع recipient.id، والكائن message.attachment مع type وpayload.attachment_id.

مثال على طلب للتحميل من ملف

تم التنسيق لإمكانية القراءة. استبدل القيم الغامقة والمائلة، مثل page_access_token، بقيمك.

curl -X POST -H "Content-Type: application/json" -d '{
    "recipient": {
      "id": "{PSID}"
    },
    "message": {
      "attachment": {
        "type": "image",
        "payload": {
          "attachment_id": "Your-attachment-ID"
        }
      }
    }
  }' "https://graph.facebook.com/v21.0/{PAGE_ID}/messages?access_token={PAGE_ACCESS_TOKEN}"

عند نجاح العملية، سيتلقى التطبيق استجابة JSON مع تعيين success إلى true.

{"success": "true"}

التحميل والإرسال

يمكنك أيضًا تحميل الوسائط وإرسالها في طلب API واحد.

مثال على طلب للتحميل من عنوان URL

تم التنسيق لإمكانية القراءة. استبدل القيم الغامقة والمائلة، مثل page_access_token، بقيمك.

curl -X POST -H "Content-Type: application/json" -d '{
   "recipient": {
     "id": "{PSID}"
   },
   "message": {
     "attachment": {
       "type": "image",
       "payload": {
         "url": "https://your-url.com/image.jpg"
       }
     }
   }
  }' "https://graph.facebook.com/v21.0/{PAGE_ID}/messages?access_token={PAGE_ACCESS_TOKEN}"

عند نجاح العملية، سيتلقى التطبيق استجابة JSON مع تعيين success إلى true.

{"success": "true"}

الخصائص

بالنسبة إلى المرفقات من عنوان URL، يمكنك توفير الخصائص التالية في نص الطلب ككائن JSON. بالنسبة إلى المرفقات من ملف، يمكنك إرسال الخصائص كبيانات نموذج.

message

message.attachment

message.attachment.payload

رموز الأخطاء