

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Uso de Amazon Connect en un entorno de VDI
<a name="using-ccp-vdi"></a>

Los entornos de infraestructura de entorno virtual (VDI) agregan otra capa de complejidad a su solución, lo que garantiza que los esfuerzos de POC y el rendimiento de las pruebas, por separado, se optimice. El panel de control de contactos (CCP) puede funcionar en entornos VDI densos, delgados y sin clientes, como lo hace cualquier otra aplicación de navegador basada en WebRTC, y lo mejor configuration/support/optimization es que lo gestione su equipo de soporte de VDI. Dicho esto, el siguiente es un conjunto de consideraciones y prácticas recomendadas que han sido de ayuda a nuestros clientes basados en VDI.

## Uso de un modelo de CCP dividido
<a name="use-split-ccp"></a>

Se recomienda utilizar un modelo de CCP dividido con un CCP sin medios que se ejecute en VDI y un CCP que lleve los medios en el PC local. Puede crear un CCP personalizado con la API de Amazon Connect Streams creando un CCP sin medios para los datos de la aplicación y la señalización de llamadas. De este modo, los medios se entregan en el ordenador local mediante el CCP estándar, mientras que los datos y los controles de llamada se entregan en la conexión remota con el CCP sin medios. Para obtener más información sobre la API de transmisiones, consulte el repositorio en. GitHub [https://github.com/aws/amazon-connect-streams](https://github.com/aws/amazon-connect-streams)

**nota**  
**Usuarios de Firefox**: si utiliza la VDI en modo dividido, no puede utilizar el navegador Firefox para el CCP fuera de la VDI. El CCP se ajusta a la guía de uso del micrófono de Firefox, y solo tiene acceso para conectarse al micrófono del usuario cuando la pestaña CCP está activa. 

El siguiente diagrama muestra cómo la estación de trabajo del agente está compuesta por un navegador local y un escritorio virtual. Se conecta a Amazon Connect a través de WebRTC y a la infraestructura virtual corporativa a través de una conexión VDI.

![\[La estación de trabajo del agente, el escritorio virtual, la infraestructura virtual corporativa y Amazon Connect.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/use-split-ccp.png)


## Escritorios en la nube
<a name="use-cloud-desktops"></a>

Si utiliza escritorios en la nube de Citrix WorkSpaces, Amazon u Omnissa, puede crear una interfaz de usuario de agente nueva o actualizar una existente, como un CCP personalizado, para descargar el procesamiento de audio al dispositivo local del agente y redirigir automáticamente el audio a Amazon Connect. Esto se traduce en una experiencia más ágil para los agentes y mejora la calidad del audio en las redes más exigentes. Para empezar, puede utilizar las [bibliotecas de código abierto de Amazon Connect](https://github.com/amazon-connect/amazon-connect-streams) para crear una interfaz de usuario de agente nueva o actualizar una existente, como un Panel de control de contacto (CCP) personalizado.

## Aspectos que debe tener en cuenta al diseñar su entorno de VDI
<a name="considerations-vdi"></a>
+ **Ubicación de los agentes**: lo ideal es que haya la menor cantidad de saltos como sea posible con el menor tiempo de ida y vuelta entre la ubicación desde la que sus agentes utilizan el CCP y la ubicación en la que está el VDI.
+ **Ubicación del host de su solución de VDI**: lo ideal es que la ubicación de su host de VDI sea en el mismo segmento de red que el de sus agentes, con el menor número de saltos posible tanto desde los recursos internos como desde un router periférico. También le interesa el menor tiempo de ida y vuelta posible para los puntos de conexión de WebRTC y de intervalo de Amazon EC2.
+ **Red**: cada salto por el que pasa el tráfico entre puntos de conexión aumenta la posibilidad de error y suma oportunidades de que se produzca latencia. Los entornos de VDI son especialmente susceptibles a los problemas de calidad de las llamadas si las rutas indicadas no están optimizadas o la línea no es lo suficientemente rápida o amplia. Si bien Direct Connect puede mejorar la calidad de las llamadas desde el router periférico al router periférico AWS, no solucionará los problemas de enrutamiento interno. Es posible que tenga que actualizar o optimizar su LAN/WAN privada o redirigirla a un dispositivo externo para eludir los problemas de audio de las llamadas. En la mayoría de las situaciones, si es necesario, el CCP no es la única aplicación que tiene problemas.
+ **Recursos dedicados**: en el nivel de red y de escritorio se recomiendan para evitar el impacto en los recursos de agente disponibles de actividades como las copias de seguridad y las transferencias de grandes archivos. Una forma de evitar la contención de recursos es restringir el acceso al escritorio a los usuarios de Amazon Connect que vayan a utilizar su entorno de forma similar, en lugar de compartir los recursos con otras unidades empresariales que pueden utilizar esos recursos de forma distinta.
+ **Uso de un teléfono virtual con conexiones remotas**: en los entornos de VDI puede afectar la calidad de audio. 
**sugerencia**  
Si sus agentes se conectan a un punto de enlace remoto y funciona en ese entorno, le recomendamos redirigir a un punto de conexión externo E.164 de audio o conectar los contenido multimedia a través del dispositivo local y, a continuación, señalizarlos a través de la conexión remota.

# Optimización de audio de Amazon Connect para escritorios en la nube de Citrix
<a name="using-ccp-vdi-citrix-step-by-step"></a>

Amazon Connect facilita la prestación de experiencias de voz de alta calidad cuando sus agentes utilizan entornos de infraestructura de escritorios virtuales (VDI) de Citrix. Sus agentes pueden aprovechar la aplicación de escritorio remoto de Citrix, como Citrix Workspaces, para descargar el procesamiento de audio a los dispositivos locales del agente y redirigir automáticamente el audio a Amazon Connect, lo que mejora la calidad del audio en las redes más exigentes. 

Para empezar, puede utilizar las [bibliotecas de código abierto de Amazon Connect](https://github.com/amazon-connect/amazon-connect-streams) para crear una interfaz de usuario de agente nueva o actualizar una existente, como un Panel de control de contacto (CCP) personalizado.

## Requisitos del sistema
<a name="using-ccp-vdi-citrix-step-by-step-requirements"></a>

En esta sección se describen los requisitos del sistema para usar el SDK de Citrix Unified Communications con Amazon Connect.
+ **Versión de la aplicación Citrix Workspace**

  Se recomienda utilizar la versión más reciente de la aplicación Citrix Workspace, tal y como se describe en [esta documentación](https://community.citrix.com/tech-zone/learn/tech-briefs/ucssdk/). Sin embargo, como mínimo, debe utilizar CWA 2305 o una versión posterior.
+ **Versión del servidor Citrix**

  Se recomienda que la versión de Citrix VDA (Virtual Delivery Agent) sea 2203 LTSR o posterior.
+ **Configuración del servidor Citrix**

  De forma predeterminada, no se admite el uso del SDK de Citrix UC. El administrador del sistema debe añadir una entrada de registro en la lista de permitidos de la siguiente manera:
  + **Ruta de clave:** `Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\WebSocketService`
  + **Nombre de clave:** `ProcessWhitelist`
  + **Tipo de clave:** `REG_MULTI_SZ`
  + **Valor de clave:**
    + `Chrome.exe`
    + `msedge.exe`

  Cuando el registro anterior esté configurado correctamente, reinicie el `CitrixHdxWebSocketService` con el **Administrador de tareas** para finalizar la configuración.  
![\[Usar el administrador de tareas en Windows para reiniciar CitrixHdxWebSocketService.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/using-ccp-vdi-citrix-server-setup.png)
+ **Configuraciones de red y firewall**
  + **Configuración del servidor Citrix**

    El administrador debe permitir que el servidor Citrix acceda al tráfico TCP/443 de Amazon Connect a los dominios mencionados en el siguiente diagrama. Para obtener más información, consulte [Configurar la red](ccp-networking.md).
  + **Configuración de la máquina del agente**

    Esta solución requiere una conexión multimedia entre el cliente ligero del agente y Amazon Connect. Para permitir el tráfico entre el equipo del agente y el puerto UDP 3478 de medios del softphone de Amazon Connect, consulte [Configurar la red](ccp-networking.md).  
![\[Configuración del firewall del servidor Citrix y del equipo del agente.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/using-ccp-vdi-citrix-server-firewall.png)
+ **Implementación de CCP no compatible**
  + CCP nativo

## Confirmación de los flujos de contenido multimedia entre el cliente ligero y Amazon Connect durante la llamada
<a name="using-ccp-vdi-citrix-confirm-media-flow"></a>
+ **Uso del administrador de tareas (Windows) para verificar**

  Inicie el **administrador de tareas** en el cliente ligero del agente y compruebe si el servicio HDX se está ejecutando o no. Si se está ejecutando, significa que el medio se está redirigiendo como se esperaba.  
![\[Uso del administrador de tareas en Windows.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/using-ccp-vdi-citrix-confirm-media-flow-windows.png)

# Optimice el audio de Amazon Connect para los escritorios WorkSpaces en la nube de Amazon
<a name="using-ccp-vdi-workspaces"></a>

Amazon Connect simplifica la entrega de experiencias de voz de alta calidad a los agentes que operan en entornos de Amazon WorkSpaces Virtual Desktop Infrastructure (VDI). Al aprovechar Amazon WorkSpaces con la función de redireccionamiento WebRTC, los agentes pueden redirigir el procesamiento de audio de Amazon Connect a sus dispositivos locales. Este sistema mejora la calidad de audio, incluso en condiciones de red poco favorables. Para beneficiarse de esta característica, debe hacer lo siguiente:
+ Utilice las [bibliotecas de código abierto de Amazon Connect](https://github.com/amazon-connect/amazon-connect-streams) para crear una interfaz de usuario de agente nueva o actualizar una existente, como un Panel de control de contacto (CCP) personalizado. 
+ Configure Amazon WorkSpaces para habilitar la redirección WebRTC.

## Requisitos del sistema
<a name="using-ccp-vdi-citrix-step-by-step-requirements"></a>

En esta sección se describen los requisitos del sistema para utilizar Amazon Connect con la redirección WorkSpaces WebRTC.
+ **WorkSpaces Protocolo**

  WorkSpaces necesita usar Amazon DCV. Para obtener más información, consulte [¿Qué es Amazon VPC?](https://docs.aws.amazon.com/dcv/latest/adminguide/what-is-dcv.html) 
+ **Versión del cliente**

  Los usuarios deben utilizar la versión 5.21.0 o WorkSpaces superior del cliente de WorkSpaces Web Access o Windows. Complete las instrucciones de [configuración e instalación](https://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html#windows_setup). 
+ **Política de grupo**

  La redirección WebRTC debe estar habilitada en la política de grupo de DCV. En el tema [Administración de la configuración de política de grupo para DCV](https://docs.aws.amazon.com/workspaces/latest/adminguide/group_policy.html#gp_configurations_dcv), abra la sección contraída titulada **Habilitación o deshabilitación del redireccionamiento de WebRTC para DCV** y complete esas instrucciones.
+ **Configuraciones de red y firewall**
  + **Configuración del VDI del espacio de trabajo**

    El administrador debe permitir que Workspaces acceda al tráfico TCP/443 de Amazon Connect a los dominios mencionados en el siguiente diagrama. Para obtener más información, consulte [Configurar la red](ccp-networking.md).
  + **Configuración de la máquina del agente**

    Esta solución requiere una conexión multimedia entre el cliente ligero del agente y Amazon Connect. Para permitir el tráfico entre el equipo del agente y el puerto UDP 3478 de medios del softphone de Amazon Connect, consulte [Configurar la red](ccp-networking.md).  
![\[Configuración del cortafuegos del equipo del agente y del VDI del espacio de trabajo.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/vdi-workspaces.png)
+ **Implementación de CCP no compatible**
  + CCP nativo

## Confirmación de los flujos de contenido multimedia entre el equipo del agente y Amazon Connect durante la llamada
<a name="using-ccp-vdi-citrix-confirm-media-flow"></a>
+ Asegúrese de que la extensión del navegador WebRTC DCV esté habilitada y en estado Listo.

# Optimización de audio de Amazon Connect para escritorios en la nube de Omnissa
<a name="using-ccp-vdi-omnissa-step-by-step"></a>

Amazon Connect facilita la prestación de experiencias de voz de alta calidad cuando sus agentes utilizan entornos de infraestructura de escritorios virtuales (VDI) de Omnissa. Sus agentes pueden aprovechar las aplicaciones de escritorio remoto de Omnissa, como Omnissa Horizon Client, para descargar el procesamiento de audio al dispositivo local del agente y redirigir automáticamente el audio a Amazon Connect, lo que mejora la calidad del audio en las redes más exigentes. 

Para empezar, puede utilizar las [bibliotecas de código abierto de Amazon Connect](https://github.com/amazon-connect/amazon-connect-streams) para crear una interfaz de usuario de agente nueva o actualizar una existente, como un Panel de control de contacto (CCP) personalizado.

## Requisitos del sistema
<a name="using-ccp-vdi-omnissa-step-by-step-requirements"></a>

En esta sección se describen los requisitos del sistema para usar el SDK de Omnissa Horizon con Amazon Connect.
+ **Versión de Omnissa Horizon Client**
  + Versión mínima requerida: 8.15.0 (Horizon 2503) tanto para el agente como para el cliente
  + Actualmente, Omnissa solo es compatible con estaciones de trabajo con agentes que ejecutan Windows para esta característica.
  + Descarga de la última versión de Omnissa Client
**importante**  
La versión 2503 será la primera versión en admitir la funcionalidad de reinicio del ICE. Las versiones anteriores no admiten esta característica.
La versión 2503 de Omnissa Horizon Client estará disponible a través de [Omnissa Customer Connect](https://customerconnect.omnissa.com/downloads/info/slug/desktop_end_user_computing/omnissa_horizon_clients/8). Consulte Customer Connect para obtener la versión más reciente.
+ **Requisitos de SDK y de extensión de Omnissa**
  + La aplicación web Horizon WebRTC admite tanto la extensión como el SDK 8.15.0 o superior.
  + Esta extensión del navegador permite que se admitan aplicaciones web con el SDK de WebRTC dentro de Horizon Agent y se puede descargar de la Chrome Store desde [aquí](https://chromewebstore.google.com/detail/horizon-webrtc-web-app-su/emildoafpcgihdmhphelfhghioccllfi?pli=1). 
+ **Compatibilidad con navegadores (últimas 3 versiones)**
  + Google Chrome
  + Microsoft Edge (Chromium)
+ **Configuración del servidor Omnissa**: el SDK de Omnissa Horizon no está habilitado de forma predeterminada. El administrador del sistema debe configurar los siguientes ajustes de registro en la máquina virtual del Omnissa Horizon Agent (preferiblemente mediante el Editor del Registro [regedit]):
  + **Abra el editor de registro**
    + Para Windows:
      + Pulse **Windows \$1 R**
      + Escriba **regedit** y pulse **Intro**.
  + Cree o vaya a la siguiente ruta del 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
    ```

  Tras instalar el agente Omnissa, los procesos html5server.exe y wsnm.exe siempre se ejecutarán en el Administrador de tareas, independientemente del estado de activación del SDK. La siguiente imagen muestra el proceso html5server.exe que se ejecuta en el Administrador de tareas.   
![\[Administrador de tareas; el proceso html5server.exe en ejecución.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/omnissa-1.png)

  La siguiente imagen muestra el proceso wsnm.exe en ejecución en el Administrador de tareas.   
![\[Administrador de tareas; el proceso wsnm.exe en ejecución.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/omnissa-2.png)
+ **Solución de problemas**
  + El archivo de registro de Omnissa se encuentra en:

    ` %tmp%\omnissa-{username}\horizon-html5Client-{pid}.log`
**nota**  
`{pid}` hace referencia al ID de proceso "horizon-protocol.exe" del Horizon Client, que se encuentra en el Administrador de tareas.
  + Configuración de registro para mejorar el registro

    Para habilitar el registro detallado para la solución de problemas, agregue las siguientes entradas de 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
    ```

    Esta configuración de registro habilita un registro detallado que puede ayudar a diagnosticar problemas relacionados con la integración de la VDI de Omnissa.
+ **Configuraciones de red y firewall**
  + **Configuración de VDI de Omnissa**

    El administrador debe permitir que el servidor Omnissa acceda al tráfico TCP/443 de Amazon Connect a los dominios mencionados en el siguiente diagrama. Consulte el tema [Configurar la red](ccp-networking.md) de esta configuración.
  + **Configuración de la estación de trabajo del agente**

    Esta solución requiere una conexión multimedia entre el cliente ligero del agente y Amazon Connect. Para permitir el tráfico entre el equipo del agente y el puerto UDP 3478 de medios del softphone de Amazon Connect, consulte [Configurar la red](ccp-networking.md).

     En el siguiente diagrama se ilustra el uso del puerto UDP 3478.  
![\[Un diagrama que ilustra el uso del puerto UDP 3478.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/omnissa-3.png)

## Cambios de código necesarios en el CCP personalizado
<a name="omnissa-required-initccp-changes"></a>

Para habilitar la optimización de audio en el entorno de VDI de Omnissa, debe configurar su CCP personalizado con los siguientes cambios.

1. Agregue el siguiente fragmento de código antes de la inicialización de CCP. Ayuda a administrar la identificación de ventanas para el CCP, algo especialmente importante si los agentes tienen varias ventanas abiertas. Añade una marca de tiempo y el marcador “Pestaña de Softphone activa” para ayudar a identificar la ventana de CCP activa.

   ```
   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. Agregue el parámetro de plataforma de VDI a su configuración de initCCP. Esto se realiza para habilitar la redirección de audio.

   ```
   softphone: {
       allowFramedSoftphone: true,  
       VDIPlatform: "OMNISSA"
   }
   ```
**importante**  
Si `VDIPlatform: "OMNISSA"` está ajustado, el CCP no recurrirá al audio estándar de un navegador web en caso de que la optimización de audio de Omnissa falle. Esto significa:  
Se producirá un error en las llamadas si un agente accede al CCP desde fuera de la máquina virtual de Omnissa.
Los desarrolladores del CCP deben determinar si el CCP se está ejecutando dentro de la máquina virtual de Omnissa antes de configurar este parámetro.
**Opciones de implementación**:  
Utilice rutas de URL distintas para el acceso de Omnissa y ajeno a Omnissa.
Utilice los parámetros de URL para determinar el entorno.
Implemente una API para determinar la configuración correcta en función del contexto del usuario.

## Confirmación de los flujos multimedia entre el cliente ligero y Amazon Connect durante la llamada
<a name="verify-omnissa"></a>

1. Asegúrese de que la extensión del navegador WebRTC de Omnissa Horizon esté habilitada y en estado Listo.

1. Compruebe el icono de la extensión en la barra de herramientas del navegador:

   1. El icono azul indica el estado Listo y la funcionalidad adecuada.

   1. El icono gris indica el estado No listo y los posibles problemas.

   La siguiente imagen muestra el aspecto de la extensión de navegador WebRTC de Omnissa Horizon cuando está habilitada y en estado Listo.  
![\[La extensión de navegador WebRTC de Omnissa Horizon cuando está habilitada.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/omnissa-4.png)

1. Compruebe el estado del proceso:

   1. Abra el Administrador de tareas.

   1. Compruebe que los procesos html5server.exe y wsnm.exe se estén ejecutando.

   1. Asegúrese de que estos procesos sigan ejecutándose durante las llamadas. Si alguno de los procesos se bloquea, la funcionalidad de la VDI fallará.

1. Pruebe el flujo de audio:

   1. Realice una llamada de prueba

   1. Verifique la optimización del audio deshabilitando el acceso al micrófono en el navegador de la máquina virtual; las llamadas deberían seguir funcionando, ya que el audio se procesa localmente.

   1. Compruebe si hay problemas de calidad o latencia del audio.

1. Use Wireshark para la comprobación:

   Wireshark es un analizador de paquetes de red gratuito y de código abierto. Para obtener más información, consulte el [sitio web](https://www.wireshark.org/) de Wireshark.

   1. Descargue Wireshark desde [aquí](https://www.wireshark.org/download.html). 

   1. Una vez instalado Wireshark, abra el wireshark en un cliente ligero y comience la monitorización de la red local.

   1. Conéctese a una llamada y, en la barra de filtros de la parte superior, introduzca el siguiente filtro:

      ```
      (udp.srcport == 3478 or udp.dstport == 3478) and ((ip.dst_host = "15.193.6.0/24"))
      ```

   1. Compruebe que puede ver el flujo de paquetes multimedia entre la máquina del agente y Amazon Connect. 

   1. Si no hay paquetes visibles:
      + Compruebe la conectividad de la red y las reglas del firewall.
      + Compruebe la configuración de optimización de audio.
**nota**  
El rango de IP que se muestra arriba es para la región de AWS Este de EE. UU. (Norte de Virginia). Para ver los rangos de IP de otras regiones, consulte [Configurar la red](ccp-networking.md).  
En la siguiente imagen se muestran los rangos de IP.  

![\[La extensión de navegador WebRTC de Omnissa Horizon cuando está habilitada.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/omnissa-5.png)


1. Registro de la consola

   1. Para Windows: abra las herramientas de desarrollo del navegador (F12).

   1. Busque el siguiente mensaje relacionado con WebRTC, que confirma la inicialización de Omnissa: R `TC.js is using OmnissaVDIStrategy`

      A continuación, se muestra un ejemplo del posible aspecto del mensaje de confirmación: 

      ```
      {
              "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"
          },
      ```

## Limitaciones
<a name="omnissa-limitations"></a>

Las siguientes configuraciones de CCP no se admiten:
+ CCP nativo: no se admite la optimización de audio para el CCP nativo. El contenido multimedia seguirá circulando por el navegador dentro de la máquina virtual para las llamadas administradas con esta.
+ Adaptador CTI de Salesforce: no admite la detección de plataformas de VDI, lo que hace que el contenido multimedia se enrute a través del navegador de la máquina virtual en lugar del procesamiento optimizado de audio en el cliente.

# Utilice el espacio de trabajo del agente para optimizar el audio para los escritorios en la nube de Citrix WorkSpaces, Amazon y Omnissa
<a name="optimize-audio-cdd"></a>

Puede utilizar el espacio de trabajo de los agentes de Amazon Connect para simplificar la entrega de experiencias de voz de alta calidad en los entornos de infraestructura de escritorio virtual (VDI) de Amazon WorkSpaces, Citrix y Omnissa. 

Amazon Connect admite la [optimización de audio para los escritorios en la nube de Amazon WorkSpaces](using-ccp-vdi-workspaces.md), [Citrix](using-ccp-vdi-citrix-step-by-step.md) y [Omnissa](using-ccp-vdi-omnissa-step-by-step.md). Esta optimización redirige el contenido multimedia del escritorio local de un agente a Amazon Connect. Simplifica la experiencia de agente y mejora la calidad del audio al reducir los saltos de red. Sus agentes pueden aprovechar estas optimizaciones de audio en el espacio de trabajo de agente.

## Cosas importantes que debe saber
<a name="optimize-audio-cdd-important-notes"></a>
+ Para los usuarios que no utilizan SSO, si los agentes acceden al espacio de trabajo del agente desde el sitio web de Amazon Connect administración, ya habrá un parámetro de consulta para el remitente adjunto a la URL. El formato de la URL es `https://your-instance-url/agent-app-v2?referrer=admin`. Para formar el parámetro de consulta de la plataforma de VDI, elimine el parámetro de remitente de la URL (por ejemplo, puede usar el Bloc de notas para editar la URL). Añada el parámetro de la plataforma de VDI directamente a la ruta `/agent-app-v2` de la URL.
+ Para optimizar el audio en el entorno de VDI, utilice siempre la URL marcada para el espacio de trabajo del agente.
+ Si no utiliza el espacio de trabajo del agente en un entorno de VDI real, no añada el parámetro de consulta de VDI.
+ Se recomienda que los agentes utilicen un dispositivo multimedia durante un contacto continuo en entornos de VDI. Dado que la información del dispositivo multimedia se transmite al inicio de un contacto, si un agente cambia de dispositivo multimedia durante un contacto continuo, no podrá acceder al audio del dispositivo actualizado.

## Cómo utilizar la optimización de audio en el espacio de trabajo del agente
<a name="howto-optimize-audio-cdd"></a>

Para utilizar la optimización de audio en el espacio de trabajo del agente, los usuarios deben tener un parámetro de consulta en la URL con un valor para el entorno de VDI en el que se utiliza el espacio de trabajo del agente. Este proceso indica al Panel de control de contacto (CCP) que lleve a cabo la redirección de WebRTC para las llamadas desde ese entorno de VDI específico al dispositivo local que utiliza el agente.

Complete los siguientes pasos para usar un parámetro de consulta para el entorno de VDI.

### Uso sin inicio de sesión basado en SSO
<a name="without-sso"></a>

1. Ve al espacio de trabajo del agente de Amazon Connect y copia la URL del espacio de trabajo del agente en el Bloc de notas.

1. Agregue un parámetro de consulta con la misma clave `VDIPlatform` y valor que el entorno de VDI específico del que disponga. Por ejemplo:

   1. En el caso del escritorio en la nube de Citrix, el valor del parámetro de consulta es `CITRIX`. En el siguiente código se muestra un ejemplo de la URL completa: 
      + `https://your-instance-url/agent-app-v2?VDIPlatform=CITRIX`

   1. Para Amazon WorkSpaces Cloud Desktop, el valor del parámetro de consulta es`AWS_WORKSPACE`. En el siguiente código se muestra un ejemplo de la URL completa:
      + `https://your-instance-url/agent-app-v2?VDIPlatform=AWS_WORKSPACE`

   1. En el caso del escritorio en la nube de Omnissa, el valor del parámetro de consulta es `OMNISSA`. En el siguiente código se muestra un ejemplo de la URL completa:
      + `https://your-instance-url/agent-app-v2?VDIPlatform=OMNISSA`

1. Copie y pegue la URL en el navegador del agente. 

1. Recomendamos marcar esta URL para todos los agentes. Esto hace que los agentes puedan acceder más fácilmente a él en el futuro con solo hacer clic en el enlace marcado.

### Uso con inicio de sesión basado en SSO
<a name="with-sso"></a>

1. Si utiliza el SSO para iniciar sesión directamente en el espacio de trabajo del agente de Amazon Connect, tendrá que cambiar la URL del estado de retransmisión de la configuración del SSO para añadir el parámetro de consulta de VDI. Siga los pasos que se describen a continuación:

   1. Copie y pegue el estado de retransmisión que está utilizando para acceder al espacio de trabajo del agente en el estado de retransmisión de su proveedor de identidades (IdP). 

   1. Consulte [algunos ejemplos](configure-saml.md#destination-relay) del estado de retransmisión. URLs En estos ejemplos, ``%2Fagent-app-v2`` es el destino. 

   1. Agregue el parámetro `VDIPlatform` con el valor adecuado a este estado de retransmisión. Siguiendo el ejemplo del enlace anterior, la dirección URL completa del estado de retransmisión del espacio de trabajo del agente de Amazon Connect tendría el siguiente aspecto:

      1. En el escritorio de Citrix

         `https://us-east-1.console.aws.amazon.com/connect/federate/instance-id?destination=%2Fagent-app-v2?VDIPlatform=CITRIX`

      1. En Amazon WorkSpaces

         `https://us-east-1.console.aws.amazon.com/connect/federate/instance-id?destination=%2Fagent-app-v2?VDIPlatform=AWS_WORKSPACE`

      1. En Omnissa

         `https://us-east-1.console.aws.amazon.com/connect/federate/instance-id?destination=%2Fagent-app-v2?VDIPlatform=OMNISSA`

1. Al configurar `VDIPlatform` la URL en estado de retransmisión, se establece automáticamente la optimización de audio en el espacio de trabajo del agente para el entorno de VDI específico que se esté utilizando.

   1. Inicie sesión desde su IdP y confirme que ``VDIPlatform`` está presente como parámetro de consulta.