حفظ الأصول

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

تقدم منصة Messenger واجهتي API تسمحان بحفظ الأصول لاستخدامها لاحقًا: Send API وAPI تحميل المرفق. تدعم واجهتا API حفظ الأصول من عنوان URL، ومن نظام الملفات المحلي لديك.

أنواع الأصول المدعومة

تدعم منصة Messenger حفظ أنواع الأصول التالية، بحجم يصل إلى 25 ميجابايت:

image (صورة)
audio (مقطع صوتي) - يجب أن يستخدم عنوان Content-Type النوع audio. على سبيل المثال، audio/mp3.
video (فيديو)
file (ملف)

الحفظ من خلال Send API

تسمح Send API بحفظ الأصل الذي تم إرساله برسالة، كخيار بديل لتحميله مقدمًا من خلال API تحميل المرفق. لإجراء ذلك، أرسل طلب POST مع تعيين payload.is_reusable على true في نقطة النهاية /messages.

الحفظ من عنوان URL

لحفظ أصل من عنوان URL، حدّد عنوان URL المصدر في الخاصية payload.url للكائن attachment في الرسالة:

{
  "recipient":{
    "id":"

For a complete list of API calls and request properties, see the Send API Reference.

الحفظ من الملف

لحفظ الأصل من نظام الملفات المحلي، أرسل طلب الرسالة إلى Send API كبيانات نموذج، وحدّد موقع الملف في الحقل filedata للطلب:

curl  \
  -F 'recipient={"id":"<PSID>"}' \
  -F 'message={"attachment":{"type":"<ASSET_TYPE>", "payload":{"is_reusable":true}}}' \
  -F 'filedata=@/tmp/shirt.png;type=image/png' \
  "https://graph.facebook.com/v19.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

For a complete list of API calls and request properties, see the Send API Reference.

استجابة API

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

{
  "recipient_id": "1254444444682919",
  "message_id": "mid.$cAAJsujCd2ORkHh27-ld7NhzuqrUK",
  "attachment_id": "687799999980546"
}

الحفظ من خلال API تحميل المرفق

تسمح API تحميل المرفق بتحميل الأصول مقدمًا. يُعد هذا مفيدًا إذا كنت تعلم مسبقًا أنك ستحتاج إلى إرسال أصول معينة بشكل متكرر. لإجراء ذلك، أرسل طلب POST إلى نقطة النهاية /message_attachments.

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

الحفظ من عنوان URL

لحفظ أصل من عنوان URL، حدّد عنوان URL المصدر في الخاصية payload.url للكائن attachment في الرسالة:

curl -X POST -H "Content-Type: application/json" -d '{
  "message":{
    "attachment":{
      "type":"image", 
      "payload":{
        "is_reusable": true,
        "url":"http://www.messenger-rocks.com/image.jpg"
      }
    }
  }
}' "https://graph.facebook.com/v2.6/me/message_attachments?access_token=<PAGE_ACCESS_TOKEN>"

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

الحفظ من الملف

لحفظ الأصل من نظام الملفات المحلي، أرسل طلب الرسالة إلى API تحميل المرفق كبيانات نموذج، وحدّد موقع الملف في الحقل filedata للطلب:

curl  \
  -F 'recipient={"id":"<PSID>"}' \
  -F 'message={"attachment":{"type":"<ASSET_TYPE>", "payload":{"is_reusable":true}}}' \
  -F 'filedata=@/tmp/shirt.png;type=image/png' \
  "https://graph.facebook.com/v19.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

استجابة API

{
  "attachment_id":"1857777774821032"
}

إرسال الأصول المحفوظة

بمجرد الحصول على attachment_id للأصل المحفوظ، يمكنك استخدامه لإرفاق الأصل بالرسالة. لمزيد من المعلومات، راجع إرسال الرسائل - إرفاق الأصول المحفوظة.

دعم المطوّر

استخدم أداة حالة Meta للتحقق من حالة منتجات الأنشطة التجارية في Meta وحالات الانقطاع.
استخدم أداة دعم مطوّر Meta للإبلاغ عن الأخطاء وعرض الأخطاء التي تم الإبلاغ عنها والحصول على المساعدة بشأن الإعلانات أو مدير الأعمال والمزيد.
تفضل بزيارة موارد الدعم في منصة Messenger لعرض المزيد من الموارد المخصصة لدعم منصة Messenger.