مصادقة تطبيقات الأنشطة التجارية

تتوفر تطبيقات الأنشطة التجارية عبر جهات Facebook حيث يمكن للأنشطة التجارية الصغيرة الانتقال لاستكشاف تطبيقات الأنشطة التجارية التابعة لجهات خارجية والارتباط بها من أجل الإعداد بسهولة باستخدام أدوات الأنشطة التجارية بتكاليف تقنية منخفضة بهدف تنمية أهداف النشاط التجاري وتحقيقها.

على عكس تسجيل دخول النشاط التجاري ونظرًا لأنه تم بدء استخدام دفق تطبيقات الأنشطة التجارية من جانب الجهات التابعة لنا، تتوفر خطوة إضافية تطلب من المستخدم تسجيل الدخول إلى منصتك عبر متصفح منبثق لمصادقة نشاطه التجاري وتحديده بهدف ربطه (يتم تحديده من خلال معرف external_business_id الذي حددته). وعند نجاح المصادقة، ستتم إعادة توجيه المستخدم مرة أخرى إلى الدفق لإكمال عملية الإعداد.

إذا كنت تريد عرض تطبيقك في جهة تطبيقات الأنشطة التجارية التي نوفرها، فيجب إنشاء عنوان URL للمصادقة ونقطة نهاية حدث Webhook وإعدادها والتحقق من صحتها عبر لوحة المطوّرين.

يجب أن تقدم جميع التطبيقات طلبًا لإجراء مراجعة الدمج، وبمجرد اعتماد عملية دمج ملحق FBE لديك، سيكون تطبيقك متوفرًا لعامة المستخدمين.

تنفيذ عنوان URL للمصادقة

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

طريقة العمل

1. يمكنك توفير نقطة نهاية مخصصة لعنوان URL (عنوان URL للمصادقة) تعمل على تحميل دفق مصادقة منصتك.
• يجب أن يوجه عنوان URL للمصادقة الخاص بك المستخدم (مالك النشاط التجاري) إلى دفق تسجيل الدخول على منصتك.
• يمكنك توفير خيار لتسجيل حساب جديد في المنصة (أي "التسجيل"). بعد التسجيل، سيتم إرسال المستخدم مرة أخرى إلى فيسبوك لإكمال ربط الحساب.
• إذا كنت تدعم أنشطة تجارية متعددة لكل حساب في منصتك، فيجب أن يعرض عنوان URL للمصادقة بعد تسجيل الدخول بنجاح واجهة مستخدم للمستخدمين بغرض تحديد النشاط التجاري الموجود على منصتك والذي يريدون ربطه بأصولهم على فيسبوك.
مثال — عنوان URL المصادقة

https://yourwebsite.com/fbe-auth

2. يعمل فيسبوك على تحميل عنوان URL المصادقة المتوفر أثناء دفق الإعداد ويلحق معلمة الاستعلام redirect_uri بالنهاية (هذا محدد URI إعادة التوجيه والذي قد يحتوي على معلمات استعلام إضافية):

   https://yourwebsite.com/fbe-auth?redirect_uri=<an_encoded_redirect_uri_with_query_params>

   مثال — محدد URI إعادة التوجيه تم ترميزه والذي قد تقوم بإلحاقه في معلمة استعلام redirect_uri:

   https://www.facebook.com/local/dev/transaction_tool_selector/redirect?app_id=<int_value>&app_name=<string_value>&page_id=<int_value>

   في نهاية هذه الخطوة، يعمل فيسبوك على تحميل عنوان URL المصادقة مع معلمة استعلام redirect_uri التي تم إلحاقها وترميزها ويبدو كما يلي:

   https://yourwebsite.com/fbe-auth?redirect_uri=https%3A%2F%2Fwww.facebook.com%2Flocal%2Fdev%2Ftransaction_tool_selector%2Fredirect%3Fapp_id%3D123%26app_name%3DSample%26page_id%3D456

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

   https?:\/\/(www\.|m\.|l\.|web\.|business\.)?(\d{4,5}\.od\.)?(business\.)?(facebook|instagram|whatsapp)\.com(\/.*)?

3. بعد انتهاء المستخدم من إكمال تسجيل الدخول/التسجيل وتحديد أي نشاط تجاري على منصتك (حسب الاقتضاء)، أعد توجيهه إلى عنوان URL من محدد redirect_uri بعد إرفاقه بكائن extras الذي تم ترميزه كمعلمة استعلام (تمامًا كما قد تستخدمه في تسجيل دخول النشاط التجاري) مع نقاط النهاية business_config وsetup المحددة فيه (وفقًا لعمليات تكوين الإعداد التي تريد تنفيذها):

   https://www.facebook.com/local/dev/transaction_tool_selector/redirect?app_id=<int_value>&app_name=<string_value>&page_id=<int_value>&extras=<an_encoded_json_string>

مصادقة iframe

لتمكين تجربة مستخدم أكثر سلاسة ضمن تطبيقات الأعمال ولتقديم دعم أفضل لعملية إنشاء الحسابات الجديدة في المنصة، يجب تمكين عنوان URL المصادقة ليتم تحميلة في iframe ضمن واجهة فيسبوك. راجع إرشادات التنفيذ ومواصفات ما بعد الرسالة في وثائق iframes.

تنفيذ حدث Webhook

تتيح لك أحداث Webhooks تلقي إشعارات HTTP فورية تتضمن التغييرات التي تطرأ على كائنات محددة في مخطط التواصل الاجتماعي على Facebook. وبالنسبة لملحق FBE، فهذا يعني أنه بعد انتهاء المستخدم من تثبيت ملحق FBE أو إلغاء تثبيته باستخدام تطبيقك (مثل، عبر تطبيقات الأنشطة التجارية)، ستتلقى تفاصيل حول هذا الإجراء عبر أحداث Webhooks.

يجب إنشاء نقطة نهاية على خادم آمن يمكنه معالجة الطلبات من خلال Facebook. ويلزم إجراء ذلك من جانب جميع شركاء المنصة الذين يريدون توفير تطبيقاتهم ضمن تطبيقات الأنشطة التجارية. راجع دليل تنفيذ حدث Webhook للحصول على تفاصيل حول كيفية إنشاء نقطة النهاية هذه.

إعداد حدث Webhook والتحقق منه

بمجرد أن تصبح نقطة نهاية حدث Webhook جاهزة، يتطلب إعدادها والتحقق منها ما يلي:

1. استخدم بطاقة Webhooks في قسم ملحق فيسبوك للأعمال -> الإعداد من لوحة معلومات التطبيق للتحقق من صلاحية نقطة النهاية واشترك في حدث webhook fbe_install. راجع دليل تنفيذ حدث Webhook للمزيد من التفاصيل.
2. بمجرد تكوين منتج أحداث Webhooks بشكل صحيح، من المفترض أن يتحول لون الدائرة أعلى الجانب الأيسر للبطاقة إلى اللون الأخضر وتظهر أيقونة علامة التحديد.

الإعداد والتحقق من الصحة عبر لوحة المطوّر

لوحة مطوِّر ملحق Facebook للأعمال هي عبارة عن منتج ضمن لوحة معلومات تطبيق المطوِّر لديك. وبمجرد منح تطبيقك إمكانية استخدام ملحق FBE، يجب استخدام لوحة المطوّر لإعداد عنوان URL للمصادقة ونقطة نهاية حدث Webhook والتحقق من صحتهما، وكذلك لإضافة تفاصيل حول ما يقدمه تطبيقك للنشاط التجاري.

إعداد عنوان URL للمصادقة والتحقق منه

بمجرد أن يصبح عنوان URL للمصادقة جاهزًا، تتطلب عملية إعداده والتحقق منه ما يلي:

1. انتقل إلى لوحة مطوّر ملحق FBE في لوحة معلومات تطبيقك. ملاحظة: في حالة عدم تكوينها، اتبع هذه التعليمات لإضافتها.
2. انقر على علامة التبويب إعداد وابحث عن بطاقة جهة تطبيقات الأنشطة التجارية.
3. حدد مربع الاختيار عرض تطبيقي في جهة تطبيقات الأنشطة التجارية.
4. في حقل إدخال عنوان URL للمصادقة، أدخل عنوان URL للمصادقة لديك.
5. انقر على الزر اختبار المصادقة.
• يتم فتح نافذة منبثقة وتحميل عنوان URL لمحاكاة كيفية استخدام Facebook له في جهات تطبيقات الأنشطة التجارية.
• تابع عملية تسجيل الدخول وتحديد النشاط التجاري (إن أمكن).
• بعد انتهاء إعادة التوجيه، سيتم إغلاق النافذة المنبثقة. وإذا تم اكتشاف أي أخطاء ضمن عملية التنفيذ (مثل قيم غير صالحة في العناصر الإضافية)، فستظهر أسفل هذه البطاقة بحيث يمكنك تحديد ما يتعين عليك إصلاحه. ولن تعمل ميزة اختبار المصادقة إلا على التحقق من صحة الإدخال في محدد redirect_uri فقط، وليس لها علاقة بتثبيت ملحق FBE بالفعل.
6. بمجرد الانتهاء من خطوات التنفيذ وتكوين العناصر الإضافية على النحو المتوقع، سيتم وضع علامة على هذه الخطوة بكونها صالحة (علامة باللون الأخضر في الزاوية العلوية اليسرى من البطاقة). سيتيح ذلك إمكانية اختبار دفق الإعداد بشكل شامل (تثبيت ملحق FBE) مباشرةً من جانب فيسبوك (راجع القسم أدناه).

الاختبار الشامل

بمجرد إعداد عنوان URL المصادقة ونقطة نهاية حدث Webhook بنجاح والتحقق من صحته في لوحة المطوّر، يمكنك إجراء اختبار شامل لدفق الإعداد ويكون مدعومًا من تطبيقك قبل الانتقال إلى وضع النشر. يمكن إجراء ذلك مباشرةً من خلال مجموعة أدوات الأعمال من فيسبوك أو واجهة صفحة فيسبوك على النحو التالي:

عبر مجموعة أدوات الأعمال من فيسبوك

1. انتقل إلى مجموعة أدوات الأعمال من فيسبوك.
2. في العمود الأيمن، انقر على المزيد من الأدوات ثم انقر على تطبيقات الأعمال.
3. يتم سرد جميع التطبيقات المتوفرة هناك. وسيتم سرد تطبيقاتك ضمن الفئة التي حددتها كمجال (مجالات) في علامة التبويب إعداد لوحة المطوّر.
4. سيحصل تطبيقك على تصنيف للاختبار فقط - ليس متوفرًا للعامة. ويعني ذلك أنه متوفر للاختبار فقط بواسطة المستخدمين الذين يتمتعون بدور في تطبيقك، وليس متوفرًا لعامة المستخدمين حتى الآن.
5. انقر على ربط وابدأ اختبار التجربة المدعومة بواسطة عنوان URL للمصادقة لديك:
   • يعمل دفق الإعداد على تنفيذ عمليات تثبيت فعلية لملحق FBE وسيتم تشغيل إشعارات حدث Webhook.

عبر واجهة صفحة فيسبوك

1. انتقل إلى صفحة فيسبوك التي تتوفر لديك صلاحية وصول المسؤول بها.
2. في العمود الأيمن من صفحة Facebook لديك، انقر على تطبيقات الأنشطة التجارية.
3. يتم سرد جميع التطبيقات المتوفرة هناك. وسيتم سرد تطبيقاتك ضمن الفئة التي حددتها كمجال (مجالات) في علامة التبويب إعداد لوحة المطوّر.
4. سيحصل تطبيقك على تصنيف للاختبار فقط - ليس متوفرًا للعامة. ويعني ذلك أنه متوفر للاختبار فقط بواسطة المستخدمين الذين يتمتعون بدور في تطبيقك، وليس متوفرًا لعامة المستخدمين حتى الآن.
5. انقر على ربط وابدأ اختبار التجربة المدعومة بواسطة عنوان URL للمصادقة لديك:
   • يعمل دفق الإعداد على تنفيذ عمليات تثبيت فعلية لملحق FBE وسيتم تشغيل إشعارات حدث Webhook.

معرفة المزيد

• كيفية استخدام تسجيل دخول النشاط التجاري لملحق FBE
• extras
• business_config
• setup
• كيفية إلغاء تثبيت ملحق FBE