إعداد المراسلة في ملحق FBE

يتيح ملحق Facebook للأعمال (FBE) للأنشطة التجارية إعداد المحادثات مع العملاء وإدارتها بسهولة في نطاق Facebook وInstagram. ويتيح دفق إعداد المراسلة في ملحق Facebook للأعمال (FBE) للأنشطة التجارية إعداد ما يلي أو دمجه:

مدير الأعمال
صفحة فيسبوك
حساب Instagram (إذا كان مرتبطًا بصفحة Facebook بالفعل)
الحساب الإعلاني
دردشة Messenger (اختياري)

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

مثال — دفق الإعداد من جهة Facebook (تطبيقات النشاط التجاري)

قبل البدء

يجب أن يكون تطبيقك مملوكًا بواسطة مدير أعمال يمثل نشاطًا تجاريًا تم التحقق منه. تعرف على المزيد حول كيفية التحقق من نشاطك التجاري.
يلزم توفير تطبيق Facebook بمستوى الوصول والميزة والأذونات التالية:
- مستوى الوصول: الوصول المتقدم
- الميزة: الوصول القياسي لإدارة الإعلانات
- الأذونات العامة: ads_management وads_read وbusiness_management وpages_manage_ads وpages_manage_metadata وpages_messagingpages_show_listو page_events
- الأذونات الخاصة: manage_business_extension — يمثل ذلك إذنًا خاصًا يتطلب من ممثل فيسبوك أن يضيف تطبيقك إلى قائمة السماح.
يمكنك إعداد المصادقة بالتكوينات المطلوبة وتشغيل دفق إعداد ملحق FBE عبر تسجيل دخول النشاط التجاري (على منصة الشريك) أو تطبيقات النشاط التجاري (على فيسبوك).

التكوينات المطلوبة

الإضافات

الحقل النوع الوصف

الحقل	النوع	الوصف
`setup`	الإعداد	مطلوب إعداد Facebook الخاص بالبائع، مثل المعرف الفريد الخاص به (`external_business_id`) أو عملة الكتالوج الخاصة به (`currency`). راجع تفاصيل كائن الإعداد.
`business_config`	business_config	مطلوب كائن التكوين الذي يستخدمه ملحق Facebook للأعمال لتكوين سير عمل ملحق Facebook للأعمال. راجع `business_config`تفاصيل الكائن.
`repeat`	boolean (قيمة منطقية)	مطلوب يمكنك تعيين هذه القيمة إلى `false`.

setup

الإعداد

مطلوب

إعداد Facebook الخاص بالبائع، مثل المعرف الفريد الخاص به (external_business_id) أو عملة الكتالوج الخاصة به (currency). راجع تفاصيل كائن الإعداد.

business_config

business_config

مطلوب

كائن التكوين الذي يستخدمه ملحق Facebook للأعمال لتكوين سير عمل ملحق Facebook للأعمال. راجع business_configتفاصيل الكائن.

repeat

boolean (قيمة منطقية)

مطلوب

يمكنك تعيين هذه القيمة إلى false.

الإعداد

يمكنك استخدام هذا الكائن لتحديد إعدادات حضور المستخدم النهائي على فيسبوك

الحقل	الوصف
نوع `external_business_id` : string (سلسلة)	مطلوب. معرف نشاط تجاري فريد لتمثيل نشاط عميلك التجاري. نستخدم ذلك كمعرف فريد. على سبيل المثال، إذا كانت شركة البائع هي "Fubar"، فقد يكون "fubar-123" هو معرف `external_business_id`.
نوع `timezone` : string (سلسلة)	مطلوب. المنطقة الزمنية التي يتواجد فيها النشاط التجاري. راجع قيم المنطقة الزمنية المحتملة.
`currency` النوع: string (سلسلة)	مطلوب. يمثل رمز العملة لمعيار ISO المكوّن من ثلاثة أحرف للعملة الافتراضية التي تستخدمها عناصر كتالوج النشاط التجاري. راجع رموز العملة المدعومة.
`business_vertical` النوع: enum (تعداد)	مطلوب. المجال المرتبط بالنشاط التجاري القيم:`MESSAGING`
`channel` النوع: enum (تعداد)	مطلوب. يوفر طريقة للشريك يمكنه من خلالها تكوين دفق ملحق FBE. بالنسبة إلى دفق المراسلة، يجب أن تكون هذه القيمة `MESSAGING`. `MESSAGING` — دفق يتيح للمستخدمين النهائيين إنشاء مدير الأعمال والحساب الإعلاني وصفحة Facebook وحساب Instagram أو تحديدهم. يعمل الإعداد من خلال هذه الأصول على تمكين المستخدم النهائي من إدارة المحادثات مع العملاء ضمن نطاق واسع.
`business_manager_id` النوع: string (سلسلة)	اختياري. معرف مدير الأعمال لمدير الأعمال الخاص بالعميل الموجود الذي يمكن لشريك إدخاله ليحدده مسبقًا للمستخدم في دفق الإعداد.
`ad_account_id` النوع: string (سلسلة)	اختياري. معرف الحساب الإعلاني لحساب المستخدم الإعلاني الموجود الذي يمكن لشريك إدخاله ليحدده مسبقًا للمستخدم في دفق الإعداد.
`page_id` النوع: string (سلسلة)	اختياري. معرف الصفحة لصفحة فيسبوك الخاصة بالعميل الموجود الذي يمكن لشريك إدخاله ليحدده مسبقًا للمستخدم في دفق الإعداد.
`ig_profile_id` النوع: string (سلسلة)	اختياري. معرف ملف النشاط التجاري على Instagram لملف النشاط التجاري على Instagram الخاص بالعميل الموجود الذي يمكن لشريك إدخاله ليحدده مسبقًا للمستخدم في دفق الإعداد.

تكوين النشاط التجاري

استخدم هذا الكائن لتكوين إعدادات النشاط التجاري للمستخدم النهائي. يتمضن ذلك أزرار الدعوات لاتخاذ إجراء (CTA) وبطاقة الخدمات والمزيد. يتضمن كل حقل "نوعًا" مرتبطًا بالجداول المعنية أدناه.

الحقل	الوصف
النوع `business` : FBEBusinessPropertiesConfigData	مطلوب. يمثل معلومات حول النشاط التجاري لدى المستخدم النهائي
`messenger_chat` النوع: FBEMessengerChatConfigData	اختياري ميزات دردشة Messenger على صفحة فيسبوك للمستخدم النهائي، مثل `enabled` و`domains`
`messenger_menu` النوع: FBEMessengerMenuConfigData	اختياري. ميزات القائمة الثابتة في Messenger، مثل `cta_button-text` و`cta_button_url`

الخطوات التالية

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