Configuración y solución de problemas de Finesse IP Phone Agent (FIPPA) en UCCX

Introducción

Este documento describe cómo configurar y solucionar problemas de Finesse IP Phone Agent (FIPPA) en Unified Contact Center Express (UCCX)

Prerequisites

Requirements

Cisco recomienda que tenga conocimiento sobre estos temas:

• UCCX
• Cisco Unified Communications Manager (CUCM)

Componentes Utilizados

La información que contiene este documento se basa en las siguientes versiones de software y hardware.

• UCCX 1.0(1).
• Teléfonos IP.

La información que contiene este documento se creó a partir de los dispositivos en un ambiente de laboratorio específico. Todos los dispositivos que se utilizan en este documento se pusieron en funcionamiento con una configuración verificada (predeterminada). Si tiene una red en vivo, asegúrese de entender el posible impacto de cualquier comando.

Antecedentes

A partir de UCCX 11.X, Cisco Agent Desktop (CAD, el conjunto de productos de Calabrio) se ha aplazado y Cisco Finesse es el único conjunto de productos de Agent Desktop disponible en UCCX. Además, no existen servicios de escritorio ni Lightweight Access Point (LDAP) de CCX. Anteriormente se podía acceder a este servicio a través de la GUI web de Cisco Desktop Administrator (CDA).

Solo hay un dispositivo Cisco Finesse que reside de forma conjunta en UCCX y gestiona Agent Desktop basado en navegador web, así como IP Phone Agent; ahora se incluye en Finesse IP Phone Agent (FIPPA). Cisco Finesse Tomcat es el único servicio expuesto en la página Serviciabilidad de CCX. (Junto con los servicios de asistencia, el motor CCX y el servicio de notificación CCX necesarios para iniciar sesión en los agentes)

Arquitectura

• El teléfono IP realiza solicitudes y obtiene respuestas a través del protocolo de transferencia de hipertexto (HTTP) en forma de objetos XML de CiscoIPPhone. Estas respuestas se utilizan directamente para construir las pantallas FIPPA.
• El corazón de FIPPA es FIPPA WAR, que gestiona todas las sesiones de FIPPA. Utiliza las mismas interfaces de programación de aplicaciones (API) REST y protocolo extensible de mensajería y presencia (XMPP) que utiliza el escritorio.
• FIPPA WAR realiza solicitudes de API REST autorizadas para utilizar el mismo rango utilizado para el escritorio Finesse.
• Por lo tanto, todas las configuraciones de códigos de cierre, códigos de motivo, etc. para FIPPA son iguales que las de Finesse Desktop.
• FIPPA WAR recibe notificaciones de eventos con XMPP puro (a diferencia de BOSH que utiliza el escritorio).
• El teléfono IP actúa como un servidor pseudoHTTP ya que los mensajes se envían a través de HTTP. Se trata de una URL que el teléfono IP, a su vez, solicita.

• 

Configuración

Inicio de sesión manual

Paso 1. Agregue el servicio después de la configuración del agente UCCX.

• Configure el teléfono del agente y el usuario final para UCCX (Asignar extensión IPCC al usuario final).
  
  
• Finesse Tomcat debe ser [INICIADO].
  
  
• Configure el servicio FIPPA como servicio de teléfono IP en el nodo: un servicio por nodo.
  
  
• Esto se hace en CUCM admin > Device > Device Settings > Phone Services.

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

Paso 2. Asocie el servicio al teléfono.

• Navegue hasta el teléfono en CUCM Device > Phone y suscriba el servicio FIPPA al teléfono, como se muestra en la imagen:

Paso 3. Configure el usuario de la aplicación FIPPA.

• Debe configurar un usuario de aplicación para FIPPA con las funciones CTI estándar activado y CTI estándar permitido para controlar todos los teléfonos.
  
  
• Este usuario de la aplicación se crea primero en CUCM y los detalles se introducen en la página CFAdmin como parte de la página URL de autenticación del teléfono. Es obligatorio iniciar sesión en FIPPA.
  
  
• La URL para esta configuración es (cfadmin) - https://UCCX-IP-or-FQDN:8445/cfadmin
  
  
• Introduzca aquí el nombre de usuario y la contraseña de la aplicación (debe ser alfanumérico).
  
  
• Click Save.
  
  
• Esta es una configuración necesaria. Sin esto, recibirá un error en el teléfono "URL de autenticación de teléfono no configurada".
  
  
• 

 Paso 4. Agregue el teléfono del agente bajo el usuario de la aplicación FIPPA.

• En CUCM, asegúrese de que el teléfono del agente (dispositivo) se agrega bajo el usuario de la aplicación FIPPA.

Nota: El usuario de la aplicación FIPPA se creó para descargar las solicitudes de inicio de sesión/dispositivo de FIPPA a este usuario en lugar de cargar el usuario de la aplicación RMCM. Sin embargo, en teoría, cualquiera de ellos se puede utilizar indistintamente para el control de dispositivos. Es importante tener en cuenta que la URL de autenticación telefónica en CFAdmin (Finesse Admin) es el usuario de la aplicación en CUCM que gestiona las solicitudes FIPPA. En nuestro caso, el usuario de la aplicación FIPPA según las prácticas recomendadas.

Paso 5. Configurar códigos o razones de cierre (opcional).

• Todos los códigos de motivo, códigos de cierre, etc. deben configurarse como parte de Finesse Admin (cfadmin).
  
  
• Todas las variables Enterprise se configuran en Finesse Admin (cfadmin).
  
  
• Es lo mismo que el escritorio del agente Cisco Finesse. 
  
  

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

Conexión con un botón

Este es un método popular de configuración de FIPPA.

Todos los pasos son similares, incluida la URL de Finesse. La única diferencia es la existencia de parámetros de servicio en el servicio de teléfono IP, así como en la página de suscripción de teléfono (servicios de suscripción y cancelación de suscripciones).

  

Paso 1. Agregue el servicio después de la configuración del agente UCCX.

• Configure el teléfono del agente y el usuario final. Finesse Tomcat debe ser [INICIADO].
  
  
• Configure el servicio FIPPA como servicio de teléfono IP en el nodo: un servicio por nodo.
  
  
• Esto se hace en CUCM admin > Device > Device Settings > Phone Services.
  
  

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

De manera similar a la configuración IPPA heredada, ingrese uno de los nombres de parámetro en minúsculas exactamente de la siguiente manera:

• id
• extensión
• contraseña

Nota: Las suscripciones de empresa no admiten el inicio de sesión con un botón.

Los valores introducidos son los parámetros de cadena de consulta exactos utilizados para la URL de suscripción.

 Paso 2. Asocie el servicio al teléfono.

• Navegue hasta el teléfono en CUCM Device > Phone y suscriba el servicio FIPPA al teléfono.

• 

Introduzca los valores de un botón de inicio de sesión para los parámetros de URL, como se muestra en la imagen:

Paso 3. Configuración del usuario de la aplicación FIPPA (URL de autenticación del teléfono).

• Debe configurar un usuario de aplicación para FIPPA con las funciones CTI estándar activado y CTI estándar permitido para controlar todos los teléfonos.
  
  
• Este usuario de la aplicación se crea primero en CUCM y los detalles se introducen en la página CFAdmin como parte de la página URL de autenticación del teléfono. Es obligatorio iniciar sesión en FIPPA.
  
  
• La URL para esta configuración es (cfadmin) - https://UCCX-IP-or-FQDN:8445/cfadmin
  
  
• Introduzca aquí el nombre de usuario y la contraseña de la aplicación (debe ser alfanumérico).
  
  
• Click Save.
  
  
• Esta es una configuración necesaria. Sin esto, recibirá un error en el teléfono "URL de autenticación de teléfono no configurada".
  
  

Paso 4. Agregue el teléfono del agente bajo el usuario de la aplicación FIPPA.

• En CUCM, asegúrese de que el teléfono del agente (dispositivo) se agrega bajo el usuario de la aplicación FIPPA

Los pasos 3,4 son los mismos que la configuración de inicio de sesión manual mencionada anteriormente.

Problemas comunes

No aparecen variables de llamada debido a un error de autenticación de URL del teléfono

Error:

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

Solución:

• Compruebe que la configuración de autenticación de URL del teléfono introducida en el gadget Configuración de agente de teléfono IP coincide con la configuración para el usuario de la aplicación en Unified CM.
• Compruebe también que la extensión del agente aparece como Dispositivo controlado para el usuario de la aplicación en Unified CM.
• Consulte para obtener más información sobre los pasos de Troubleshooting: 

Visualización de teléfonos inactivos "Host no encontrado"

Error:

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

Solución:

• Si tiene una URL de visualización inactiva, asegúrese de que la URL sea correcta. Si la dirección URL utiliza FQDN, asegúrese de que el servidor DNS puede resolver este FQDN.
• Si no necesita la pantalla inactiva, asegúrese de que no haya ninguna URL configurada para el teléfono. Asegúrese también de que el campo Idle Timer (Temporizador de inactividad) esté vacío.
• De forma alternativa, si utiliza una plantilla de registro automático en Unified CM, consulte la siguiente información para obtener una resolución potencial: https://supportforums.cisco.com/document/12332916/service-applet-pops-phone-idle-application-showing-phone-host-not-found

Troubleshoot

• Compruebe y verifique la configuración.
• Finesse Tomcat debe ser IN_SERVICE en el nodo que intenta iniciar sesión.

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

• El diseño XML de FIPPA debe devolverse cuando un explorador Web acceda a él.

http://UCCX-IP-or-FQDN:8082/fippa/#DEVICENAME#

Ejemplo: Abrir la dirección URL en un explorador Web

http://UCCX-IP-or-FQDN:8082/fippa/SEPAAAABBBCCCC

• Para probar realmente el inicio de sesión con un agente de ejemplo, también se puede probar en el navegador web.

Ejemplo: Para el dispositivo de agente SEPAAAABBBCCCC, ID de agente=arunabh, contraseña=cisco, extensión=62000

http://UCCX-IP-or-FQDN:8082/fippa/SEPAAAABBBCCCC/login?password=cisco&extension=62000&id=arunabh

Recopilación de registros 

• Los registros de FIPPA son nombrado como Los registros de FIPPA se encuentran en la carpeta de registros de Cisco Finesse.

CLI :

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

  

• Desde Real Time Monitoring Tool (RTMT): recopile los registros de Cisco Finesse.
• Esto contiene los logs de Finesse localhost y los logs de FIPPA.
• Los mensajes también se ven cuando el agente inicia sesión en el tratamiento por parte de Finesse Tomcat - Los registros del motor CCX también se pueden analizar.

Información Relacionada

• Capítulo: Tareas de Finesse IP Phone Agent
• Capítulo: Cisco Finesse
• Pautas para la configuración del teléfono del agente