Configurar e solucionar problemas do Finesse IP Phone Agent (FIPPA) no UCCX

Introdução

Este documento descreve como configurar e solucionar problemas do Finesse IP Phone Agent (FIPPA) no Unified Contact Center Express (UCCX)

Pré-requisitos

Requisitos

A Cisco recomenda que você tenha conhecimento destes tópicos:

• UCCX
• Cisco Unified Communications Manager (CUCM)

Componentes Utilizados

As informações neste documento são baseadas nestas versões de software e hardware:

• UCCX 11.0(1)
• Telefones IP.

As informações neste documento foram criadas a partir de dispositivos em um ambiente de laboratório específico. Todos os dispositivos utilizados neste documento foram iniciados com uma configuração (padrão) inicial. Se a rede estiver ativa, certifique-se de que você entenda o impacto potencial de qualquer comando.

Informações de Apoio

A partir do UCCX 11.X, o Cisco Agent Desktop (CAD - o conjunto de produtos calabrio) foi adiado e o Cisco Finesse é o único conjunto de produtos Agent Desktop disponível no UCCX. Além disso, não há serviços de desktop ou LDAP CCX. Anteriormente, eles eram acessíveis por meio da WebGUI do Cisco Desktop Administrator (CDA) .

Há apenas um dispositivo Cisco Finesse que reside no UCCX e lida com o Agent Desktop baseado em navegador da Web e com o IP Phone Agent - agora empacotado como Finesse IP Phone Agent (FIPPA). O Cisco Finesse Tomcat é o único serviço exposto na página de facilidade de manutenção do CCX. (Junto com os serviços de suporte, o CCX Engine e o serviço de Notificação do CCX necessários para fazer logon dos agentes)

Arquitetura

• O Telefone IP faz solicitações e obtém respostas sobre o Protocolo de Transferência de Hipertexto (HTTP - Hypertext Transfer Protocol) na forma de Objetos XML do Telefone IP da Cisco. Essas respostas são usadas diretamente para construir as telas FIPPA.
• O coração da FIPPA é a GUERRA FIPPA, que gerencia todas as sessões FIPPA. Ele usa as mesmas interfaces REST Application Programming Interface (APIs) e Extensible Messaging and Presence Protocol (XMPP) usadas pelo Desktop.
• O FIPPA WAR faz solicitações de APIs REST que estão autorizadas a usar o mesmo território usado para o Finesse Desktop.
• Assim, todas as configurações de códigos de finalização, códigos de razão, etc. para FIPPA são as mesmas do Finesse Desktop.
• O FIPPA WAR recebe notificações de eventos com XMPP puro (ao contrário do BOSH que o Desktop usa).
• O Telefone IP atua como um Servidor pseudo-HTTP, já que as mensagens são enviadas por push via HTTP. Isso está na forma de uma URL que o telefone IP, por sua vez, solicita.

• 

Configuração

Login manual

Etapa 1. Adicione o serviço após a configuração do Agente do UCCX.

• Configure o telefone do agente e o usuário final para o UCCX (Atribua o ramal IPCC ao usuário final).
  
  
• Finesse Tomcat deve ser [STARTED].
  
  
• Configure o serviço FIPPA como um serviço de telefone IP no nó - um serviço por nó.
  
  
• Isso é feito em CUCM admin > Device > Device Settings > Phone Services.

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

Etapa 2. Associe o serviço ao telefone.

• Navegue para o telefone no dispositivo CUCM > Telefone e assine o serviço FIPPA para o telefone, como mostrado na imagem:

Etapa 3. Configurar o usuário do aplicativo FIPPA.

• Você deve configurar um usuário de aplicativo para FIPPA com as funções CTI padrão habilitado e CTI padrão permitindo o controle de todos os telefones.
  
  
• Esse usuário do aplicativo é criado no CUCM primeiro, e os detalhes são inseridos na página CFAdmin como parte da página URL de autenticação do telefone. Isso é obrigatório para fazer login no FIPPA.
  
  
• A URL para esta configuração é (cfadmin) - https://UCCX-IP-or-FQDN:8445/cfadmin
  
  
• Digite aqui o nome de usuário e a senha do aplicativo (devem ser alfanuméricos).
  
  
• Click Save.
  
  
• Essa é uma configuração necessária. Sem isso, você receberá um erro no telefone "URL de autenticação do telefone não configurada".
  
  
• 

 Etapa 4. Adicione o telefone do agente sob o usuário do aplicativo FIPPA.

• No CUCM, verifique se o telefone do agente (dispositivo) foi adicionado ao usuário do aplicativo FIPPA.

Note: O usuário do aplicativo FIPPA foi criado para descarregar as solicitações de logon/dispositivo FIPPA para esse usuário, em vez de carregar o usuário do aplicativo RMCM. No entanto, em teoria, qualquer um deles pode ser usado de forma intercambiável para o controle de dispositivos. É importante observar que o URL de autenticação do telefone no CFAdmin (Finesse Admin) é o usuário do aplicativo no CUCM que lida com solicitações FIPPA. Em nosso caso, o usuário do aplicativo FIPPA de acordo com as práticas recomendadas.

Etapa 5. Configurar códigos de Finalização ou Motivos (opcional).

• Todos os códigos de razão, códigos de finalização, etc. devem ser configurados como parte do Finesse Admin (cfadmin).
  
  
• Todas as variáveis empresariais são configuradas no Finesse Admin (cfadmin).
  
  
• Isso é o mesmo que o Cisco Finesse Agent Desktop. 
  
  

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

Login com um botão

Esse é um método popular de configuração FIPPA.

Todas as etapas são semelhantes, incluindo a URL do Finesse. A única diferença é a existência de parâmetros de serviço sob o IP Phone Service, bem como a página de assinatura do telefone (serviços de assinatura/cancelamento de assinatura).

  

Etapa 1. Adicionar o serviço após a configuração do agente do UCCX.

• Configure o telefone do agente e o usuário final. Finesse Tomcat deve ser [STARTED].
  
  
• Configure o serviço FIPPA como um serviço de telefone IP no nó - um serviço por nó.
  
  
• Isso é feito em CUCM admin > Device > Device Settings > Phone Services.
  
  

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

Semelhante à configuração IPPA legada, insira um dos nomes de parâmetro em minúsculas exatamente como a seguir:

• id
• extensão
• senha

Note: Não há suporte para Entrada com um Botão com assinaturas corporativas.

Os valores inseridos são os parâmetros exatos da cadeia de caracteres de consulta usados para a URL de inscrição.

 Etapa 2. Associe o serviço ao telefone.

• Navegue para o telefone no dispositivo CUCM > Telefone e assine o serviço FIPPA para o telefone.

• 

Insira os valores de Login de um botão para os parâmetros de URL, como mostrado na imagem:

Etapa 3. Configurar o usuário do aplicativo FIPPA (URL de autenticação do telefone).

• Você deve configurar um usuário de aplicativo para FIPPA com as funções CTI padrão habilitado e CTI padrão permitindo o controle de todos os telefones.
  
  
• Esse usuário do aplicativo é criado no CUCM primeiro, e os detalhes são inseridos na página CFAdmin como parte da página URL de autenticação do telefone. Isso é obrigatório para fazer login no FIPPA.
  
  
• A URL para esta configuração é (cfadmin) - https://UCCX-IP-or-FQDN:8445/cfadmin
  
  
• Digite aqui o nome de usuário e a senha do aplicativo (devem ser alfanuméricos).
  
  
• Click Save.
  
  
• Essa é uma configuração necessária. Sem isso, você receberá um erro no telefone "URL de autenticação do telefone não configurada".
  
  

Etapa 4. Adicione o telefone do agente sob o usuário do aplicativo FIPPA.

• No CUCM, verifique se o telefone do agente (dispositivo) foi adicionado ao usuário do aplicativo FIPPA

As etapas 3 e 4 são as mesmas da configuração de login manual mencionada acima.

Problemas comuns

Nenhuma variável de chamada é exibida devido a um erro de autenticação de URL do telefone

Erro:

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

Solução:

• Verifique se as Configurações de autenticação da URL do telefone inseridas no gadget Configurações do IP Phone Agent correspondem às configuradas para o usuário do aplicativo no Unified CM.
• Verifique também se o ramal do agente está listado como um Dispositivo controlado para o usuário do aplicativo no Unified CM.
• Consulte para obter mais etapas de solução de problemas: 

Telefones ociosos exibem "Host não encontrado"

Erro:

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

Solução:

• Se você tiver um URL de exibição ocioso, verifique se o URL está correto. Se a URL usar FQDN, verifique se o servidor DNS pode resolver esse FQDN.
• Se você não precisar do visor ocioso, verifique se não há um URL de visor ocioso configurado para o telefone. Verifique também se o campo Temporizador de ociosidade está em branco.
• Como alternativa, se você usar um Modelo de registro automático no Unified CM, consulte o seguinte para obter uma possível resolução: https://supportforums.cisco.com/document/12332916/service-applet-pops-phone-idle-application-showing-phone-host-not-found

Troubleshooting

• Verifique a configuração.
• O Finesse Tomcat deve ser IN_SERVICE no nó em que você tenta fazer logon.

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

• O layout XML FIPPA deve ser retornado quando acessado por um navegador da Web.

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

Exemplo: Abrir o URL em um navegador da Web

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

• Para testar o login com um agente de amostra, também é possível testá-lo no navegador da Web.

Exemplo: Para o dispositivo do agente SEPAAABBBBCCCC, ID do agente=arunabh, senha=cisco, Extensão=62000

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

Coleta de logs 

• Os logs do FIPPA são nomeado como Logs FIPPA localizados na pasta de log do Cisco Finesse.

CLI :

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

  

• Na Real Time Monitoring Tool (RTMT) - Colete os logs do Cisco Finesse.
• Contém os logs localhost Finesse e os logs FIPPA.
• As mensagens também são vistas quando o tratamento de logon do agente pelo Finesse Tomcat - CCX Engine também pode ser analisado.

Informações Relacionadas

• Capítulo: Tarefas do Agente de Telefone IP Finesse
• Capítulo: Cisco Finesse
• Diretrizes para a configuração do telefone do agente