قبل المتابعة، يرجى التأكد من استيفاء المتطلبات الأساسية التالية:

• يجب أن يكون المستخدم الذي يقوم بالإعداد مسؤولاً في مؤسسة Salesforce حيث سيتم تثبيت التكامل.

• يتطلب هذا التكامل الحد الأدنى من إصدار Salesforce Enterprise. راجع إصدارات Salesforce لمزيد من المعلومات.

• يجب أن يكون لدى المنظمة برنامج Webex مُهيأً بالتراخيص الصحيحة للوظائف المطلوبة بما في ذلك المراسلة والاجتماعات والمكالمات.
• يجب أن يكون لدى جميع المستخدمين الذين يستخدمون التكامل إمكانية الوصول إلى Salesforce وتراخيص Salesforce المطلوبة.
• يجب أن يمتلك جميع المستخدمين تراخيص Webex المطلوبة لاستخدام وظائف Webex محددة مثل اجتماعات Webex ومكالمات Webex من داخل Salesforce.

  يتم دعم CUCM و Broadworks بوظائف جزئية. راجع قيود الاتصال في علامة التبويب الاتصال لمزيد من التفاصيل.

• هذا التكامل متاح لـ Salesforce Lightning.

  يجب عليك نشر نطاقي في مؤسستك إذا كنت ترغب في استخدام مكونات Lightning. راجع وثائق My Domain Salesforce للحصول على مزيد من المعلومات.

• يجب تكوين وصول المستخدم إلى عمليات الدمج في مؤسستك.

  • بدون حزمة Pro— عندما يكون لديك مركز التحكم الأساسي، يمكنك اختيار السماح أو رفض الوصول إلى جميع عمليات التكامل لجميع المستخدمين لديك.

  • مع حزمة Pro— مع حزمة Pro، لديك وظائف متقدمة لإدارة الوصول إلى عمليات التكامل للمستخدمين.

  راجع تكوين وصول المستخدم إلى عمليات الدمج لمزيد من المعلومات.

بالنسبة لإصدارات تكامل Webex Salesforce الأحدث من 1.14، يمكنك الآن الترقية باستخدام Salesforce Exchange.

لتثبيت تكامل Webex عبر Salesforce Exchange:

1. انتقل إلى تطبيق Webex لـ Salesforce في AppExchange.
2. اختر احصل عليه الآن.
3. حدد المؤسسة المتصلة التي تريد تثبيت التكامل فيها.
4. قم بتثبيت التطبيق للمسؤولين فقط.
5. تابع مع قم بتفويض تكامل Webex في علامة التبويب التثبيت والإدارة.

قبل اتباع خطوات التكوين، يجب عليك أولا الانتقال إلى ملاحظات الإصدار وتنزيل أحدث إصدار من حزمة Webex App Salesforce.

المتطلبات

إصدار Salesforce للمؤسسات

يتطلب هذا التكامل الحد الأدنى من إصدار Salesforce Enterprise. راجع إصدارات Salesforce لمزيد من المعلومات.

نطاقي في مؤسسة Salesforce

يجب عليك نشر نطاقي في مؤسستك إذا كنت ترغب في استخدام مكونات Lightning. راجع وثائق My Domain Salesforce للحصول على مزيد من المعلومات.

وصول المستخدم في مركز التحكم

يجب تكوين وصول المستخدم إلى عمليات الدمج في مؤسستك.

• بدون حزمة Pro— عندما يكون لديك مركز التحكم الأساسي، يمكنك اختيار السماح أو رفض الوصول إلى جميع عمليات التكامل لجميع المستخدمين لديك.

• مع حزمة Pro— مع حزمة Pro، لديك وظائف متقدمة لإدارة الوصول إلى عمليات التكامل للمستخدمين.

راجع تكوين وصول المستخدم إلى عمليات الدمج لمزيد من المعلومات.

الاتصال

• يتم دعم Webex Call بالكامل للمكالمات الواردة والصادرة للتحكم في المكالمات داخل Salesforce.

• الاتصال في Webex (CM الموحد) مدعوم جزئيا. تفتح المكالمات الصادرة فقط نافذة منبثقة لتسجيل الدخول إلى Salesforce. بالنسبة للوارد ، يرن تطبيق Webex ولكن لا يمكن ل Salesforce اعتراض المكالمة ، لذلك لا تظهر نافذة التسجيل المنبثقة.

إذا كنت تعمل مع Webex for Salesforce الإصدار 1.18 أو أقدم، فقبل أن تتمكن من العمل مع Webex Calling داخل Salesforce، ستحتاج إلى تكوين ترخيص Salesforce. اتبع الأقسام الواردة في هذه المقالة للبدء والتشغيل.

1. إنشاء تطبيق متصل

لإنشاء تطبيق متصل جديد:

1. في الإعداد، ابحث عن تطبيق العميل الخارجي.

   

2. ضمن تطبيق العميل الخارجي، اختر الإعدادات.
3. قم بتمكين زر التبديل لـ السماح بإنشاء تطبيقات متصلة. إذا كان زر التطبيق المتصل الجديد مفعلاً بالفعل، فلا حاجة إلى اتخاذ إجراء جديد. يمكنك إنشاء تطبيق متصل جديد.

   

4. لإنشاء تطبيق متصل جديد، انقر فوق زر تطبيق متصل جديد وأدخل التفاصيل المطلوبة.

   

5. أدخل اسم التطبيقالمتصل ، على سبيل المثال ، MyExampleApp.
6. أدخل عنوان بريد إلكتروني للتواصل.
7. حدد تمكين إعدادات OAuth.
8. حدد عنوان URL مؤقتًا للرد (سنقوم بتحديث هذا لاحقًا)، على سبيل المثال، https://localhost/placeholder.

   

9. قم بالتمرير لأسفل واختر نطاقات OAuth التالية:
   • الوصول الكامل (كامل)
   • تنفيذ الطلبات في أي وقت (refresh_token, offline_access)

   

   يسمح نطاق "تنفيذ الطلبات في أي وقت لـ Named Credentials بتحديث رمز الوصول الخاص بك عند انتهاء صلاحية الجلسة.

10. انتقل إلى أسفل الصفحة وانقر على حفظ ثم انقر على متابعة.
11. في الصفحة التالية، انتقل إلى API (تمكين إعدادات OAuth) وانقر على إدارة تفاصيل المستهلك.

    

    قد تحتاج إلى إعادة المصادقة مع Salesforce.

12. دوّن مفتاح المستهلك وسر المستهلك .

    

2. إنشاء موفر مصادقة

بعد ذلك، ستحتاج إلى إنشاء موفر مصادقة، والذي يسهل عملية المصادقة مع مؤسسة Salesforce الخاصة بك.

لإنشاء موفر مصادقة:

1. في الإعداد، ابحث عن المصادقة وحدد المصادقة. مقدمو الخدمات. انقر على جديد.

   

2. حدد Salesforce كنوع الموفر .
3. أدخل اسمًا لمزود المصادقة، على سبيل المثال، ApexMDTAPI.
4. ألصق مفتاح المستهلك وسر المستهلك اللذين قمت بحفظهما عند تكوين تطبيق Connected الخاص بك.
5. أدخل النطاقات التالية في النطاقات الافتراضية، كامل refresh_token offline_access.
6. اترك باقي الحقول فارغة وانقر على حفظ.

   

7. انسخ عنوان URL الخاص بالاستدعاء من قسم تكوين Salesforce.

   

8. قم بتحرير تطبيقك المتصل واستبدل عنوان URL العنصر النائب بعنوان URL الخاص بالاستدعاء الذي نسخته من تكوين Salesforce أعلاه.

   

9. احفظ تطبيقك المتصل.

   قد تحتاج إلى الانتظار لمدة تصل إلى 10 دقائق للسماح للإعدادات بأن تدخل حيز التنفيذ وتنتشر في جميع أنحاء البنية التحتية لـ Salesforce.

3. أنشئ بيانات اعتماد مُسماة

ستحتاج بعد ذلك إلى إنشاء بيانات اعتماد مُسماة.

لإنشاء بيانات اعتماد مُسماة:

1. في الإعداد، ابحث عن المسمى وحدد بيانات الاعتماد المسماة. انقر على إرث جديد.

   

2. أدخل القيمة التالية لـ Label، ApexMDTAPI.
3. بالنسبة لـ URL، أدخل عنوان URL الخاص بمؤسستك، على سبيل المثال، https://na1.salesforce.com، أو، إذا كنت تستخدم My Domain، اسم نطاق My Domain المؤهل بالكامل، على سبيل المثال، https://mycompany.my.salesforce.com.
4. بالنسبة لنوع الهوية ، اختر Named Principal.
5. بالنسبة لبروتوكول المصادقة، اختر OAuth 2.0.
6. بالنسبة لـ موفر المصادقة، اختر موفر المصادقة الذي أنشأته سابقًا.
7. For Scope, enter, full refresh_token offline_access.
8. تفعيل بدء عملية المصادقة عند الحفظ.

   

9. في خيارات الاستدعاء، قم بتمكين السماح بدمج الحقول في نص HTTP ثم انقر فوق حفظ.

   

10. سيُطلب منك تسجيل الدخول إلى مؤسستك. بعد تسجيل الدخول، سترى مربع حوار السماح بالوصول. انقر السماح.
11. سيتم بعد ذلك إعادة توجيهك إلى شاشة بيانات الاعتماد المسماة ، وستشير حالة المصادقة إلى أنك مصادق عليك . your-email@domain.com.

4. أنشئ موقعك في شاشة إدارة Webex

وأخيرًا، انتقل إلى الموضوع التالي في علامة التبويب Calling ، Create site for calling، أدناه.

بالنسبة لتكاملات Webex لـ Salesforce الإصدار 1.19 والإصدارات الأحدث، اتبع التعليمات الواردة في هذه المقالة لإزالة أي تطبيق Webex Connected App موجود للتفويضات وبيانات الاعتماد المسماة وموفري التفويض، ثم قم بإنشاء تطبيق Webex Connected App جديد لتفويض Salesforce.

قم بإزالة أي تطبيقات Webex Connected موجودة، وبيانات اعتماد مُسماة، وموفري مصادقة.

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

قم بإزالة تطبيق Webex Connected الحالي لديك:

1. في الزاوية العلوية اليمنى من صفحة الهبوط الخاصة بك في Salesforce، حدد رمز الترس واختر إعداد.
2. في مربع النص Quick Find أدخل App Manager وحدده من القائمة.
3. انتقل إلى تطبيق Webex Connected الخاص بك في القائمة، وانقر فوق رمز السهم لأسفل الموجود على يمين الإدخال، ثم اختر عرض.
4. حدد حذف ثم حدد حذف مرة أخرى عند مطالبتك بالتأكيد.

قم بإزالة أي بيانات اعتماد Webex المسماة الموجودة:

1. في مربع النص Quick Find أدخل Named Credentials وحدده من القائمة.
2. 2. انقر فوق السهم المتجه للأسفل على يمين إدخال بيانات اعتماد Webex المسمى واختر حذف.
3. 3. اختر احذف مرة أخرى عند مطالبتك بالتأكيد.

قم بإزالة أي موفر مصادقة Webex موجود:

1. في مربع النص Quick Find أدخل Auth. الموفرون وحدده من القائمة.
2. حدد رابط Del في بداية إدخال موفر مصادقة Webex.
3. اختر موافق عند مطالبتك بالتأكيد.

انتقل إلى القسم التالي لإنشاء تطبيق Webex Connected جديد لتفويض Salesforce.

أنشئ تطبيق Webex Connected جديد لتفويض Salesforce

لإنشاء تطبيق Webex Connected جديد لتفويض Salesforce:

1. في الزاوية العلوية اليمنى من صفحة الهبوط الخاصة بك في Salesforce، حدد رمز الترس واختر إعداد.
2. استرجع عنوان URL الخاص بنطاقك: في البحث السريع، ابحث عن النطاقاتوحددها، ثم احفظ عنوان URL من نطاقي.
3. في الإعداد، ابحث عن تطبيق العميل الخارجي.

   

4. ضمن تطبيق العميل الخارجي، اختر الإعدادات.
5. قم بتمكين زر التبديل لـ السماح بإنشاء تطبيقات متصلة. إذا كان زر التطبيق المتصل الجديد مفعلاً بالفعل، فلا حاجة إلى اتخاذ إجراء جديد. يمكنك إنشاء تطبيق متصل جديد.

   

6. لإنشاء تطبيق متصل جديد، انقر فوق زر تطبيق متصل جديد وأدخل التفاصيل المطلوبة.

   

7. في مربع النص Quick Find أدخل App Manager وحدده من القائمة.
8. أدخل اسم التطبيقالمتصل ، على سبيل المثال، Webex Salesforce Authorization.
9. أدخل عنوان بريد إلكتروني لـ Contact Email.
10. حدد تمكين إعدادات OAuth.
11. أدخل عنواني URL للرد باستخدام عنوان URL الذي استرجعته سابقًا، واحد في كل سطر، مع إضافة /apex/ webexsfdcauth و /apex/ cisco_webex__webexsfdcauth كلاحقات. على سبيل المثال:

    https://my-company.my.salesforce.com/apex/webexsfdcauth

    https://my-company.my.salesforce.com/apex/cisco_webex__webexsfdcauth

12. اختر النطاقات التالية من قائمة نطاقات OAuth المتاحة في نطاقات OAuth المحددة:
    • الوصول الكامل (كامل)
    • تنفيذ الطلبات في أي وقت (refresh_token, offline_access)
13. قم بإلغاء تحديد طلب مفتاح إثبات لامتداد تبادل التعليمات البرمجية (PKCE) لتدفقات التفويض المدعومة.
14. احفظ التطبيق المتصل وقم بتدوين مفتاح المستهلك و سر المستهلك لاستخدامهما لاحقًا.

1. في صفحة إدارة Webex ، انتقل إلى أسفل إلى لوحة استيراد بيانات الندوة عبر الإنترنت :

   

2. اختر كائن Salesforce من القائمة المنسدلة Object :

   

   بالنسبة للكائن Object، يمكنك الاختيار من بين كائنات Salesforce القياسية التالية بالإضافة إلى أي كائنات مخصصة تم تكوينها مسبقًا:

   • جهات الاتصال
   • العملاء المحتملين

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

   بالنسبة لتلك العناصر القياسية، يمكنك اختيار ربطها بحملات Salesforce الخاصة بك على النحو التالي:

   • أعضاء الحملة: تتوفر بيانات العملاء المحتملين وجهات الاتصال المستوردة في قسم أعضاء الحملة ضمن حملة Salesforce المستهدفة، وهي ميزة قياسية في Salesforce.( متوفرة في الإصدار 1.16 والإصداراتالأحدث )
   • أعضاء حملة ندوات Webex عبر الإنترنت: تتوفر العملاء المحتملون وجهات الاتصال المستوردة في قسم أعضاء حملة Webex Webinar الخاص بحملة Salesforce المستهدفة، وهي ميزة مخصصة في Webex.
   • كل من أعضاء الحملة وأعضاء حملة Webex Webinar: تتوفر بيانات العملاء المحتملين وجهات الاتصال المستوردة في كلا الموقعين ضمن حملة Salesforce.( متوفرة في الإصدار 1.16 والإصداراتالأحدث )
   سيتم استيراد أي كائن مخصص آخر تختاره من القائمة إلى قسم أعضاء حملة Webex Webinar في حملة Salesforce المستهدفة.

3. في واجهة اختيار المفتاح الأساسي ، اختر حقلاً فريداً كمفتاح أساسي واستخدم السهم الأيمن لنقله إلى قائمة العناصر المحددة .

   

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

4. في واجهة تعيين حقول البيانات ، اختر حقلاً من كائن Salesforce الذي قمت بتحديده وقم بتعيينه إلى حقل مطابق لكائن الندوة عبر الإنترنت. استخدم + زر "حقل جديد " لإضافة حقول إضافية حسب الحاجة.
   يجب ربطجميع حقول كائنات Salesforce بحقول الندوات عبر الإنترنت المقابلة كما هو موضح أعلاه.
   لا يمكن ربط سوى الأسئلة القياسية من نماذج تسجيل ندوات Webex عبر الإنترنت بحقول Salesforce. لا يتم دعم الأسئلة المخصصة في ندوات Webex عبر الإنترنت.
5. يمكنك إزالة الحقول التي أضفتها باستخدام أيقونة سلة المهملات الموجودة بجوار الحقل على اليمين.
6. انقر فوق حفظ عند الانتهاء، وبمجرد التحقق من مفتاحك الأساسي، انقر فوق حفظ في مربع حوار التأكيد:

   

   يتم عرض عمليات الربط في اللوحة المحدثة:

   

   يمكنك حذف تعيينات الكائنات باستخدام رمز سلة المهملات، والذي سيعرض مربع حوار تأكيد إضافي، أو تعديل التعيينات الموجودة باستخدام رمز القلم الرصاص.
   يمكنك دائمًا العودةإلى هنا وتغيير المفتاح الأساسي، ولكن هذا لن يقوم بتحديث المفتاح الأساسي للسجلات التي تم استيرادها بالفعل فيالنظام . ونتيجة لذلك، قد يؤدي هذا إلى تكرار البيانات، لذا قم بتعديل المفاتيح الأساسية بحذر.

1. تأكد من تفعيل استيراد الندوات عبر الإنترنت للجميع. Profiles/Users معطل:

   

2. من خلال تفعيل استيراد الندوات عبر الإنترنت، فقط لهذه العناصر Profiles/Users من القائمة المنسدلة، اختر إما الملف الشخصي أو المستخدم:

   

   • لإضافة ملف تعريف، حدد ملف تعريف، وانقر في مربع نص البحث واختر دور Salesforce من القائمة المنسدلة. انقر فوق "إضافة" لإضافة الدور:

     

   • لإضافة مستخدم فردي، حدد "مستخدم"، وأدخل اسم المستخدم في مربع النص. انقر فوق "إضافة" لإضافة المستخدم:

     

   لحذف مستخدم أو ملف تعريف، انقر فوق رمز سلة المهملات المجاور للإدخال.