شكرًا على ملاحظاتك.

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

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

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

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

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

• يجب تكوين وصول المستخدم إلى عمليات الدمج في مؤسستك.
  • بدون Pro Pack —عندما يكون لديك Control Hub الأساسي، يمكنك السماح أو رفض الوصول إلى جميع عمليات الدمج لجميع المستخدمين لديك.
  • مع Pro Pack - مع Pro Pack، لديك وظائف متقدمة لإدارة وصول المستخدمين إلى عمليات الدمج.

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

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

لتثبيت تكامل Webex باستخدام ساليسفورس إكستشينج:

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

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

المتطلبات

إصدار ساليسفورس للمؤسسات

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

نطاقي في مؤسسة ساليسفورس

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

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

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

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

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

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

الاتصال

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

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

إذا كنت تعمل مع Webex لـ Salesforce الإصدار 1.18 أو إصدار سابق، فيجب عليك تكوين ترخيص Salesforce قبل أن تتمكن من العمل Webex Calling داخل Salesforce.

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

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

   

2. ضمن تطبيقات العميل الخارجي، اختر الإعدادات.
3. قم بتشغيل السماح بإنشاء تطبيقات متصلة. إذا كان زر New Connected App ممكّنًا بالفعل، فيمكنك المضي قدمًا وإنشاء تطبيق متصل جديد.

   

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

   

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

   

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

   

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

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

    

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

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

    

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

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

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

   

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

   

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

   

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

   

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

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

قم بإنشاء بيانات اعتماد مسماة

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

   

2. أدخل ApexMDTAPI في التسمية.
3. أدخل عنوان URL الخاص بمثيل مؤسستك في عنوان URL، مثل https://na1.salesforce.com؛ أو إذا كنت تستخدم نطاقي، اسم نطاقي المؤهل بالكامل، مثل 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.

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

استمر في إنشاء موقع للاتصال في قسم الاتصال.

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

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

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

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

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

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

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

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

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

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

قم بإنشاء تطبيق Webex Connected جديد للحصول على ترخيص Salesforce

لإنشاء تطبيق Webex Connected جديد للحصول على ترخيص Salesforce:

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

   

4. ضمن تطبيقات العميل الخارجي، حدد الإعدادات.
5. قم بتشغيل السماح بإنشاء تطبيقات متصلة. إذا كان زر New Connected App ممكّنًا بالفعل، فيمكنك المضي قدمًا وإنشاء تطبيق متصل جديد.

   

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

   

7. في مربع نص البحث السريع، أدخل مدير التطبيقات وحدده من القائمة.
8. أدخل اسم تطبيق متصل، على سبيل المثال، ترخيص Webex Salesforce.
9. أدخل عنوان بريد إلكتروني للبريد الإلكتروني لجهة الاتصال.
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. انقر فوق حفظ.
15. انسخ مفتاح المستهلك وسر المستهلك واحفظهما بأمان. تحتاج إلى هذه القيم عند تكوين ترخيص Salesforce في Control Hub.

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

قبل أن تبدأ

• تحتاج إلى وصول مسؤول نظام Salesforce.
• يجب تمكين نطاقي في مؤسسة Salesforce الخاصة بك.

استرجع عنوان URL الخاص بالنطاق الخاص بي

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

قم بإنشاء تطبيق عميل خارجي جديد

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

   أدخل التفاصيل التالية:

   • اسم تطبيق العميل الخارجي - ترخيص Webex Salesforce
   • اسم API - Webex_Salesforce_Authorization(يتم تعبئته تلقائيًا)
   • البريد الإلكتروني للاتصال - عنوان البريد الإلكتروني الخاص بالمسؤول
   • حالة التوزيع - محلي

3. انقر فوق إنشاء.

تكوين إعدادات OAuth

1. ضمن API (تمكين إعدادات OAuth)، انقر على تمكين OAuth.
2. قم بتكوين عناوين URL الخاصة برد الاتصال. [your-domain]استبدل قيمة Salesforce My Domain الخاصة بك، وأدخل كل عنوان URL في سطر منفصل:
   • https://[your-domain].my.salesforce.com/apex/webexsfdcauth
   • https://[your-domain].my.salesforce.com/apex/cisco_webex__webexsfdcauth
3. أضف نطاقات OAuth هذه إلى نطاقات OAuth المحددة:
   • وصول كامل (full)
   • تنفيذ الطلبات في أي وقت (refresh_token، offline_access)
4. ضمن الأمان، احتفظ بمفتاح إثبات الطلب لتبادل التعليمات البرمجية (PKCE) محددًا.
5. انقر فوق إنشاء.

استرجع مفتاح المستهلك وسر المستهلك

1. في الإعداد، حدد إدارة التطبيقات > مدير تطبيقات العميل الخارجي.
2. انقر فوق ترخيص Webex Salesforce.
3. انقر على علامة تبويب الإعدادات، ثم افتح إعدادات OAuth.
4. انقر فوق مفتاح المستهلك والسرية.
5. تحقق من بريدك الإلكتروني للحصول على رمز التحقق من Salesforce.
6. في صفحة التحقق من هويتك، أدخل الرمز وانقر فوق التحقق.
7. انسخ مفتاح المستهلك وسر المستهلك واحفظهما بأمان. تحتاج إلى هذه القيم عند تكوين ترخيص Salesforce في Control Hub.

قم بترحيل تطبيق متصل موجود

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

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

تحقق من الترحيل

1. في الإعداد، اختر إدارة التطبيقات > مدير تطبيقات العميل الخارجي.
2. تأكد من ظهور ترخيص Webex Salesforce في القائمة.
3. انقر على التطبيق وتحقق من أن علامة تبويب الإعدادات تعرض عناوين URL الصحيحة لرد الاتصال ونطاقات OAuth:
   • وصول كامل (full)
   • تنفيذ الطلبات في أي وقت (refresh_token، offline_access)
4. (اختياري) استرجع مفتاح المستهلك وسر المستهلك وتأكد من تطابقهما مع القيم الأصلية.

قم بإلغاء تنشيط التطبيق المتصل الأصلي (اختياري)

بعد التحقق من أن تطبيق العميل الخارجي يعمل، قم بما يلي:

1. في الإعداد، حدد إدارة التطبيقات.
2. ابحث عن تطبيق Connected الأصلي وانقر على السهم المتجه لأسفل على يمين الصف الخاص به.
3. اختر إدارة.
4. ضمن سياسات OAuth، قم بتعيين المستخدمين المسموح لهم بحظر التراخيص الجديدة، أو ترك التطبيق المتصل نشطًا خلال فترة انتقالية.

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

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

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

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

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

   عند التمكين، يكون سجل المكالمات متاحًا لجميع المستخدمين وملفات التعريف.

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

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

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

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

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