Finesse IP Phone Agent (FIPPA) in UCX configureren en probleemoplossing uitvoeren

Downloadopties

PDF (824.2 KB)
Met Adobe Reader op diverse apparaten bekijken

Bijgewerkt:21 september 2017

Document-id:212115

Inclusief taalgebruik

De documentatie van dit product is waar mogelijk geschreven met inclusief taalgebruik. Inclusief taalgebruik wordt in deze documentatie gedefinieerd als taal die geen discriminatie op basis van leeftijd, handicap, gender, etniciteit, seksuele oriëntatie, sociaaleconomische status of combinaties hiervan weerspiegelt. In deze documentatie kunnen uitzonderingen voorkomen vanwege bewoordingen die in de gebruikersinterfaces van de productsoftware zijn gecodeerd, die op het taalgebruik in de RFP-documentatie zijn gebaseerd of die worden gebruikt in een product van een externe partij waarnaar wordt verwezen. Lees meer over hoe Cisco gebruikmaakt van inclusief taalgebruik.

Over deze vertaling

Cisco heeft dit document vertaald via een combinatie van machine- en menselijke technologie om onze gebruikers wereldwijd ondersteuningscontent te bieden in hun eigen taal. Houd er rekening mee dat zelfs de beste machinevertaling niet net zo nauwkeurig is als die van een professionele vertaler. Cisco Systems, Inc. is niet aansprakelijk voor de nauwkeurigheid van deze vertalingen en raadt aan altijd het oorspronkelijke Engelstalige document (link) te raadplegen.

Inhoud

Inleiding

Voorwaarden

Vereisten

Gebruikte componenten

Achtergrondinformatie

Architectuur

Configuratie

Handmatige aanmelding

Aanmelden met één knop

Veelvoorkomende problemen

Er worden geen gespreksvariabelen weergegeven vanwege een fout in de URL-verificatie van de telefoon

Weergave inactiviteittelefoons "host niet gevonden"

Problemen oplossen

Logbestanden verzamelen

Gerelateerde informatie

Inleiding

Dit document beschrijft hoe u Finesse IP Phone Agent (FIPPA) op Unified Contact Center Express (UCX) kunt configureren en problemen kunt oplossen

Voorwaarden

Vereisten

Cisco raadt kennis van de volgende onderwerpen aan:

UCCX
Cisco Unified Communications Manager (CUCM)

Gebruikte componenten

De informatie in dit document is gebaseerd op de volgende software- en hardware-versies:

UCS 11.0(1).
IP-telefoons.

De informatie in dit document is gebaseerd op de apparaten in een specifieke laboratoriumomgeving. Alle apparaten die in dit document worden beschreven, hadden een opgeschoonde (standaard)configuratie. Als uw netwerk live is, moet u zorgen dat u de potentiële impact van elke opdracht begrijpt.

Achtergrondinformatie

Vanaf UCCX 11.X is Cisco Agent Desktop (CAD - de calabrio-productsuite) uitgesteld en Cisco Finesse is de enige Agent-desktopproductsuite die op UCCX beschikbaar is. Bovendien bestaan er geen desktopservices of CCX Lichtgewicht access point (LDAP). Dit was voorheen toegankelijk via de Cisco Desktop Administrator (CDA) WebGUI.

Er is alleen een Cisco FineReader-apparaat dat ook op UCCX aanwezig is en zowel op de webbrowser gebaseerde Agent-desktop als IP Phone Agent verwerkt - nu verpakt als Finesse IP Phone Agent (FIPPA). De Cisco Finesse Tomcat is de enige service die wordt weergegeven op de pagina CCX-onderhoudbaarheid. (Samen met de ondersteuningsdiensten, de CCX Engine en de CCX Notification-service die nodig zijn om agents in te loggen)

Architectuur

De IP-telefoon doet verzoeken en krijgt antwoorden via Hypertext Transfer Protocol (HTTP) in de vorm van Cisco IP-telefoon XML-objecten. Deze reacties worden direct gebruikt om de FIPPA-schermen te construeren.
Het hart van FIPPA is de FIPPA OORLOG die alle FIPPA-sessies beheert. Het maakt gebruik van dezelfde REST Application Programming Interface (API's) en Extensible Messaging and Presence Protocol (XMPP) interfaces die door het bureaublad worden gebruikt.
De FIPPA WAR maakt REST API's verzoeken die zijn geautoriseerd om hetzelfde Realm te gebruiken dat wordt gebruikt voor de Finesse Desktop.
Alle configuraties voor afrondingscodes, oorzaakcodes, etc. voor FIPPA zijn dus hetzelfde als Finesse Desktop.
De FIPPA WAR krijgt gebeurtenismeldingen met pure XMPP (in tegenstelling tot de BOSH de Desktop gebruikt).
De IP-telefoon fungeert als een pseudo-HTTP server als berichten via HTTP worden gedrukt. Dit is in de vorm van een URL die de IP-telefoon op zijn beurt vraagt.

Configuratie

Handmatige aanmelding

Stap 1. Voeg de service toe na configuratie van UCS Agent.

Configureer de Agent-telefoon en de eindgebruiker voor UCCX (wijs IPCC-uitbreiding toe aan de eindgebruiker).
Finesse Tomcat moet zijn [START].
De FIPPA-service configureren als een IP-telefoonservice op het knooppunt - één service per knooppunt.
Dit gebeurt bij CUCM-beheer > Apparaat > Apparaatinstellingen > Telefoonservices.

URL: http://UCCX-IP-ADDRESS:8082/fippa/#DEVICENAME#

Stap 2. Koppel de service aan de telefoon.

Navigeer naar de telefoon op het CUCM-apparaat > Telefoon en abonneer de FIPPA-service op de telefoon, zoals in de afbeelding:

Stap 3. Configureer de FIPPA-toepassingsgebruiker.

U moet een applicatie gebruiker voor FIPPA configureren met de rollen Standaard CTI Enabled en Standaard CTI Toestaan controle van alle telefoons.
Deze toepassingsgebruiker wordt eerst gemaakt op CUCM en de details worden ingevoerd op de CFAdmin pagina als onderdeel van de URL-pagina voor telefoonverificatie. Dit is verplicht om in te loggen op FIPPA.
De URL voor deze configuratie is (cfadmin) - https://UCCX-IP-or-FQDN:8445/cfadmin
Typ hier de gebruikersnaam en het wachtwoord voor de toepassing (dit moet alfanumeriek zijn).
Klik op Save (Opslaan).
Dit is een noodzakelijke configuratie. Zonder dit, ontvangt u een fout op de telefoon "Telefoon verificatie URL niet geconfigureerd".

Stap 4. Voeg de Agent-telefoon toe onder de FIPPA-toepassingsgebruiker.

Zorg er op CUCM voor dat de agent phone (apparaat) is toegevoegd onder de FIPPA-toepassingsgebruiker.

Opmerking: De gebruiker van de FIPPA-toepassing is gemaakt om FIPPA-log-/apparaatverzoeken aan deze gebruiker te offloaden in plaats van te laden op de RMCM-toepassingsgebruiker. In theorie kan een van deze twee echter onderling verwisselbaar worden gebruikt voor apparaatbesturing. Het is belangrijk om op te merken dat de URL voor telefoonverificatie op CFAdmin (Finesse Admin) de Toepassingsgebruiker op CUCM is die FIPPA-verzoeken afhandelt. In ons geval, FIPPA Application User zoals aanbevolen praktijken.

Stap 5. Configuratie van Wrap Up-codes of redenen (optioneel).

Alle Reden-codes, afrondingscodes enzovoort moeten worden geconfigureerd als een onderdeel van Finesse Admin (cfadmin).
Alle Enterprise-variabelen zijn ingesteld op Finesse Admin (cfadmin).
Dit is hetzelfde als het bureaublad van Cisco FineReader-agents.

URL: https://UCCX-IP-or-FQDN:8445/cfadmin

Aanmelden met één knop

Dit is een populaire methode voor FIPPA Configuration.

Alle stappen zijn vergelijkbaar, inclusief de URL van Finesse. Het enige verschil is het bestaan van serviceparameters onder de IP-telefoonservice, evenals de telefoonabonnementspagina (Subscriber/ Unsubscribe-services).

Stap 1. Voeg de service toe na de configuratie van de UCS-agent.

Configureer de Agent-telefoon en de eindgebruiker. Finesse Tomcat moet zijn [START].
De FIPPA-service configureren als een IP-telefoonservice op het knooppunt - één service per knooppunt.
Dit gebeurt bij CUCM-beheer > Apparaat > Apparaatinstellingen > Telefoonservices.

URL: http://UCCX-IP-ADDRESS:8082/fippa/#DEVICENAME#

Gelijkaardig aan de erfenis IPPA configuratie, ga één van de parameternamen in in kleine letters precies in zoals dit:

id
verlenging
wachtwoord

Opmerking: One Button Sign In wordt niet ondersteund door Enterprise-abonnementen.

De ingevoerde waarden zijn de exacte parameters van de query die voor de abonnement-URL worden gebruikt.

Stap 2. Koppel de service aan de telefoon.

Navigeer naar de telefoon op het CUCM-apparaat > Telefoon en abonneer de FIPPA-service op de telefoon.

Voer de waarden in van de knop Login voor de URL-parameters, zoals in de afbeelding:

Stap 3. Configuratie van de FIPPA-toepassingsgebruiker (telefoonverificatie-URL).

U moet een applicatie gebruiker voor FIPPA configureren met de rollen Standaard CTI Enabled en Standaard CTI Toestaan controle van alle telefoons.
Deze toepassingsgebruiker wordt eerst gemaakt op CUCM en de details worden ingevoerd op de CFAdmin pagina als onderdeel van de URL-pagina voor telefoonverificatie. Dit is verplicht om in te loggen op FIPPA.
De URL voor deze configuratie is (cfadmin) - https://UCCX-IP-or-FQDN:8445/cfadmin
Typ hier de gebruikersnaam en het wachtwoord voor de toepassing (dit moet alfanumeriek zijn).
Klik op Save (Opslaan).
Dit is een noodzakelijke configuratie. Zonder dit, ontvangt u een fout op de telefoon "Telefoon verificatie URL niet geconfigureerd".

Stap 4. Voeg de Agent-telefoon toe onder de FIPPA-toepassingsgebruiker.

Zorg er op CUCM voor dat de agent phone (apparaat) is toegevoegd onder de FIPPA-toepassingsgebruiker

Stappen 3 en 4 zijn hetzelfde als de hierboven genoemde handmatige inlogconfiguratie.

Veelvoorkomende problemen

Er worden geen gespreksvariabelen weergegeven vanwege een fout in de URL-verificatie van de telefoon

Fout:

“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.

Oplossing:

Controleer of de instellingen voor de IP Phone URL-verificatie die zijn ingevoerd in het gadget IP Phone Agent, overeenkomen met de instellingen die zijn geconfigureerd voor de toepassingsgebruiker in Unified CM.
Controleer ook of de agent-extensie wordt vermeld als een Gecontroleerd apparaat voor de toepassingsgebruiker in Unified CM.
Raadpleeg voor meer stappen voor probleemoplossing:

Weergave inactiviteittelefoons "host niet gevonden"

Fout:

“Error” and “Host not found”
Or
“Idle Application” and “Host not found”

Oplossing:

Als u de URL voor niet-actieve weergave hebt, zorg dan dat de URL juist is. Als de URL FQDN gebruikt, zorg er dan voor dat de DNS-server deze FQDN kan oplossen.
Als u niet vereist de Idle Display, zorg ervoor dat er geen Idle Display URL is geconfigureerd voor de telefoon. Zorg ook dat het veld Inactiviteitstimer leeg is.
Als u een sjabloon voor automatische registratie in Unified CM gebruikt, raadpleegt u het volgende voor een mogelijke resolutie: https://supportforums.cisco.com/document/12332916/service-applet-pops-phone-idle-application-showing-phone-host-not-found

Problemen oplossen

Controleer en verifieer de configuratie.
Finesse Tomcat moet in_SERVICE zijn op het knooppunt dat u probeert in te loggen.

https://UCCX-FQDN:8445/finesse/api/SystemInfo

De lay-out van FIPPA XML moet worden teruggekeerd wanneer betreden door een Web Browser.

http://UCS-IP-of-FQDN:8082/fippa/#DEVICENAME#

Voorbeeld: De URL in een webbrowser openen

http://UCCX-IP-or-FQDN 8082/FIPPA/SEPA ABBCCC

Om daadwerkelijk inloggen met een sample agent te testen, kan men het ook testen in de web browser.

Voorbeeld: Voor Agent-apparaat SEPAabbcc, Agent ID=arunabh, password=cisco, Extension=62000

http ://UCS-IP-of-FQDN :8082/fippa/SEPAabbcc/login?password=cisco&extension=62000&id=arunabh

Logbestanden verzamelen

De logs voor FIPPA zijn Benoemd als De FIPPA-logbestanden bevinden zich in de map Cisco Finesse.

CLI :

file list activelog /desktop/logs/fippa/*
file get activelog /desktop/logs/fippa/*

Van Real Time Monitoring Tool (RTMT) - Verzamel de Cisco Finesse-logbestanden.
Dit bevat de Finesse localhost-logbestanden en de FIPPA-logbestanden.
Berichten worden ook gezien wanneer de agent log in behandeling door de Finesse Tomcat - CCX Engine logs ook kunnen worden geanalyseerd.