As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Configurar e analisar gravações de tela do atendente no Amazon Connect Contact Lens
Para ajudar os atendentes a oferecer um excelente atendimento ao cliente, você pode usar o recurso de gravação de tela do Contact Lens para obter informações sobre gerenciamento de qualidade. Ele registra a área de trabalho do atendente, o que ajuda a identificar oportunidades para melhorar o desempenho. Essas informações também são úteis para garantir a conformidade.
Por exemplo, vamos supor que a maioria dos atendentes leve dois minutos para processar um reembolso, mas Jane Farias leve quatro minutos. Você pode assistir a uma gravação do desktop dela quando ela estiver fazendo um reembolso e descobrir por que ela está demorando mais.
O diagrama a seguir mostra os componentes gerais da gravação de tela. Para acessar um diagrama de sequência que mostra as chamadas de rede entre diferentes componentes, consulte [Requisitos de rede](sr-system-req.md#network-requirements).
![\[Um diagrama do fluxo de gravação de tela.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/screen-recording-flow.png)
**Topics**
+ [Amazon Connect Aplicativo do cliente](amazon-connect-client-app.md)
+ [Requisitos de rede e sistema](sr-system-req.md)
+ [Habilitar gravação de tela](enable-sr.md)
+ [Analisar as gravações de tela do atendente](review-screen-recordings.md)
+ [Baixar arquivos de log na aplicação de gravação de tela](troubleshoot-sr.md)
+ [Use EventBridge eventos da Amazon para rastrear o status da gravação de tela](track-screen-recording-status.md)
+ [Perguntas frequentes sobre recursos de gravação de tela](faq-screenrecording.md)
# Amazon Connect Aplicativo do cliente
A gravação de tela do Amazon Connect é aceita no Windows e no Chrome OS. Esta página fornece as instruções de download e instalação da aplicação de gravação de tela em cada sistema operacional e os requisitos mínimos do sistema para os dispositivos do atendente.
**Topics**
+ [Windows](#windows-client)
+ [Chrome OS](#chrome-os)
## Windows
### Informações sobre a versão
+ Versão: v2.0.3 (mais recente)
+ Data do lançamento: 16 de janeiro de 2025
+ Link para download: [AmazonConnectClientWin-v2.0.3](https://d4yqf2f7seiym.cloudfront.net/builds/AmazonConnectClientWin-v2.0.3.zip)
+ Nota de lançamento: esta versão oferece suporte AWS GovCloud (US) aos clientes e tem melhorias de segurança.
O link acima baixa o arquivo **AmazonConnectClientWin- [version] .zip.** O arquivo zip contém o arquivo **Amazon.Connect.Client.Service.Setup.[version].msi**. Para obter instruções de instalação, consulte [Habilitar gravação de tela](enable-sr.md).
Para ser notificado quando houver uma atualização no aplicativo Amazon Connect cliente, recomendamos assinar o feed RSS deste guia do administrador. Escolha o link **RSS** que aparece abaixo do título desta página (ao lado do link do PDF).
### Instruções de instalação do cliente
Nesta etapa, você instala o arquivo **Amazon.Connect.Client.Service** na área de trabalho do atendente ou no ambiente virtual que ele usa. Essa é a aplicação cliente do Amazon Connect .
**nota**
No caso do sistema operacional multissessão do Windows, o instalador precisa ser executado apenas uma vez na máquina. A gravação de tela no sistema operacional multissessão do Windows é aceita somente na versão 2.0.0 ou posterior.
Se sua instância do Amazon Connect estiver em AWS GovCloud (Oeste dos EUA), você deverá instalar a versão 2.0.3 ou posterior.
Você precisa configurar uma lista de permissões de domínios do Amazon Connect que podem se comunicar com a aplicação cliente. As gravações de tela são capturadas somente dos domínios do Amazon Connect especificados na sua lista de permissões.
#### Instalação programática usando ferramentas de distribuição de software
+ Baixe a versão mais recente do arquivo **Amazon.Connect.Client.Service.Setup.msi**.
+ Use o mecanismo de distribuição de software de sua organização, como o centro de software, para instalar a aplicação cliente **Amazon.Connect.Client.Service** nas áreas de trabalho dos atendentes.
+ Implante usando o sistema de distribuição de software empresarial da sua organização, como o Microsoft System Center Configuration Manager, o SCCM, ou outras ferramentas de implantação automatizada.
+ Inclua o parâmetro `ALLOWED_CONNECT_DOMAINS` usando a seguinte sintaxe:
```
msiexec /i Amazon.Connect.Client.Service.Setup.msi ALLOWED_CONNECT_DOMAINS="connect-dev-instance.my.connect.aws,connect-prod-instance.my.connect.aws"
```
#### Instalação manual
+ Baixe a versão mais recente do arquivo **Amazon.Connect.Client.Service.Setup.msi**.
+ Clique duas vezes no arquivo de instalação.
+ Entre na lista de permissões de domínios do Amazon Connect quando solicitado. A imagem a seguir mostra um exemplo de como especificar um domínio na lista de permissões, na caixa de diálogo **Definir configurações de instalação**. Para ver mais exemplos, consulte as *Diretrizes para especificar sua lista de permissões de domínios do Amazon Connect* abaixo.
![\[A caixa de diálogo Definir configurações de instalação.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/domain-allowlist-windows.png)
+ Escolha **Instalar** para concluir a instalação.
#### Verifique se o aplicativo Amazon Connect cliente está sendo executado e funcionando corretamente
##### Para verificar se a aplicação está em execução:
+ No Gerenciador de tarefas do Windows, confira se há um processo em segundo plano chamado **Amazon.Connect.Client.Service**. Esse é o aplicativo Amazon Connect cliente.
+ No Gerenciador de tarefas do Windows, em **Processos de usuários**, verifique se há outro processo chamado **Amazon.Connect.Client. RecordingSession**depois que o usuário aceita o primeiro contato em que a gravação de tela está ativada.
A imagem a seguir mostra o **Amazon.Connect.Client. RecordingSession**no Gerenciador de tarefas.
![\[Amazon.Connect.Client. RecordingSession no Gerenciador de tarefas.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/taskmanager.png)
##### Para verificar se a aplicação está funcionando corretamente e criando arquivos de log:
1. Navegue até o seguinte diretório: `C:\ProgramData\Amazon\Amazon.Connect.Client.Service\logs`
1. Abra os arquivos de log que estão no diretório.
1. Em uma instalação bem-sucedida, os arquivos de log contêm a seguinte linha: `Checking that services are still running, result : true`
1. Navegue até o seguinte diretório: `%USERPROFILE%\AppData\Local\Amazon\Amazon.Connect.Client.RecordingSession\Logs`
1. Abra os arquivos de log que estão no diretório.
1. Em uma instalação bem-sucedida, os arquivos de log contêm a seguinte linha: `Session initiation completed with result: True`
#### Diretrizes para especificar sua lista de permissões de domínios do Amazon Connect
Siga as diretrizes abaixo ao inserir domínios na caixa **Domínios permitidos do Connect**. Caso contrário, a instalação falhará.
+ Formato: domínios do Amazon Connect separados por vírgula
+ Caracteres válidos para domínios do Amazon Connect: use apenas A-Z, a-z, 0-9, hífen (-), ponto (.).
+ Prefixos de protocolo, como https:// ou http://, não são necessários.
+ Limitações:
+ Máximo de 500 entradas de domínio
+ Máximo de 256 caracteres por entrada de domínio
+ Tamanho total máximo de entrada de 128 mil caracteres
Veja a seguir exemplos de como especificar seu domínio.
##### Correto
+ domain1.my.connect.aws,domain2.my.connect.aws
+ ddomain-1.my.connect.aws, 1-domain.my.connect.aws
+ domain-12.my.connect.aws
##### Incorreto
+ \$1123domain.foo
+ domain:2.foo
+ \$1domain.my.connect.aws
+ https://domain1.my.connect.aws
+ \$1.my.connect.aws
## Chrome OS
O recurso de gravação de tela do Amazon Connect no ChromeOS requer dois componentes:
+ Aplicação web isolada
+ Extensão do navegador Google Chrome
A instalação desses componentes em dispositivos Agent Chrome pode ser realizada por meio do Google Enterprise Admin Console. As URLs opções para configurar a instalação do Isolated Web App e da extensão do navegador Chrome são fornecidas abaixo e podem ser configuradas para atualização automática por meio da configuração de manifesto web JSON.
### Local de download e instruções de instalação
Conclua as etapas a seguir no Google Enterprise Admin Console. Aplique a política para todos os dispositivos do atendente em que o recurso de gravação de tela precisa ser habilitado.
#### Instalar a aplicação web isolada
+ ID do pacote web: `ajbye5keylrcyakugr3zttu6f524eoamjc7mc6ubw3x3547xu3hxqaacai`
+ Atualize o URL do manifesto: `https://screenrecording.connect.aws/chromeos/amazon-connect-client-iwa/releases/update_manifest.json`
**Como instalar a aplicação web isolada**
1. Navegue até o [Portal do administrador do Google](https://admin.google.com) (https://admin.google.com) e faça login com suas credenciais de administrador corporativo do Google.
1. Selecione **Adicionar uma aplicação web isolada**.
1. Copie e cole os seguintes detalhes e, depois, escolha **Salvar**:
+ ID do pacote web: `ajbye5keylrcyakugr3zttu6f524eoamjc7mc6ubw3x3547xu3hxqaacai`
+ Atualize o URL do manifesto: https://screenrecording.connect. aws/chromeos/amazon-connect-client-iwa/releases/update\$1manifest.json
A imagem a seguir mostra um exemplo de caixa de diálogo **Adicionar uma aplicação web isolada** preenchida.
![\[Uma caixa de diálogo Adicionar uma aplicação web isolada preenchida.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/addisolatedwebapp.png)
1. Configure a **política de instalação** para `Force Install + Pin to ChromeOS Taskbar` e altere **Iniciar no login** para `Force Launch and Prevent Closing` para garantir que a aplicação web isolada seja iniciada automaticamente quando o computador estiver conectado for reiniciado.
![\[Seções Política de instalação e Iniciar no login.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/installationpolicy.png)
1. Defina a **configuração gerenciada** para permitir que seus domínios do Amazon Connect iniciem a gravação de tela em máquinas de atendentes. Um exemplo de **Configuração gerenciada** é mostrado na imagem a seguir.
![\[A seção Configuração gerenciada.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/managedconfiguration.png)
+ O nome de chave deve ser `allowListedDomain`. Os nomes de domínio não devem incluir caminhos, strings de consulta nem barras finais (/).
+ Substitua `your-instance-alias-*` pelo alias de sua instância do Amazon Connect.
```
{
"allowListedDomain": [
"https://your-instance-alias-1.my.connect.aws",
"https://your-instance-alias-2.my.connect.aws"]
}
```
1. Conclua as etapas a seguir para configurar a aplicação web isolada para permitir soquetes diretos, gravação de tela e permissões de gerenciamento de janelas:
+ Navegue até **Dispositivos**, **Chrome**, **Recursos da Web** e **Adicionar origem**.
+ Insira `ajbye5keylrcyakugr3zttu6f524eoamjc7mc6ubw3x3547xu3hxqaacai` e escolha **Salvar**.
A imagem a seguir mostra onde os dispositivos, o ChromeS e os recursos da web estão localizados no menu de navegação esquerdo do Chrome.
![\[No menu de navegação esquerdo, escolha Chrome OS.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/allorigins.png)
A imagem a seguir mostra a localização dos **soquetes diretos**, da **gravação de tela** e do **gerenciamento de janelas** na página de recursos da web.
![\[A localização dos soquetes diretos, da gravação de tela e da página de recursos web de gerenciamento de janelas.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/directsockets.png)
#### Instalar a extensão do navegador Google Chrome
+ ID da extensão: cjmichfmnimgeoadokmeaiclklkdccod
+ URL personalizado: `https://screenrecording.connect.aws/chromeos/amazon-connect-extension/releases/updates.xml`
**Como instalar a extensão do navegador Google Chrome**
1. Navegue até **Adicionar extensão ou aplicação Chrome por ID**, conforme mostrado na imagem a seguir.
![\[A opção Adicionar extensão ou aplicação Chrome por ID no painel de navegação esquerdo.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/appandextensions.png)
1. Em **Adicionar extensão ou aplicação Chrome por ID**, escolha **De um URL personalizado** e insira as seguintes informações:
+ ID da extensão: `cjmichfmnimgeoadokmeaiclklkdccod`
+ URL personalizado: `https://screenrecording.connect.aws/chromeos/amazon-connect-extension/releases/updates.xml`
![\[A caixa de diálogo Adicionar extensão ou aplicação Chrome por ID, a opção De um URL personalizado.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/chromeapp.png)
1. Configure a **política de instalação** para **forçar a instalação** e escolha **Salvar**, conforme mostrado na imagem a seguir.
![\[A opção Política de instalação está definida como Forçar instalação.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/forceinstall.png)
# Requisitos de sistema e rede para gravação de tela no Amazon Connect
Este tópico fornece os requisitos do sistema para usar a gravação de tela e descreve o fluxo de dados detalhado que ela usa em cada plataforma.
## Requisitos do sistema
Veja a seguir os requisitos mínimos do sistema para dispositivos de atendentes realizarem a gravação de tela. Será necessário ter escopo para memória adicional, largura de banda e CPU para o sistema operacional e para qualquer outro programa que esteja sendo executado no dispositivo a fim de evitar a contenção de recursos.
+ CPU: 2.0 GHz (4 núcleos ou 4 vCPU recomendados)
+ Memória: 4 GB
+ Rede: 600 Kbps
### Sistemas operacionais compatíveis
+ Windows 10 e 11 64 bits com base na arquitetura x86-64
+ Chrome OS versão 140 ou posterior registrado em um domínio empresarial do Google.
**nota**
Quando a configuração de multisessão do Windows habilitada, permitindo que vários atendentes usem um único host Windows, garanta que a estação de trabalho do atendente tenha a disponibilidade de recursos recomendada para cada sessão simultânea.
## Requisitos de rede
+ **Porta usada para gravação de tela**: a aplicação cliente do Amazon Connect se comunica com o CCP por meio de um websocket local na porta 5431 (no Windows) e 25431 (no Chrome OS).
+ **URLs para adicionar à sua lista de permissões do firewall**: Para garantir uma funcionalidade suave de gravação de tela, adicione os seguintes padrões de URL à sua lista de permissões:
+ Do CCP: `connect-recording-staging-*.s3.dualstack.your-region-name.amazonaws.com`. Se você preferir não usar curingas, a lista de endpoints está disponível em https://screenrecording.connect. aws/config/connect- recording-endpoint-allowlist .json. Essa lista pode ser atualizada no futuro. Consulte a `createDate` na parte superior do arquivo para conferir se há atualizações.
+ Da aplicação cliente de gravação de tela: `https://your-connect-instance-alias.my.connect.aws/taps/client/auth`
+ **Diagrama de sequência**: o diagrama de sequência a seguir mostra as chamadas de rede entre os diferentes componentes envolvidos na gravação de tela.
![\[Um diagrama de sequência mostra as chamadas de rede entre os diferentes componentes envolvidos na gravação de tela.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/sequence-diagram.png)
+ No Windows, o Amazon Connect Client é a combinação do processo em segundo plano do Amazon.Connect.Client.Service e do Amazon.Connect.Client. RecordingSession.
+ No ChromeOS, o cliente do Amazon Connect é a combinação da aplicação web isolada e da extensão do navegador.
# Habilitar gravação de tela para a instância do Amazon Connect
Este tópico fornece etapas para habilitar a gravação de tela para a instância do Amazon Connect, baixar e instalar a aplicação cliente Amazon Connect e executar as principais etapas de configuração.
**Topics**
+ [Etapa 1: Habilitar gravação de tela para sua instância](#install-sr-step1)
+ [Etapa 2: Baixar e instalar a aplicação cliente do Amazon Connect](#install-sr-step2)
+ [Etapa 3: configurar o bloco Definir comportamento de gravação e análise](#configure-recording-block)
+ [Dicas de configuração](#tips-sr)
## Etapa 1: Habilitar gravação de tela para sua instância
**Importante**
Se a instância do Amazon Connect foi criada antes de outubro de 2018 e você não tem perfis vinculados a serviços configurados, siga as etapas em [Usar perfis vinculados a serviços](https://docs.aws.amazon.com/connect/latest/adminguide/connect-slr.html#migrate-slr) para migrar para o perfil vinculado a serviços do Amazon Connect.
As etapas desta seção explicam como atualizar as configurações da instância para habilitar a gravação de tela e como criptografar artefatos de gravação.
1. Abra o console do Amazon Connect em [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. Escolha os tipos de instância.
1. No painel de navegação, escolha **Armazenamento de dados**, role para baixo até **Gravações de tela** e escolha **Editar**, conforme mostrado na imagem a seguir.
![\[A seção Gravações de tela da página Armazenamento de dados.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/console-screenrecordings.png)
1. Escolha **Habilitar gravação de tela** e, depois, **Criar um bucket do S3 (recomendado)** ou **Selecionar um bucket do S3 existente**.
1. Se você optar por **criar um bucket do Amazon S3 (recomendado)**, insira um nome na caixa **Nome**. Para optar por usar um bucket existente, selecione-o na lista **Nome**.
1. (Opcional) Para criptografar os artefatos de gravação no bucket do Amazon S3, selecione **Ativar criptografia** e escolha uma chave do KMS.
**nota**
Quando você ativa a criptografia, o Amazon Connect usa a chave do KMS para criptografar quaisquer dados de gravação intermediários enquanto o serviço os processa.
1. Quando terminar, escolha **Save (Salvar)**.
Para obter mais informações sobre as configurações de instância, consulte [Atualizar as configurações da instância do Amazon Connect](update-instance-settings.md).
## Etapa 2: Baixar e instalar o aplicativo Amazon Connect cliente
Siga as instruções em [Amazon Connect Aplicativo do cliente](amazon-connect-client-app.md) para baixar e instalar a aplicação cliente do Amazon Connect para seu sistema operacional.
## Etapa 3: configurar o bloco Definir comportamento de gravação e análise
+ Adicione um bloco [Set recording and analytics behavior (Definir o comportamento de gravação e análise)](set-recording-behavior.md) imediatamente após o ponto de entrada no fluxo. Adicione o bloco a cada fluxo que você deseja habilitar para gravação de tela.
+ A imagem a seguir mostra a página Propriedades do bloco [Set recording and analytics behavior (Definir o comportamento de gravação e análise)](set-recording-behavior.md). Na seção **Gravação de tela**, escolha **Ativado**.
![\[O bloco Definir comportamento de gravação e a seção Gravação de tela.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/screenrecordingblock.png)
## Dicas de configuração
+ Para permitir que os supervisores pesquisem contatos que tenham gravações de tela, adicione um bloco [Set contact attributes (Definir atributos do contato)](set-contact-attributes.md) antes de **Definir o comportamento de gravação e análise**. Adicione um atributo personalizado com um nome semelhante a **screen recording = true**. Os supervisores podem [pesquisar esse atributo personalizado](search-custom-attributes.md) para encontrar aqueles que têm gravações de tela.
+ É recomendável adicionar um bloco [Distribute by percentage (Distribuir por porcentagem)](distribute-by-percentage.md) antes de **Definir o comportamento de gravação e análise**. Isso permite que você use a gravação de tela para alguns e não para todos os contatos.
+ Talvez você queira aproveitar [SuspendContactRecording](https://docs.aws.amazon.com/connect/latest/APIReference/API_SuspendContactRecording.html)e [ResumeContactRecording](https://docs.aws.amazon.com/connect/latest/APIReference/API_ResumeContactRecording.html) APIs evitar que informações confidenciais sejam capturadas na gravação da tela.
# Analisar as gravações de tela do atendente na aplicação Amazon Connect Client
Use as gravações de tela para identificar áreas de treinamento do atendente (por exemplo, atendimento de longa duração ao contato ou não conformidade com processos de negócios) assistindo às ações de um atendente enquanto ele atende a um contato de chamada, chat ou tarefa.
A gravação de tela é sincronizada com a gravação de voz e a transcrição do contato, para que você possa ouvir ou ler ao mesmo tempo o que está sendo dito.
**nota**
As gravações de tela só estão disponíveis para contatos concluídos.
**Topics**
+ [Etapa 1: atribuir permissões para analisar as gravações de tela na aplicação cliente do Amazon Connect](#assign-permissions-sr)
+ [Etapa 2: analisar as gravações de tela](#review-sr-2)
+ [Assista no Picture-in-picture modo Watch](#picture-in-picture)
## Etapa 1: atribuir permissões para analisar as gravações de tela na aplicação cliente do Amazon Connect
Para permitir que os usuários analisem gravações de tela, atribua a seguinte permissão de perfil de segurança de **Análise e otimização**:
+ **Gravação de tela - Acessar**: permite que um usuário, como um supervisor ou membro da equipe de garantia de qualidade, acesse e analise gravações de tela.
**Importante**
A gravação de tela mescla o vídeo da gravação de tela com o arquivo não editado da gravação de chamada. Se os usuários tiverem permissão para visualizar as gravações de tela, eles poderão ouvir o áudio não editado.
+ **Gravação de tela - Botão Habilitar download**: permite que um usuário, como um supervisor ou membro da equipe de garantia de qualidade, visualize um botão de download na página **Detalhes de contato** para baixar vídeos de gravação de tela.
Para obter informações sobre como adicionar mais permissões a um perfil de segurança existente, consulte [Atualizar perfis de segurança no Amazon Connect](update-security-profiles.md).
## Etapa 2: analisar as gravações de tela
1. Faça login no Amazon Connect com uma conta de usuário que tenha a permissão **Análise e otimização** – **Gravação de tela - Acessar** no respectivo perfil de segurança.
Se você também tiver a permissão de **Gravação de tela - botão Habilitar download**, poderá ver um botão na página **Detalhes de contato** que permite baixar uma gravação de tela e visualizá-la off-line.
1. No menu de navegação, escolha **Análise e otimização**, **Pesquisa de contato**.
1. Pesquise o contato que você deseja analisar.
**dica**
Se você tiver adicionado um atributo personalizado aos fluxos para indicar quando a gravação de tela está habilitada, poderá [pesquisar por atributo personalizado](search-custom-attributes.md) para localizar registros de contato com gravações de tela. Para obter mais informações, consulte [Dicas de configuração](enable-sr.md#tips-sr).
1. Clique ou toque no ID do contato para ver a página **Detalhes de contato**.
1. A seção **Gravação** contém um reprodutor de vídeo que exibe gravações de tela, conforme mostrado na imagem a seguir.
![\[Uma gravação de tela.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/screen-recording-show-recording.png)
**Importante**
A reprodução da gravação de tela na página **Detalhes do contato** não é aceita no domínio legado `https://your-instance-alias/awsapps.com`. Recomendamos usar o domínio `https://your-instance-alias.my.connect.aws/` para reproduzir gravações de tela. Para obter mais informações, consulte [Atualizar o domínio do Amazon Connect](update-your-connect-domain.md) neste guia.
1. Use os controles do lado direito para ampliar e diminuir o zoom, ajustar o vídeo à janela, baixar o vídeo, expandi-lo para tela cheia e reproduzi-lo. picture-in-picture
![\[Os controles de aumento e redução do zoom.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/screen-recording-zoom.png)
1. Se você não vir uma gravação de vídeo, verifique se o botão **Mostrar gravação de tela** está ativado.
Se não aparecer nenhum vídeo, talvez a gravação da tela ainda não esteja pronta (isto é, carregada no bucket do Amazon S3). Se o problema persistir, entre em contato com o [AWS Support Center](https://console.aws.amazon.com/support/home#/).
## Assista no Picture-in-picture modo Watch
É uma boa ideia mover o vídeo para outro lugar no monitor enquanto assiste. Por exemplo, é possível reposicionar o vídeo para poder ler a transcrição. Use o ** Picture-in-picturemodo Assistir** para fazer isso.
1. Escolha o picture-in-picture botão nos controles do lado direito, conforme mostrado na imagem a seguir.
![\[O botão de picture-in-picture no lado direito da página.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/screen-recording-picture-in-picture.png)
1. Escolha o **X** no canto superior direito para abrir a janela de volta. A imagem a seguir mostra o vídeo no Picture-in-picture modo e a localização do **X** para abrir a janela de volta.
![\[O vídeo no picture-in-picture modo e a localização do botão Voltar à aba.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/screen-recording-back-tab.png)
# Baixar os arquivos de log da aplicação Amazon Connect Client para solução de problemas
Ao abrir um ticket do AWS Support para problemas com gravações de tela, inclua os arquivos de log do aplicativo Amazon Connect cliente e do trabalhador compartilhado na área de trabalho do agente.
## Amazon Connect Arquivos de log do aplicativo cliente (Windows)
Na área de trabalho do atendente, navegue até:
+ `C:\ProgramData\Amazon\Amazon.Connect.Client.Service\logs`
**Esse arquivo contém os registros, incluindo a conexão do Websocket entre o navegador e o aplicativo cliente e outra conexão do Websocket entre o Amazon.Connect.Client e o Amazon.Connect.** ** RecordingSession**.
+ `%USERPROFILE%\AppData\Local\Amazon\Amazon.Connect.Client.RecordingSession\Logs`
Esse arquivo contém logs de atividades de gravação de tela. (Não aplicável para a versão 1.x.)
## Logs de operadores compartilhados (Windows e ChromeOS)
Abra o CCP. Ele deve estar aberto para que você possa ver o trabalhador **ClientAppInterface**compartilhado.
### Chrome
1. Abra o navegador Chrome. Para o tipo de URL `chrome://inspect/#workers`.
1. Na seção **Trabalhadores compartilhados**, localize o trabalhador compartilhado chamado **ClientAppInterface**.
1. Escolha **inspecionar** para abrir uma DevTools instância.
1. Escolha a guia **Console**, clique com o botão direito no despejo de log e selecione **Salvar como** para armazenar o despejo de log em um arquivo local.
### Firefox
1. Abra o navegador Firefox. Para o tipo de URL `about:debugging#workers`.
1. Na seção **Trabalhadores compartilhados**, escolha **Inspecionar** para**/connect/ccp-naws/static/client-app-interface.js**.
1. Clique com o botão direito na guia **Console** e selecione **Salvar todas as mensagens no arquivo** para armazenar o despejo de log em um arquivo local.
### Edge (Chromium)
1. Abra o navegador Chrome. Para o tipo de URL `edge://inspect/#workers`.
1. Na seção **Trabalhadores compartilhados**, localize o trabalhador compartilhado chamado **ClientAppInterface**.
1. Escolha **inspecionar** para abrir uma DevTools instância.
1. Escolha a guia **Console**, clique com o botão direito no despejo de log e selecione **Salvar como** para armazenar o despejo de log em um arquivo local.
# Use EventBridge eventos da Amazon para rastrear o status da gravação de tela
Com a Amazon EventBridge, você pode visualizar o status das [gravações de tela do agente](agent-screen-recording.md) quase em tempo real. O evento para cada gravação de tela do agente inclui success/failure status, códigos de falha com descrições, local da gravação, tamanho da gravação, versão do cliente instalado e horários de início e término da gravação de tela.
Você pode se integrar a outros AWS serviços para obter informações analíticas ou de monitoramento das gravações de tela do agente:
+ Consulte com o [Amazon CloudWatch Log Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html)
+ Receba alertas quase em tempo real em um painel do [Amazon Quick](https://aws.amazon.com/quicksight/)
+ Crie relatórios agregados fora do Amazon Connect
+ Conecte suas outras soluções personalizadas de pipeline de dados com a Amazon EventBridge
**Topics**
+ [Formatos de carga útil de EventBridge eventos da Amazon](#eventbridge-payload-formats)
+ [Crie uma regra para corresponder aos EventBridge eventos da Amazon](#create-eventbridge-rule)
+ [Configurar o destino da EventBridge regra criada pela Amazon](#configure-eventbridge-target)
## Formatos de carga útil de EventBridge eventos da Amazon
### Evento com status de gravação de tela - INICIADO
Esse evento é emitido quando um contato é aceito pelo agente, o que pode ocorrer antes do início da gravação, para cada contato com a gravação de tela do agente ativada.
```
{
"version": "0",
"id": "the_event_id_from_eventbridge",
"detail-type": "Screen Recording Status Changed",
"source": "aws.connect",
"account": "your_aws_account_id",
"time": "2026-01-01T00:00:00Z",
"region": "us-west-2",
"resources": [
"arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/contact/your_contact_id",
"arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id"
],
"detail": {
"version": "1.0",
"recordingStatus": "INITIATED",
"eventDeduplicationId": "unique_uuid",
"instanceArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id",
"contactArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/contact/your_contact_id",
"agentArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/agent/your_agent_id",
"clientInfo": {
"appVersion": "2.0.3.0",
}
}
}
```
### Evento com status de gravação de tela - CONCLUÍDO
Esse evento é emitido quando a gravação de tela termina na área de trabalho do agente. Isso não significa que a gravação de tela foi enviada com sucesso para o seu bucket do Amazon S3.
```
{
"version": "0",
"id": "the_event_id_from_eventbridge",
"detail-type": "Screen Recording Status Changed",
"source": "aws.connect",
"account": "your_aws_account_id",
"time": "2026-01-01T00:00:00Z",
"region": "us-west-2",
"resources": [
"arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/contact/your_contact_id",
"arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id"
],
"detail": {
"version": "1.0",
"recordingStatus": "COMPLETED",
"eventDeduplicationId": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeee",
"instanceArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id",
"contactArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/contact/your_contact_id",
"agentArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/agent/your_agent_id",
"clientInfo": {
"appVersion": "2.0.3.0",
},
"recordingInfo": {
"startTime": "2026-01-01T00:00:00.000Z",
"endTime": "2026-01-01T00:00:00.000Z",
}
}
}
```
### Evento com status de gravação de tela - PUBLICADO
Esse evento é emitido quando a gravação de tela é carregada com sucesso no seu bucket do Amazon S3. Os detalhes incluem a localização do bucket do Amazon S3, o tamanho da gravação e a duração da gravação.
```
{
"version": "0",
"id": "the_event_id_from_eventbridge",
"detail-type": "Screen Recording Status Changed",
"source": "aws.connect",
"account": "your_aws_account_id",
"time": "2026-01-01T00:00:00Z",
"region": "us-west-2",
"resources": [
"contactArn",
"instanceArn"
],
"detail": {
"version": "1.0",
"recordingStatus": "PUBLISHED",
"eventDeduplicationId": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeee",
"instanceArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id",
"contactArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/contact/your_contact_id",
"agentArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/agent/your_agent_id",
"clientInfo": {
"appVersion": "2.0.3.0",
},
"recordingInfo": {
"startTime": "2026-01-01T00:00:00.000Z",
"endTime": "2026-01-01T00:00:00.000Z",
"publishTime": "2026-01-01T00:00:00.000Z",
"location": "s3://your-bucket-name/object-prefix/object-key",
"durationInMillis": 100000,
"sizeInBytes": 1000000
}
}
}
```
### Evento com status de gravação de tela - FALHA
Esse evento é emitido se a gravação da tela falhar. Os detalhes sobre as informações de falha são fornecidos como uma estimativa do possível motivo da falha que somos capazes de detectar.
```
{
"version": "0",
"id": "the_event_id_from_eventbridge",
"detail-type": "Screen Recording Status Changed",
"source": "aws.connect",
"account": "your_aws_account_id",
"time": "2026-01-01T00:00:00Z",
"region": "us-west-2",
"resources": [
"arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/contact/cccccccc-cccc-cccc-cccc-ccccccccccccc",
"arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id"
],
"detail": {
"version": "1.0",
"recordingStatus": "FAILED",
"eventDeduplicationId": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeee",
"instanceArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id",
"contactArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/contact/cccccccc-cccc-cccc-cccc-ccccccccccccc",
"agentArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/agent/your_agent_id",
"clientInfo": {
"appVersion": "2.0.3.0",
},
"failureInfo": {
"code": "UNKNOWN",
"message": "UNKNOWN",
"source": "Unknown failure"
},
"recordingInfo": {
"startTime": "2026-01-01T00:00:00.000Z"
}
}
}
```
## Crie uma regra para corresponder aos EventBridge eventos da Amazon
Para se inscrever em EventBridge eventos da Amazon para obter o status de gravação de tela, você precisa criar uma EventBridge regra da Amazon que corresponda à fonte definida do evento e ao tipo de detalhe do evento. Isso pode ser feito por meio do AWS console ou das AWS CDK bibliotecas.
### Crie uma regra usando o AWS console
No AWS console, crie uma nova regra em Amazon EventBridge → Ônibus → Regras.
#### Use o barramento de eventos padrão
![\[A página Criar regra mostrando a seleção padrão do ônibus de eventos.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/screen-recording-eventbridge-event-rule.png)
#### Use um modelo de padrão de evento
Selecione o padrão de evento definido nas listas suspensas.
![\[O menu suspenso Origem do evento mostrando aws.connect selecionado.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/screen-recording-eventbridge-event-source.png)
![\[O padrão de evento mostrando o status de gravação de tela alterado foi selecionado.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/screen-recording-eventbridge-event-pattern.png)
Se o tipo de evento não estiver aparecendo na lista suspensa, você também pode criar o mesmo padrão usando o **padrão personalizado (editor JSON**) com:
```
{
"source": [ "aws.connect" ],
"detailType": [ "Screen Recording Status Changed" ]
}
```
### Crie uma regra usando AWS CDK
Como alternativa, se você gerencia AWS recursos com AWS CDK, aqui está um exemplo de trecho de TypeScript código para criar uma regra da Amazon EventBridge :
```
import { Rule } from 'aws-cdk-lib/aws-events';
const eventBridgeRule = new Rule(this, 'YourEventBridgeRuleLogicalName', {
ruleName: 'your-event-bridge-rule-name',
description: 'your rule description',
eventPattern: {
source: [ "aws.connect" ],
detailType: [ "Screen Recording Status Changed" ]
}
});
```
## Configurar o destino da EventBridge regra criada pela Amazon
A Amazon EventBridge oferece suporte a vários AWS serviços como alvos. Dependendo de suas necessidades, é flexível criar seu próprio pipeline de processamento de eventos com outros AWS serviços. É possível definir até cinco destinos para cada regra. Para obter mais informações, consulte as [ EventBridge metas da Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-targets.html) no *Guia EventBridge do usuário da Amazon*.
### Grupo de CloudWatch registros da Amazon como um exemplo de destino
O exemplo a seguir usa um [grupo de CloudWatch registros da Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html) como destino.
![\[A configuração do Target mostrando o grupo de CloudWatch registros selecionado.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/screen-recording-eventbridge-target-cwl.png)
No AWS CDK código, crie o recurso e adicione-o à EventBridge regra da Amazon:
```
import { LogGroup, RetentionDays } from "aws-cdk-lib/aws-logs";
import { CloudWatchLogGroup } from 'aws-cdk-lib/aws-events-targets';
const logGroup = new LogGroup(this, 'YourLogGroupLogicalName', {
logGroupName: '"/aws/events/your-log-group-name',
retention: RetentionDays.ONE_YEAR
});
eventBridgeRule.addTarget(new CloudWatchLogGroup((logGroup)));
```
#### Exemplo de consultas do Amazon CloudWatch Log Insights
Usando a linguagem de consulta do Amazon CloudWatch Insights, aqui estão alguns exemplos de consultas:
+ **Exemplo de consulta sobre a taxa de sucesso**
```
fields @timestamp, @message, detail
| stats sum(detail.recordingStatus= "PUBLISHED") as Count_Success,
sum(detail.recordingStatus= "INITIATED") as Count_Total,
Count_Success / Count_Total as Success_Ratio
```
+ **Exemplo de consulta para obter contagens de cada status de gravação**
```
fields @timestamp, @message, detail
| stats count(*) as Count group by detail.recordingStatus as recordingStatus
```
+ **Exemplo de consulta sobre contatos com falha com os códigos de falha mais comuns**
```
fields @timestamp, @message, detail
| filter detail.recordingStatus = "FAILED"
| stats count(*) as Count group by detail.failureInfo.code as FailureCode
| sort by Count desc
```
+ **Exemplo de consulta sobre agentes com mais contatos falhados**
```
fields @timestamp, @message, detail
| filter detail.recordingStatus = "FAILED"
| stats count(*) as Count group by detail.agentArn as AgentArn
| sort by Count desc
```
# Perguntas frequentes sobre os recursos de gravação de tela do Amazon Connect
Este tópico fornece perguntas frequentes sobre o uso dos recursos de gravação de tela do Amazon Connect.
**Topics**
+ [Especificações gerais](#faq-sr-general)
+ [Configuração](#faq-sr-configuration)
+ [desempenho](#faq-sr-performance)
## Especificações gerais
+ **Qual é o formato de arquivo das gravações de tela?**
Os arquivos de gravação de tela são salvos no MP4 formato.
+ **Quais Amazon Connect canais são compatíveis?**
Você pode gerar gravações de tela para contatos de voz, chat e tarefas.
+ **Você capturou a tela inteira?**
Sim, o Atendimento ao Amazon Connect Cliente registra todos os aplicativos abertos no monitor do agente, até três monitores.
+ **A gravação de tela comporta sessões simultâneas de usuários no Windows usando ambientes de infraestrutura de área de trabalho virtual (VDI)?**
Sim, a gravação de tela comporta sessões simultâneas de usuários no Windows ao usar a aplicação cliente do Amazon Connect versão 2.0.0 ou posterior.
+ **Onde os arquivos de gravação de tela estão armazenados na minha conta da AWS ?**
As gravações de tela são entregues ao bucket do Amazon S3 e criptografadas usando a chave do KMS que você especificar. Esse processo é semelhante ao de armazenamento e criptografia de gravações de chamadas.
+ **Como posso receber notificação quando houver uma versão mais recente da aplicação cliente?**
+ No caso do Windows, para receber notificação quando houver uma atualização na aplicação cliente do Amazon Connect , recomendamos assinar o feed RSS deste guia do administrador. Escolha o link **RSS** que aparece abaixo do título desta página (ao lado do link do PDF).
+ Para o ChromeOS, a aplicação web isolada e a extensão do Chrome são hospedadas e gerenciadas pelo Amazon Connect. Elas são atualizadas automaticamente à medida que novas versões são publicadas.
+ **Posso optar apenas pela gravação de tela e não pela gravação de chamadas?**
Sim, você pode habilitar a gravação de tela sem a gravação de chamadas para uma chamada de voz.
+ **Como faço para encontrar a localização da gravação de tela no Amazon S3?**
Você pode encontrar o local da gravação da tela na seção [RecordingsInfo](ctr-data-model.md#ctr-RecordingsInfo) do registro de contato. Veja o campo **Local**.
+ **Como faço para habilitar a gravação de tela para uma porcentagem dos meus contatos?**
Você pode usar o bloco [Distribute by percentage (Distribuir por porcentagem)](distribute-by-percentage.md) no fluxo para habilitar uma porcentagem de contatos para gravação de tela.
+ **A gravação de tela está em conformidade com o PCI?**
O Amazon Connect, incluindo o recurso de gravação de tela, está em conformidade com o Payment Card Industry Data Security Standard (PCI DSS). No entanto, você é responsável por determinar se sua implementação específica atende aos requisitos de conformidade.
**Importante**
Durante uma videochamada ou sessão de compartilhamento de tela, os atendentes podem ver o vídeo ou o compartilhamento de tela do cliente mesmo quando este está em espera. É responsabilidade do cliente lidar com as informações de identificação pessoal (PII) adequadamente. Se quiser alterar esse comportamento, crie um CCP personalizado e um widget de comunicação. Para obter mais informações, consulte [Integrar chamadas na aplicação, pela web, por vídeo e compartilhamento de tela de maneira nativa à sua aplicação](config-com-widget2.md).
+ **A gravação de tela funciona com áreas de trabalho de atendentes e CCP personalizados?**
A gravação de tela foi projetada para funcionar com espaços de trabalho de atendentes e CCP personalizados criados com a [biblioteca JS do Amazon Connect Streams](https://github.com/amazon-connect/amazon-connect-streams). Recomendamos testar sua solução personalizada antes de implantar a gravação de tela na produção.
+ **Posso usar a gravação de tela em qualquer lugar do mundo?**
A gravação de tela está disponível em todas AWS GovCloud (US) as regiões AWS comerciais em que o Amazon Connect está disponível. Mas o uso da gravação de tela pode estar sujeito à conformidade com as leis de privacidade e outras leis. Consulte a equipe de conformidade antes de habilitar esse recurso para os atendentes.
Para usar a gravação de tela em AWS GovCloud (Oeste dos EUA), é necessária a versão 2.0.3 ou posterior do cliente.
+ **Os atendentes são alertados quando a gravação de tela é habilitada para um contato?**
Por padrão, o Amazon Connect não fornece um recurso de notificação. No entanto, você pode usar a [biblioteca JS do Amazon Connect Streams](https://github.com/amazon-connect/amazon-connect-streams/blob/master/cheat-sheet.md) para criar um aviso ou outro indicador visual na área de trabalho de um atendente para sinalizar que a gravação de tela está em uso.
+ **O que acontece se um atendente fechar o navegador durante um contato ou imediatamente após o término do contato?**
Se o navegador for fechado no início do contato antes que qualquer dado de captura de tela possa ser carregado no Amazon Connect, a gravação final da tela poderá não ser publicada. Se o navegador for fechado imediatamente após o término de um contato, mas antes que os dados finais da captura de tela possam ser carregados, a gravação da tela será publicada na próxima vez que o atendente fizer login no CCP.
+ **A gravação de tela é interrompida quando um atendente coloca um cliente em espera?**
Não, a gravação da tela continua sendo realizada quando um atendente coloca um cliente em espera.
+ **A gravação de tela é aceita quando os atendentes estão conectados a várias instâncias do CCP?**
Não, a gravação de tela não é aceita quando os atendentes estão conectados a várias instâncias do CCP simultaneamente no mesmo navegador ou em navegadores diferentes. Você pode observar um comportamento inconsistente com as gravações de tela nesses casos.
## Configuração
+ **Posso optar apenas pela gravação de tela e não pela gravação de chamadas?**
Sim, você pode habilitar a gravação de tela sem a gravação de chamadas para uma chamada de voz. Para fazer isso, desabilite a gravação de voz no bloco [Set recording and analytics behavior (Definir o comportamento de gravação e análise)](set-recording-behavior.md) enquanto mantém a gravação de tela habilitada.
+ **Como faço para encontrar a localização da gravação de tela no Amazon S3?**
Você pode encontrar o local da gravação da tela na seção [RecordingsInfo](ctr-data-model.md#ctr-RecordingsInfo) do registro de contato. Veja o campo **Local**.
+ **Como faço para habilitar a gravação de tela para uma porcentagem dos meus contatos?**
Você pode usar o bloco [Distribute by percentage (Distribuir por porcentagem)](distribute-by-percentage.md) no fluxo para habilitar uma porcentagem de contatos para gravação de tela.
+ **Qual é o tamanho médio de um arquivo de gravação de tela por minuto no S3?**
O tamanho médio da gravação de tela é de 1,5 MB/minuto. Esse tamanho pode variar dependendo de fatores, como codificação de vídeo etc.
+ **Qual é a taxa de quadros para gravação de tela? Ela é configurável?**
A tela é gravada a 5 quadros por segundo e isso não é configurável.
+ **Qual codec é usado para gravação de tela?**
A gravação de tela usa o codec OpenH264.
+ **Existe uma maneira de escolher qual áudio (editado ou não editado) será usado para gravação de tela?**
Não, hoje apenas o áudio não editado é usado para gravação de tela.
+ **Há um limite de serviço para gravação de tela?**
Não, não há limite de serviço ou cota para o serviço de gravação de tela.
+ **Existe uma duração máxima para a gravação de tela?**
Não, a solução de gravação de tela não impõe duração máxima para uma gravação.
+ **Quantos monitores de atendentes podem ser gravados?**
A gravação de tela pode gravar até três telas/monitores.
+ **Posso configurar meu bucket S3 de armazenamento de call/screen gravação para habilitar a criptografia em nível de bucket com uma chave KMS diferente da chave KMS usada como parte da configuração de armazenamento de dados da instância?**
Não, a mesma chave deve ser usada em nível de bucket e também como parte da configuração de armazenamento de dados da instância.
## desempenho
+ **Quais são os requisitos de largura de banda para gravação de tela?**
Recomendamos 500 kbps por contato simultâneo com a gravação de tela habilitada.
+ **Por que vejo um maior uso da CPU depois de instalar a aplicação cliente de gravação de tela na minha máquina Windows?**
A gravação de tela em geral é uma aplicação de uso intenso da CPU e, portanto, espera-se um aumento na utilização da CPU. Recomendamos garantir que você forneça recursos suficientes, conforme documentado em [Requisitos do sistema](sr-system-req.md#sr-requirements), para evitar problemas de contenção de recursos.