دمج Salesforce مع تطبيق Webex

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

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

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

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

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

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

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

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

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

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

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

بالنسبة لإصدارات تكامل 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 Pack—عندما يكون لديك مركز التحكم الأساسي، يمكنك اختيار السماح أو رفض الوصول إلى جميع التكاملات لجميع المستخدمين لديك.

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

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

الاتصال

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

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

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

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

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

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

   

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

   

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

   

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

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

   

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

9. قم بتدوين ملاحظة حول مفتاح المستهلك و سر المستهلك.

   

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

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

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

1. في Setup، ابحث عن Auth وحدد Auth. المزودين. انقر فوق جديد.

   

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

   

7. انسخ عنوان URL الخاص بـ Callback من قسم Salesforce Configuration.

   

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

   

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. بالنسبة لـ نوع الهوية، اختر المدير المسمى.
5. بالنسبة لـ بروتوكول المصادقة اختر OAuth 2.0.
6. بالنسبة لـ موفر المصادقة، اختر موفر المصادقة الذي قمت بإنشائه مسبقًا.
7. بالنسبة لـ النطاق، أدخل، كامل refresh_token offline_access.
8. تمكين بدء تدفق المصادقة عند الحفظ.

   

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

   

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

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

وأخيرا، انتقل إلى الموضوع التالي في علامة التبويب الاتصال ، إنشاء موقع للاتصال، أدناه.

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

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

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

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

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

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

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

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

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

انتقل إلى القسم التالي لإنشاء ترخيص جديد لتطبيق Webex Connected App for Salesforce.

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

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

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

1. في مربع النص البحث السريع أدخل مدير التطبيقات وحدده من القائمة.
2. أدخل اسم التطبيق المتصل، على سبيل المثال، Webex Salesforce Authorization.
3. أدخل عنوان البريد الإلكتروني لـ البريد الإلكتروني للاتصال.
4. حدد تمكين إعدادات OAuth.
5. أدخل عنواني 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

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

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

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

لتمكين أو تعطيل سجل المكالمات:

1. انتقل إلى مسؤول Webex.
2. قم بالتمرير لأسفل إلى سجل مكالمات Webex.
3. قم بالتبديل إلى الإعداد المطلوب، سواء ممكّنًا أو معطلًا.

   عند تمكين هذه الميزة، يصبح سجل المكالمات متاحًا لجميع المستخدمين والملفات الشخصية.

بالنسبة لمستخدمي CUCM وBroadworks، الوظائف التالية غير مدعومة:

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

بالنسبة لجميع تكاملات Salesforce، لاحظ القيد التالي:

• يفرض Salesforce حدًا لعدد الأحداث (25000) والذي قد يتسبب في فشل التكاملات في ظل الاستخدام الكثيف. تتوفر حزم Salesforce لزيادة هذا الحد. لمعرفة مزيد من المعلومات، ارجع إلى https://developer.salesforce.com/docs/atlas.en-us.platform_events.meta/platform_events/platform_event_limits.htm.

• لا تتوفر مكونات أداة الاتصال Webex في تطبيق Salesforce للجوال.

باستخدام لوحة تكوين استيراد بيانات ندوات الويب في Webex، يمكن لمستخدمي Salesforce المعتمدين استيراد المدعوين والمسجلين والحاضرين في ندوات الويب في Webex مباشرةً إلى كائنات Salesforce مثل العملاء المحتملين وجهات الاتصال.

تتوفر واجهة تكوين استيراد بيانات الندوة عبر الإنترنت من صفحة Webex Admin :

بمجرد تمكين استيراد ندوة الويب، يمكن للمستخدمين المعتمدين استيراد بيانات ندوة الويب الخاصة بـ Webex باستخدام أداة Webinars :

تعيين أذونات ندوة الويب Webex لمستخدمي Salesforce

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

لتعيين الأذونات للمستخدم:

1. انتقل إلى دمج Salesforce مع تطبيق Webex.
2. اختر علامة التبويب إدارة الموجودة في أسفل المقالة ثم قم بتوسيع توفير الوصول:

   

3. اتبع الإرشادات لإضافة إذن Webex Import Admin إلى حسابات مستخدمي Salesforce الخاصة بك.

تكوين عرض نطاق وقت ندوة الويب Webex

لتكوين النطاق الزمني لندوات الويب Webex المعروضة:

1. انقر فوق زر تطبيقات Salesforce، وأدخل Webex في حقل البحث، ثم اختر Webex Admin:

   

2. ابحث عن لوحة ندوات الويب Webex وأدخل عدد الأيام التي تريد عرض ندوات الويب السابقة والمقبلة فيها في أداة ندوات الويب Webex على الصفحة الرئيسية:

   

متابعة تكوين تعيينات حقول استيراد ندوة الويب Webex.

تكوين تعيينات حقول استيراد ندوة الويب Webex

باستخدام إعدادات استيراد ندوة الويب Webex، يمكنك تحديد التعيينات بين حقول كائنات Salesforce وكائنات ندوة الويب. على سبيل المثال، يمكنك تعيين الأسماء الأولى والأخيرة لكائن جهة اتصال Salesforce إلى أسماء الحقول الموازية للمدعوين إلى الندوة عبر الإنترنت والمسجلين والحاضرين: firstName و lastName.

لتكوين إعدادات استيراد ندوة الويب Webex:

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

   

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

   

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

   • جهات الاتصال
   • العملاء المتوقعون

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

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

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

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

   

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

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

   

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

   

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