Preparar o Ambiente Amazon Connect para Real-Time Third Party Telephony Recording (Multi-ACD)

Este tópico descreve as etapas de preparação do ambiente AWS necessárias antes que Real-Time Third Party Telephony Recording (Multi-ACD) possa gravar chamadas da sua instância do Amazon Connect. Você executa todas as etapas em sua conta do AWS. Depois de concluir essas etapas, seu Representante de Conta do NiCE CXone usa os valores coletados por você para terminar a configuração no lado do NiCE CXone.

Este procedimento é fornecido apenas como um exemplo de como configurar AWS para integração com NiCE CXone. É responsabilidade do cliente configurar e implantar os elementos do AWS corretamente para que eles sejam integrados corretamente com NiCE CXone.

Antes de iniciar

  • Certifique-se de que você tenha acesso administrativo à sua conta AWS e à instância Amazon Connect.

  • Seu Engenheiro de Serviços Profissionais de NiCE fornecerá os valores específicos de NiCE referenciados neste procedimento.

  • Para obter informações sobre licenciamento e permissões, consulte Recording de Terceiro de Telefonia Em tempo real.

Workflow

Execute as seguintes etapas na ordem correta para preparar seu AWS ambiente para a gravação.

Etapa 1: localizar o ARN da Amazon Connect Instância

Etapa 2: Habilitar Streaming de Mídia Ativo

Etapa 3: Configurar Fluxos de Amazon Connect

Etapa 4: criar a Função iam de acesso ao KVS

Etapa 5: Configurar o EventBridge

Etapa 6: Configurar Eventos de Agente

Etapa 1: localizar o ARN da Amazon Connect Instância

Você precisa do ARN de sua instância Amazon Connect para diversas etapas deste procedimento. Localize-o e salve-o com segurança para referência.

Para localizar o ARN da sua instância:

  1. Abra o(a) AWS Console e vá para Amazon Connect.

  2. Selecione sua instância.

  3. Copie o Instance ARN da página de visão geral da instância e salve em um local seguro.

Etapa 2: Habilitar Streaming de Mídia Ativo

Amazon Connect deve transmitir o áudio da chamada para Kinesis Video Streams (KVS) antes que NiCE possa recuperá-lo. Amazon Connect cria automaticamente um stream do KVS para cada chamada depois que o streaming de mídia em tempo real é habilitado. O ARN do stream é incluído na carga útil do evento de contato, e NiCE CXone o utiliza para recuperar o áudio.

Para habilitar o streaming de mídia em tempo real:

  1. Abra o AWS Console e vá para Amazon Connect.

  2. Selecione sua instância.

  3. Vá para armazenamento de dados.

  4. Em Streaming de mídia ativo, ative o streaming de mídia ativo e configure um prefixo de stream e período DE retenção.

  5. Nas configurações de criptografia, selecione uma das seguintes opções:

    • Use a chave gerenciada pela AWS padrão: aws/kinesisvideo.

    • Use uma chave gerenciada pelo cliente (CMK).

  6. Salve a configuração.

Se as diretrizes de conformidade da sua organização exigirem uma Customer Managed Key (CMK) para criptografia KVS, você deve atualizar explicitamente a política de Chave do KMS para conceder as permissões KMS:Decrypt e KMS:DescribeKey à Função iam da solução externa de gravação. Se você não conceder essas permissões, o gravador falhará ao processar fragmentos anteriores, mesmo que tenha permissões de stream IAM válidas.

Etapa 3: Configurar Fluxos de Amazon Connect

Você deve executar essas etapas para cada Amazon Connect fluxo em que a gravação é necessária. Os blocos Iniciar Streaming de Mídia e Contact Tags devem ser incluídos em todos os fluxos relevantes, especificamente:

  • Fluxos de Transferência de agente

  • Fluxos de Transferência de fila DE espera

  • Fluxos de entrada

Para configurar fluxos:

  1. Abra o editor de fluxo em AWS Console.

  2. Selecione o fluxo que você deseja configurar para gravação.

  3. Adicione o Bloco Iniciar Transmissão de Mídia.

  4. Em Iniciar streaming, selecione as seguintes caixas de seleção:

    • Do cliente

    • Para o cliente

  5. Em seguida, adicione o Contact Etiquetas Block.

    O bloco Contact tags deve ser adicionado após o bloco Iniciar transmissão de mídia.

  6. Em Selecionar ação de tag, selecione Tag.

  7. Em Tag key, insira kvsStreamArn (diferencia maiúsculas de minúsculas).

  8. Defina o valor dinamicamente, usando Media streams como o namespace e Customer audio stream ARN como a chave.

  9. Por último, adicione Dados comerciais Personalizados (se necessário).

  10. Crie um novo bloco de Contact tags.

  11. Defina a chave da tag como o campo de dados comerciais.

  12. Defina o valor manualmente ou dinamicamente.

  13. Clique em Confirm.

Etapa 4: criar a Função iam de acesso ao KVS

NiCE CXone lê o áudio da chamada dos seus Kinesis Video Streams usando acesso entre contas. Você deve criar uma Função iam que NiCE CXone possa assumir.

Antes de criar a função, obtenha os seguintes valores com o seu Engenheiro de Serviços Profissionais NiCE:

Valor

Descrição

Usado para:

NiCE-contaID da conta NiCE AWSEste é o principal que assume a função.
cxone-tenant-idSeu id DO locatário NiCE CXoneIsto é usado como o id externo do STS.

Para criar a Função iam de acesso ao KVS:

  1. Crie uma Função iam com a seguinte política de confiança. Substitua os valores de espaço reservado pelos fornecidos pelo seu Engenheiro de Serviços Profissional NiCE.

    var(--codeSnippetCopyLabel)
    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Principal": {
            "AWS": "arn:aws:iam::<NiCE-account>:root"
          },
          "Action": "sts:AssumeRole",
          "Condition": {
            "StringEquals": {
              "sts:ExternalId": "<cxone-tenant-id>"
            }
          }
        }
      ]
    }
  2. Anexe a política de permissão a seguir à função para conceder a NiCE CXone acesso de leitura aos seus Streams de Vídeo Kinesis.

    var(--codeSnippetCopyLabel)
    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": [
            "kinesisvideo:GetDataEndpoint",
            "kinesisvideo:GetMedia",
            "kinesisvideo:GetMediaForFragmentList",
            "kinesisvideo:ListFragments",
            "kinesisvideo:DescribeStream"
          ],
          "Resource": "arn:aws:kinesisvideo:<region>:<customer-account-id>:stream/kvs-connect-*"
        }
      ]
    }
  3. Salve a função arn. Você precisará dela para inserir na configuração do NiCE CXone como KVS Access Role ARN.

Etapa 5: Configurar o EventBridge

Amazon Connect encaminha eventos de contato e agente da sua conta AWS para NiCE CXone usando o Amazon EventBridge. É necessário criar uma Função iam de encaminhamento e uma regra do EventBridge em seu barramento de eventos padrão.

Antes de continuar, obtenha os seguintes valores com o Engenheiro de Serviços Profissionais NiCE:

Valor

Descrição

NiCE-contaID da conta NiCE conta AWS
target-event-bus-nameO barramento de eventos NiCE que recebe seus eventos encaminhados
NiCE-regiãoA região NiCE AWS

Para criar a Função iam de encaminhamento:

  1. Crie uma Função iam que permita ao EventBridge enviar eventos entre contas para o barramento de eventos NiCE.

  2. Use a seguinte política de confiança. Substitua os valores de placeholder pelos fornecidos pelo seu Engenheiro de Serviços Profissional NiCE.

    var(--codeSnippetCopyLabel)
    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Principal": { "Service": "events.amazonaws.com" },
          "Action": "sts:AssumeRole"
        }
      ]
    }
  3. Anexar a seguinte política de permissão à função para enviar eventos entre contas para o barramento de eventos NiCE.

    var(--codeSnippetCopyLabel)
    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": "events:PutEvents",
          "Resource": "arn:aws:events:<NiCE-region>:<NiCE-account>:event-bus/<target-event-bus-name>"
        }
      ]
    }
  4. Salve a função arn.

Para criar a regra do EventBridge:

  1. No seu barramento de eventos padrão do EventBridge, crie uma regra com o seguinte padrão de evento. Esse padrão corresponde tanto a eventos de contato Amazon Connect quanto a eventos de agente.

    var(--codeSnippetCopyLabel)
    {
      "source": ["aws.connect", "cxone.amc.agentdata.kinesis"],
      "detail-type": [
        "Amazon Connect Contact Event",
        "Amazon Connect Agent Event via Kinesis"
      ],
      "resources": [
        "arn:aws:connect:<region>:<customer-account-id>:instance/<instance-id>"
      ]
    }
  2. Defina a meta da regra como o barramento de eventos NiCE CXone:

    configuração

    valor

    Tipo de destinobarramento de eventos do EventBridge
    Barramento de evento metaarn:aws:events:<região>:<NiCE-openrec-account>:event-bus/<target-event-bus-name>
    Função de execuçãoA Função iam de encaminhamento que você criou acima

Etapa 6: Configurar Eventos de Agente

Os eventos de agente exigem dois componentes adicionais: um fluxo de dados do Kinesis conectado à sua instância do Amazon Connect e um EventBridge Pipe que republica esses eventos em seu barramento de eventos padrão para que a regra criada acima possa capturá-los.

Para criar o Fluxo de dados Kinesis:

  1. Abra o AWS Console e vá para Kinesis.

  2. Crie um novo fluxo de dados.

  3. Configure a contagem de shards com base no volume esperado de eventos de agente.

    Para implantações pequenas, geralmente um fragmento é suficiente. Um único fragmento oferece suporte a até 1 MB/s de entrada ou 1.000 registros/s.
    Para implantações maiores, aumente o número de fragmentos conforme necessário.

  4. Defina a retenção para 24 horas, no mínimo.

  5. No console AWS, vá para Data Streaming>Agent Events.

  6. Associe o stream de Kinesis à sua instância de Amazon Connect.

  7. Salve a configuração.

Para criar o EventBridge Pipe:

Criar um Pipe do EventBridge para ler do stream Kinesis e republicar no barramento de eventos padrão.

  1. Configure as configurações de acordo com a tabela abaixo.

    Configurações

    valor

    FonteO fluxo de dados Kinesis que você criou acima (posição inicial: LATEST, tamanho do lote: um)
    MetaBarramento de evento padrão do EventBridge
    Campo meta > Fontecxone.amc.agentdata.kinesis
    Meta > tipo de detalheAmazon Connect Evento de agente via Kinesis
    Meta > RecursosSua ARN de instância Amazon Connect
  2. Use o seguinte modelo de entrada para o Transformador de Entrada Meta:

    var(--codeSnippetCopyLabel)
    {"data": <$.data>, "sequenceNumber": "<$.sequenceNumber>"}

Arquitetura de replicação multirregional

Na arquitetura multirregião, cada região é configurada para enviar os eventos do EventBridge do cliente para o event bridge NiCE CXone.

Se a sua implantação do Amazon Connect estiver configurada em um modelo de replicação multirregional, você deve criar e configurar os mesmos recursos em cada conta/região AWS participante (função KVS/IAM, Fluxo de dados Kinesis + EventBridge Pipe para eventos de agente, regra do EventBridge e função de encaminhamento). Configure cada região para encaminhar eventos e permitir o acesso à mídia de forma independente.

Parâmetros

CustomerAccountIdYour AWS account ID that hosts Amazon Connect.
ConnectInstanceIdYour Amazon Connect instance ID (from the instance ARN).
KvsAccessRoleArnThe ARN of the KVS access IAM role you created above.

Parâmetros fornecidos pelos Serviços NiCE CXone

parâmetro

Descrição

NiceAccountIdconta NiCE CXone ID da conta AWS, a entidade principal para a política de confiança de função do KVS.
CXoneTenantIdSeu id DO locatário NiCE CXone, usado como o id externo do STS na função KVS.
NiceOpenRecAccountA conta NiCE CXone Open Recording AWS que é proprietária do barramento do EventBridge meta.
TargetEventBusNameO nome do barramento de eventos NiCE CXone que recebe seus eventos encaminhados.
CXoneTargetRegionSua região de destino NiCE CXone.

Lista de verificação de configuração

Use esta lista de verificação para confirmar que você concluiu todas as etapas antes de passar a tarefa para o seu NiCE Engenheiro de Serviços Profissionais:

  • O streaming de mídia Ativo está habilitado na instância Amazon Connect.

  • Cada fluxo gravado inclui os blocos Iniciar streaming de mídia e Contact tags.

  • A Função iam de acesso ao KVS é criada, com a política de confiança e a política de permissão anexadas.

  • O fluxo de dados Kinesis é criado e associado à instância Amazon Connect como armazenamento de eventos do agente.

  • O EventBridge Pipe é criado com a fonte, o tipo de detalhe, os recursos e o modelo de entrada corretos.

  • A Função iam de encaminhamento do EventBridge é criada.

  • A regra do EventBridge é criada no barramento de eventos padrão usando o padrão de evento acima, com a meta definida para o barramento entre contas NiCE CXone, usando a função de encaminhamento.