تحديثات مهمة منذ كتابة هذا الدليل:
-
المراجعة التطبيقية مطلوبة الآن. منذ سبتمبر 2021، تتطلب Meta أن يجتاز تطبيقك المراجعة التطبيقية وأن تتم الموافقة عليه على إذن قراءة oEmbed (يُسمى الآن Meta oEmbed Read للتطبيقات التي تم إنشاؤها بعد 8 أبريل 2025). بدون هذا، ستفشل استدعاءات واجهة برمجة تطبيقات oEmbed. راجع إرشادات تقديم المراجعة التطبيقية من Meta للحصول على نصائح حول الحصول على الموافقة.
-
قد لا يتم عرض مربعات Instagram بشكل صحيح. اعتبارًا من 3 نوفمبر 2025، أزالت Meta الحقول
thumbnail_urlوthumbnail_widthوthumbnail_heightوauthor_nameمن استجابات Instagram oEmbed. يعتمد رمز onebox الخاص بـ Discourse حاليًا على هذه الحقول (lib/onebox/engine/instagram_onebox.rb)، مما قد يؤدي إلى ظهور تضمينات تالفة أو فارغة. -
يتم دعم عناوين URL للمشاركات و IGTV فقط. يدعم Discourse حاليًا فقط عناوين URL
/p/(مشاركة) و/tv/(IGTV) الخاصة بـ Instagram. لا يتم دعم عناوين URL لـ Reels (/reel/). -
تم تغيير واجهة مستخدم (UI) وحدة تحكم مطوري فيسبوك بشكل كبير منذ التقاط لقطات الشاشة أدناه في ديسمبر 2020. لا تزال الخطوات العامة متشابهة، ولكن الشاشات والخيارات المحددة قد تبدو مختلفة.
إذا كان لديك بالفعل تطبيق Facebook مرتبط بموقع Discourse الخاص بك، فانتقل لأسفل إلى إضافة oEmbed إلى تطبيق Facebook الخاص بك.
إذا لم يكن لديك حساب مطور Facebook وتطبيق Facebook:
انتقل إلى https://developers.facebook.com/. سيُطلب منك تسجيل الدخول إلى حساب Facebook الخاص بك إذا لم تكن قد سجلت الدخول حاليًا. قد يُطلب منك “تحويل” حساب Facebook الخاص بك إلى حساب مطور إذا لم تكن قد قمت بذلك من قبل. قد يُطلب منك التحقق من حسابك لدى Facebook عن طريق إضافة رقم هاتف أو عن طريق إكمال خطوات أخرى. ستحتاج فقط إلى اتباع المطالبات والقيام بما يطلبه منك Facebook.
بمجرد حصولك على حساب مطور Facebook، انقر على “تطبيقاتي” (My Apps) من الشاشة الرئيسية لمطور Facebook:
و “إنشاء تطبيق” (Create App):
حدد نوع التطبيق “شيء آخر” (Something Else) و “متابعة” (Continue):
أدخل “اسم العرض للتطبيق” (App Display Name) و “بريد إلكتروني لجهة اتصال التطبيق” (App Contact Email). بمجرد قراءة الشروط والسياسات الخاصة بهم، يمكنك النقر على “إنشاء تطبيق” (Create App):
إذا كنت روبوتًا: لا يوجد ما يمكن رؤيته هنا. بيب بوب بوب. 
إذا لم تكن روبوتًا: انقر على “أنا لست روبوتًا” (I’m not a robot)، واتبع المطالبات، وانقر على “إرسال” (Submit).
تهانينا! لديك تطبيق Facebook!
إضافة oEmbed إلى تطبيق Facebook الخاص بك:
مرر لأسفل في قائمة المنتجات، وابحث عن “oEmbed” وانقر على “إعداد” (Set Up):
إذا كنت توافق على كيفية استخدامك لمنتج oEmbed، فحدد المربع، ثم انقر على “تأكيد” (Confirm):
تمت إضافة منتج oEmbed. انقر على “الإعدادات” (Settings):
يجب ملء “اسم العرض” (Display Name) و “بريد جهة الاتصال” (Contact Email) بالفعل. ستحتاج إلى إدخال عناوين URL لـ “سياسة الخصوصية” (Privacy Policy) و “شروط الخدمة” (Terms of Service). حدد “فئة” (Category) من قائمة الخيارات المتاحة. انقر على “حفظ التغييرات” (Save Changes) عندما تكون سعيدًا بكل شيء:
انقر على المفتاح في الجزء العلوي من الشاشة للتغيير من وضع “قيد التطوير” (In development) إلى وضع “مباشر” (Live):
انقر على “تبديل الوضع” (Switch Mode):
إرسال تطبيقك للمراجعة التطبيقية (مطلوب منذ 2021):
قبل أن يتمكن تطبيقك من الوصول إلى واجهة برمجة تطبيقات oEmbed في الإنتاج، يجب عليك إرساله إلى المراجعة التطبيقية وطلب إذن قراءة oEmbed (أو Meta oEmbed Read للتطبيقات التي تم إنشاؤها بعد 8 أبريل 2025).
- في لوحة معلومات التطبيق الخاص بك، انتقل إلى المراجعة التطبيقية (App Review) ← الأذونات والميزات (Permissions and Features).
- ابحث عن قراءة oEmbed (oEmbed Read) (أو Meta oEmbed Read) وانقر على طلب (Request).
- قد تحتاج أولاً إلى إجراء مكالمة اختبار ناجحة لواجهة برمجة التطبيقات قبل أن يصبح زر الطلب نشطًا. قد يستغرق الأمر ما يصل إلى 24 ساعة بعد أول مكالمة لواجهة برمجة التطبيقات الخاصة بك.
- عند التقديم، قدم عنوان URL على موقع Discourse الخاص بك يحتوي على تضمين Instagram، واشرح أن موقعك يستخدم برنامج منتدى Discourse لتضمين منشورات Instagram باستخدام واجهة برمجة تطبيقات oEmbed.
راجع توثيق oEmbed من Meta للحصول على إرشادات مفصلة للتقديم.
إنشاء رمز وصول التطبيق الخاص بك:
بعد الانتهاء من كل ذلك، يمكننا فعليًا إنشاء رمز وصول للتطبيق عن طريق اتباع تعليمات Facebook حول رموز وصول التطبيق. ستحتاج إلى قيمة حقل “معرف التطبيق” (App ID)، وقيمة حقل “سر التطبيق” (App Secret). للحصول على سر التطبيق، انقر على “إظهار” (Show). قد يُطلب منك إعادة المصادقة على نفسك أو ما شابه، ولكن يجب أن ينتهي بك الأمر بقيمة سداسية عشرية طويلة يمكنك نسخها:
وفقًا لتوثيق Facebook، تحتاج إلى إرسال تلك القيم إلى Facebook لإنشاء رمز مميز. هل أنت على دراية باستخدام curl؟ ممتاز! يقترحون ما يلي (مع استبدال {your-app-id} و {your-app-secret} بالقيم التي نسختها من الشاشة أعلاه).
curl -X GET "https://graph.facebook.com/oauth/access_token?client_id={your-app-id}&client_secret={your-app-secret}&grant_type=client_credentials"
بدلاً من ذلك، قد يعمل نسخ عنوان URL فقط (بعد استبدال هذين القيمتين) في متصفحك أيضًا:
https://graph.facebook.com/oauth/access_token?client_id={your-app-id}&client_secret={your-app-secret}&grant_type=client_credentials
سيستجيب Facebook بقطعة صغيرة من JSON، والتي يجب أن تبدو شيئًا كهذا المثال:
{"access_token":"1234567890654321|c3bd55c09fc5e561552ad7a8717","token_type":"bearer"}
انسخ قيمة access_token الخاصة بك، باستثناء علامات الاقتباس (أي في مثالي ستكون 1234567890654321|c3bd55c09fc5e561552ad7a8717)، وانتقل إلى إعدادات موقع Discourse الخاص بك. ابحث عن إعداد الموقع المسمى facebook_app_access_token في إعدادات Onebox. الصق قيمة ‘access_token’ في هذا الحقل:
انقر على 
… وأنت جاهز!
قد يؤدي لصق عنوان URL مثل https://www.instagram.com/p/CIRhYzFM7Lu/ في منشور على موقعك إلى ظهور مربع واحد جميل، تمامًا مثل هذا:
بانتظار الموافقة على تطبيقي الثاني…
)، ولكن الاختلاف الرئيسي هو أنه يجب طلب oEmbed بعد اجتياز تطبيقك لمراجعة التطبيق.
