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á. # Usar o Amazon Connect em um ambiente de VDI Os ambientes de VDI (Virtual Desktop Infrastructure, Infraestrutura de desktop virtual) adicionam outra camada de complexidade à sua solução que garante iniciativas separadas de POC e testes de desempenho a serem otimizados. O Painel de Controle de Contato (CCP) pode operar em ambientes VDI densos, finos e sem clientes, como qualquer outro aplicativo de navegador baseado em WebRTC, e configuration/support/optimization é melhor gerenciado pela sua equipe de suporte de VDI. Dito isso, veja a seguir uma coleção de considerações e práticas recomendadas que foram úteis para nossos clientes baseados em VDI. ## Usar um modelo de CCP dividido Recomendamos usar um modelo de CCP dividido com um CCP sem mídia em execução na VDI e um CCP transportando a mídia no PC local. Você pode criar um CCP personalizado com a API do Amazon Connect Streams criando um CCP sem mídia para dados da aplicação e sinalização de chamada. Dessa forma, a mídia é entregue à área de trabalho local usando o CCP padrão, com controles de dados e chamadas entregues à conexão remota com o CCP sem mídia. Para obter mais informações sobre a API de streams, consulte o GitHub repositório em. [https://github.com/aws/amazon-connect-streams](https://github.com/aws/amazon-connect-streams) **nota** **Usuários do Firefox**: se você estiver usando a VDI no modo dividido, não poderá usar o navegador Firefox para um CCP fora da VDI. O CCP está em conformidade com as diretrizes de uso do microfone do Firefox e só tem acesso para se conectar ao microfone do usuário quando a guia do CCP está em foco. O diagrama a seguir mostra como a estação de trabalho do atendente é composta por um navegador local e uma área de trabalho virtual. Ela se conecta ao Amazon Connect por meio do WebRTC e à infraestrutura virtual corporativa por meio de uma conexão VDI. ![\[A estação de trabalho do atendente, a área de trabalho virtual, a infraestrutura virtual corporativa e o Amazon Connect.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/use-split-ccp.png) ## Áreas de trabalho na nuvem Se você usa desktops em nuvem Citrix WorkSpaces, Amazon ou Omnissa, você pode criar uma nova interface de usuário do agente ou atualizá-la existente, como uma CCP personalizada, para transferir o processamento de áudio para o dispositivo local do seu agente e redirecionar automaticamente o áudio para o Amazon Connect. Isso resulta em uma experiência de atendente mais simplificada e aumenta a qualidade do áudio em redes desafiadoras. Para começar, você pode usar as [bibliotecas de código aberto do Amazon Connect](https://github.com/amazon-connect/amazon-connect-streams) para criar ou atualizar uma interface do usuário do atendente, como CCP personalizado. ## Considerações ao desenvolver um ambiente de VDI + **Localização dos atendentes**: o ideal é que haja o menor número possível de saltos com o menor tempo de ida e volta entre o local onde os atendentes usam o CCP e o local do host de VDI. + **Localização do host da solução de VDI**: o ideal é que a localização de host de VDI esteja no mesmo segmento de rede que os atendentes, com o menor número possível de saltos tanto de recursos internos quanto de um roteador de borda. Você também deseja o menor tempo de ida e volta possível para os endpoints do intervalo do WebRTC e do Amazon EC2. + **Rede**: cada salto pelo qual o tráfego passa entre os endpoints aumenta a possibilidade de falha e adiciona a oportunidade de introduzir a latência. Os ambientes de VDI são particularmente suscetíveis a problemas de qualidade de chamada se a rota subjacente não estiver otimizada ou o pipe não for rápido ou grande o suficiente. Embora Direct Connect possa melhorar a qualidade das chamadas do roteador de borda para AWS, ele não resolverá problemas de roteamento interno. Pode ser necessário atualizar ou otimizar sua LAN/WAN privada ou redirecionar para um dispositivo externo para contornar problemas de áudio de chamada. Na maioria dos cenários, se isso for necessário, o CCP não é o único aplicativo que está tendo problemas. + **Recursos dedicados**: no nível de rede e de desktop são recomendados para evitar um impacto nos recursos disponíveis do atendente a partir de atividades, como backups e grandes transferências de arquivos. Uma maneira de impedir a contenção de recursos é restringir o acesso ao desktop a usuários do Amazon Connect que usarão seu ambiente de maneira semelhante, em vez de compartilhar recursos com outras unidades de negócios que possam usar esses recursos de maneira diferente. + **Usar um softphone com conexões remotas**: em ambientes de VDI pode causar impacto na qualidade do áudio. **dica** Se os agentes se conectarem a um endpoint remoto e operarem nesse ambiente, recomendamos redirecionar o áudio para um endpointl E.164 externo ou conectar a mídia por meio do dispositivo local e, em seguida, sinalizar por meio da conexão remota. # Otimizar o áudio do Amazon Connect para áreas de trabalho na nuvem Citrix O Amazon Connect facilita proporcionar experiências de voz de alta qualidade quando os atendentes estão usando ambientes de infraestrutura de área de trabalho virtual (VDI) Citrix. Os atendentes podem aproveitar as aplicações de área de trabalho remota Citrix, como o Citrix Workspaces, para transferir o processamento de áudio para o dispositivo local do atendente e redirecionar automaticamente o áudio para o Amazon Connect, resultando em uma experiência mais simples do atendente e em uma melhor qualidade de áudio em redes desafiadoras. Para começar, você pode usar as [bibliotecas de código-fonte aberto do Amazon Connect](https://github.com/amazon-connect/amazon-connect-streams) para criar uma nova interface do usuário do agente ou atualizar uma existente, como um Painel de controle do contato (CCP) personalizado. ## Requisitos do sistema Esta seção descreve os requisitos do sistema para usar o SDK do Citrix Unified Communications com o Amazon Connect. + **Versão da aplicação Citrix Workspace** É recomendável usar a versão mais recente da aplicação Citrix Workspace, conforme descrito [nesta documentação](https://community.citrix.com/tech-zone/learn/tech-briefs/ucssdk/). No entanto, no mínimo, você deve usar o CWA 2305 ou posterior. + **Versão do Citrix Server** Recomenda-se que a versão do Citrix VDA (Virtual Delivery Agent) seja 2203 LTSR ou posterior. + **Configuração do Citrix Server** O Citrix UC SDK não é compatível com uso por padrão, e o administrador do sistema precisa adicionar uma entrada de registro da lista de permissões da seguinte forma: + **Caminho da chave:** `Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\WebSocketService` + **Nome da chave:** `ProcessWhitelist` + **Tipo de chave:** `REG_MULTI_SZ` + **Valor da chave:** + `Chrome.exe` + `msedge.exe` Depois de configurar o registro acima com êxito, reinicie o `CitrixHdxWebSocketService` usando o **Gerenciador de tarefas** para concluir a configuração. ![\[Usando o gerenciador de tarefas no Windows para reiniciar CitrixHdxWebSocketService.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/using-ccp-vdi-citrix-server-setup.png) + **Configurações de rede/firewall** + **Configuração do servidor Citrix** O administrador precisa permitir que o servidor Citrix acesse o tráfego TCP/443 do Amazon Connect para os domínios mencionados no diagrama a seguir. Para obter mais informações, consulte [Configurar sua rede](ccp-networking.md). + **Configuração da máquina do atendente** Esta solução requer uma conexão de mídia entre o thin client do atendente e o Amazon Connect. Para permitir o tráfego entre a máquina do atendente e a porta UDP 3478 do Softphone Media do Amazon Connect, consulte [Configurar sua rede](ccp-networking.md). ![\[Configurações de firewall do servidor e da máquina do atendente Citrix.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/using-ccp-vdi-citrix-server-firewall.png) + **Implantação de CCP não compatível** + CCP nativo ## Confirmar os fluxos de mídia entre o thin client e o Amazon Connect durante a chamada + **Usar o Gerenciador de Tarefas (Windows) para verificar** Inicie o **Gerenciador de Tarefas** no thin client do atendente e verifique se o serviço HDX está em execução ou não. Se ele estiver em execução, isso indicará que a mídia está sendo redirecionada conforme esperado. ![\[Uso do gerenciador de tarefas no Windows.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/using-ccp-vdi-citrix-confirm-media-flow-windows.png) # Otimize o áudio do Amazon Connect para desktops WorkSpaces na nuvem da Amazon O Amazon Connect simplifica a entrega de experiências de voz de alta qualidade para agentes que operam em ambientes Amazon WorkSpaces Virtual Desktop Infrastructure (VDI). Ao utilizar a Amazon WorkSpaces com o recurso de redirecionamento WebRTC, os agentes podem redirecionar o processamento de áudio do Amazon Connect para seus dispositivos locais. Essa abordagem resulta em melhor qualidade de áudio, mesmo em condições de rede desafiadoras. Para aproveitar esse recurso, faça o seguinte: + Use as [bibliotecas de código aberto do Amazon Connect](https://github.com/amazon-connect/amazon-connect-streams) para criar ou atualizar uma interface do usuário do atendente, como um Painel de controle do contato (CCP) personalizado. + Configure WorkSpaces a Amazon para habilitar o redirecionamento do WebRTC. ## Requisitos do sistema Esta seção descreve os requisitos do sistema para usar o Amazon Connect com redirecionamento WorkSpaces WebRTC. + **WorkSpaces Protocolo** WorkSpaces precisa usar o Amazon DCV. Para acessar mais informações, consulte [O que é o Amazon DCV?](https://docs.aws.amazon.com/dcv/latest/adminguide/what-is-dcv.html). + **Versão do cliente** Os usuários devem usar o WorkSpaces Web Access ou WorkSpaces o cliente Windows versão 5.21.0 ou superior. Conclua as instruções de [configuração e instalação](https://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html#windows_setup). + **Política de grupo** O redirecionamento do WebRTC precisa ser habilitado na política de grupo do DCV. No tópico [Gerenciar configurações de política de grupo para DCV](https://docs.aws.amazon.com/workspaces/latest/adminguide/group_policy.html#gp_configurations_dcv), abra a seção recolhida intitulada **Habilitar ou desabilitar o redirecionamento WebRTC para DCV** e siga as instruções. + **Configurações de rede/firewall** + **Configuração de VDI do Workspace** O administrador precisa permitir que o Workspaces acesse o tráfego TCP/443 do Amazon Connect para os domínios mencionados no diagrama a seguir. Para obter mais informações, consulte [Configurar sua rede](ccp-networking.md). + **Configuração da máquina do atendente** Esta solução requer uma conexão de mídia do thin client do atendente ao Amazon Connect. Para permitir o tráfego entre a máquina do atendente e a porta UDP 3478 do Softphone Media do Amazon Connect, consulte [Configurar sua rede](ccp-networking.md). ![\[Configurações de VDI do espaço de trabalho e firewall da máquina do atendente.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/vdi-workspaces.png) + **Implantação de CCP não compatível** + CCP nativo ## Confirmar os fluxos de mídia entre a máquina do atendente e o Amazon Connect durante a chamada + Verifique se a extensão do navegador WebRTC do DCV está habilitada e no estado Pronto. # Otimizar o áudio do Amazon Connect para áreas de trabalho na nuvem Omnissa O Amazon Connect facilita proporcionar experiências de voz de alta qualidade quando os atendentes estão usando ambientes de infraestrutura de área de trabalho virtual (VDI) Omnissa. Os atendentes podem utilizar as aplicações de área de trabalho remota Omnissa, como o Omnissa Horizon Client, para transferir o processamento de áudio para o dispositivo local do atendente e redirecionar automaticamente o áudio para o Amazon Connect, resultando em uma melhor qualidade de áudio em redes desafiadoras. Para começar, você pode usar as [bibliotecas de código-fonte aberto do Amazon Connect](https://github.com/amazon-connect/amazon-connect-streams) para criar uma nova interface do usuário do agente ou atualizar uma existente, como um Painel de controle do contato (CCP) personalizado. ## Requisitos do sistema Esta seção descreve os requisitos do sistema para usar o SDK do Omnissa Horizon com o Amazon Connect. + **Versão do Omnissa Horizon Client** + Versão mínima necessária: 8.15.0 (Horizon 2503) para atendentes e clientes + No momento, a Omnissa comporta apenas a estações de trabalho de atendentes que executam o Windows para esse recurso. + Baixe a versão mais recente do Omnissa Client **Importante** A versão 2503 será a primeira a comportar a funcionalidade de reinicialização do ICE. As versões anteriores não comportam esse recurso. A versão 2503 do Omnissa Horizon Client estará disponível por meio do [Omnissa Customer Connect](https://customerconnect.omnissa.com/downloads/info/slug/desktop_end_user_computing/omnissa_horizon_clients/8). Consulte o Customer Connect para receber a versão mais recente. + **Extensão Omnissa e requisitos do SDK** + O Horizon WebRTC Web App comporta a extensão e o SDK 8.15.0 ou posterior. + Essa extensão de navegador habilita o suporte a aplicações web para o WebRTC SDK no Horizon Agent e pode ser baixada pela Chrome Store [aqui](https://chromewebstore.google.com/detail/horizon-webrtc-web-app-su/emildoafpcgihdmhphelfhghioccllfi?pli=1). + **Suporte a navegadores (três versões mais recentes)** + Google Chrome + Microsoft Edge (Chromium) + **Configuração do Omnissa Server**: o SDK do Omnissa Horizon não está habilitado por padrão. O administrador do sistema precisa definir as seguintes configurações do Registro dentro da Máquina Virtual do Omnissa Horizon Agent (preferencialmente por meio do Editor do Registro (regedit)): + **Abra o Editor do Registro** + Para Windows: + Pressione **Windows\$1 R** + Digite **regedit** e pressione **Enter**. + Criar/navegar até o seguinte caminho de registro: ``` Key Path: Computer\HKLM\SOFTWARE\Policies\Omnissa\Horizon\WebRTCRedirSDKWebApp Key Names and Values: chrome_enabled (REG_DWORD) = 1 edge_chrome_enabled (REG_DWORD) = 1 enabled (REG_DWORD) = 1 ``` ``` Key Path: Computer\HKLM\SOFTWARE\Policies\Omnissa\Horizon\WebRTCRedirSDKWebApp\UrlAllowList Key Name: https://*.connect.aws/* Key Name: https://*.connect.aws.a2z.com/* Key Type: REG_SZ ``` Após a instalação do agente Omnissa, os processos html5server.exe e wsnm.exe sempre estarão em execução no Gerenciador de tarefas, independentemente do status de ativação do SDK. A imagem a seguir mostra o processo html5server.exe em execução no Gerenciador de tarefas. ![\[Gerenciador de tarefas e o processo html5server.exe em execução.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/omnissa-1.png) A imagem a seguir mostra o processo wsnm.exe em execução no Gerenciador de tarefas. ![\[Gerenciador de tarefas e o processo wsnm.exe em execução.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/omnissa-2.png) + **Solução de problemas** + O arquivo de log do Omnissa pode ser encontrado em: ` %tmp%\omnissa-{username}\horizon-html5Client-{pid}.log` **nota** O `{pid}` refere-se ao ID do processo do cliente Horizon "horizon-protocol.exe", que pode ser encontrado no Gerenciador de tarefas. + Configurações de Registro para registro em log aprimorado Para habilitar o registro em log detalhado para solução de problemas, adicione as seguintes entradas do Registro: ``` HKEY_LOCAL_MACHINE\SOFTWARE\Omnissa\Horizon\Html5mmr: - "html5mmr.log.noThrottle" = dword:00000001 ``` ``` HKEY_LOCAL_MACHINE\SOFTWARE\Omnissa\Horizon\Html5mmr\WebrtcRedir: - "html5mmr.log.webrtc.allowFullText" = dword:00000001 - "html5mmr.log.webrtc.allowThrottle" = dword:00000000 - "html5mmr.log.webrtc.sharedlib.internal" = dword:00000001 - "html5mmr.log.webrtc.sharedlib.network" = dword:00000001 - "html5mmr.log.webrtc.sharedlib.media" = dword:00000001 - "html5mmr.log.webrtc.shim.logToConsole" = dword:00000001 - "html5mmr.log.webrtc.sharedlib.signal" = dword:00000001 - "html5mmr.log.noThrottle" = dword:00000001 - "html5mmr.log.webrtc.tracelevel" = dword:00000001 ``` Essas configurações de Registro permitem um registro em log detalhado que pode ajudar no diagnóstico de problemas com a integração do Omnissa VDI. + **Configurações de rede/firewall** + **Configuração do Omnissa VDI** O administrador precisa permitir que o servidor Omnissa acesse o tráfego TCP/443 do Amazon Connect para os domínios mencionados no diagrama a seguir. Consulte o tópico [Configurar sua rede](ccp-networking.md) para ter detalhes sobre essa configuração. + **Configuração da estação de trabalho do atendente** Esta solução requer uma conexão de mídia entre o thin client do atendente e o Amazon Connect. Siga o tópico [Configurar sua rede](ccp-networking.md) para permitir o tráfego entre a máquina do atendente e a porta UDP 3478 do Softphone Media do Amazon Connect. O diagrama a seguir ilustra o uso da porta UDP 3478. ![\[Um diagrama ilustrando o uso da porta UDP 3478.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/omnissa-3.png) ## Alterações de código necessárias em seu CCP personalizado Para habilitar a otimização de áudio no ambiente Omnissa VDI, você deve configurar seu CCP personalizado com as alterações a seguir. 1. Adicione o trecho de código a seguir antes da inicialização do CCP. Isso ajuda a gerenciar a identificação de janelas para o CCP, especialmente importante quando os atendentes têm várias janelas abertas. Ele adiciona um carimbo de data/hora e o marcador “Guia Telefone virtual ativo” para ajudar a identificar a janela ativa do CCP. ``` const ACTIVE_SOFTPHONE_TAB = "Active Softphone Tab"; window.addEventListener('message', (event) => { if (event.data.type === 'get_horizon_window_title') { let title = document.title; const currentTime = new Date(); if (!title.endsWith(ACTIVE_SOFTPHONE_TAB)) { title += ` ${currentTime.getHours()}${currentTime.getMinutes()}${currentTime.getSeconds()} ` + ACTIVE_SOFTPHONE_TAB; document.title += ` ${currentTime.getHours()}${currentTime.getMinutes()}${currentTime.getSeconds()} ` + ACTIVE_SOFTPHONE_TAB; } event.source.postMessage( { type: 'horizon_window_title_response', title: title, source: 'parent' }, event.origin ); } }); ``` 1. Adicione o parâmetro da plataforma VDI à sua configuração do InitCCP. O objetivo disso é habilitar o redirecionamento de áudio. ``` softphone: { allowFramedSoftphone: true, VDIPlatform: "OMNISSA" } ``` **Importante** Quando o `VDIPlatform: "OMNISSA"` é definido, o CCP não retornará ao áudio padrão do navegador da Web se a otimização de áudio do Omnissa falhar. Isso significa que: As chamadas falharão se um atendente acessar o CCP fora da Omnissa VM. Os desenvolvedores do CCP devem determinar se o CCP será executado dentro da Omnissa VM antes de definir esse parâmetro. **Opções de implementação**: Use caminhos de URL separados para acesso Omnissa e não Omnissa. Use parâmetros de URL para determinar o ambiente. Implemente uma API para determinar a configuração correta com base no contexto do usuário. ## Como verificar o fluxo de mídia entre o thin client e o Amazon Connect durante a chamada 1. Verifique se a extensão do navegador WebRTC do Omnissa Horizon está habilitada e no estado Pronto. 1. Confira o ícone da extensão na barra de ferramentas do seu navegador: 1. O ícone azul indica o estado Pronto e a funcionalidade adequada. 1. O ícone cinza indica o estado Não pronto e possíveis problemas. A imagem a seguir mostra a aparência da extensão de navegador Omnissa Horizon WebRTC quando habilitada e no estado Pronto. ![\[A extensão do navegador Omnissa Horizon WebRTC quando habilitada.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/omnissa-4.png) 1. Conferir o status do processo: 1. Abra o Gerenciador de tarefas. 1. Verifique se os processos html5server.exe e wsnm.exe estão em execução. 1. Esses processos devem permanecer em execução durante as chamadas. Se um deles falhar, a funcionalidade da VDI falhará. 1. Teste o fluxo de áudio: 1. Faça uma chamada de teste 1. Verifique a otimização do áudio desabilitando o acesso ao microfone no navegador da VM. As chamadas devem continuar funcionando enquanto o áudio está sendo processado localmente 1. Confira se há problemas de latência ou qualidade de áudio. 1. Use o Wireshark para verificar: O Wireshark é um analisador de pacotes de rede gratuito e de código aberto. Para acessar mais informações, consulte o [site](https://www.wireshark.org/) do Wireshark. 1. Baixe o Wireshark [aqui](https://www.wireshark.org/download.html). 1. Depois que o Wireshark for instalado, abra o wireshark no thin client e comece a monitorar sua rede local. 1. Conecte-se a uma chamada e, na barra de filtro na parte superior, insira o seguinte filtro: ``` (udp.srcport == 3478 or udp.dstport == 3478) and ((ip.dst_host = "15.193.6.0/24")) ``` 1. Verifique se você pode ver o fluxo de pacotes de mídia entre a máquina do atendente e o Amazon Connect. 1. Se nenhum pacote estiver visível: + Confira a conectividade de rede e as regras de firewall. + Confira as configurações de otimização de áudio. **nota** O intervalo de IP mostrado acima é para a região do Leste dos EUA (Norte da Virgínia) da AWS . Para intervalos de IP de outras regiões, consulte [Configurar sua rede](ccp-networking.md). A imagem a seguir mostra os intervalos de IP de. ![\[A extensão do navegador Omnissa Horizon WebRTC quando habilitada.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/omnissa-5.png) 1. Registro em log do console 1. Para Windows: abra as ferramentas do desenvolvedor do navegador (F12). 1. Procure a seguinte mensagem relacionada ao WebRTC confirmando a inicialização do Omnissa: R`TC.js is using OmnissaVDIStrategy` Confira um exemplo a seguir de como a mensagem de confirmação se parece. ``` { "component": "softphone", "level": "LOG", "text": " RTC.js is using OmnissaVDIStrategy", "time": "2025-04-03T20:47:40.460Z", "exception": null, "objects": [], "line": 64, "agentResourceId": "20c6b5a3-259e-4e18-a8a7-b962d54a6344", "loggerId": "1743713238678-pz6yp1q4n9s", "contextLayer": "CRM" }, ``` ## Limitações As seguintes configurações do CCP não são aceitos: + CCP nativo: a otimização de áudio para o CCP nativo não é aceita. A mídia continuará fluindo pelo navegador dentro da VM para chamadas processadas usando esse mesmo navegador. + Adaptador CTI Salesforce: não aceita a detecção da plataforma VDI, resultando em roteamento de mídia pelo navegador da VM em vez de processamento otimizado de áudio do lado do cliente. # Use o espaço de trabalho do agente para otimizar o áudio para desktops em nuvem Citrix WorkSpaces, Amazon e Omnissa Você pode usar o espaço de trabalho do agente Amazon Connect para simplificar a entrega de experiências de voz de alta qualidade nos ambientes Amazon WorkSpaces, Citrix e Omnissa Virtual Desktop Infrastructure (VDI). O Amazon Connect oferece suporte à [otimização de áudio para desktops em nuvem Amazon WorkSpaces](using-ccp-vdi-workspaces.md), [Citrix](using-ccp-vdi-citrix-step-by-step.md) e [Omnissa](using-ccp-vdi-omnissa-step-by-step.md). Essa otimização redireciona a mídia do área de trabalho local de um atendente para o Amazon Connect. Ela simplifica a experiência do atendente e aumenta a qualidade do áudio ao reduzir os saltos de rede. Seus atendentes podem utilizar essas otimizações de áudio no espaço de trabalho do atendente. ## O que é importante saber + Para usuários sem SSO, se os agentes navegarem até o espaço de trabalho do agente a partir do site do Amazon Connect administrador, haverá um parâmetro de consulta para o referenciador já anexado ao URL. O formato do URL é `https://your-instance-url/agent-app-v2?referrer=admin`. Para formar o parâmetro de consulta da plataforma VDI, remova o parâmetro referenciador do URL (por exemplo, você pode usar o Bloco de notas para editar o URL). Anexe o parâmetro da plataforma VDI diretamente ao caminho da URL `/agent-app-v2`. + Para otimização de áudio dentro do ambiente VDI, sempre use o URL marcado para o espaço de trabalho do atendente. + Se você não estiver usando o espaço de trabalho do atendente dentro de um ambiente VDI real, não acrescente o parâmetro de consulta VDI. + Recomendamos que os atendentes permaneçam com um dispositivo de mídia durante um contato contínuo em ambientes VDI. Como as informações do dispositivo de mídia são retransmitidas no início de um contato, se um atendente trocar de dispositivo de mídia durante um contato contínuo, ele não conseguirá acessar o áudio no dispositivo atualizado. ## Como usar a otimização de áudio no espaço de trabalho do agente Para usar a otimização de áudio no espaço de trabalho do agente, os usuários precisam ter um parâmetro de consulta na URL com um valor para o ambiente de VDI no qual o espaço de trabalho do agente é usado. Esse processo sinaliza ao Painel de controle de contato (CCP) para realizar o redirecionamento WebRTC para as chamadas desse ambiente VDI específico para o dispositivo local que está sendo usado pelo atendente. Conclua as etapas a seguir para usar um parâmetro de consulta para o ambiente VDI. ### Usar sem login baseado em SSO 1. Acesse o espaço de trabalho do agente do Amazon Connect e copie a URL do espaço de trabalho do agente para o Bloco de notas. 1. Anexe um parâmetro de consulta com a chave `VDIPlatform` e o valor igual ao ambiente VDI específico que você tem. Por exemplo: 1. Para a área de trabalho em nuvem Citrix, o valor do parâmetro de consulta é `CITRIX`. O código a seguir mostra um exemplo do URL completo: + `https://your-instance-url/agent-app-v2?VDIPlatform=CITRIX` 1. Para o desktop WorkSpaces em nuvem da Amazon, o valor do parâmetro de consulta é`AWS_WORKSPACE`. O código a seguir mostra um exemplo do URL completo: + `https://your-instance-url/agent-app-v2?VDIPlatform=AWS_WORKSPACE` 1. Para a área de trabalho em nuvem Omnissa, o valor do parâmetro de consulta é `OMNISSA`. O código a seguir mostra um exemplo do URL completo: + `https://your-instance-url/agent-app-v2?VDIPlatform=OMNISSA` 1. Copie e cole o URL no navegador do atendente. 1. Recomendamos marcar esse URL como favorito para todos os atendentes. Isso facilita o acesso dos atendentes no futuro, bastando clicar no link marcado como favorito. ### Usar com login baseado em SSO 1. Se você usar o SSO para fazer login diretamente no espaço de trabalho do agente do Amazon Connect, precisará alterar a URL do estado de retransmissão da sua configuração de SSO para acrescentar o parâmetro de consulta da VDI. Para isso, conclua as seguintes etapas: 1. Copie e cole o estado de retransmissão que você está usando para acessar o espaço de trabalho do atendente no estado de retransmissão do seu provedor de identidades (IdP). 1. Veja [exemplos do estado URLs do relé](configure-saml.md#destination-relay). Nos exemplos, ``%2Fagent-app-v2`` é o destino. 1. Adicione o parâmetro `VDIPlatform` com o valor apropriado a esse estado de retransmissão. Usando o exemplo do link acima, o URL completo do estado de retransmissão para o espaço de trabalho do atendente do Amazon Connect teria a seguinte aparência: 1. Em áreas de trabalho Citrix `https://us-east-1.console.aws.amazon.com/connect/federate/instance-id?destination=%2Fagent-app-v2?VDIPlatform=CITRIX` 1. Na Amazon WorkSpaces `https://us-east-1.console.aws.amazon.com/connect/federate/instance-id?destination=%2Fagent-app-v2?VDIPlatform=AWS_WORKSPACE` 1. Em Omnissa `https://us-east-1.console.aws.amazon.com/connect/federate/instance-id?destination=%2Fagent-app-v2?VDIPlatform=OMNISSA` 1. A configuração `VDIPlatform` da URL do estado de retransmissão define automaticamente a otimização de áudio no espaço de trabalho do agente para o ambiente VDI específico que está sendo usado. 1. Faça login por meio do seu IdP e confirme se ``VDIPlatform`` está presente como um parâmetro de consulta.