

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Utilisation d’Amazon Connect dans un environnement VDI
<a name="using-ccp-vdi"></a>

Les environnements d’infrastructure de bureau virtuel (VDI) ajoutent une autre couche de complexité à votre solution qui justifie des efforts POC distincts et des tests de performances d’optimisation. Le panneau de configuration des contacts (CCP) peut fonctionner dans des environnements VDI denses, fins et sans client, comme le fait toute autre application de navigateur basée sur le WebRTC, et il configuration/support/optimization est préférable de le gérer par votre équipe d'assistance VDI. Cela dit, ce qui suit est un ensemble de considérations et de bonnes pratiques qui ont été utiles pour nos clients basés sur VDI.

## Utilisation d’un modèle de CCP fractionné
<a name="use-split-ccp"></a>

Nous recommandons d’utiliser un modèle de CCP fractionné avec un CCP sans média s’exécutant dans la VDI et un CCP transportant le contenu multimédia sur le PC local. Vous pouvez créer un CCP personnalisé avec l’API Amazon Connect Streams en créant un CCP sans média pour les données d’application et la signalisation d’appel. Ainsi, le contenu multimédia est transmis au bureau local à l’aide d’un CCP standard, les contrôles de données et d’appels étant transmises à la connexion à distance avec le CCP sans média. Pour plus d'informations sur l'API streams, consultez le GitHub référentiel à l'adresse [https://github.com/aws/amazon-connect-streams](https://github.com/aws/amazon-connect-streams).

**Note**  
**Utilisateurs de Firefox** : si vous utilisez la VDI en mode fractionné, vous ne pouvez pas utiliser le navigateur Firefox pour CCP en dehors de la VDI. Le CCP est conforme aux instructions d’utilisation du microphone de Firefox et ne peut se connecter au microphone de l’utilisateur que lorsque l’onglet CCP est sélectionné. 

Le schéma suivant montre comment la station de travail de l’agent se compose d’un navigateur local et d’un bureau virtuel. Elle se connecte à Amazon Connect via WebRTC et à l’infrastructure virtuelle d’entreprise via une connexion VDI.

![\[Station de travail de l’agent, bureau virtuel, infrastructure virtuelle d’entreprise et Amazon Connect.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/use-split-ccp.png)


## Bureaux cloud
<a name="use-cloud-desktops"></a>

Si vous utilisez des ordinateurs de bureau cloud Citrix WorkSpaces, Amazon ou Omnissa, vous pouvez créer une nouvelle interface utilisateur d'agent ou mettre à jour une interface utilisateur existante, telle qu'un CCP personnalisé, afin de décharger le traitement audio sur l'appareil local de votre agent et de rediriger automatiquement le son vers Amazon Connect. Cela se traduit par une expérience plus rationalisée pour les agents et une amélioration de la qualité audio sur les réseaux complexes. Pour bien démarrer, vous pouvez créer une interface utilisateur d’agent ou mettre à jour une interface utilisateur existante telle qu’un CCP personnalisé à l’aide des [bibliothèques open source Amazon Connect](https://github.com/amazon-connect/amazon-connect-streams).

## Points à prendre en compte lors de la conception de votre environnement VDI
<a name="considerations-vdi"></a>
+ **Emplacement de vos agents** : dans l’idéal, il y a aussi peu de sauts que possible avec la plus faible durée de cycle entre l’emplacement à partir duquel vos agents utilisent le CCP et l’emplacement de l’hôte VDI.
+ **Emplacement de l’hôte de votre solution VDI** : idéalement, l’emplacement de votre hôte VDI se situe sur le même segment réseau que vos agents, avec aussi peu de sauts que possible à partir des deux ressources internes, ainsi qu’un routeur périphérique. Vous souhaitez également un aller-retour le plus court possible pour les deux points de terminaison de plage WebRTC et Amazon EC2.
+ **Réseau** : chaque saut effectué par le trafic entre les points de terminaison augmente le risque d’un échec et ajoute une occasion d’introduire de la latence. Les environnements VDI sont particulièrement sensibles aux problèmes de qualité des appels si le chemin sous-jacent n’est pas optimisé ou si le canal n’est pas suffisamment large ou rapide. Bien qu'il Direct Connect puisse améliorer la qualité des appels entre le routeur périphérique et le routeur AWS, il ne résoudra pas les problèmes de routage internes. Il se peut que vous ayez besoin de mettre à niveau ou d’optimiser votre redirection LAN/WAN privée, ou la rediriger vers un appareil externe afin de contourner les problèmes d’audio d’appels. Dans la plupart des cas, si nécessaire, le CCP ne sera pas la seule application confrontée à un problème.
+ **Ressources dédiées** : recommandées au niveau du réseau et du bureau pour empêcher d’affecter les ressources de l’agent disponibles à partir des activités, telles que des sauvegardes et des transferts de fichiers volumineux. Une solution pour empêcher le conflit de ressources est la limitation de l’accès aux utilisateurs Amazon Connect qui emploient leur environnement d’une manière similaire, au lieu de partager des ressources avec d’autres unités commerciales qui peuvent utiliser ces ressources différemment.
+ **Utilisation d’un logiciel de téléphonie par Internet avec des connexions à distance** : dans les environnements VDI, cela peut nuire à la qualité de l’audio. 
**Astuce**  
Si vos agents se connectent à un point de terminaison distant et fonctionnent dans cet environnement, nous vous recommandons soit de faire passer l’audio par un autre chemin vers un point de terminaison E.164 externe, ou de connectez le média via le périphérique local, puis d’envoyer un message via la connexion distante.

# Optimisation de l’audio Amazon Connect pour les bureaux cloud Citrix
<a name="using-ccp-vdi-citrix-step-by-step"></a>

Amazon Connect facilite l’offre d’expériences vocales de qualité supérieure lorsque vos agents utilisent des environnements d’infrastructure de bureau virtuel (VDI) Citrix. Vos agents peuvent tirer parti de leurs applications de bureau à distance Citrix telles que Citrix Workspace pour décharger le traitement audio sur l’appareil local de l’agent et rediriger automatiquement l’audio vers Amazon Connect, ce qui permet d’améliorer la qualité audio sur les réseaux complexes. 

Pour bien démarrer, vous pouvez créer une interface utilisateur d’agent ou mettre à jour une interface utilisateur existante telle qu’un panneau de configuration des contacts (CCP) personnalisé à l’aide des [bibliothèques open source Amazon Connect](https://github.com/amazon-connect/amazon-connect-streams).

## Configuration système requise
<a name="using-ccp-vdi-citrix-step-by-step-requirements"></a>

Cette section décrit la configuration système requise pour utiliser le kit SDK Citrix Unified Communications avec Amazon Connect.
+ **Version de l’application Citrix Workspace**

  Il est recommandé d’utiliser la version la plus récente de l’application Citrix Workspace, comme indiqué dans [cette documentation](https://community.citrix.com/tech-zone/learn/tech-briefs/ucssdk/). Cependant, vous devez au minimum utiliser CWA version 2305 ou ultérieure.
+ **Version du serveur Citrix**

  Il est recommandé que la version de Citrix VDA (Virtual Delivery Agent) soit 2203 LTSR ou ultérieure.
+ **Configuration du serveur Citrix**

  Le kit SDK Citrix UC n’est pas pris en charge par défaut et l’administrateur du système doit ajouter une entrée de registre de liste d’autorisation comme suit :
  + **Chemin de la clé :** `Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\WebSocketService`
  + **Nom de la clé :** `ProcessWhitelist`
  + **Type de clé :** `REG_MULTI_SZ`
  + **Valeur de la clé :**
    + `Chrome.exe`
    + `msedge.exe`

  Après avoir configuré le registre avec succès, redémarrez `CitrixHdxWebSocketService` à l’aide du **Gestionnaire de tâches** pour terminer la configuration.  
![\[Utiliser le gestionnaire de tâches de Windows pour redémarrer CitrixHdxWebSocketService.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/using-ccp-vdi-citrix-server-setup.png)
+ **Configurations de la mise en réseau et du pare-feu**
  + **Configuration du serveur Citrix**

    L’administrateur doit autoriser le serveur Citrix à accéder au trafic Amazon Connect TCP/443 vers les domaines mentionnés dans le schéma suivant. Pour de plus amples informations, veuillez consulter [Configuration de votre réseau](ccp-networking.md).
  + **Configuration de la machine de l’agent**

    Cette solution nécessite une connexion média entre le client léger de l’agent et Amazon Connect. Pour autoriser le trafic entre la machine de l’agent et le port UDP 3478 d’Amazon Connect Softphone Media, consultez [Configuration de votre réseau](ccp-networking.md).  
![\[Paramètres de pare-feu du serveur Citrix et de la machine de l’agent.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/using-ccp-vdi-citrix-server-firewall.png)
+ **Déploiement CCP non pris en charge**
  + CCP natif

## Confirmation des flux de média entre le client léger et Amazon Connect pendant l’appel
<a name="using-ccp-vdi-citrix-confirm-media-flow"></a>
+ **Utilisation du Gestionnaire de tâches (Windows) pour vérifier**

  Lancez le **Gestionnaire de tâches** sur le client léger de l’agent et vérifiez si le service HDX est en cours d’exécution ou non. S’il est en cours d’exécution, cela signifie que le média est redirigé comme prévu.  
![\[Utilisation du Gestionnaire de tâches sous Windows.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/using-ccp-vdi-citrix-confirm-media-flow-windows.png)

# Optimisez le son Amazon Connect pour les ordinateurs de bureau Amazon WorkSpaces dans le cloud
<a name="using-ccp-vdi-workspaces"></a>

Amazon Connect simplifie la fourniture d'expériences vocales de haute qualité aux agents opérant dans les environnements Amazon WorkSpaces Virtual Desktop Infrastructure (VDI). En tirant parti d'Amazon WorkSpaces avec la fonctionnalité de redirection WebRTC, les agents peuvent rediriger le traitement audio Amazon Connect vers leurs appareils locaux. Cette approche améliore la qualité audio, même dans des conditions réseau difficiles. Pour profiter de cette fonctionnalité, procédez comme suit :
+ Créez une interface utilisateur d’agent ou mettez à jour une interface utilisateur existante telle qu’un panneau de configuration des contacts (CCP) personnalisé à l’aide des [bibliothèques open source Amazon Connect](https://github.com/amazon-connect/amazon-connect-streams). 
+ Configurez Amazon WorkSpaces pour activer la redirection WebRTC.

## Configuration système requise
<a name="using-ccp-vdi-citrix-step-by-step-requirements"></a>

Cette section décrit la configuration système requise pour utiliser Amazon Connect avec la redirection WorkSpaces WebRTC.
+ **WorkSpaces Protocole**

  WorkSpaces doit utiliser Amazon DCV. Pour plus d’informations, consultez [En quoi consiste Amazon DCV ?](https://docs.aws.amazon.com/dcv/latest/adminguide/what-is-dcv.html) 
+ **Version du client**

  Les utilisateurs doivent utiliser WorkSpaces Web Access ou le client WorkSpaces Windows version 5.21.0 ou supérieure. Suivez les instructions [Configuration et installation](https://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html#windows_setup). 
+ **Politique de groupe**

  La redirection WebRTC doit être activée dans la politique de groupe DCV. Dans la rubrique [Gestion des paramètres de politique de groupe pour DCV](https://docs.aws.amazon.com/workspaces/latest/adminguide/group_policy.html#gp_configurations_dcv), ouvrez la section réduite intitulée **Activation ou désactivation de la redirection WebRTC pour DCV** et suivez ces instructions.
+ **Configurations de la mise en réseau et du pare-feu**
  + **Configuration de la VDI d’espace de travail**

    L’administrateur doit autoriser les espaces de travail à accéder au trafic Amazon Connect TCP/443 vers les domaines mentionnés dans le schéma suivant. Pour de plus amples informations, veuillez consulter [Configuration de votre réseau](ccp-networking.md).
  + **Configuration de la machine de l’agent**

    Cette solution nécessite une connexion média entre le client léger de l’agent et Amazon Connect. Pour autoriser le trafic entre la machine de l’agent et le port UDP 3478 d’Amazon Connect Softphone Media, consultez [Configuration de votre réseau](ccp-networking.md).  
![\[Paramètres de la VDI d’espace de travail et du pare-feu de la machine de l’agent.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/vdi-workspaces.png)
+ **Déploiement CCP non pris en charge**
  + CCP natif

## Confirmation des flux de média entre la machine de l’agent et Amazon Connect pendant l’appel
<a name="using-ccp-vdi-citrix-confirm-media-flow"></a>
+ Assurez-vous que l’extension de navigateur WebRTC DCV est activée et à l’état Prête.

# Optimisation de l’audio Amazon Connect pour les bureaux cloud Omnissa
<a name="using-ccp-vdi-omnissa-step-by-step"></a>

Amazon Connect facilite l’offre d’expériences vocales de qualité supérieure lorsque vos agents utilisent des environnements d’infrastructure de bureau virtuel (VDI) Omnissa. Vos agents peuvent tirer parti de leurs applications de bureau à distance Omnissa telles qu’Omnissa Horizon Client pour décharger le traitement audio sur l’appareil local de l’agent et rediriger automatiquement l’audio vers Amazon Connect, ce qui permet d’améliorer la qualité audio sur les réseaux complexes. 

Pour bien démarrer, vous pouvez créer une interface utilisateur d’agent ou mettre à jour une interface utilisateur existante telle qu’un panneau de configuration des contacts (CCP) personnalisé à l’aide des [bibliothèques open source Amazon Connect](https://github.com/amazon-connect/amazon-connect-streams).

## Configuration système requise
<a name="using-ccp-vdi-omnissa-step-by-step-requirements"></a>

Cette section décrit la configuration système requise pour utiliser le kit SDK Omnissa Horizon avec Amazon Connect.
+ **Version d’Omnissa Horizon Client**
  + Version minimale requise : 8.15.0 (Horizon 2503) pour l’agent et le client
  + Omnissa ne prend actuellement en charge que les stations de travail d’agent exécutant Windows pour cette fonctionnalité.
  + Téléchargement de la version la plus récente d’Omnissa Horizon Client
**Important**  
La version 2503 sera la première à prendre en charge la fonctionnalité de redémarrage ICE. Les versions antérieures ne prennent pas en charge cette fonctionnalité.
La version 2503 d’Omnissa Horizon Client sera disponible via [Omnissa Customer Connect](https://customerconnect.omnissa.com/downloads/info/slug/desktop_end_user_computing/omnissa_horizon_clients/8). Consultez Customer Connect pour obtenir la version la plus récente.
+ **Configuration requise pour l’extension et le kit SDK Omnissa**
  + L’application Web WebRTC Horizon prend en charge l’extension et le kit SDK version 8.15.0 ou supérieure.
  + Cette extension de navigateur permet la prise en charge des applications Web pour le kit SDK WebRTC dans Horizon Agent et peut être téléchargée depuis le Chrome Store à partir d’[ici](https://chromewebstore.google.com/detail/horizon-webrtc-web-app-su/emildoafpcgihdmhphelfhghioccllfi?pli=1). 
+ **Prise en charge du navigateur (3 versions les plus récentes)**
  + Google Chrome
  + Microsoft Edge (Chromium)
+ **Configuration du serveur Omnissa** : le kit SDK Omnissa Horizon n’est pas activé par défaut. L’administrateur système doit configurer les paramètres de registre suivants dans la machine virtuelle Omnissa Horizon Agent (de préférence via l’éditeur de registre [regedit]) :
  + **Ouverture de l’éditeur de registre**
    + Pour Windows :
      + Appuyez sur **Windows \$1 R**.
      + Tapez **regedit** et appuyez sur **Entrée**.
  + Créez le/Accédez au chemin de registre suivant :

    ```
    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
    ```

  Après l’installation de l’agent Omnissa, les processus html5server.exe et wsnm.exe sont toujours exécutés dans le Gestionnaire des tâches, quel que soit le statut d’activation du kit SDK. L’image suivante illustre le processus html5server.exe en cours d’exécution dans le Gestionnaire des tâches.   
![\[Gestionnaire des tâches, processus html5server.exe en cours d’exécution.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/omnissa-1.png)

  L’image suivante illustre le processus wsnm.exe en cours d’exécution dans le Gestionnaire des tâches.   
![\[Gestionnaire des tâches, processus wsnm.exe en cours d’exécution.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/omnissa-2.png)
+ **Résolution des problèmes**
  + Le fichier journal Omnissa se trouve à l’adresse suivante :

    ` %tmp%\omnissa-{username}\horizon-html5Client-{pid}.log`
**Note**  
Le `{pid}` désigne l’ID de processus « horizon-protocol.exe » d’Horizon Client, qui se trouve dans le Gestionnaire des tâches.
  + Paramètres de registre pour une journalisation améliorée

    Pour activer la journalisation détaillée à des fins de résolution des problèmes, ajoutez les entrées de registre suivantes :

    ```
    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
    ```

    Ces paramètres de registre permettent une journalisation détaillée qui facilite le diagnostic des problèmes liés à l’intégration de la VDI Omnissa.
+ **Configurations de la mise en réseau et du pare-feu**
  + **Configuration de la VDI Omnissa**

    L’administrateur doit autoriser le serveur Omnissa à accéder au trafic Amazon Connect TCP/443 vers les domaines mentionnés dans le schéma ci-dessous. Consultez la rubrique [Configuration de votre réseau](ccp-networking.md) pour cette configuration.
  + **Configuration de la station de travail de l’agent**

    Cette solution nécessite la connexion média entre le client léger de l’agent et Amazon Connect. Suivez la rubrique [Configuration de votre réseau](ccp-networking.md) pour autoriser le trafic entre la machine de l’agent et le port UDP 3478 d’Amazon Connect Softphone Media.

     Le schéma suivant illustre l’utilisation du port UDP 3478.  
![\[Schéma illustrant l’utilisation du port UDP 3478.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/omnissa-3.png)

## Changements de code requis sur votre CCP personnalisé
<a name="omnissa-required-initccp-changes"></a>

Pour activer l’optimisation audio dans l’environnement VDI Omnissa, vous devez configurer votre CCP personnalisé avec les modifications suivantes.

1. Ajoutez l’extrait de code suivant avant l’initialisation du CCP. Il permet de gérer l’identification des fenêtres pour le CCP, ce qui est particulièrement important lorsque les agents ouvrent plusieurs fenêtres. Il ajoute un horodatage et un marqueur « Active Softphone Tab » pour faciliter l’identification de la fenêtre CCP active.

   ```
   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. Ajoutez le paramètre de plateforme VDI dans votre configuration initCCP. Cela permet d’activer la redirection audio.

   ```
   softphone: {
       allowFramedSoftphone: true,  
       VDIPlatform: "OMNISSA"
   }
   ```
**Important**  
Lorsque le paramètre `VDIPlatform: "OMNISSA"` est défini, le CCP ne revient pas à l’audio standard du navigateur Web en cas d’échec de l’optimisation audio Omnissa. Autrement dit :  
Les appels échouent si un agent accède au CCP en dehors de la machine virtuelle Omnissa.
Les développeurs CCP doivent déterminer si le CCP s’exécute dans la machine virtuelle Omnissa avant de définir ce paramètre.
**Options d’implémentation** :  
Utilisez des chemins d’URL distincts pour les accès Omnissa et non Omnissa.
Déterminez l’environnement à l’aide de paramètres d’URL.
Implémentez une API pour déterminer la configuration correcte en fonction du contexte utilisateur.

## Vérification du flux de média entre le client léger et Amazon Connect pendant l’appel
<a name="verify-omnissa"></a>

1. Assurez-vous que l’extension de navigateur WebRTC Omnissa Horizon est activée et à l’état Prête.

1. Vérifiez l’icône de l’extension dans la barre d’outils de votre navigateur :

   1. L’icône bleue indique l’état Prête et le bon fonctionnement.

   1. L’icône grise indique l’état Non prête et les problèmes potentiels.

   L’image suivante montre à quoi ressemble l’extension de navigateur WebRTC Omnissa Horizon lorsqu’elle est activée et à l’état Prête.  
![\[Extension de navigateur WebRTC Omnissa Horizon lorsqu’elle est activée.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/omnissa-4.png)

1. Vérifiez le statut du processus :

   1. Ouvrez le Gestionnaire des tâches.

   1. Vérifiez que les processus html5server.exe et wsnm.exe sont en cours d’exécution.

   1. Assurez-vous que ces processus continuent de s’exécuter pendant les appels. Si l’un des processus se bloque, la fonctionnalité VDI échoue.

1. Testez le flux audio :

   1. Réalisation d’un appel de test

   1. Vérifiez l’optimisation audio en désactivant l’accès au microphone dans le navigateur de la machine virtuelle. Les appels devraient continuer à fonctionner, car l’audio est traité localement.

   1. Vérifiez s’il y a des problèmes de latence ou de qualité audio.

1. À l’aide de Wireshark, vérifiez :

   Wireshark est un analyseur de paquets réseau gratuit et open source. Pour plus d’informations, consultez le [site Web](https://www.wireshark.org/) de Wireshark.

   1. Téléchargez Wireshark [ici](https://www.wireshark.org/download.html). 

   1. Une fois Wireshark installé, ouvrez-le sur un client léger et commencez à surveiller votre réseau local.

   1. Connectez-vous à un appel, puis saisissez le filtre suivant dans la barre de filtre en haut :

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

   1. Vérifiez que vous pouvez voir le flux de paquets multimédia entre la machine de l’agent et Amazon Connect. 

   1. Si aucun paquet n’est visible :
      + Vérifiez la connectivité réseau et les règles de pare-feu.
      + Vérifiez les paramètres d’optimisation audio.
**Note**  
La plage d’adresses IP indiquée ci-dessus concerne la région AWS USA Est (Virginie du Nord). Pour obtenir les plages d’adresses IP des autres régions, consultez [Configuration de votre réseau](ccp-networking.md).  
L’image suivante illustre les plages d’adresses IP pour .  

![\[Extension de navigateur WebRTC Omnissa Horizon lorsqu’elle est activée.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/omnissa-5.png)


1. Journalisation de la console

   1. Pour Windows : ouvrez les outils de développement du navigateur (F12).

   1. Recherchez le message suivant relatif à WebRTC confirmant l’initialisation d’Omnissa : R`TC.js is using OmnissaVDIStrategy`

      Voici un exemple de ce à quoi ressemble le message de confirmation : 

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

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

Les configurations de CCP suivantes ne sont pas prises en charge :
+ CCP natif : l’optimisation audio pour le CCP natif n’est pas prise en charge. Le contenu multimédia continue de circuler dans le navigateur à l’intérieur de la machine virtuelle pour les appels traités à l’aide de celui-ci.
+ Adaptateur Salesforce CTI : ne prend pas en charge la détection de la plateforme VDI, ce qui entraîne le routage du contenu multimédia via le navigateur de la machine virtuelle au lieu d’un traitement audio optimisé côté client.

# Utilisez l'espace de travail de l'agent pour optimiser le son pour les ordinateurs de bureau cloud Citrix WorkSpaces, Amazon et Omnissa
<a name="optimize-audio-cdd"></a>

Vous pouvez utiliser l'espace de travail des agents Amazon Connect pour simplifier la fourniture d'expériences vocales de haute qualité dans les WorkSpaces environnements Amazon, Citrix et Omnissa Virtual Desktop Infrastructure (VDI). 

Amazon Connect prend en charge [l'optimisation audio pour les ordinateurs de bureau cloud Amazon WorkSpaces](using-ccp-vdi-workspaces.md), [Citrix](using-ccp-vdi-citrix-step-by-step.md) et [Omnissa](using-ccp-vdi-omnissa-step-by-step.md). Cette optimisation redirige le contenu multimédia depuis le bureau local d’un agent vers Amazon Connect. Elle rationalise l’expérience des agents et améliore la qualité audio en réduisant les sauts de réseau à réseau. Vos agents peuvent tirer parti de ces optimisations audio dans l’Espace de travail de l’agent.

## Points importants à connaître
<a name="optimize-audio-cdd-important-notes"></a>
+ Pour les utilisateurs non SSO, si les agents accèdent à l'espace de travail de l'agent depuis le site Web de l' Amazon Connect administrateur, un paramètre de requête pour le référent sera déjà ajouté à l'URL. L’URL est au format `https://your-instance-url/agent-app-v2?referrer=admin`. Pour former le paramètre de requête de plateforme VDI, supprimez le paramètre de référent de l’URL. (Par exemple, vous pouvez modifier l’URL à l’aide du Bloc-notes.) Ajoutez le paramètre de plateforme VDI directement au chemin `/agent-app-v2` de l’URL.
+ Optimisez toujours l’audio dans l’environnement VDI à l’aide de l’URL mise en signet pour l’Espace de travail de l’agent.
+ Si vous n’utilisez pas l’Espace de travail de l’agent dans un environnement VDI réel, n’ajoutez pas le paramètre de requête VDI.
+ Nous recommandons aux agents de rester sur un seul appareil multimédia pendant un contact dans les environnements VDI. Comme les informations de l’appareil multimédia sont relayées au début d’un contact, si un agent doit changer d’appareil multimédia pendant un contact, il ne peut pas accéder à l’audio de l’appareil mis à jour.

## Comment utiliser l'optimisation audio dans l'espace de travail des agents
<a name="howto-optimize-audio-cdd"></a>

Pour utiliser l'optimisation audio dans l'espace de travail de l'agent, les utilisateurs doivent disposer d'un paramètre de requête dans l'URL avec une valeur pour l'environnement VDI dans lequel l'espace de travail de l'agent est utilisé. Ce processus indique au Panneau de configuration des contacts (CCP) d’effectuer une redirection WebRTC pour les appels provenant de cet environnement VDI spécifique vers l’appareil local utilisé par l’agent.

Pour utiliser un paramètre de requête pour l’environnement VDI, procédez comme suit :

### Utilisation sans connexion basée sur l’authentification unique
<a name="without-sso"></a>

1. Accédez à l'espace de travail de l'agent Amazon Connect et copiez l'URL de l'espace de travail de l'agent dans le Bloc-notes.

1. Ajoutez un paramètre de requête avec la clé `VDIPlatform` et la valeur égale à l’environnement VDI spécifique dont vous disposez. Par exemple :

   1. Pour le bureau cloud Citrix, la valeur du paramètre de requête est `CITRIX`. Le code suivant illustre un exemple d’URL complète : 
      + `https://your-instance-url/agent-app-v2?VDIPlatform=CITRIX`

   1. Pour Amazon WorkSpaces Cloud Desktop, la valeur du paramètre de requête est`AWS_WORKSPACE`. Le code suivant illustre un exemple d’URL complète :
      + `https://your-instance-url/agent-app-v2?VDIPlatform=AWS_WORKSPACE`

   1. Pour le bureau cloud Omnissa, la valeur du paramètre de requête est `OMNISSA`. Le code suivant illustre un exemple d’URL complète :
      + `https://your-instance-url/agent-app-v2?VDIPlatform=OMNISSA`

1. Copiez-collez l’URL dans le navigateur de l’agent. 

1. Nous vous recommandons de mettre en signet cette URL pour tous les agents. Ainsi, les agents pourront y accéder facilement à l’avenir en cliquant simplement sur le lien mis en signet.

### Utilisation avec connexion basée sur l’authentification unique
<a name="with-sso"></a>

1. Si vous utilisez l'authentification unique pour vous connecter directement à l'espace de travail de l'agent Amazon Connect, vous devez modifier l'URL de l'état du relais de votre configuration SSO pour ajouter le paramètre de requête VDI. Pour ce faire, procédez comme suit :

   1. Copiez-collez l’état du relais vous permettant d’accéder à l’Espace de travail de l’agent dans l’état du relais de votre fournisseur d’identité (IdP). 

   1. Voir [des exemples d'état du relais URLs](configure-saml.md#destination-relay). Dans les exemples, ``%2Fagent-app-v2`` est la destination. 

   1. Ajoutez le paramètre `VDIPlatform` avec la valeur appropriée à cet état de relais. À l’aide de l’exemple du lien ci-dessus, l’URL complète de l’état du relais pour l’Espace de travail de l’agent Amazon Connect ressemblerait à ce qui suit :

      1. Dans Citrix Desktop

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

      1. Sur Amazon WorkSpaces

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

      1. Dans Omnissa

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

1. La définition de l'URL `VDIPlatform` dans l'état du relais définit automatiquement l'optimisation audio dans l'espace de travail de l'agent pour l'environnement VDI spécifique utilisé.

   1. Connectez-vous depuis votre IdP et confirmez que le paramètre ``VDIPlatform`` est présent en tant que paramètre de requête.