المقدمة
يوضح هذا المستند كيفية تكوين عامل هاتف IP (FIPPA) Finesse واستكشاف أخطائه وإصلاحها على Unified Contact Center Express (UCCX)
المتطلبات الأساسية
المتطلبات
توصي Cisco بأن تكون لديك معرفة بالمواضيع التالية:
- UCCX
- برنامج Cisco Unified Communications Manager (CUCM)
المكونات المستخدمة
تستند المعلومات الواردة في هذا المستند إلى إصدارات البرامج والمكونات المادية التالية:
- UCCX 11.0(1).
- هواتف بروتوكول الإنترنت.
تم إنشاء المعلومات الواردة في هذا المستند من الأجهزة الموجودة في بيئة معملية خاصة. بدأت جميع الأجهزة المُستخدمة في هذا المستند بتكوين ممسوح (افتراضي). إذا كانت شبكتك قيد التشغيل، فتأكد من فهمك للتأثير المحتمل لأي أمر.
معلومات أساسية
بدءا من UCCX 11.x وما بعده، تم تأجيل برنامج Cisco Agent Desktop (CAD - مجموعة منتجات Cisco) وتعد Cisco Finesse المجموعة الوحيدة من المنتجات المكتبية الوكيل المتوفرة على UCCX. بالإضافة إلى ذلك، لا توجد خدمات سطح المكتب أو نقطة وصول خفيفة الوزن (LDAP) CCX. كان يمكن الوصول إليها مسبقا من خلال WebGUI لمسؤول سطح المكتب (CDA) من Cisco .
هناك فقط جهاز Cisco Finesse الذي يقيم بشكل مشترك على UCCX ويعالج كلا من "عميل سطح المكتب المستند إلى مستعرض الويب" بالإضافة إلى وكيل هاتف IP - الذي تم حزمه الآن ك Finesse IP Phone Agent (FIPPA). Cisco Finesse Tomcat هي الخدمة الوحيدة المكشوفة على صفحة خدمة CCX. (إلى جانب خدمات الدعم، فإن محرك CCX وخدمة إعلام CCX مطلوبة لتسجيل الدخول إلى الوكلاء)
عمارة
- يقدم هاتف بروتوكول الإنترنت طلبات ويحصل على استجابات عبر بروتوكول نقل النص التشعبي (HTTP) في شكل كائنات XML CiscoIPPhone. هذه الردود استعملت مباشرة لبناء FIPPA شاشة.
- قلب FIPPA هو حرب FIPPA التي تدير كل جلسات FIPPA. وهو يستخدم نفس واجهة برمجة تطبيقات REST (APIs) وواجهات بروتوكول المراسلات والتواجد الموسع (XMPP) التي يستخدمها سطح المكتب.
- تقوم "حرب FIPPA" بطلبات REST APIs المسموح لها باستخدام نفس النطاق المستخدم مع سطح المكتب Finesse.
- وبالتالي فإن جميع تكوينات رموز الالتفاف ورموز الأسباب وما إلى ذلك ل FIPPA هي نفسها الموجودة في Finesse Desktop.
- تحصل حرب FIPPA على إعلامات الحدث باستخدام XMPP النقي (بخلاف BOSH الذي يستخدمه سطح المكتب).
- يعمل هاتف IP كخادم pseudo-HTTP بينما يتم دفع الرسائل عبر HTTP. هذا في شكل عنوان URL الذي يطلبه هاتف IP، بدوره.
التكوين
تسجيل الدخول اليدوي
الخطوة 1. أضف الخدمة بعد تكوين وكيل UCCX.
- تكوين هاتف الوكيل والمستخدم النهائي ل UCCX (تعيين ملحق IPCC للمستخدم النهائي).
- يجب أن يكون Finesse Tomcat [بدء].
- قم بتكوين خدمة FIPPA كخدمة IP Phone على العقدة - خدمة واحدة لكل عقدة.
- ويتم ذلك على إدارة CUCM > الجهاز > إعدادات الجهاز > خدمات الهاتف.
URL: http://UCCX-IP-ADDRESS:8082/fippa/#DEVICENAME#

الخطوة 2. أربط الخدمة بالهاتف.
- انتقل إلى الهاتف على جهاز CUCM > الهاتف واشترك في خدمة FIPPA إلى الهاتف، كما هو موضح في الصورة:


الخطوة 3. قم بتكوين مستخدم تطبيق FIPPA.
- يجب تكوين مستخدم تطبيق ل FIPPA مع تمكين CTI القياسي للأدوار والسماح CTI القياسي بالتحكم في جميع الهواتف.
- يتم إنشاء مستخدم التطبيق هذا على CUCM أولا، ويتم إدخال التفاصيل في صفحة CFAdmin كجزء من صفحة عنوان URL لمصادقة الهاتف. هذا إجباري أن يدون داخل FIPPA.
- عنوان URL لهذا التكوين (cfadmin) - https://UCCX-IP-or-FQDN:8445/cfadmin
- أدخل اسم مستخدم التطبيق وكلمة المرور هنا (يجب أن تكون أبجدية رقمية).
- انقر فوق حفظ.
- هذا تكوين ضروري. بدون هذا، تتلقى خطأ على الهاتف "لم يتم تكوين عنوان URL لمصادقة الهاتف".
الخطوة 4. أضف هاتف الوكيل تحت مستخدم تطبيق FIPPA.
- في CUCM، تأكد من إضافة هاتف الوكيل (الجهاز) ضمن مستخدم تطبيق FIPPA.
ملاحظة: تم إنشاء مستخدم تطبيق FIPPA لإلغاء تحميل طلبات تسجيل الدخول / الجهاز ل FIPPA لهذا المستخدم بدلا من وضع التحميل على مستخدم تطبيق RMCM. ولكن من الناحية النظرية، يمكن إستخدام أي منهما بشكل تبادلي للتحكم في الجهاز. من المهم ملاحظة أن عنوان URL لمصادقة الهاتف على CFAdmin (Finesse Admin) هو مستخدم التطبيق على CUCM الذي يقوم بمعالجة طلبات FIPPA. في حالتنا، يتم إستخدام تطبيق FIPPA وفقا للممارسات المعاد تجميعها.
الخطوة 5. تكوين أكواد أو أسباب التفاف (إختياري).
- يجب تكوين جميع رموز الأسباب ورموز الالتفاف وما إلى ذلك كجزء من Finesse Admin (cfadmin).
- يتم تكوين جميع متغيرات المؤسسة على Finesse Admin (cfadmin).
- هذا هو نفس سطح المكتب لوكيل Cisco Finesse.
URL: https://UCCX-IP-or-FQDN:8445/cfadmin
تسجيل دخول زر واحد
هذه طريقة شائعة لتكوين FIPPA.
كل الخطوات متشابهة بما في ذلك URL الخاص ب Finesse. والفرق الوحيد هو وجود معلمات الخدمة تحت خدمة هاتف IP، بالإضافة إلى صفحة الاشتراك في الهاتف (خدمات الاشتراك/إلغاء الاشتراك).
الخطوة 1. أضف الخدمة بعد تكوين وكيل UCCX.
- تكوين هاتف الوكيل والمستخدم النهائي. يجب أن يكون Finesse Tomcat [بدء].
- قم بتكوين خدمة FIPPA كخدمة IP Phone على العقدة - خدمة واحدة لكل عقدة.
- ويتم ذلك على إدارة CUCM > الجهاز > إعدادات الجهاز > خدمات الهاتف.
URL: http://UCCX-IP-ADDRESS:8082/fippa/#DEVICENAME#
مثل تكوين IPPA القديم، أدخل أحد أسماء المعلمات في أحرف صغيرة مثل هذا تماما:
ملاحظة: لا يتم دعم تسجيل الدخول لزر واحد مع اشتراكات المؤسسة.
القيم التي تم إدخالها هي معلمات سلسلة الاستعلام الدقيقة المستخدمة لعنوان URL الخاص بالاشتراك.


الخطوة 2. أربط الخدمة بالهاتف.
- انتقل إلى الهاتف على جهاز CUCM > الهاتف واشترك في خدمة FIPPA إلى الهاتف.
قم بإدخال قيم زر واحد تسجيل الدخول لمعلمات عنوان URL، كما هو موضح في الصورة:

الخطوة 3. تكوين مستخدم تطبيق FIPPA (عنوان URL للمصادقة الهاتفية).
- يجب تكوين مستخدم تطبيق ل FIPPA مع تمكين CTI القياسي للأدوار والسماح CTI القياسي بالتحكم في جميع الهواتف.
- يتم إنشاء مستخدم التطبيق هذا على CUCM أولا، ويتم إدخال التفاصيل في صفحة CFAdmin كجزء من صفحة عنوان URL لمصادقة الهاتف. هذا إجباري أن يدون داخل FIPPA.
- عنوان URL لهذا التكوين (cfadmin) - https://UCCX-IP-or-FQDN:8445/cfadmin
- أدخل اسم مستخدم التطبيق وكلمة المرور هنا (يجب أن تكون أبجدية رقمية).
- انقر فوق حفظ.
- هذا تكوين ضروري. بدون هذا، تتلقى خطأ على الهاتف "لم يتم تكوين عنوان URL لمصادقة الهاتف".

الخطوة 4. أضف هاتف الوكيل تحت مستخدم تطبيق FIPPA.
- في CUCM، تأكد من إضافة هاتف الوكيل (الجهاز) تحت مستخدم تطبيق FIPPA
الخطوات 3،4 هي نفسها السجل اليدوي في التكوين المذكور أعلاه.
المشكلات الشائعة
لا تظهر متغيرات الاتصال بسبب خطأ مصادقة عنوان URL للهاتف
الخطأ:
“Phone URL authentication username or password is incorrect in the IP Phone Agent settings. Contact your administrator.”
Note: The same error appears on the IP Phone if the supervisor forces an agent to sign out from the Team Performance gadget. In this case, when the agent presses OK, they are directed to the Sign In screen.
الحل:
- تحقق من أن إعدادات مصادقة عنوان URL للهاتف التي تم إدخالها في الأداة المساعدة لإعدادات عامل هاتف IP تطابق تلك التي تم تكوينها لمستخدم التطبيق في Unified CM.
- تحقق أيضا من أن ملحق العامل مدرج كجهاز تحكم لمستخدم التطبيق في Unified CM.
- راجع للحصول على مزيد من خطوات أستكشاف الأخطاء وإصلاحها:
الهواتف الخاملة تعرض "المضيف غير موجود"
الخطأ:
“Error” and “Host not found”
Or
“Idle Application” and “Host not found”
الحل:
استكشاف الأخطاء وإصلاحها
- تحقق من التكوين وتحقق منه.
- يجب أن يكون Finesse Tomcat in_SERVICE على العقدة التي تحاول تسجيل الدخول إليها.
https://UCCX-FQDN:8445/finesse/api/SystemInfo
- يجب إرجاع تخطيط XML FIPPA عند الوصول إليه من قبل مستعرض ويب.
http ://UCCX-IP-or-FQDN:8082/FIPPA/#DEVICENAME#
مثال: فتح عنوان URL في مستعرض ويب
http://UCCX-IP-or-FQDN:8082/FIPPA/SEPAAABBCCCC
- لاختبار الدخول فعليا باستخدام عينة عامل، يمكن إختبار ذلك أيضا في متصفح الويب.
مثال: بالنسبة للجهاز الوكيل SEPAAABBCCCC، معرف الوكيل=arunabh، كلمة المرور=cisco، extension=62000
http ://UCCX-IP-or-FQDN:8082/fippa/SEPAAABBCCCC/login؟password=cisco&extension=62000&id=arunabh
مجموعة السجلات
- السجلات ل FIPPA هي مسمى باسم سجلات FIPPA الموجودة في مجلد سجل Cisco Finesse.
CLI :
file list activelog /desktop/logs/fippa/*
file get activelog /desktop/logs/fippa/*
- من أداة مراقبة الوقت الفعلي (RTMT) - تجميع سجلات Cisco Finesse.
- يحتوي هذا على سجلات Finesse Localhost وسجلات FIPPA.
- تظهر الرسائل أيضا عندما يمكن تحليل سجل العميل في المعالجة بواسطة Finesse Tomcat - سجلات محرك CCX.
معلومات ذات صلة