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

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

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

تحميل مرفق

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

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

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

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

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

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

curl -X POST "https://graph.facebook.com/v19.0/Your-page-id/message_attachment" \
     -H "Content-Type: application/json" \
     -d '{
           "access_token":"Your_page_access_token",
           "message":{
             "attachment":{
               "type":"image"
             }
           },
           "filedata":"@/path-to-your-file/image.png";"type":"image/png"
         }'

عند نجاح العملية، سيتلقى التطبيق كائن 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 "https://graph.facebook.com/v19.0/Your-page-id/messages" \
     -H "Content-Type: application/json" \
     -d '{
           "access_token":"Your_page_access_token",
           "message":{
             "attachment":{
               "type":"image",
               "payload":{
                 "attachment_id":"Your-attachment-ID"
               }
             }
           }
         }'

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

{"success": "true"}

الخصائص

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

message

message.attachment

message.attachment.payload

رموز الأخطاء