Integração de cliente Guide - Amazon Connect
Introdução
Esta página ajuda os clientes que estão integrando Amazon Connect ACD com CXone WFM usando o Engagement Hub. Ela fornece orientações de implementação para integrações de canal de voz e chat de entrada, destinadas a administradores de TI, integradores de sistema e planejadores de WFM.
Escopo
-
Filas separadas para dados históricos de chamadas de entrada e saída.
-
Abrange dados históricos, em tempo real e intradiários.
-
Aplicável a integrações de canal de voz de entrada.
-
Relatório de Atividade do agente.
-
Suporta apenas um Contrato de Nível de serviço por fila DE espera (somente um campo precisa ser configurado para contatos atendidos em X segundos, Contatos abandonados em X segundos ao agendar os relatórios no Amazon Connect. Aqui X é o nível de serviço).
-
A configuração da fila DE espera trata contatos para um canal de mídia (voz ou chat) e em uma direção (inbound). A Competência como fila DE espera é suportada.
Exemplo: voice-inbound, chat-inbound.
Fora do escopo
-
Eventos de canal digital e de saída.
-
Entrada e saída na mesma fila DE espera. Se os dados (tanto de entrada quanto de saída) forem enviados na mesma fila DE espera, por exemplo, dados de retornar chamada de voz, todo esse registro será ignorado e não será considerado para o cálculo da previsão.
-
Recarregar dados históricos de ACD.
-
A máquina de estados DO agente que gera o relatório de atividade do agente não oferece suporte à repetição de eventos históricos de estado do agente para gerar o relatório de atividade histórica do Agente.
-
Eventos não ordenados recebidos do ACD para um agente são descartados e não serão exibidos no relatório de atividades do agente.
-
Nível de serviço de abandono.
-
Recarregamento manual de dados históricos.
-
Não há suporte para a configuração de fila DE espera para lidar com contatos de múltiplos canais de mídia (voz, chat, e-mail, tarefas) de ambas as direções (inbound e outbound) (não há suporte para Competência como um atributo). Por exemplo, voice-inbound-outbound, voice-chat-inbound.
Responsabilidades do cliente
-
O cliente é responsável por fazer download e instalar o conector, com orientação da equipe de implementação.
Você deve ter sessão iniciada no aplicativo CXone WFM para acessar a página Downloads. Se não tiver sessão iniciada, nenhum arquivo estará disponível para download.
-
Garanta a conectividade de rede do ambiente AWS do cliente com o ambiente AWS da NiCE.
-
Configure os canais do Amazon Connect e o roteamento conforme necessário.
-
É necessária uma assinatura ativa a Amazon Connect, juntamente com as licenças apropriadas para:
-
Canais
-
CXone WFM
-
-
Forneça os detalhes de conexão do bucket do S3 e do stream do Kinesis durante a instalação do conector.
-
Atribua um ponto de contato técnico para coordenar com a equipe de implementação.
-
Para usar o Agent Activity Report, os itens a seguir são necessários.
-
Habilitação do recurso de máquina de estados do Estado do agente (a ser feita pela equipe de P&D durante a implantação)
Observação: Não é recomendável alternar com frequência a máquina de Estado do agente.
-
É necessário um mapeamento separado para RTA e dados históricos na tela “ACD mapeamento de atividades” do CXone Work Force Management (atualmente, o mesmo mapeamento é usado para RTA e histórico).
-
O evento de logout precisa ser mapeado para o código DE atividade “Logout”, conforme mostrado abaixo. O estado Offline não será exibido no relatório de adesão histórica; no entanto, ele é necessário para evitar que as entradas sejam exibidas como não mapeadas.
-
Visão geral da integração
Pré-requisitos
Certifique-se de que as configurações e os acessos a seguir estejam em vigor antes da implementação:
-
Acesso de leitura ao bucket S3 para leitura dos relatórios históricos.
-
Acesso de leitura ao stream do Kinesis Amazon para dados em tempo real.
-
Os ids de agentes e os Ids de competência devem ser mapeados no CXone WFM de acordo com os requisitos específicos do cliente.
-
Acesso a um ambiente de testes para validação e configuração.(se aplicável)
Parâmetros de pilha do CloudFormation exigidos pelo cliente
|
parâmetro |
Tipo |
Descrição |
Valor padrão |
|---|---|---|---|
| VpcId | AWS::EC2::VPC::Id | Id de VPC existente | Nenhum(a) |
| SubnetId1 | AWS::EC2::Subnet::Id | ID da sub-rede na primeira zona de disponibilidade com acesso de saída (NAT Gateway) para a implantação do ECS | Nenhum(a) |
| SubnetId2 | AWS::EC2::Subnet::Id | ID da sub-rede na segunda zona de disponibilidade com acesso de saída (NAT Gateway) para a implantação do ECS | Nenhum(a) |
| AvailabilityZone1 | AWS::EC2::AvailabilityZone::Name | Primeira zona de disponibilidade para implantação do ECS | Nenhum(a) |
| AvailabilityZone2 | AWS::EC2::AvailabilityZone::Name | Segunda zona de disponibilidade para implantação do ECS | Nenhum(a) |
| InstanceType | Comando | Tipo de instância do EC2 para o cluster do ECS | t3.small |
| AmazonConnectS3BucketName | Comando | Nome do bucket S3 para os relatórios históricos desta instância específica de Amazon Connect | Nenhum(a) |
| AmazonConnectS3FolderPrefix | Comando | Prefixo de pasta para os Uploads desta instância de Amazon Connect | Nenhum(a) |
| AmazonConnectKinesisStreamArn | Comando | ARN de Stream de Kinesis para os dados em tempo real da instância do Amazon Connect | Nenhum(a) |
| AmazonConnectKinesisStreamName | Comando | Amazon Connect Nome da transmissão Kinesis | Nenhum(a) |
| EnableCloudWatchAlarms | Comando | Deve habilitar alarmes do CloudWatch para monitoramento (Sim/NÃO) | Sim, Não |
| AlarmNotificationEmail1 | Comando | E-mail para enviar assinatura para notificações de alarme (Obrigatório se EnableCloudWatchAlarms estiver definido como "YES"; caso contrário, pode ser mantido vazio) | Nenhum(a) |
| AlarmNotificationEmail2 | Comando | Email para enviar assinatura de notificações de alarme | Nenhum(a) |
| AlarmNotificationEmail3 | Comando | Email para enviar assinatura para notificações de alarme | Nenhum(a) |
| AlarmNotificationEmail4 | Comando | Email para enviar assinatura de notificações de alarme | Nenhum(a) |
| AlarmNotificationEmail5 | Comando | Email para enviar assinatura de notificações de alarme | Nenhum(a) |
Arquitetura de Alto Nível
Arquitetura
-
Conector → ACD Hub → NiCE CXone WFM.
-
O conector desenvolvido pela NiCE fornece funcionalidade Histórica e de RTA para a integração do Engagement Hub.
-
A configuração do Engagement Hub é hospedada na conta AWS de propriedade da NiCE.
-
A configuração do conector é hospedada na conta AWS do cliente.
-
O conector foi projetado para ler dados de relatório somente de fluxos do Kinesis Amazon e buckets do S3. Ele envia esses dados para o serviço ACD Hub para processamento. Ele não cria, atualiza ou modifica nenhum dado existente no locatário.
-
O cliente deve prefixar os nomes dos arquivos de relatório no bucket S3 da seguinte forma, com um intervalo de 15 minutos entre os arquivos:
-
Relatório de QR – Relatório de Fila DE espera
-
AQR – Relatório de Fila DE espera do Agente
-
ASPR – Relatório de Desempenho do Sistema do Agente
-
Componentes principais
S3 Bucket
-
Armazena relatórios históricos.
-
Uma função Lambda única é criada para configurar um gatilho que é ativado sempre que um novo arquivo é adicionado ao bucket.
Fluxo Kinesis
-
Processa registros de dados de agente em tempo real de Amazon Connect.
-
Requer permissões apropriadas para acesso e processamento de dados.
Fila DE espera SQS histórica: é criada para rastrear relatórios históricos carregados no bucket S3.
Dead Letter Queue (DLQ): captura e armazena dados de arquivos não processados para análise posterior.
Conector unificado: hospeda e executa o serviço do Conector Amazon Connect.
Funções e permissões
Funções do IAM necessárias para executar o conector
O conector cria automaticamente as seguintes funções do IAM quando o script de configuração é executado.
Função de Execução de Tarefa do ECS
Nome: acdhub-amazon-connector-task-execution-role
-
Finalidade: Permite que o ECS gerencie o ciclo de vida do recipiente (exemplos: extração de imagens, envio de logs)
-
Entidade confiável: ecs-tasks.amazonaws.com
-
Políticas Gerenciadas: AmazonECSTaskExecutionRolePolicy
Função de Instância do ECS
acdhub-amazon-connector-instance-role
-
Finalidade: Permite que instâncias do EC2 ingressem no cluster do ECS
-
Entidade confiável: ec2.amazonaws.com
-
Políticas Gerenciadas: AmazonEC2ContainerServiceforEC2Role
Função de Tarefa do ECS
acdhub-amazon-connector-task-role
-
Objetivo: Fornece permissões em nível de aplicativo para o serviço de conector
-
Entidade confiável: ecs-tasks.amazonaws.com
- Políticas Inline Personalizadas:
Função de execução do Lambda
Nome: Role849a3c81
-
Objetivo:
-
Suporta a gestão de notificação de bucket do S3 (usada por um recurso personalizado do CloudFormation)
-
-
Entidade confiável: lambda.amazonaws.com
-
Políticas Gerenciadas: AWSLambdaBasicExecutionRole
-
Política em linha personalizada: DefaultPolicye3c7c10e
Ações
-
s3:GetBucketNotification
-
s3:PutBucketNotification
Recursos
-
*
-
Para Notificação de SQS
-
sqs:GetQueueAttributes
-
sqs:GetQueueUrl
-
sqs:SendMessage
Principal
-
Serviço: http://s3.amazonaws.com
Condição
-
ArnLike: "aws:SourceArn":
"arn:aws:s3:::{amazon_connect_s3_bucket.bucket_name}"
Dependências externas
-
Instância Amazon Connect: Requer credenciais DE acesso e configuração.
-
VPC existente: deve fornecer o ID da VPC e os IDs das sub-redes.
-
Repositório ECR: Deve existir com a imagem do recipiente do conector.
-
Configurações
Configuração do locatário
-
Abra o Gerenciador de Locatário e navegue até:
Locatários > Aplicativos e recursos > WFM > editar configuração do Aplicativo WFM > Definir configurações
-
Em determinados recursos, escolha WFM Advanced.
-
Selecione a opção via WFM Engagement Hub na lista suspensa Integração DE ACD e clique em Terminar.
-
Nome: ACD nome sem espaços
-
Versão: Exemplo 17.0.0 e acima.
-
Mapeamento de dados
Estados padrão do agente
|
NOME |
Id do evento |
Motivo do evento |
Código DE atividade |
ESTADO |
|---|---|---|---|---|
| Pausa | Pausa | Pausa | Fechado | |
| Disponível | Disponível | Aberto | Aberto | |
| Fazer login | Fazer login | Aberto | Aberto | |
| Terminar sessão | Terminar sessão | Logout | Fechado | |
| desligada | desligada | Logout | Fechado | |
| Voz-INBOUND-CONNECTING | VOICE-INBOUND-CONNECTING | Aberto | Aberto | |
| VOICE-INBOUND-CONNECTED | Voz-INBOUND-CONNECTED | Aberto | Aberto | |
| VOICE-INBOUND-CONNECTED_ONHOLD | Voz-entrada-CONECTADO_ONHOLD | Aberto | Aberto | |
| Voz-entrada-ENCERRADA | VOICE-INBOUND-ENDED | Aberto | Aberto | |
| VOICE-INBOUND-MISSED | VOICE-INBOUND-PERDIDA | Aberto | Aberto | |
| Voz-entrada-Erro | Voz-INBOUND-Erro | Aberto | Aberto | |
| VOICE-INBOUND-ONHOLD | VOICE-INBOUND-ONHOLD | Aberto | Aberto | |
| Voz-Transferência-CONECTANDO | VOICE-TRANSFER-CONNECTING | Aberto | Aberto | |
| Voz-Transferência-CONECTADA | Voz-Transferência-CONECTADA | Aberto | Aberto | |
| VOICE-TRANSFER-CONNECTED_ONHOLD | VOICE-TRANSFER-CONNECTED_ONHOLD | Aberto | Aberto | |
| Transferência DE voz ENCERRADA | Transferência DE voz ENCERRADA | Aberto | Aberto | |
| CHAT-API-CONNECTING | CHAT-API-CONNECTING | Aberto | Aberto | |
| CHAT-API-CONNECTED | CHAT-API-CONNECTED | Aberto | Aberto | |
| CHAT-API-ENDED | CHAT-API-ENDED | Aberto | Aberto | |
| CHAT-API-MISSED | CHAT-API-MISSED | Aberto | Aberto | |
| CHAT-API-ERROR | CHAT-API-ERROR | Aberto | Aberto | |
| CHAT-API-ONHOLD | CHAT-API-ONHOLD | Aberto | Aberto | |
| CHAT-QUEUE_TRANSFER-CONNECTING | CHAT-QUEUE_TRANSFER-CONNECTING | Aberto | Aberto | |
| CHAT-QUEUE_TRANSFER-CONNECTED | CHAT-QUEUE_TRANSFER-CONNECTED | Aberto | Aberto | |
| CHAT-QUEUE_TRANSFER-ENDED | CHAT-QUEUE_TRANSFER-ENDED | Aberto | Aberto |
Métricas históricas
Relatório de fila DE espera
-
Contatos recebidos
-
Abandonada curta
-
Abandonada longa
-
Tratado Curto
-
Tratado longo
-
Tempo Atendidas
-
Tempo de espera
-
Work (ACW) Time
-
Tempo de Retardo da fila DE espera
-
Percentual de nível de serviço
-
Pendências
-
Pendências Expiradas
-
Pendências Não Expiradas
-
Contatos da parte certa
-
Tempo de conversa / Tempo de atendimento da parte certa
-
Contatos de Parte Errada
-
Tempo de conversa/Tempo de atendimento da parte errada
-
Ativo
Relatório de fila DE espera do agente
-
AgentValor
-
Id do agente
-
Tempo Atendido
-
Tempo de espera
-
Work (ACW) Time
-
Contatos da parte certa
-
Tempo de conversa / Tempo de atendimento de parte certa
-
Contatos da Parte Errada
-
Contatos de Parte Errada
-
Ativo
Relatório de atividade do agente
-
ACDLoginId
-
Código de evento
-
Código do motivo
-
Hora de início do agente
-
Hora de início do agente
Relatório de desempenho do sistema do agente
-
AgentValue
-
Id do agente
-
ReadyTime
-
NotReadyTime
-
Hora de login
Tipos DE mídia aceitos
-
Voz de entrada
-
Chat
Classificações de Canal de mídia
-
Resposta imediata (via voz de entrada)
-
Resposta postergável (via chat)
Protocolos
-
Para tempo real, o conector estabelece conexão com o fluxo Kinesis do Amazon.
-
Para relatórios históricos, o cliente deve configurar o bucket do S3 na conta AWS do cliente.
Tipos de dados suportados
-
Dados históricos (15 min)
-
Dados da previsão
-
Intradia
-
-
Aderência em tempo real (Transições de Estado do agente)
Especificações de recuperação de dados
O conector oferece suporte a estes mecanismos de recuperação de dados:
-
Tempo real: o Conector escuta o fluxo Amazon Connect do Kinesis para eventos de estado do agente.
-
Histórico: O Conector busca dados históricos periodicamente no bucket S3.
-
Quando o ACD ou o conector está inativo, o estado do agente é exibido como o último estado na tela do CXone WFM RTA.
-
Para intervalos de meia-noite/feriado (em que nenhum dado é gerado pelo ACD), nenhum dado é exibido na tela Intraday do CXone WFM.
Modelos de Implantação
Amazon Connect ACD integrado com o conector desenvolvido pela NiCE e o CXone WFM.
-
O conector é executado exclusivamente em tarefas do ECS em instâncias EC2.
-
A configuração ECS multi-AZ garante resiliência. As Tarefas consomem Kinesis streams e filas SQS por locatário.
-
Os intervalos de verificação de ponto e sondagem são configuráveis.
Dados do contato - Pegging
Os valores de tempo de contato são atribuídos ao intervalo em que o contato é concluído.
Todos os valores para contatos de integração do Engagement Hub são fixados no final do intervalo quando o contato é concluído.
Exemplo:
Se um contato iniciar no intervalo de 12:00–12:15 e for concluído no intervalo de 12:15–12:30, ele é atribuído ao intervalo de 12:15–12:30.
Limitações conhecidas
-
Relatório de adesão histórica não está disponível.
-
Uma fila DE espera pode oferecer suporte a somente um tipo DE mídia e uma direção (por exemplo, entrada de voz ou entrada de chat).
-
Há um retardo de 6 a 16 minutos após o fim de cada intervalo antes que o Amazon Connect ACD envie dados históricos ao Conector nice.
Como resultado, os dados de Intraday podem aparecer na UI do CXone WFM aproximadamente 25 minutos após o término do intervalo.
-
Somente um Contrato de Nível de serviço por fila DE espera é suportado.
-
Se o cliente já estiver integrado ao produto IEX, um bucket S3 separado deve ser criado para o consumo do CXone WFM Engagement Hub.
-
Manual recarregamento de dados históricos é suportado para até 30 dias antes.
-
RTA data export não está disponível para o ACD Amazon connect.
-
Quando o ACD ou o conector está inativo, não há alteração no estado do agente na tela RTA no CXone WFM; ela continua a mostrar o último estado atualizado.
Perguntas frequentes
Consulta: É possível integrar múltiplas instâncias de ACD Amazon Connect em um único ambiente do NiCE WFM?
Ans: Atualmente, somente é suportado 1 mapeamento de ACD.
Consulta: O que acontece se a integração falhar ou os dados forem atrasados?
Ans: Entre em contato com a equipe de suporte.
Consulta: É necessário algum tempo de inatividade durante a configuração?
R: Para novo cliente, o tempo de inatividade segue o processo de configuração padrão do CXone WFM.
Consulta: O que devo fazer se o estado padrão do agente mudar?
Resp.: Entre em contato com a equipe de Implementação para atualizar o mapeamento de dados de ACD no CXone WFM Tenant Manager.
Consulta: O que devo fazer se o nome da fila DE espera for alterado?
Resp.: Entre em contato com a equipe de Implementação para atualizar o mapeamento de nome da fila DE espera no CXone WFM Tenant Manager.
Consulta: O que devo fazer se um novo Agente for adicionado?
Resp.: Entre em contato com a equipe de Implementação para atualizar o nome do agente na seção Funcionários do CXone WFM.
Consulta: O que devo fazer quando o nome de ACD for alterado?
Resp: Importar manualmente os dados históricos no aplicativo CXone WFM.
Consulta: O que devo fazer quando o nome da competência WEM for alterado?
Resp.: Importe manualmente os dados históricos no aplicativo CXone WFM.
Consulta: O que acontece se os ids de agentes forem alterados?
Resp: Garanta o mapeamento consistente de ID para evitar incompatibilidades de RTA.
Consulta: O que acontece se os parâmetros da pilha do CloudFormation forem alterados?
R.: Contate a equipe de Implementação para atualizar os parâmetros.
Consulta: O que devo fazer se quisermos adicionar mais canais de mídia?
Resp: Entre em contato com a equipe de produto para discutir as opções compatíveis.
Suporte e Recursos
-
Contato de Serviços Profissionais NICE.
-
CXone WFM Central de Ajuda.