

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 Connect Customer è 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.

**Importante**  
Per utilizzarla[Rule-based redazione per le registrazioni delle schermate](rule-based-redaction-screen-recording.md), è necessario installare la versione 3.0.2 o successiva dell'applicazione Connect Customer client. Rule-based la redazione richiede inoltre l'estensione del browser Connect Customer su ogni browser utilizzato dagli agenti durante i contatti registrati. Per le istruzioni sulla distribuzione, consulta[Implementa l'estensione del browser](deploy-browser-extension.md).

**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: v3.0.2 (più recente)
+ Data di rilascio: 30 giugno 2026
+ Link per il download: [AmazonConnectClientWin-v3.0.2](https://d4yqf2f7seiym.cloudfront.net/builds/AmazonConnectClientWin-v3.0.2.zip) 
+ Nota sulla versione: questa versione aggiunge il supporto per la redazione basata su regole delle registrazioni delle schermate degli agenti.

Il collegamento sopra riportato consente di scaricare il file **AmazonConnectClientWin- [versione] .zip**. **Il file zip contiene il. Amazon.Connect.Client.Service.Setup [versione] .msi** file. 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 questo passaggio installa 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 l'istanza Connect Customer è in AWS GovCloud (US-West), è necessario installare la versione 2.0.3 o successiva.
È necessario configurare un elenco consentito di domini Connect Customer autorizzati a comunicare con l'applicazione client. Le registrazioni delle schermate vengono acquisite solo dai domini Connect Customer specificati nella lista consentita.

#### 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 **Amazon AD. Connect.Client.Service**app client sui 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 l'ultima versione del **Amazon.Connect.Client.Service.Setup.msi**file.
+ Scegli il file di installazione.
+ Inserisci l'elenco dei domini consentiti di Connect Customer quando richiesto. 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 il Connect Customer L'applicazione client è in esecuzione e funziona correttamente
<a name="verify-installation"></a>

##### Verifica che l’applicazione sia in esecuzione:
<a name="verify-running"></a>
+ In Task Manager di Windows, verifica la presenza di 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 che **Amazon.Connect.Client.RecordingSession**prende il nome dall'utente che accetta il primo contatto in cui è abilitata la registrazione dello schermo. 

  L'immagine seguente viene **Amazon.Connect.Client.RecordingSession**mostrata 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 la lista consentita dei domini Connect Customer
<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 Comma-separated Connect Customer
+ Caratteri validi per i domini Connect Customer: usa 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 funzione di registrazione dello schermo Connect Customer 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. I seguenti URL configurano l'installazione della Isolated Web App e dell'estensione del browser Chrome e puoi impostarli per l'aggiornamento automatico tramite la configurazione JSON del manifesto Web.

### 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. Accedi 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 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 la **configurazione gestita** per consentire l'elenco dei domini Connect Customer 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 effettivo dell'istanza Connect Customer.

   ```
   {
   "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)