- الرئيسية
- /
- المقال
شكرًا على ملاحظاتك.
في هذه المقالة
هل لديك ملاحظات؟قم بإنشاء أصول الدردشة الرقمية وتكوينها في Control Hub لـ Webex Connect أو مركز اتصال Webex أو مركز اتصال Webex للمؤسسات.
نظرة عامة
استخدم القنوات الرقمية في Control Hub لإنشاء أصول دردشة وتكوينها للويب (الدردشة المباشرة) والجوال (المراسلة داخل التطبيق) والإشعارات الفورية. تعتمد الإعدادات المتاحة للتكوين على الخدمة المحددة في التعيين إلى وما إذا كنت تختار الويب أو الهاتف المحمول أو كليهما.
توضح هذه المقالة عملية تكوين الأصول الكاملة، بما في ذلك الإمكانات المدعومة، والمراسلة، وبيانات اعتماد موفر الدفع، وترخيص JSON Web Token (JWT)، ومفاتيح ويب JSON (JWK)، وبروتوكولات النقل، والتسجيل متعدد المستخدمين، والتكوين الخاص بالخدمة بعد إنشاء الأصل.
القدرات المدعومة
| القدرة | Webex Connect | مركز اتصال Webex | مؤسسة مركز اتصال Webex |
|---|---|---|---|
| الدردشة الحية على الويب | مدعوم | مدعوم | مدعوم |
| المراسلة داخل التطبيق على الهاتف المحمول | مدعوم | مدعوم | مدعوم |
| الويب والجوال في أصل واحد | مدعوم | غير مدعوم | غير مدعوم |
| الهاتف المحمول - الإشعارات الفورية لنظام Android | مدعوم | مدعوم | مدعوم |
| الهاتف المحمول - الإشعارات الفورية لنظام iOS | مدعوم | مدعوم | مدعوم |
| إشعارات الويب الفورية | مدعوم (كروم وفايرفوكس) | غير مدعوم | غير مدعوم |
| JWT - الهاتف المحمول | مدعوم | مدعوم ومطلوب | مدعوم ومطلوب |
| JWT - الويب | مدعوم | غير مدعوم | غير مدعوم |
| تسجيلات متعددة المستخدمين | مدعوم | مدعوم | مدعوم |
| علبة الوارد من جانب الخادم | مدعوم | لا ينطبق | لا ينطبق |
| داتا ستريم | مدعوم | لا ينطبق | لا ينطبق |
قبل أن تبدأ
- قم بتسجيل الدخول إلى Control Hub كمسؤول كامل أو مسؤول مركز اتصال يمكنه إدارة الأصول الرقمية.
- تأكد من توفير الخدمات Webex Connect الرقمية أو مركز اتصال Webex أو Contact Center Enterprise للمؤسسة. بدون الاستحقاق، لا تتوفر الأصول الرقمية.
- حدد نقطة دخول مركز الاتصال والتدفق الذي سيتلقى محادثات الدردشة الجديدة.
- إذا كان النشر يستخدم الإشعارات الفورية عبر الهاتف المحمول، فقم بإعداد بيانات اعتماد Firebase أو Huawei أو Apple المطلوبة من قبل النظام الأساسي المحدد.
- إذا كنت تخطط لاستخدام ترخيص JWT، فقم بإعداد JWK العام المستخدم للتحقق من الرموز الصادرة عن الواجهة الخلفية الموثوقة الخاصة بك.
تكوين أصل الدردشة
لتكوين أصل دردشة:
| 1 |
قم بتسجيل الدخول إلى مركز التحكم. |
| 2 |
انتقل إلى الخدمات > الأصول الرقمية. |
| 3 |
حدد إنشاء أصل. |
| 4 |
في تكوين تفاصيل الأصول، أدخل القيم التالية:
|
| 5 |
في المراسلة، حدد النظام الأساسي وقم بتكوين الدردشة المباشرة/المراسلة داخل التطبيق وأي إشعارات فورية مطلوبة. تعتمد الخيارات المعروضة على النظام الأساسي المحدد. تتوفر إعدادات إشعارات Android و iOS عند تحديد الهاتف المحمول. يتوفر Web Push عندما يتم تحديد الويب للأصل المعين لهWebex Connect. |
تكوين المراسلة
في المراسلة، حدد النظام الأساسي وقم بتكوين إمكانات المراسلة للأصل.
لتكوين المراسلة:
يجب أن تكون بروتوكولات النقل الأساسية والثانوية مختلفة. إذا لم تتمكن SDK من إنشاء اتصال باستخدام البروتوكول الأساسي، فإنها تستخدم البروتوكول الثانوي كإجراء احتياطي.
| 1 |
النظام الأساسي: بالنسبة Webex Connect إلى الويب أو الهاتف المحمول أو كليهما. بالنسبة للجوال، حدد Android أو iOS أو كليهما. بالنسبة لمركز اتصال Webex أو مركز اتصال Webex للمؤسسات، حدد إما الويب أو الهاتف المحمول. |
| 2 |
الدردشة المباشرة/المراسلة داخل التطبيق: لأنها متاحة للويب والجوال. Webex Connect بالنسبة لمركز اتصال Webex أو مركز اتصال Webex للمؤسسات، يوفر الويب الدردشة الحية ويوفر الهاتف المحمول المراسلة داخل التطبيق. |
| 3 |
بروتوكول النقل الأساسي: حدد MQTT أو Web Socket. |
| 4 |
بروتوكول النقل الثانوي: حدد البروتوكول غير المحدد كأساسي. |
تكوين الإشعارات الفورية
قم بتمكين السماح بالإشعارات الفورية عندما يجب أن يتلقى التطبيق إشعارات من خلال موفر الدفع الذي تم تكوينه. تعتمد أقسام الإشعارات المعروضة على النظام الأساسي المحدد.
تتوفر خيارات موفر الدفع التالية:
- أندرويد: فيريباس للمراسلة السحابية (FCM) أو هواوي أو كليهما. ينطبق على Webex Connect مركز اتصال Webex ومؤسسة مركز اتصال Webex.
- iOS: FCM أو خدمة الإشعارات الفورية من Apple (APNS) أو المصادقة المستندة إلى الرموز لـ APNS. ينطبق على Webex Connect مركز اتصال Webex ومؤسسة مركز اتصال Webex.
- الويب: المراسلة السحابية في Firebase. ينطبق Webex Connect فقط على.
حدد النظام الأساسي وقم بتكوين الموفر المناسب في الموضوع المقابل.
احصل على حساب خدمة Firebase JSON
يستخدم Webex ملف JSON لحساب خدمة Firebase لمصادقة طلبات الخادم إلى Firebase Cloud Messaging. استخدم مشروع Firebase المرتبط بالتطبيق الخاص بك.
للحصول على حساب خدمة Firebase JSON وتحميله:
الأمان: يحتوي حساب خدمة Firebase JSON على بيانات اعتماد حساسة. قم بتخزينه بأمان وتحميل الملف فقط لمشروع Firebase المقصود.
للحصول على تعليمات تكوين المراسلة السحابية لـ Firebase، راجع إرسال رسالة باستخدام واجهة برمجة تطبيقات FCM HTTP v1.
| 1 |
افتح وحدة تحكم Firebase وحدد مشروع Firebase المستخدم من قبل التطبيق الخاص بك. |
| 2 |
افتح إعدادات المشروع > حسابات الخدمة. |
| 3 |
حدد إنشاء مفتاح خاص جديد، وقم بتأكيد التنزيل. |
| 4 |
قم بتخزين ملف JSON الذي تم تنزيله بأمان. يحتوي الملف على بيانات اعتماد المفتاح الخاص. |
| 5 |
في Control Hub، قم بتحميل ملف JSON في تحميل حساب خدمة Firebase JSON لتكوين إشعارات Android أو iOS أو الويب المعمول بها. |
تكوين الإشعارات الفورية لنظام Android
يتم عرض قسم إشعارات Android عند تحديد الإشعارات الفورية للجوال وAndroid والسماح بالإشعارات الفورية. حدد مزودًا واحدًا على الأقل؛ يمكن تكوين Firebase و Huawei بشكل فردي أو معًا. يتوفر هذا التكوين Webex Connect لأصول مركز اتصال Webex ومركز اتصال Webex للمؤسسات المحمولة.
وثائق الموفر: Huawei - إعداد واختبار Push Kit
| 1 |
حدد الهاتف المحمول وAndroid والسماح بالإشعارات الفورية. يتم عرض قسم إشعارات Android. |
| 2 |
حدد المراسلة السحابية لـ Firebase وقم بتحميل ملف JSON لحساب خدمة Firebase المطلوب من مشروع Firebase. |
| 3 |
إذا كان التطبيق يدعم الأجهزة التي تستخدم خدمات Huawei Mobile، فحدد Huawei وأدخل معرف التطبيق والسرية داخل التطبيق من AppGallery Connect. استثناء Huawei: يمكن تخطي تكوين Huawei عندما لا يدعم التطبيق الأجهزة التي لا تحتوي على خدمات Google Play. تدعم Webex Connect الإرشادات الحالية EMUI 10.x والإصدارات الأحدث. |
تكوين الإشعارات الفورية لنظام iOS
يتم عرض قسم إشعارات iOS عند تحديد الأجهزة المحمولة وiOS والسماح بالإشعارات الفورية. حدد مزود دفع واحد. يتوفر هذا التكوين Webex Connect لأصول مركز اتصال Webex ومركز اتصال Webex للمؤسسات المحمولة.
للحصول على تعليمات تكوين APNs المستندة إلى الشهادات، راجع إنشاء اتصال قائم على الشهادة إلى APNs.
للحصول على تعليمات تكوين APNs المستندة إلى الرموز، راجع إنشاء اتصال قائم على الرموز المميزة إلى APNs.
| 1 |
حدد الهاتف المحمول وiOS والسماح بالإشعارات الفورية. يتم عرض قسم إشعارات iOS. |
| 2 |
حدد مزود دفع واحد. |
| 3 |
بالنسبة للمراسلة السحابية في Firebase، قم بتحميل ملف JSON لحساب خدمة Firebase الذي تم تنزيله من مشروع Firebase. |
| 4 |
بالنسبة لخدمة Apple Push Notification Service (APNS)، أدخل كلمة مرور الشهادة، وحدد Sandbox أو Production، وقم بتحميل شهادة APNS، وأدخل اسمًا، وتحقق من صحة التكوين. يتم دعم تنسيق شهادة.p12 فقط. |
| 5 |
لمصادقة APNS المستندة إلى الرمز المميز، أدخل معرف المفتاح ومعرف الفريق وحزمة التطبيق أو معرف الحزمة، وحدد Sandbox أو Production، وقم بتحميل ملف المفتاح الخاص لـ APNS. اختيار البوابة: استخدم Sandbox لتطبيق التطوير والإنتاج لتطبيق جاهز للإنتاج. قم بتخزين مفتاح APNS الخاص بأمان؛ تسمح Apple باسترداد ملف مفتاح.p8 الذي تم تنزيله مرة واحدة فقط. |
| 6 |
استبدل شهادة مزود Apple قبل انتهاء صلاحيتها لتجنب الانقطاع لتأجيل التسليم. |
تكوين إشعارات الويب الفورية
لا تتوفر إشعارات Web Push إلا للأصول المعينة Webex Connect مع تحديد الويب. يتم دعم كروم وفايرفوكس. متصفح Safari Web Push غير مدعوم حاليًا.
لا يتم دعم إشعارات Web Push للأصول المعينة لمركز اتصال Webex أو مركز اتصال Webex Enterprise.
لتكوين إشعارات Web Push:
| 1 |
تأكد من تعيين الأصل Webex Connect وتحديد الويب. |
| 2 |
استخدم Chrome أو Firefox للوصول إلى موقع الويب وتلقي إشعارات Web Push. |
| 3 |
عنوان URL لموقع الويب (مطلوب): أدخل عنوان URL لموقع الويب الذي سيتلقى إشعارات Web Push. |
| 4 |
رمز الإعلام (مطلوب): أدخل المسار إلى أيقونة الإعلام. يجب أن تكون الأيقونة 80 × 80 بكسل. |
| 5 |
قم بتكوين المراسلة السحابية لـ Firebase (FCM) لتطبيق الويب الخاص بك باتباع وثائق Firebase. |
| 6 |
حساب خدمة Firebase JSON (مطلوب): قم بتحميل ملف JSON لحساب خدمة Firebase الذي يحتوي على المفتاح الخاص المطلوب لاستخدام واجهة برمجة تطبيقات Firebase Cloud Messaging HTTP v1. |
تكوين ترخيص رمز ويب JSON
يتطلب ترخيص JWT أن يتم ترخيص اتصال SDK باستخدام رمز ويب JSON صالح. بالنسبة للأصول الجديدة، يكون نوع التشفير غير متماثل.
دعم JWT كما يلي:
- Webex Connect: مدعوم للجوال والويب في نفس الأصل.
- مركز اتصال Webex ومركز اتصال Webex للمؤسسات - الويب: غير مدعوم.
- مركز اتصال Webex ومركز اتصال Webex للمؤسسات - الهاتف المحمول: مدعوم ومطلوب لتكوين أصول الهاتف المحمول.
قم بتكوين الإعدادات التالية:
- نوع التشفير: غير متماثل للأصول الجديدة.
- انتهاء صلاحية الرمز (مطلوب): أدخل المدة التي يظل فيها JWT صالحًا قبل أن يكون رمز هوية المستخدم الجديد مطلوبًا. نطاق صالح: 5-360 دقيقة. الإعداد الافتراضي: 60 دقيقة.
- مفاتيح JSON على الويب (مطلوبة): قم بتحميل JWK العام المستخدم للتحقق من الرموز المميزة. يمكنك إضافة مفتاح ثانٍ للتدوير. الحد الأقصى: مفتاحان.
قم بإضافة مفتاح ويب JSON العام وإعداده كما هو موضح في الموضوعات الفرعية.
قم بإعداد JWK العام
يجب أن يحتوي الملف الذي تم تحميله على مفتاح التحقق العام من RSA. يتحقق Webex من خصائص JWK التالية.
يتم تعريف خصائص JWK في RFC 7517، القسم 4. يتم تعريف الخصائص الخاصة بالخوارزمية في RFC 7518.
| اسم الخاصية | وصف |
|---|---|
| طحلب | يحدد خوارزمية التشفير المستخدمة مع المفتاح. القيمة المطلوبة هي RS256، التي تحدد RSASSA-PKCS1- باستخدام SHA-256. v1_5 |
| ه | يتم تمثيل أس المفتاح العام لـ RSA كقيمة مشفرة باستخدام Base64Urluint. |
| key_ops | يحدد العملية التي تم تصميم المفتاح لها. القيمة المدعومة هي التحقق، مما يشير إلى أن المفتاح يُستخدم للتحقق من التوقيعات الرقمية. انظر RFC 7517، القسم 4.3. |
| kty | يحدد عائلة خوارزمية التشفير المستخدمة مع المفتاح. يجب أن تكون القيمة RSA. انظر RFC 7517، القسم 4.1. |
| ن | المعامل الخاص بالمفتاح العام لـ RSA، والذي يتم تمثيله كقيمة مشفرة باستخدام Base64Urluint. |
| استخدام | يحدد الاستخدام المقصود للمفتاح العام. يجب أن تكون القيمة sig، مما يشير إلى أن المفتاح مخصص للتحقق من التوقيع. انظر RFC 7517، القسم 4.2. |
| طفل | يحدد المفتاح ويستخدم لمطابقة مفتاح معين، مثل أثناء تدوير المفتاح. انظر RFC 7517، القسم 4.5. |
إضافة مفتاح ويب JSON
لإضافة مفتاح ويب JSON عام:
| 1 |
حدد إضافة مفتاح. |
| 2 |
أدخل اسم مفتاح ويب JSON. |
| 3 |
أدخل مُصدر مفتاح الويب JSON. يجب أن تتطابق هذه القيمة مع المُصدر الذي تستخدمه الواجهة الخلفية الموثوقة عند إنشاء JWT. |
| 4 |
قم بتحميل ملف JWK العام. |
| 5 |
حدد حفظ. |
تكوين تسجيلات متعددة المستخدمين
قم بتمكين السماح بتسجيلات المستخدمين المتعددين على نفس الجهاز عندما يمكن لعدة مستخدمين التسجيل على نفس الجهاز الفعلي.
- يتم تسليم الإشعارات الفورية لكل من المستخدمين المسجلين النشطين وغير النشطين.
- يتم تسليم الدردشة الحية أو المراسلة داخل التطبيق إلى المستخدم النشط حاليًا. يتم وضع الرسائل الخاصة بالمستخدمين غير النشطين في قائمة الانتظار حتى يصبح المستخدم نشطًا مرة أخرى.
تكوين Webex Connect إعدادات إضافية
- جهاز واحد لكل مستخدم: يقيد المستخدم بجهاز مسجل واحد. يؤدي التسجيل على جهاز جديد إلى إيقاف التسليم الفوري للجهاز القديم.
- علبة الوارد من جانب الخادم: تخزن نسخة من جانب الخادم من بيانات علبة الوارد لاسترجاعها لاحقًا.
- تدفق البيانات: يرسل بيانات الأحداث القابلة للتطبيق إلى Webex Connect التكامل المحدد للرسائل المرسلة من خلال واجهة برمجة تطبيقات المراسلة.
احفظ لإنشاء الأصل
بعد تكوين المراسلة القابلة للتطبيق وترخيص JWT والتسجيل متعدد المستخدمين Webex Connect والإعدادات، احفظ التكوين لإنشاء أصل الدردشة.
|
حدد حفظ لإنشاء الأصل. انتظر التأكيد على إنشاء الأصل بنجاح.
|
تكامل الخدمة الكامل
بعد إنشاء أصل الدردشة، أكمل التكامل للخدمة المحددة في Assign to. اتبع الإجراء المعمول به لمركز اتصال Webex أو مؤسسة مركز اتصال Webex. Webex Connect
Webex Connectتكامل كامل
بالنسبة للأصل المعين لهWebex Connect، أكمل تخطيط الخدمة وتكوين التدفق فيهWebex Connect. ترخيص العقدة غير مطلوب.
يمكنك استخدام عقدة البدء أو الحدث المخصص أو خطاف الويب المخصص لالتقاط الأحداث الواردة وتشغيل التدفق. لمزيد من المعلومات، راجع عقدة البدء والحدث المخصص وخطاف الويب المخصص.
| 1 |
قم بتسجيل الدخول إلىWebex Connect. |
| 2 |
أكمل تخطيط الخدمة القابل للتطبيق وتكوين التدفق لأصل الدردشة. |
| 3 |
سجل معرف التطبيق الذي تم إنشاؤه ومفتاح العميل. |
| 4 |
قم بتنزيل ملف تكوين SDK لكل منصة محددة. |
تكامل مركز اتصال Webex الكامل
بالنسبة للأصل الذي تم تعيينه إلى مركز اتصال Webex، قم بتعيين الأصل إلى نقطة إدخال مركز اتصال Webex، ثم أكمل ترخيص عقدة مركز اتصال Webex.
| 1 |
افتح تكوين مركز الاتصال في Control Hub. |
| 2 |
قم بإنشاء أو فتح نقطة الإدخال التي تتلقى محادثات الدردشة. |
| 3 |
في مخطط التدفق، حدد أصل الدردشة وتدفق إدخال العميل المطلوب. |
| 4 |
احفظ نقطة الإدخال وتحقق من الأصول وتخطيط التدفق. |
| 5 |
أكمل ترخيص عقدة مركز اتصال Webex فيWebex Connect. للحصول على التعليمات، راجع عقد تكامل مهام Webex CC وتراخيص العقدة. |
| 6 |
لنشر الويب، قم بتكوين أداة الدردشة المباشرة واحصل على كود تضمين موقع الويب في Control Hub. |
تكامل كامل للمؤسسات في مركز اتصال Webex
بالنسبة للأصل المعين إلى Webex Contact Center Enterprise، أكمل ترخيص عقدة CCE Webex Connect قبل تكوين تدفق التوجيه.
| 1 |
قم بتسجيل الدخول إلىWebex Connect. |
| 2 |
ترخيص عقدة CCE الكامل. للحصول على التعليمات، راجع عقد تكامل CCE وتراخيص العقدة. |
| 3 |
قم بتكوين عقد تكامل CCE القابلة للتطبيق وتدفق التوجيه لأصل الدردشة. للحصول على أمثلة التدفق، راجع تكوينات التدفق. |
| 4 |
احفظ التدفق واختبره. |
للحصول على إرشادات تكوين إضافية، راجع أفضل الممارسات والإرشادات والأسئلة الشائعة.
الاستثناءات والقيود
ضع الاستثناءات والقيود التالية في الاعتبار:
- قم بتأكيد اختيار القناة والنظام الأساسي والمهمة والتوجيه قبل إنشاء الأصل. لا يمكن تغيير القناة بعد الإنشاء، ويتم تقييد تغييرات النظام الأساسي بسبب عبء العمل.
- بالنسبة لمركز اتصال Webex ومركز اتصال Webex Enterprise، لا يمكن لأصل واحد استخدام الويب والهاتف المحمول معًا. قم بإنشاء أصول منفصلة عندما يكون كلاهما مطلوبًا.
- إشعارات Web Push متاحة فقط لـWebex Connect. لا يتم دعم كل من Safari Web Push ومركز اتصال Webex وWeb Push الخاص بالمؤسسات في مركز اتصال Webex.
- لا يتم دعم ترخيص JWT لأصول الويب المعينة لمركز اتصال Webex أو مركز اتصال Webex Enterprise.
- بالنسبة لمركز اتصال Webex ومركز اتصال Webex Enterprise، قم بإجراء تكوين نقطة الإدخال والتدفق وعناصر واجهة المستخدم ورمز التضمين في قسم مركز الاتصال في Control Hub.
- من أجلWebex Connect، أكمل الخدمة وتكوين التدفق فيWebex Connect.
- لا تحذف أصل الدردشة بعد تعيينه إلى إحدى الخدمات دون إزالة التعيين النهائي أو تحديثه أولاً. لا يمكن استعادة الأصل المحذوف ويمكن أن يترك التخطيط الحالي غير قابل للاستخدام.
- بعد الإنشاء، احتفظ بمعرف التطبيق الذي تم إنشاؤه ومفتاح العميل وملفات تكوين SDK المطلوبة لتهيئة SDK المناسبة.
