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.

      Evento de desconexão mapeado para o código de atividade Logout

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.

An architecture diagram of the NiCE connector providing Historic and RTA functionality for Engagement Hub integration with Amazon Connect
  • 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:

As políticas em linha personalizadas para a função do IAM necessária para executar o conector

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

    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

  1. Abra o Gerenciador de Locatário e navegue até:

    Locatários > Aplicativos e recursos > WFM > editar configuração do Aplicativo WFM > Definir configurações

  2. Em determinados recursos, escolha WFM Advanced.

    A página de configuração do locatário com WFM Advanced selecionado em Select Features

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

    A página de configuração do locatário com a opção WFM Engagement Hub selecionada em Integração do ACD

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.