Integração de cliente Guide - Avaya CMS
Introdução
Este guia oferece suporte a clientes que estão integrando o Avaya CMS local (versão 17.0 ou superior) com NiCE CXone WFM usando o Engagement Hub. Ele fornece orientações de implementação para integrações de canal de voz e chat, direcionadas a administradores de TI, integradores de sistemas e planejadores de WFM.
Escopo
Este guia:
-
Cobre a troca de dados históricos, em tempo real e intradiários.
-
Aplicável a integrações do canal de voz.
-
Projetado para Avaya CMS versão 17 e superior.
Responsabilidades do cliente
-
O cliente é responsável por fazer o download e instalar o conector, com orientação da equipe de implementação.
Você pode visualizar o conteúdo da página de Downloads somente após efetuar login no aplicativo NiCE CXone WFM. Se você não estiver com sessão iniciada, nenhum arquivo estará disponível para download.
-
O cliente deve configurar os canais do sistema avaya e o roteamento conforme necessário.
-
É necessária uma assinatura ativa do Avaya CMS, juntamente com as licenças apropriadas para os canais e para NiCE CXone WFM.
-
Durante a instalação do conector Avaya CMS, o cliente deve fornecer os detalhes de conexão JDBC.
-
Para dados em tempo real, o cliente deve configurar o sistema Avaya CMS com o host e a porta da máquina em que o conector está instalado.
-
Atribua um ponto de contato técnico para coordenar com a equipe de implementação.
Visão geral da integração
Pré-requisitos
Certifique-se de que as seguintes configurações e os seguintes acessos estejam em vigor antes da implementação:
-
Dados históricos são acessados via JDBC.
-
Eventos de estado do agente em tempo real são acessados via TCP.
-
Garanta a acessibilidade ao banco de dados Informix do IBM.
-
Configure o firewall para permitir tráfego de saída nas portas 443 e 80.
-
Os ids de agentes e Ids de competência devem ser mapeados em NiCE CXone WFM de acordo com os requisitos específicos do cliente.
-
Forneça acesso a um ambiente de teste para validação e configuração.(se aplicável)
Arquitetura
-
Avaya CMS (on-prem) → Conector → Hub ACD → CXone WFM.
-
O Conector Avaya CMS fornece funcionalidade Histórica & RTA para Integração do Engagement Hub.
-
A configuração do Engagement Hub está na conta AWS de propriedade da NiCE.
-
A configuração do Conector Avaya CMS é hospedada nas instalações do cliente.
Tipos DE mídia aceitos
-
Voz de entrada
-
Marcador de saída manual
-
Chat
Classificações de canal de mídia
-
Resposta imediata (via voz de entrada)
-
Resposta postergável (via chat)
-
Saída (via marcador de saída manual)
Protocolos
-
Para em tempo real, o cliente precisa configurar o sistema Avaya CMS com o host e a porta da máquina na qual o conector Avaya CMS está instalado.
-
Para relatórios históricos, o conector Avaya CMS estabelece uma conexão JDBC com o sistema Avaya CMS.
Tipos de dados compatíveis
-
Dados históricos (15 min)
-
Dados da previsão
-
Intradia
-
Relatório predefinido de adesão
-
-
Aderência em tempo real (Transições de Estado do agente) via Conector
Especificidades da recuperação de dados
O conector Avaya CMS oferece suporte a estes mecanismos de recuperação de dados:
-
Tempo real: O conector Avaya CMS escutará o host e a porta TCP configurados no sistema Avaya CMS para eventos de estado do agente em tempo real.
-
Histórico: O conector Avaya CMS estabelecerá uma conexão JDBC com o sistema Avaya CMS para buscar dados históricos periodicamente.
Modelos de implantação
On-prem ACD com conector on-prem, com WFM baseado em nuvem.
Dados de contato de fixação
-
Pegging de Contatos - intervalo quando o contato é concluído
-
Valores de tempo de contato - intervalo quando o contato é concluído
Todos os valores para os contatos de integração do Engagement Hub são fixados no final do intervalo quando o contato é concluído.
Exemplo: Se um contato começa em um intervalo de 15 minutos (12:00 a 12:15) e é concluído em outro intervalo (12:15 a 12:30), o contato é registrado no intervalo em que o contato é concluído (12:15 a 12:30).
Integração Histórica
Histórico: O conector Avaya CMS estabelecerá uma conexão JDBC com o sistema Avaya CMS para buscar dados históricos periodicamente.
Os dados do relatório estão disponíveis em intervalos de 15 minutos. Aqui estão os conjuntos DE dados suportados:
Mapeamento de dados e definições
Os dados de relatório estão disponíveis em intervalos de 15 minutos. Aqui estão os conjuntos DE dados compatíveis:
Dados da fila DE espera
Nome da tabela do banco de dados Informix do Avaya CMS: hsplit
As seguintes propriedades podem ser configuradas usando o Queue Data Report:
|
CXone WFM nome do campo |
Avaya CMS nome do campo ACD |
|---|---|
| QueueValue | Campo não disponível com ACD |
| QueueName | SPLIT |
| IsOutbound | Campo não disponível com ACD |
| ContactsReceived | CALLSOFFERED - DEQUECALLS - OUTFLOWCALLS |
| AbandonedShort | Campo não disponível com ACD |
| AbandonedLong | ABNCALLS |
| HandledShort | Campo não disponível com ACD |
| HandledLong | ACDCALLS |
| Tempo de atendimento | ACDTIME |
| WorkTime | ACWTIME |
| QueueDelayTime | RINGTIME |
| SvcLvlPct | SERVICELEVEL OR 100* (ACCEPTABLE / (ACDCALLS + ABNCALLS)) |
| Tempo de atendimento da Parte Correta | O_ACDTIME |
| RightPartyContacts | O_ACDCALLS |
| WrongPartyHandleTime | Campo não disponível com ACD |
| Contatos com a parte incorreta | Campo não disponível com ACD |
| Pendências | MAXINQUEUE |
| BacklogNotExpired | CALLSOFFERED - (ABNCALLS + DISCCALLS) |
| BacklogExpirado | DISCCALLS |
| HoldTime | HOLDTIME |
| Ativo | Não aplicável |
Nome da tabela do banco de dados Avaya CMS: hagent
Os atributos a seguir podem ser configurados usando o relatório de Fila DE espera do Agente:
|
CXone WFM nome do campo |
Avaya CMS nome do campo ACD |
|---|---|
| Valor da fila | Campo não disponível com ACD |
| QueueName | SPLIT |
| IsOutbound | Campo não disponível com ACD |
| AgentValue | LOGID |
| AgentId: | Campo não disponível com ACD |
| Atendidas | ACDCALLS |
| Tempo tratado | ACDTIME |
| WorkTime | ACWTIME |
| Tempo de atendimento da Parte Correta | O_ACDTIME |
| RightPartyContacts | O_ACDCALLS |
| WrongPartyHandleTime | Campo não disponível com ACD |
| WrongPartyContacts | Campo não disponível com ACD |
| HoldTime | HOLDTIME |
| Ativo | Não aplicável |
Nome da tabela do banco de dados Avaya CMS: hagent
Os seguintes atributos podem ser configurados usando o Agent System Performance Report:
|
CXone WFM nome do campo |
Avaya CMS nome do campo ACD |
|---|---|
| AgentValue | LOGID |
| AgentId: | Campo não disponível com ACD |
| ReadyTime | TI_AVAILTIME |
| ReadyTime | TI_OTHERTIME |
| Hora de login | Campo não disponível com ACD e não obrigatório para Intradia |
Nome da tabela do banco de dados Avaya CMS: ag_actv
As seguintes atribuições podem ser configuradas usando o Relatório de Atividade do Agente:
|
CXone WFM nome do campo |
Avaya CMS nome do campo ACD |
|---|---|
| AgentValue | Campo não disponível com ACD |
| AgentId: | LOGID |
| Nome do usuário | Campo não disponível com ACD |
| Estado | workMode+"" |
| StartTime | STARTTIME_UTC |
| Duração | duração |
| Motivo | Se o valor de WORKMODE for 110, o motivo deve ser considerado como LOGOUTREASON; caso contrário, AUXREASON deve ser considerado. |
Este mapeamento fornece uma referência básica de como os componentes do dashboard funcionam dentro da configuração padrão. No entanto, o comportamento do componente pode variar com base nos requisitos específicos do cliente
Integração em tempo real
A interface adesão em tempo real (RTA) fornece dados do agente, especificamente seus estados atuais, do Avaya CMS para o NiCE NiCE CXone WFM.
Mapeamento de dados
Dados de estados DO agente em tempo real
|
Campos obrigatórios |
Disponível |
|---|---|
| loginId | Sim |
| acdId | Sim |
| eventCode | Sim |
| Código de razão | Sim |
| eventUtcTime | Sim |
Estados DO agente padrão
|
Eventos RTA CMS padrão |
Identificador de evento |
Código do motivo |
Definição |
|---|---|---|---|
| 0 | 0 | Desconhecido | |
| 10 | 10 | Sem equipe | |
| 20 | 20 | Disponível | |
| 30 | 30 | ACD | |
| 31 | 31 | Saída ACD | |
| 32 | 32 | Entrada ACD | |
| N/A | 600 | 0 | AUXOutonHold |
| N/A | 600 | 1 a 99 | AUXOutonHold w/Reason (600 enviado no campo 2, Motivo enviado no campo 4) |
| 40 | 40 | ACW | |
| 41 | 41 | Saída ACW | |
| 42 | 42 | Entrada ACW | |
| 50 | 50 | 0 | AUX puro |
| 50 | 50 | 1 a 99 | AUX c/Código do motivo 1-99 (50 enviado no campo 2, Motivo enviado no campo 4) |
| 51 | 51 | AUX Fora | |
| 52 | 52 | AUX In | |
| 60 | 60 | DACD | |
| 61 | 61 | Saída DACD | |
| 62 | 62 | Entrada DACD | |
| 70 | 70 | DACW | |
| 71 | 71 | Saída DACW | |
| 72 | 72 | Entrada DACW | |
| 80 | 80 | Toque | |
| 100 | 100 | Logon - transitório - raramente visto | |
| 110 | 110 | Logout - transitório - raramente visto | |
| 220 | 220 | Outro | |
| N/A | 700 | Agente Em espera |
Data constraints
-
NiCE NiCE CXone WFM Id do agente de logon = id do agente
-
Comprimento máx. do Logon ID = Unlimited - ARN gerado pelo sistema (máximo de 256 caracteres)
-
NiCE NiCE CXone WFM Estado do agente = estado atual do Agente
-
Comprimento máx. de estado do agente = 100 caracteres
Observações e Limitações
Observações
Amostra (verificada ou adicionada após a integração do cliente):
-
Tempo de atendimento e Tempo de conversa são calculados no final do intervalo da interação.
-
Os estados AUX/ACW dependem de transições precisas do estado do agente.
-
O mapeamento de fila DE espera pode afetar a precisão das métricas de nível de serviço.
Limitações conhecidas
-
Os mecanismos automáticos e manuais de Repetir e Recarregar não são suportados.
-
A integração em tempo real pode não suportar atualizações de estado do agente em frações de segundo.
-
A reposição de dados históricos requer intervenção manual e validação.
-
As métricas podem ser distorcidas se os logins/logouts do agente não ocorrerem dentro do mesmo intervalo.
-
Os campos gerados pelo CMS podem diferir na interpretação dependendo da estrutura do relatório.
Monitoramento e Solução de problemas
Monitorando
-
Arquivos de registro no Conector.
-
Confirmação de entrega de dados.
-
WFM painel de status de importação.
Dicas de solução de problemas
-
Verifique incompatibilidades entre agente/fila DE espera.
-
Certifique-se de que os scripts do CMS sejam gerados no formato correto (CSV/JSON).
-
Validar os registros de data e hora dos arquivos e o alinhamento de intervalo.
Perguntas frequentes
-
Posso exportar relatórios personalizados do CMS?
Sim, desde que atendam aos requisitos de campo e formato.
-
O que acontece se os ids de agentes forem alterados?
Garanta um mapeamento de ID consistente para evitar incompatibilidades de adesão.
-
Can em tempo real a adesão incluir o rastreamento do estado AUX?
Sim, os estados AUX, ACW e pronto/Não pronto são monitorados se houver suporte na versão do seu CMS e na configuração de relatório.
-
Quais são os requisitos técnicos para a integração?
Mais de 350 MB de espaço em disco para instalação e pelo menos 1 GB para execução.
-
Como é feito o tratamento da segurança de dados durante a integração?
Conforme o requisito de cada cliente, pois o cliente configura sua rede interna conforme seus requisitos de segurança.
-
É possível integrar múltiplas instâncias do Avaya CMS em um único ambiente NICE WFM?
Atualmente, apenas 1 mapeamento de ACD é suportado.
-
O que acontece se a integração falhar ou os dados estiverem atrasados?
Entre em contato com a equipe de suporte.
-
Há necessidade de inatividade durante a configuração?
Para novo cliente, o tempo de inatividade é conforme o processo de configuração inicial do CXOne WFM.
Histórico de Revisões
|
Revisão |
Data |
Descrição |
|---|---|---|
| 1.0 | 1/8/25 | Versão inicial do documento. |