

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Connect Customer Applicazione client
<a name="amazon-connect-client-app"></a>

La registrazione dello schermo di Amazon Connect è supportata in Windows e Chrome OS. Questa pagina fornisce le istruzioni per il download e l’installazione dell’applicazione di registrazione dello schermo in ogni sistema operativo e i requisiti minimi di sistema per i dispositivi dell’agente.

**Topics**
+ [Windows](#windows-client)
+ [Chrome OS](#chrome-os)

## Windows
<a name="windows-client"></a>

### Version information (Informazioni relative alla versione)
<a name="version-info"></a>
+ Versione: v2.0.3 (più recente)
+ Data di rilascio: 16 gennaio 2025
+ Link per il download: [AmazonConnectClientWin-v2.0.3](https://d4yqf2f7seiym.cloudfront.net/builds/AmazonConnectClientWin-v2.0.3.zip) 
+ Nota di rilascio: questa versione supporta i AWS GovCloud (US) clienti e presenta miglioramenti della sicurezza.

Il link sopra riportato consente di scaricare il file **AmazonConnectClientWin- [versione] .zip.** Il file zip contiene il file **Amazon.Connect.Client.Service.Setup.[versione].msi**. Per le istruzioni di installazione, consulta [Abilitazione della registrazione dello schermo](enable-sr.md).

Per ricevere una notifica in caso di aggiornamento dell'applicazione Connect Customer client, consigliamo di abbonarsi al feed RSS di questa guida per amministratori. Scegli il link **RSS** presente sotto il titolo di questa pagina (accanto al link PDF).

### Istruzioni per l’installazione del client
<a name="client-install"></a>

In questa fase installi il file **Amazon.Connect.Client.Service** sul desktop dell’agente o nell’ambiente virtuale utilizzato dall’agente. Questa è l’applicazione client Connect Customer .

**Nota**  
In caso di sistema operativo Windows multisessione, esegui il programma di installazione solo una volta nel computer. La funzionalità di registrazione dello schermo su sistema operativo multisessione Windows è supportata solo dalla versione 2.0.0 e successive.
Se la tua istanza Amazon Connect è in AWS GovCloud (Stati Uniti occidentali), devi installare la versione 2.0.3 o successiva.
È necessario configurare un elenco di domini Amazon Connect consentiti che sono autorizzati a comunicare con l’applicazione client. Le registrazioni dello schermo vengono acquisite solo dai domini Amazon Connect specificati in tale elenco.

#### Installazione programmatica mediante strumenti di distribuzione software
<a name="programmatic-installation"></a>
+ Scarica la versione più recente del file **Amazon.Connect.Client.Service.Setup.msi**.
+ Utilizza il meccanismo di distribuzione del software della tua organizzazione, ad esempio Software Center, per installare l’app client **Amazon.Connect.Client.Service** nei desktop degli agenti.
+ Esegui la distribuzione utilizzando il sistema di distribuzione del software aziendale dell’organizzazione come Microsoft System Center Configuration Manager, SCCM o altri strumenti di implementazione automatica.
+ Includi il parametro `ALLOWED_CONNECT_DOMAINS` utilizzando la sintassi seguente:

  ```
  msiexec /i Amazon.Connect.Client.Service.Setup.msi ALLOWED_CONNECT_DOMAINS="connect-dev-instance.my.connect.aws,connect-prod-instance.my.connect.aws"
  ```

#### Installazione manuale
<a name="manual-installation"></a>
+ Scarica la versione più recente del file **Amazon.Connect.Client.Service.Setup.msi**.
+ Fai doppio clic sul file di installazione.
+ Quando richiesto, inserisci l’elenco dei domini consentiti di Amazon Connect. L’immagine seguente mostra un esempio di come specificare un dominio nell’elenco dei domini consentiti nella finestra di dialogo **Configura impostazioni di installazione**. Per altri esempi, consulta le *Linee guida per specificare l’elenco dei domini consentiti di Amazon Connect* di seguito.  
![Finestra di dialogo Configura impostazioni di installazione.](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/domain-allowlist-windows.png)
+ Per completare l’installazione, seleziona **Installa**.

#### Verifica che l'applicazione Connect Customer client sia in esecuzione e funzioni correttamente
<a name="verify-installation"></a>

##### Verifica che l’applicazione sia in esecuzione:
<a name="verify-running"></a>
+ In Windows Task Manager controlla che sia presente un processo in background denominato **Amazon.Connect.Client.Service**. Questa è l'applicazione Connect Customer client.
+ In Task Manager di Windows, in **Processi degli utenti**, verifica la presenza di un altro processo denominato **Amazon.Connect.Client. RecordingSession**dopo che l'utente ha accettato il primo contatto in cui è abilitata la registrazione dello schermo. 

  L'immagine seguente mostra **Amazon.Connect.Client. RecordingSession**in Task Manager.  
![Amazon.Connect.Client. RecordingSession in Task Manager.](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/taskmanager.png)

##### Per verificare che l’applicazione funzioni correttamente e crei i file di log:
<a name="verify-functioning"></a>

1. Accedere alla seguente directory: `C:\ProgramData\Amazon\Amazon.Connect.Client.Service\logs`

1. Apri i file di log presenti nella directory.

1. Se l’installazione è riuscita, i file di log contengono la riga seguente: `Checking that services are still running, result : true`

1. Accedere alla seguente directory: `%USERPROFILE%\AppData\Local\Amazon\Amazon.Connect.Client.RecordingSession\Logs`

1. Apri i file di log presenti nella directory.

1. Se l’installazione è riuscita, i file di log contengono la riga seguente: `Session initiation completed with result: True`

#### Linee guida per specificare l’elenco dei domini consentiti di Amazon Connect
<a name="domain-allowlist-guidelines"></a>

Assicurati di rispettare le seguenti linee guida quando inserisci domini nella casella **Domini di connessione consentiti**. In caso contrario, l’installazione avrà esito negativo.
+ Formato: domini Amazon Connect separati da virgole
+ Caratteri validi per i domini di Amazon Connect: utilizza solo A-Z, a-z, 0-9, trattino (-), punto (.)
+ I prefissi di protocollo come https://o http:// non sono richiesti.
+ Restrizioni:
  + Massimo 500 voci di dominio
  + Massimo 256 caratteri per voce di dominio
  + Lunghezza totale di input massima di 128.000 caratteri

Di seguito sono riportati alcuni esempi di come specificare il dominio.

##### Corretto
<a name="correct-examples"></a>
+ domain1.my.connect.aws,domain2.my.connect.aws
+ ddomain-1.my.connect.aws, 1-domain.my.connect.aws
+ domain-12.my.connect.aws

##### Errato
<a name="incorrect-examples"></a>
+ \_123domain.foo
+ domain:2.foo
+ \*domain.my.connect.aws
+ https://domain1.my.connect.aws
+ \*.my.connect.aws

## Chrome OS
<a name="chrome-os"></a>

La funzionalità di registrazione dello schermo di Amazon Connect su ChromeOS richiede due componenti:
+ App web isolata
+ Estensione del browser Google Chrome

L’installazione di questi componenti sui dispositivi Chrome degli agenti può essere eseguita tramite la console di amministrazione di Google Enterprise. Le estensioni URLs per configurare l'installazione della Isolated Web App e del browser Chrome sono fornite di seguito e possono essere impostate per l'aggiornamento automatico tramite la configurazione del web manifest JSON.

### Posizione per il download e istruzioni di installazione
<a name="download-install"></a>

Completa i seguenti passaggi nella console di amministrazione di Google Enterprise. Applica la policy a tutti i dispositivi degli agenti in cui è necessario abilitare la funzionalità di registrazione dello schermo.

#### Installa l’app web isolata
<a name="isolated-web-app"></a>
+ ID del pacchetto web: `ajbye5keylrcyakugr3zttu6f524eoamjc7mc6ubw3x3547xu3hxqaacai`
+ Aggiorna l’URL manifesto: `https://screenrecording.connect.aws/chromeos/amazon-connect-client-iwa/releases/update_manifest.json`

**Per installare l’app web isolata**

1. Vai al [Google Admin Portal](https://admin.google.com) (https://admin.google.com) e accedi con le tue credenziali di amministratore aziendale di Google.

1. Seleziona **Aggiungi un’app web isolata**.

1. Fai doppio clic sul file e sul lato destro della pagina scegli **Salva**.
   + ID del pacchetto web: `ajbye5keylrcyakugr3zttu6f524eoamjc7mc6ubw3x3547xu3hxqaacai`
   + Aggiorna l'URL del manifesto: https://screenrecording.connect. aws/chromeos/amazon-connect-client-iwa/releases/update\_manifest.json

   L’immagine seguente mostra un esempio della finestra di dialogo **Aggiungi un’app web isolata** che è stata completata.  
![Finestra di dialogo Aggiungi un’app web isolata completata.](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/addisolatedwebapp.png)

1. Configura la **policy di installazione** su `Force Install + Pin to ChromeOS Taskbar` e modifica **Launch on Login** su `Force Launch and Prevent Closing` per assicurarti che l’app web isolata venga avviata automaticamente quando viene effettuato l’accesso a un computer che viene riavviato.  
![Sezioni Policy di installazione e Launch on login.](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/installationpolicy.png)

1. Configura **Configurazione gestita** per consentire l’inserimento nell’elenco dei domini Amazon Connect che sono autorizzati ad avviare la registrazione dello schermo sui computer degli agenti. L’immagine seguente mostra un esempio della scheda **Configurazione gestita**.   
![Sezione Configurazione gestita.](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/managedconfiguration.png)
   + Il nome chiave DEVE essere `allowListedDomain`. I nomi di dominio non devono includere percorsi, stringhe di query o barre finali (/).
   + Sostituisci `your-instance-alias-*` con l’alias dell’istanza Amazon Connect corrente.

   ```
   {
   "allowListedDomain": [
   "https://your-instance-alias-1.my.connect.aws",
   "https://your-instance-alias-2.my.connect.aws"]
   }
   ```

1. Completa i seguenti passaggi per configurare l’app web isolata per consentire le autorizzazioni Direct Socket, Screen recording e Window management: 
   + Passa a **Devices**, **Chrome**, **Web capabilities**, **Add Origin**.
   + Immetti `ajbye5keylrcyakugr3zttu6f524eoamjc7mc6ubw3x3547xu3hxqaacai`, quindi seleziona **Save**.

   L’immagine seguente mostra dove si trovano i dispositivi, ChromeS e le funzionalità web nel menu di navigazione a sinistra di Chrome.   
![Menu di navigazione a sinistra in Chrome OS.](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/allorigins.png)

L’immagine seguente mostra la posizione di **Direct sockets**, **Screen recording** e **Window management** nella pagina delle funzionalità web.

![La posizione delle funzionalità web Direct sockets, Screen recording e Window management.](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/directsockets.png)


#### Installazione dell’estensione del browser Google Chrome
<a name="chrome-extension"></a>
+ ID estensione: cjmichfmnimgeoadokmeaiclklkdccod
+ URL personalizzato: `https://screenrecording.connect.aws/chromeos/amazon-connect-extension/releases/updates.xml`

**Per installare l’estensione del browser Google Chrome**

1. Vai a **Add Chrome app or extension by ID**, come mostrato nella figura seguente.  
![Opzione Add Chrome app or extension by ID nella barra di navigazione a sinistra.](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/appandextensions.png)

1. In **Add Chrome app or extension by ID**, scegli **From a custom URL** e inserisci le seguenti informazioni:
   + ID estensione: `cjmichfmnimgeoadokmeaiclklkdccod`
   + URL personalizzato: `https://screenrecording.connect.aws/chromeos/amazon-connect-extension/releases/updates.xml`  
![Finestra di dialogo Add Chrome app or extension by ID, opzione From a custom URL.](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/chromeapp.png)

1. Configura **Installation Policy** per **Force Install**, quindi scegli **Save**, come mostrato nell’immagine seguente.  
![L’opzione Installation Policy è impostata su Force install.](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/forceinstall.png)