Contact Center Express anbinden

Wozu dient das

EasyUC liest die Konfiguration eines Cisco Unified Contact Center Express (UCCX) über dessen Administrations-API aus und zeigt sie im Arbeitsbereich EasyUC Cisco an: Applications, Agenten, Supervisor, Skills, Teams sowie die Repositories für Scripts, Documents und Prompts. Einzelne Einstellungen lassen sich von dort aus auch ändern.

Damit das funktioniert, hinterlegen Sie einmal Host und Zugangsdaten eines CCX-Administrators. EasyUC spricht den Server ausschließlich per HTTPS unter dem festen Pfad /adminapi an. Das Speichern der Verbindung schreibt nichts in den CCX. Das Kennwort liegt verschlüsselt in EasyUC und wird nie wieder angezeigt.

Die Verbindung wird beim Speichern an die gerade aktive CUCM-Verbindung gebunden. Arbeiten Sie später in einem anderen CUCM-Cluster, bleibt der CCX-Bereich dort gesperrt.

Voraussetzungen

• Modul CUCM ist auf der Appliance aktiv. Das Menü Contact Center Express gehört zum Arbeitsbereich EasyUC Cisco.
• Verbindung einrichten oder ändern: nur Administratoren (ROLE_APP_ADMIN, ROLE_OWNER, ROLE_ADMIN oder ROLE_SUPER_ADMIN).
• Lesen ohne Administratorrolle: ROLE_APP_CCX und zusätzlich je Bereich ROLE_APP_CCX_DASHBOARD, ROLE_APP_CCX_AGENTS, ROLE_APP_CCX_APPLICATIONS, ROLE_APP_CCX_SCRIPTS, ROLE_APP_CCX_DOCUMENTS, ROLE_APP_CCX_PROMPTS, ROLE_APP_CCX_SKILLS, ROLE_APP_CCX_TEAMS.
• Ändern ohne Administratorrolle: zusätzlich ROLE_APP_CCX_AGENTS_EDIT, ROLE_APP_CCX_APPLICATIONS_EDIT oder ROLE_APP_CCX_SCRIPTS_EDIT. Das Bearbeitungsrecht setzt immer das Leserecht des Bereichs voraus.
• Auf dem CCX: ein Administratorkonto mit Zugriff auf die Administrations-API. Der CCX muss von der Appliance per HTTPS erreichbar sein.
• Für die automatische Agenten-Einrichtung zusätzlich: der Name des CUCM Application Users, über den UCCX die Agententelefone steuert (RmCm-Provider). Er muss im gebundenen CUCM-Cluster existieren.
• Eine aktive CUCM-Verbindung ist in der Kopfzeile ausgewählt.

Schritt für Schritt: Verbindung hinterlegen

1. Wählen Sie oben den Arbeitsbereich EasyUC Cisco und prüfen Sie in der Kopfzeile, dass die CUCM-Verbindung ausgewählt ist, zu der dieser CCX gehört.
2. Öffnen Sie im Menü Contact Center Express → Dashboard.
3. Klicken Sie oben rechts auf Verbindung. Ist noch nichts eingerichtet, öffnet sich der Bereich CCX-Verbindung für Administratoren von selbst.
4. Tragen Sie unter Host / IP die Adresse des CCX ein, zum Beispiel uccx01.intern. Nur Hostname oder IP-Adresse, ohne https://, Port oder Pfad.
5. Tragen Sie unter API-Administrator den Benutzernamen und unter Kennwort das Kennwort des CCX-Administrators ein.
6. Tragen Sie unter RmCm Application User den CUCM Application User des RmCm-Providers ein, wenn Sie Agenten aus dem Benutzerprofil heraus einrichten wollen. Sonst bleibt das Feld leer.
7. Lassen Sie TLS-Zertifikat prüfen eingeschaltet, wenn der CCX ein Zertifikat einer vertrauenswürdigen Zertifizierungsstelle verwendet.
8. Klicken Sie auf Verbindung speichern. EasyUC meldet Verbindung in EasyUC gespeichert. und lädt das Dashboard neu.

Schritt für Schritt: Dashboard lesen

1. Öffnen Sie Contact Center Express → Dashboard.
2. Lesen Sie die drei Kennzahlen Applications, Agenten und Supervisor. Ein Klick auf eine Kennzahl öffnet die zugehörige Liste.
3. Prüfen Sie die Tabellen darunter. Sie zeigen jeweils die ersten 10 Applications und Agenten sowie alle Supervisor mit ihren primären und sekundären Teams.
4. Klicken Sie auf Aktualisieren, um den Stand neu aus dem CCX zu laden. Unten steht der Zeitpunkt des Abrufs und der Host.
5. Wechseln Sie über die Reiter Agenten, Skills, Teams, Applications, Script, Documents und Prompts in die Listen. Sichtbar sind nur die Reiter, für die Sie ein Leserecht haben.

Felder und Optionen

Ergebnis prüfen und Fehler eingrenzen

• Erfolg: Das Dashboard zeigt Zahlen statt eines Strichs, und in der Fußzeile steht Stand: mit Uhrzeit und Host.
• Noch keine CCX-Verbindung eingerichtet. Ein EasyUC-Administrator kann sie unter „Verbindung“ hinterlegen. Es fehlen Host, Benutzer oder Kennwort.
• Bitte eine IP-Adresse oder einen Hostnamen ohne URL, Port oder Pfad angeben. Entfernen Sie https://, Portangabe und Pfad aus dem Feld Host / IP.
• CCX-Administrator und Kennwort sind erforderlich. Beim ersten Speichern muss das Kennwort eingegeben werden.
• CCX verweigert den Zugriff. Administrator-Zugang und API-Berechtigungen prüfen. Benutzername, Kennwort und die Berechtigung des Kontos auf dem CCX kontrollieren.
• CCX ist nicht erreichbar oder das TLS-Zertifikat konnte nicht geprüft werden. Netzwerkweg und Firewall zur Appliance prüfen. Bei einem selbst signierten Zertifikat die Zertifikatskette klären oder die Prüfung bewusst ausschalten.
• Die CCX-Verbindung ist an einen anderen CUCM-Cluster gebunden. Wechseln Sie in der Kopfzeile auf die CUCM-Verbindung, unter der die CCX-Verbindung gespeichert wurde, oder speichern Sie sie als Administrator unter der gewünschten Verbindung neu.
• Die CCX-Verbindung wird gerade verwendet oder geändert. Bitte erneut versuchen. Eine andere Änderung läuft noch. Kurz warten und wiederholen.
• CCX-Zugangsdaten müssen nach einem Wechsel des Anwendungsschlüssels neu gespeichert werden. Kennwort erneut eingeben und speichern.
• Gelbe Hinweise im Dashboard nennen den Bereich und die Meldung des CCX, wenn nur ein Teil der Daten geladen werden konnte.