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à.
# Utilizzo dell’autenticazione del chiamante in tempo reale con Voice ID in Amazon Connect
**Nota**
Avviso di fine del supporto: il 20 maggio 2026, AWS terminerà il supporto per Amazon Connect Voice ID. Dopo il 20 maggio 2026, non potrai più accedere a Voice ID sulla console Amazon Connect, accedere alle funzionalità Voice ID sul sito Web di Amazon Connect amministrazione o nel Pannello di controllo dei contatti o accedere alle risorse Voice ID. Per ulteriori informazioni, consulta [Fine del supporto di Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
Amazon Connect Voice ID fornisce funzionalità di autenticazione del chiamante e rilevamento delle frodi in tempo reale, rendendo le interazioni vocali nei contact center più sicure ed efficienti. Voice ID usa il machine learning per verificare l'identità dei clienti legittimi analizzando le caratteristiche vocali uniche di un chiamante. I contact center hanno così a disposizione un ulteriore livello di sicurezza che non dipende dalle risposte del chiamante a diverse domande di sicurezza e semplifica la registrazione e la verifica dei clienti senza modificare il flusso naturale della conversazione. Voice ID consente anche di rilevare in tempo reale i truffatori che spesso prendono di mira il contact center, riducendo così le perdite dovute alle frodi.
Amazon Connect Voice ID permette di eseguire le operazioni seguenti:
+ Registrare passivamente i clienti per l'autenticazione vocale senza richiedere loro di ripetere una parola o una frase specifica.
+ Eseguire la migrazione dei clienti a Voice ID registrandoli in batch.
+ Verificare l'identità dei clienti registrati analizzando le loro caratteristiche vocali uniche.
+ Rilevare i truffatori in base a una lista di controllo creata.
+ Rilevare i casi di spoofing vocale.
## Modalità di funzionamento di Voice ID
### Registrazione dei clienti
1. Quando un cliente chiama per la prima volta, l'agente verifica l'identità del chiamante usando le misure di sicurezza esistenti, ad esempio chiedendo il cognome da nubile della madre o un codice OTP (One-Time Password) inviato tramite SMS. In questo modo, solo i clienti legittimi vengono registrati in Voice ID.
1. Voice ID inizia ad ascoltare il cliente che parla dopo che quest'ultimo raggiunge il blocco [Imposta ID voce](set-voice-id.md) in cui è abilitata la funzionalità Voice ID. Voice ID ascolta la chiamata fino a quando non si verifica una delle situazioni seguenti:
+ L'audio ricevuto è sufficiente per valutare il parlante per l'autenticazione, la segnalazione di una frode o la registrazione (se richiesto). A tale scopo sono necessari 30 secondi di parlato, esclusi i silenzi.
+ La chiamata termina.
1. Voice ID crea quindi l'impronta vocale per la registrazione. Un'impronta vocale è una rappresentazione matematica che cattura implicitamente gli aspetti unici della voce di un individuo, come il ritmo, il tono, l'intonazione e il volume del parlato.
Per la registrazione in Voice ID, non è necessario che il chiamante pronunci o ripeta frasi specifiche.
### Autenticazione dei clienti
1. Quando un cliente registrato chiama di nuovo, la sua identità viene verificata tramite un'interazione con un sistema di risposta vocale interattiva (IVR) o durante l'interazione con un agente.
Per impostazione predefinita, Voice ID necessita di 10 secondi di parlato da parte del chiamante per l'autenticazione e ciò può avvenire come parte di una tipica interazione del cliente nel sistema lVR o con l'agente (ad esempio "puoi dirmi nome e cognome?" e "qual è il motivo della chiamata?"). È possibile modificare la quantità di parlato richiesta usando la proprietà [Tempo di risposta di autenticazione](set-voice-id.md#set-voice-id-properties-authentication-response-time) nel blocco [Imposta ID voce](set-voice-id.md).
1. Voice ID usa l'audio per generare l'impronta vocale del chiamante, la confronta con l'impronta vocale registrata corrispondente all'identità dichiarata e restituisce un risultato di autenticazione.
Per ulteriori informazioni sull'esperienza dell'agente, consulta [Registrazione dei chiamanti in Voice ID nel Contact Control Panel (CCP)](use-voiceid.md).
## Quantità di parlato necessaria per la registrazione e l'autenticazione
+ Registrazione: 30 secondi di parlato netto del cliente (esclusi i silenzi) per creare un'impronta vocale e registrare un cliente.
+ Verifica: per impostazione predefinita, 10 secondi di parlato netto del cliente per verificare che la voce appartenga all'identità dichiarata. Il parlato può provenire dall'interazione con un sistema IVR o con un agente. È possibile modificare la quantità di parlato richiesta usando la proprietà [Tempo di risposta di autenticazione](set-voice-id.md#set-voice-id-properties-authentication-response-time) nel blocco [Imposta ID voce](set-voice-id.md).
## Registrazione in batch
Puoi iniziare subito a usare la biometria registrando in batch i clienti che hanno già acconsentito al suo utilizzo. Utilizzando le registrazioni audio archiviate nel tuo bucket S3 e un file di input JSON che fornisce l'identificatore dell'altoparlante e un collegamento alle registrazioni audio, puoi richiamare il batch Voice ID. APIs
Per ulteriori informazioni, consulta [Iscrizione in batch in Amazon Connect Voice ID utilizzando i dati audio di chiamate precedenti](voiceid-batch-enrollment.md).
## Rilevamento di truffatori noti
Per configurare il rilevamento dei truffatori in tempo reale sono necessari i passaggi seguenti:
1. [Crea una nuova lista di controllo](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_CreateWatchlist.html) per archiviare i truffatori noti. In alternativa, usa la lista di controllo predefinita creata al momento dell'abilitazione di Voice ID.
1. [Registra i truffatori](voiceid-fraudster-watchlist.md) nella nuova lista di controllo o in quella predefinita.
1. Nel blocco [Imposta ID voce](set-voice-id.md) specifica la lista di controllo da usare.
Quando uno dei truffatori presenti nella lista di controllo specificata nel flusso chiama il contact center, Voice ID analizza l'audio della chiamata per restituire un punteggio di rischio e un risultato. Questo punteggio indica il livello di corrispondenza tra l'impronta vocale del chiamante e quella del truffatore nella lista di controllo. Voice ID necessita di 10 secondi di audio per valutare l'audio della chiamata e determinare eventuali rischi di frode da parte di truffatori noti.
### Lista di controllo predefinita
Al momento della creazione del dominio Voice ID, Voice ID crea una lista di controllo di truffatori predefinita per il dominio. Il nome e la descrizione della lista di controllo di truffatori predefinita vengono crittografati usando la chiave KMS fornita nel dominio e salvati in Voice ID.
Se non fornisci il valore watchlistId per la lista di truffatori da usare per il rilevamento delle frodi o la registrazione dei truffatori, Voice ID usa la lista di controllo di truffatori predefinita.
Non è possibile aggiornare i metadati della lista di controllo di truffatori predefinita, ma puoi associare truffatori alla lista o annullare l'associazione.
**Nota**
Se il dominio Voice ID è stato creato prima di marzo 2023 (mese del lancio delle liste di controllo di truffatori): è stata creata una lista di controllo predefinita in cui sono stati inseriti tutti i truffatori esistenti.
## Rilevamento di casi di spoofing vocale
1. Quando un potenziale truffatore tenta di effettuare lo spoofing dell'audio del chiamante tramite riproduzione dell'audio o sintesi vocale, Voice ID restituisce un punteggio di rischio e un risultato per indicare la probabilità che la voce sia stata simulata tramite spoofing.
1. Lo spoofing vocale è abilitato solo quando abiliti la funzionalità di rilevamento delle frodi nel flusso di contatti. I punteggi di spoofing vocale non vengono restituiti quando è abilitata solo l’autenticazione dei parlanti.
1. Voice ID necessita di 10 secondi di audio per valutare l'audio della chiamata e determinare eventuali rischi di frode tramite spoofing vocale.
## Quali dati vengono archiviati?
Voice ID archivia i file audio della voce del parlante, le impronte vocali e gli identificatori del parlante. Questi dati vengono crittografati usando una chiave KMS fornita dall'utente.
Se abiliti il rilevamento dei truffatori in una lista di controllo, Voice ID archivia anche l'audio e le impronte vocali dei truffatori. Per ulteriori informazioni, consulta [Dati gestiti da Amazon Connect](data-handled-by-connect.md).
# Fine del supporto per Amazon Connect Voice ID
Dopo un’attenta valutazione, abbiamo deciso di interrompere il supporto per Amazon Connect Voice ID a partire dal 20 maggio 2026. Amazon Connect Voice ID non accetterà più nuovi clienti a partire dal 20 maggio 2025. In qualità di cliente esistente con un account registrato al servizio prima del 20 maggio 2025, puoi continuare a utilizzare le funzionalità di Amazon Connect Voice ID. Dopo il 20 maggio 2026, non potrai più utilizzare Amazon Connect Voice ID.
In questa pagina sono fornite istruzioni e best practice per gli amministratori IT e gli utenti di Amazon Connect per la transizione da Voice ID a soluzioni alternative per soddisfare le tue esigenze aziendali, Ciò potrebbe includere soluzioni AWS dei partner disponibili sul AWS Marketplace, come [Pindrop®](https://aws.amazon.com/marketplace/pp/prodview-f7rqlwjby3er4), o do-it-yourself soluzioni con. AWS End User Messaging SMS
## Do-it-yourself soluzioni con AWS End User Messaging SMS
Puoi migliorare la sicurezza del contact center abilitando l'autenticazione basata su One-Time-Pin (OTP) per il tuo contact center con AWS End User Messaging SMS. Puoi fare riferimento a un esempio di soluzione per abilitare OTPs l'utilizzo AWS End User Messaging SMS per crearne uno per il tuo contact center. Per ulteriori informazioni su questa soluzione, consulta il seguente post di blog: [Build a Secure One Time Password Architecture with AWS](https://aws.amazon.com/blogs/messaging-and-targeting/build-a-secure-one-time-password-architecture-with-aws/). Per ulteriori informazioni su AWS End User Messaging SMS, consulta [What is AWS End User Messaging SMS?](https://docs.aws.amazon.com/sms-voice/latest/userguide/what-is-sms-mms.html)
## Gestione dei dati di Voice ID
Puoi ottenere informazioni su tutti i domini Voice ID presenti nella tua AWS contabilità utilizzando l'`ListDomains`API Voice ID in combinazione con l'`DescribeDomain`API. Per ulteriori informazioni sulla gestione dei tuoi domini Amazon Connect Voice ID, consulta [Gestire i domini Amazon Connect Voice ID](voiceid-domain-operations.md).
Per un dominio Voice ID specifico, puoi scaricare i dati sui chiamanti registrati utilizzando l’API `ListSpeakers` e sui truffatori registrati utilizzando l’API `ListFraudsters`. Per ulteriori informazioni sulla gestione di interlocutori e truffatori, consulta [Gestione degli altoparlanti, della lista di controllo e delle frodi con Amazon Connect Voice ID APIs](voiceid-speaker-fraudster-management-apis.md). Puoi assicurarti che tutti i dati dei tuoi clienti su Voice ID vengano eliminati utilizzando l’API `DeleteDomain` di Voice ID. È necessario eseguire questa operazione per ogni dominio Voice ID in ogni AWS regione e per ogni account.
# Domini Voice ID in Amazon Connect Voice ID
**Nota**
Avviso di fine del supporto: il 20 maggio 2026, AWS terminerà il supporto per Amazon Connect Voice ID. Dopo il 20 maggio 2026, non potrai più accedere a Voice ID sulla console Amazon Connect, accedere alle funzionalità Voice ID sul sito Web di Amazon Connect amministrazione o nel Pannello di controllo dei contatti o accedere alle risorse Voice ID. Per ulteriori informazioni, consulta [Fine del supporto di Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
Quando abiliti Amazon Connect Voice ID, crei un dominio Voice ID: un container per tutti i dati Voice ID, come gli identificatori dei parlanti (che fungono da identificatore del cliente), le impronte vocali, l'audio del cliente usato per creare le impronte vocali di registrazione e gli stati di registrazione (registrato, disattivato, e così via) associati agli identificatori dei parlanti. Per rilevare i truffatori in una lista di controllo, il dominio Voice ID archivia gli identificatori dei truffatori, le impronte vocali e l'audio usato per creare le impronte vocali.
Di seguito sono riportate le linee guida per la creazione di domini Voice ID:
+ Ogni istanza Amazon Connect può essere associata a un solo dominio Voice ID.
+ Ogni dominio Voice ID può essere associato a più istanze Amazon Connect. Ciò consente di usare gli stessi dati dei clienti archiviati in più istanze Amazon Connect.
+ È possibile creare più domini, ma questi non condividono i dati dei clienti tra loro.
+ È consigliabile creare un nuovo dominio Voice ID da associare a un'istanza Amazon Connect quando:
+ Si sta abilitando Voice ID per la prima volta nell'account in una regione AWS .
+ Ci si vuole assicurare di isolare i domini Voice ID usati per gli ambienti di test e produzione.
+ È consigliabile usare un dominio Voice ID esistente quando:
+ Si desidera usare lo stesso set di chiamanti e truffatori registrati in diverse istanze Amazon Connect (che possono appartenere a diversi team del servizio clienti)
+ Si desidera usare lo stesso ambiente di test in diverse istanze Amazon Connect di test.
**Nota**
Solo i domini Voice ID esistenti nella stessa regione nell'account Amazon Connect possono essere condivisi tra istanze Amazon Connect in tale regione.
+ È possibile modificare l'associazione dell'istanza Amazon Connect dal dominio corrente a un nuovo dominio in qualsiasi momento, scegliendone uno diverso.
+ Per eliminare un dominio Voice ID, utilizza l'API [DeleteDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteDomain.html)Voice ID. `DeleteDomain`soft elimina il dominio. Amazon Connect attende 30 giorni prima di cancellare completamente i dati del dominio. Durante questo periodo, Voice ID è disabilitato per tutte le istanze Amazon Connect a cui è associato. Per ripristinare un dominio durante questa finestra, invia un Supporto ticket e fornisci l'ID del dominio. L'ID del dominio è indicato nella sezione Voice ID della console Amazon Connect, come illustrato nell'esempio seguente:
![\[Sezione Voice ID della console Amazon Connect che mostra il campo ID del dominio necessario per il ripristino del dominio.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/voiceid-domain.png)
L'eliminazione di un dominio Voice ID elimina tutti i dati dei clienti archiviati, come registrazioni audio, impronte vocali e identificatori dei parlanti, nonché tutte le liste di controllo di truffatori gestite.
## Stato della registrazione
Voice ID archivia tre diversi stati di registrazione per un parlante: `ENROLLED`, ` OPTED_OUT` e `EXPIRED`. Puoi richiamare lo stato di questi altoparlanti utilizzando [Amazon Connect Voice ID APIs](https://docs.aws.amazon.com/voiceid/latest/APIReference/) e utilizzando i blocchi del flusso di contatti per intraprendere le azioni appropriate.
+ `ENROLLED`: quando un nuovo chiamante viene registrato in Voice ID, Voice ID crea una nuova impronta vocale e imposta lo stato del parlante su `ENROLLED`. Anche se registri nuovamente lo stesso chiamante in Voice ID, lo stato rimane comunque `ENROLLED`.
+ `OPTED_OUT`: Se un chiamante non fornisce il consenso alla registrazione ai dati biometrici, puoi disattivarlo (nel Pannello di controllo dei contatti) o utilizzare. APIs Voice ID crea una nuova voce per questo chiamante e imposta lo stato del parlante su `OPTED_OUT`. Voice ID non genera alcuna impronta vocale né archivia registrazioni audio per il parlante. Le future richieste di registrazione per il parlante vengono rifiutate a meno che la relativa voce non venga eliminata.
+ `EXPIRED`: se non si accede all'impronta vocale di un chiamante o non la si aggiorna per tre anni, Voice ID cambia lo stato in `EXPIRED` e non è più possibile eseguire le autenticazioni per questo chiamante. È possibile registrare nuovamente il chiamante o eliminarlo da Voice ID.
## Parlanti scaduti
Ai fini della conformità BIPA, Voice ID fa scadere automaticamente i parlanti se per tre anni non viene effettuata una registrazione, una nuova registrazione o un'autenticazione.
Per visualizzare l'ultimo accesso di un oratore, guarda l'`lastAccessedAt`attributo restituito da and. `DescribeSpeaker` `ListSpeakers` APIs
Se cerchi di usare l'API `EvaluateSesssion` per autenticare un parlante scaduto, viene restituita una decisione di autenticazione `SPEAKER_EXPIRED`.
Per usare di nuovo il parlante scaduto, è necessario registrarlo nuovamente.
## Identificatori di parlanti e truffatori
Voice ID usa gli identificatori dei parlanti per fare riferimento alle impronte vocali e recuperarle in un dominio Voice ID. È consigliabile usare identificatori che non contengano informazioni di identificazione personale (PII).
Voice ID crea due campi per fare riferimento a un chiamante:
+ `CustomerSpeakerId`: un identificatore fornito dal cliente. Può contenere da 1 a 256 caratteri ed essere composto solo dai caratteri: **a-z**, **A-Z**, **0-9**, **-** e **\$1**
+ `GeneratedSpeakerId`: una stringa alfanumerica univoca di 22 caratteri creata da Voice ID e restituita al momento della registrazione del chiamante.
Gli [altoparlanti Amazon Connect Voice ID APIs](https://docs.aws.amazon.com/voiceid/latest/APIReference/Welcome.html) accettano entrambi i tipi di identificatori degli altoparlanti, ma emettono `GeneratedSpeakerId` nel Voice ID solo flussi di eventi e record di contatti. Se desideri registrare nuovamente il chiamante per ripetere l'impronta vocale, puoi usare lo stesso identificatore `CustomerSpeakerId`.
Analogamente, Voice ID crea identificatori dei truffatori univoci, detti `GeneratedFraudsterID`, per ogni truffatore aggiunto a una lista di controllo del dominio. Voice ID restituisce l'identificatore del truffatore se nel corso di una chiamata viene rilevato un truffatore durante il rilevamento del rischio di frode.
# Nozioni di base su come abilitare Voice ID in Amazon Connect
**Nota**
Avviso di fine del supporto: il 20 maggio 2026, AWS terminerà il supporto per Amazon Connect Voice ID. Dopo il 20 maggio 2026, non potrai più accedere a Voice ID sulla console Amazon Connect, accedere alle funzionalità Voice ID sul sito Web di Amazon Connect amministrazione o nel Pannello di controllo dei contatti o accedere alle risorse Voice ID. Per ulteriori informazioni, consulta [Fine del supporto di Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
## Prima di iniziare
Prima di iniziare, completa le attività seguenti.
**Topics**
+ [
### Concessione delle autorizzazioni richieste
](#enable-voiceid-permissions)
+ [
### Scelta del nome per il dominio Voice ID
](#enable-voiceid-domains)
+ [
### Crea un file AWS KMS key per crittografare i dati archiviati nel dominio
](#enable-voiceid-awsmanagedkey)
### Concessione delle autorizzazioni richieste
È necessario concedere le autorizzazioni richieste a utenti, gruppi o ruoli. Per ulteriori informazioni, consulta [AmazonConnectVoiceIDFullAccess](security_iam_awsmanpol.md#amazonconnectvoiceidfullaccesspolicy).
L'accesso a Voice ID APIs tramite il Contact Control Panel (CCP) è disabilitato per impostazione predefinita.
### Scelta del nome per il dominio Voice ID
Quando abiliti Voice ID, ti viene richiesto di fornire un nome di dominio descrittivo e significativo per te, ad esempio il nome della tua organizzazione, ad esempio *Voice* ID-. ExampleCorp
### Crea un file AWS KMS key per crittografare i dati archiviati nel dominio
Quando abiliti Voice ID, viene richiesto di creare o fornire una [AWS KMS key](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#kms_keys). Tale chiave consente la crittografa dei dati dei clienti archiviati da Voice ID, come file audio, impronte vocali e identificatori dei parlanti.
Step-by-step le istruzioni per creare queste chiavi KMS sono fornite in. [Passaggio 2: creare un nuovo dominio Voice ID e una nuova chiave di crittografia](#enable-voiceid-step2)
I dati a riposo, in particolare i campi in formato libero forniti dall'utente, i file audio e le impronte vocali, vengono crittografati con la chiave KMS scelta. La chiave gestita dal cliente viene creata e gestita dall'utente ed è di sua proprietà. Hai il pieno controllo della chiave KMS (a AWS KMS pagamento).
Quando si effettuano chiamate a Voice ID per scopi diversi da `CreateDomain` o `UpdateDomain`, l'utente che effettua la chiamata necessita delle autorizzazioni `kms:Decrypt` per la chiave associata al dominio. Quando effettua chiamate a `CreateDomain` o `UpdateDomain`, l'utente necessita anche delle autorizzazioni `kms:DescribeKey` e `kms:CreateGrant` per la chiave. Quando crei (o aggiorni) un dominio Voice ID, viene creata una concessione per la chiave KMS in modo che possa essere usata dai processi asincroni di Voice ID (come la registrazione dei parlanti) e dal ruolo collegato al servizio Amazon Connect durante i flussi. Questa concessione include un contesto di crittografia che specifica il dominio a cui è associata la chiave. Per ulteriori informazioni sulle concessioni, consulta [Uso delle concessioni](https://docs.aws.amazon.com/kms/latest/developerguide/grants.html) nella Guida per gli sviluppatori di AWS Key Management Service .
Se crei un dominio e lo associ a una chiave, archivi alcuni dati e quindi cambi la chiave KMS con una chiave diversa, viene avviato un processo asincrono per crittografare nuovamente i vecchi dati con la nuova chiave KMS. Al termine di questo processo, tutti i dati del dominio saranno crittografati con la nuova chiave KMS e potrai ritirare la vecchia chiave in tutta sicurezza. Per ulteriori informazioni, consulta [UpdateDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_UpdateDomain).
**Suggerimento**
Puoi creare chiavi KMS o fornire una chiave KMS esistente a livello di programmazione. Per ulteriori informazioni, consulta [Amazon Connect Voice ID APIs](https://docs.aws.amazon.com/voiceid/latest/APIReference/).
## Passaggio 1: leggere l'accettazione del consenso BIPA
La lettura dell'accettazione del consenso BIPA (Biometric Privacy Act) è un requisito per abilitare Voice ID. È sufficiente eseguire questa operazione una sola volta per account, in tutte le regioni. Non puoi eseguire questo passaggio utilizzando APIs. Per ulteriori informazioni sul BIPA, consulta questo articolo di Wikipedia: [Biometric Information Privacy Act](https://en.wikipedia.org/wiki/Biometric_Information_Privacy_Act).
1. Apri la console Amazon Connect all'indirizzo [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. Nella pagina delle istanze, seleziona l'alias dell'istanza. L'alias dell'istanza è anche il **nome dell'istanza** che appare nell'URL Amazon Connect. L'immagine seguente mostra la pagina **Istanze di contact center virtuali di Amazon Connect**, con un riquadro attorno all'alias dell'istanza.
![\[La pagina delle istanze del contact center virtuale di Amazon Connect, l'alias dell'istanza.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/instance.png)
1. Nel riquadro di navigazione scegli **Voice ID**. Leggi l'accettazione del consenso BIPA e conferma, se sei d'accordo.
![\[Pagina Abilita Voice ID che mostra il pulsante di accettazione del consenso del BIPA (Biometric Information Privacy Act) che gli utenti devono leggere e accettare prima di abilitare Voice ID.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/voiceid-bipa.png)
## Passaggio 2: creare un nuovo dominio Voice ID e una nuova chiave di crittografia
Puoi eseguire questo passaggio utilizzando la console Amazon Connect o Amazon Connect e Voice ID APIs.
------
#### [ Amazon Connect console instructions ]
1. Nella sezione **Configurazione del dominio** scegli **Crea un nuovo dominio**.
![\[Interfaccia di configurazione del dominio con opzioni per creare un nuovo dominio o sceglierne uno esistente.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/voiceid-enable-domain.png)
1. Nella casella **Nome di dominio**, inserisci un nome descrittivo che sia significativo per te, ad esempio il nome della tua organizzazione, ad esempio *VoiceID* -. ExampleCorp
1. In **Crittografia**, crea o inserisci il tuo dominio AWS KMS key per crittografare il tuo dominio Voice ID. Di seguito sono illustrati i passaggi per creare la chiave KMS:
1. Scegli **Crea chiave KMS**.
![\[Sezione di crittografia della pagina di configurazione di Voice ID che mostra il pulsante ‘Crea chiave AWS KMS’ per creare una nuova chiave di crittografia.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/voiceid-create-kms-key.png)
1. Nel browser verrà aperta una nuova scheda per la console del sistema di gestione delle chiavi (KMS). Nella pagina **Configura chiave**, scegli **Simmetrica**, quindi scegli **Avanti.**
![\[Configura la pagina della chiave con il tipo di chiave Simmetrica selezionato per la crittografia e la decrittografia.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-create-kms-key-configure-key.png)
1. Nella pagina **Aggiungi etichette** aggiungi un nome e una descrizione per la chiave KMS e quindi scegli **Avanti**.
1. Nella pagina **Definisci le autorizzazioni per gestire la chiave** scegli **Avanti**.
1. Nella pagina **Definisci le autorizzazioni per utilizzare le chiavi** scegli **Avanti**.
1. Nella pagina **Verifica e modifica la policy della chiave**, scegli **Fine**.
1. Torna alla scheda del browser della console di Amazon Connect, pagina **Voice ID**. Fai clic sulla **AWS KMS key** o toccala per visualizzare la chiave creata in un elenco a discesa. Scegli la chiave creata.
1. Scegli **Abilita Voice ID**.
------
#### [ API instructions ]
1. Chiama l'[CreateDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_CreateDomain.html)API per creare un nuovo dominio Voice ID.
1. Chiama l'[CreateIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateIntegrationAssociation.html)API per associare il dominio Voice ID all'istanza Amazon Connect.
1. Passa l'ARN del dominio Voice ID appena creato nel parametro `IntegrationArn`. Per `IntegrationType` usa `VOICE_ID`.
------
L'abilitazione di Voice ID per l'istanza è stata completata. Sono stati creati gli elementi seguenti:
+ Dominio Voice ID e una lista di controllo di truffatori predefinita che conterrà i truffatori.
+ Una EventBridge regola Amazon gestita nel tuo account. Questa regola viene usata per importare eventi Voice ID per creare record di contatti relativi a Voice ID. Amazon Connect aggiunge inoltre le [autorizzazioni di Voice ID](connect-slr.md) al ruolo collegato al servizio per Amazon Connect.
Nel passaggio 3 verrà configurato il funzionamento di Voice ID nel flusso.
## Passaggio 3: configurare Voice ID nel flusso di contatti
In questo passaggio vengono aggiunti i blocchi richiesti al flusso e viene configurato il funzionamento di Voice ID.
+ [Riproduci comando](play.md): aggiungi questo blocco prima del blocco [Imposta ID voce](set-voice-id.md) per trasmettere correttamente l'audio. Puoi modificarlo per includere un semplice messaggio come "Ti diamo il benvenuto".
+ [Imposta ID voce](set-voice-id.md): dopo il blocco [Riproduci comando](play.md), aggiungi il blocco [Imposta ID voce](set-voice-id.md). Deve trovarsi all'inizio di una chiamata. Usa questo blocco per avviare lo streaming audio ad Amazon Connect Voice ID per verificare l'identità del chiamante, non appena la chiamata viene connessa a un flusso.
Nel blocco **Imposta ID voce** puoi configurare la soglia di autenticazione, il tempo di risposta, la soglia di frode e la lista di controllo di truffatori da usare per rilevare eventuali truffatori noti.
+ [Set contact attributes (Imposta attributi contatti)](set-contact-attributes.md): usa questo blocco per passare l'attributo `CustomerId` a Voice ID. L'attributo `CustomerId` può essere, ad esempio, il numero cliente nel sistema CRM. Puoi creare una funzione Lambda per estrarre l'ID cliente univoco del chiamante dal sistema CRM. Voice ID utilizza questo attributo come `CustomerSpeakerId` per il chiamante.
**Nota**
`CustomerId` può essere un valore alfanumerico. Supporta solo i caratteri speciali \$1 e - (trattino basso e trattino). Non è necessario che sia un identificatore univoco universale (UUID). Poiché Voice ID memorizza le informazioni biometriche per ogni altoparlante, ti consigliamo vivamente di utilizzare un identificatore che non contenga informazioni personali sul campo. CustomerSpeakerId Per ulteriori informazioni, consulta `CustomerSpeakerId` nel tipo di dati [Speaker](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_Speaker.html).
+ [Controlla ID voce](check-voice-id.md): usa questo blocco per controllare la risposta di Voice ID per lo stato di registrazione, l'autenticazione vocale e il rilevamento delle frodi, quindi esegui la ramificazione in base a uno degli stati restituiti.
### Esempio di flusso di Voice ID
**Chiamante non registrato**
1. Quando un cliente chiama per la prima volta, l'attributo `CustomerId` viene passato a Voice ID usando il blocco [Set contact attributes (Imposta attributi contatti)](set-contact-attributes.md).
1. Voice ID cerca `CustomerId` nel suo database. Poiché non è presente, invia un messaggio di risultato **Non registrato**. Il blocco [Controlla ID voce](check-voice-id.md) si ramifica in base a questo risultato e puoi decidere quale deve essere il passaggio successivo. È ad esempio possibile richiedere agli agenti di registrare il cliente per l'autenticazione vocale.
1. Voice ID inizia ad ascoltare il cliente che parla dopo che quest'ultimo raggiunge il blocco [Imposta ID voce](set-voice-id.md) in cui è abilitata la funzionalità Voice ID. Rimane in ascolto fino a quando non accumula 30 secondi di parlato netto o fino a quando la chiamata non termina, a seconda dell'evento che si verifica per primo.
**Chiamante registrato**
1. Alla successiva chiamata del cliente, Voice ID trova il relativo attributo `CustomerId` nel database.
1. Voice ID inizia ad ascoltare l'audio per creare un'impronta vocale. L'impronta vocale creata questa volta viene usata per scopi di autenticazione, in modo che Voice ID possa confrontare se il chiamante è stato registrato in precedenza.
1. L'impronta vocale corrente del chiamante viene confrontata con l'impronta vocale archiviata associata all'identità dichiarata. Viene restituito un risultato in base alla proprietà **Soglia di autenticazione** configurata nel blocco [Imposta ID voce](set-voice-id.md).
1. Dopo aver valutato il parlato, se le impronte vocali sono simili viene restituito il messaggio **Autenticato**. In caso contrario, viene restituito uno degli altri stati.
1. Il contatto viene quindi instradato lungo il ramo appropriato dal blocco [Controlla ID voce](check-voice-id.md).
# Autorizzazioni dei profili di sicurezza per Amazon Connect Voice ID
**Nota**
Avviso di fine del supporto: il 20 maggio 2026, AWS terminerà il supporto per Amazon Connect Voice ID. Dopo il 20 maggio 2026, non potrai più accedere a Voice ID sulla console Amazon Connect, accedere alle funzionalità Voice ID sul sito Web di Amazon Connect amministrazione o nel Pannello di controllo dei contatti o accedere alle risorse Voice ID. Per ulteriori informazioni, consulta [Fine del supporto di Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
+ Per consentire agli utenti di cercare i contatti in base al relativo stato di Voice ID, assegna la seguente autorizzazione **Analisi e ottimizzazione** al loro profilo di sicurezza:
+ **ID voce – Attributi e ricerca**: consente agli utenti di cercare e visualizzare i risultati di Voice ID nella pagina **Dettagli di contatto**.
+ Per concedere agli agenti l'accesso a Voice ID nel Pannello di controllo dei contatti, assegna la seguente autorizzazione al gruppo **Pannello di controllo contatti**:
+ **Voice ID – Accesso**: abilita i controlli nel Pannello di controllo dei contatti per consentire agli agenti di:
+ Visualizzare i risultati dell'autenticazione.
+ Eseguire l'opt-out o la riautenticazione di un chiamante.
+ Aggiornare `SpeakerID`.
+ Visualizzare i risultati del rilevamento delle frodi, rieseguire l'analisi delle frodi (decisione sul rilevamento delle frodi, tipo di frode e punteggio).
**Nota**
La funzionalità di inserimento o aggiornamento di `SpeakerID` non è disponibile con il widget Voice ID predefinito nel Pannello di controllo dei contatti. Per includere l'opzione per l'aggiornamento di `SpeakerID`, implementa l'API [Amazon Connect Streams](https://github.com/aws/amazon-connect-streams) `updateVoiceIdSpeakerId` nel Pannello di controllo dei contatti personalizzato.
L'immagine seguente mostra un esempio di questi controlli nel Pannello di controllo dei contatti:
![\[Contatta il Pannello di controllo (CCP) che mostra i controlli Voice ID, tra cui lo stato di iscrizione, il risultato dell’autenticazione e i pulsanti per l’adesione o la non adesione dei clienti.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/voiceid-ccp-controls.png)
Per informazioni su come aggiungere altre autorizzazioni a un profilo di sicurezza esistente, consulta [Aggiornare i profili di sicurezza in Amazon Connect](update-security-profiles.md).
Per impostazione predefinita, il profilo di sicurezza **amministratore** dispone già delle autorizzazioni per eseguire tutte le attività in Voice ID.
# Cercare e analizzare i risultati dell’autenticazione di Voice ID
**Nota**
Avviso di fine del supporto: il 20 maggio 2026, AWS terminerà il supporto per Amazon Connect Voice ID. Dopo il 20 maggio 2026, non potrai più accedere a Voice ID sulla console Amazon Connect, accedere alle funzionalità Voice ID sul sito Web di Amazon Connect amministrazione o nel Pannello di controllo dei contatti o accedere alle risorse Voice ID. Per ulteriori informazioni, consulta [Fine del supporto di Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
Usa la pagina [Ricerca contatti](contact-search.md) per cercare ed esaminare i risultati relativi allo stato di registrazione, all'autenticazione vocale e al rilevamento di truffatori in una lista di controllo. Con le [autorizzazioni per il profilo di sicurezza](contact-search.md#required-permissions-search-contacts) richieste (**Analisi e ottimizzazione** – **ID voce – Attributi e ricerca - Visualizza**), puoi cercare i risultati di Voice ID usando i seguenti filtri:
+ **Operazioni della persona che parla**: usa questo filtro per cercare i contatti in cui il chiamante è stato registrato in Voice ID o ha scelto l'opt-out di Voice ID.
+ **Risultato dell'autenticazione**: usa questo filtro per cercare i contatti per cui l'autenticazione di Voice ID ha restituito i seguenti risultati:
+ Autenticato
+ Non autenticato
+ Disattivato
+ Senza risultati
+ Non registrato
Se ad esempio desideri cercare tutti i contatti il cui stato di autenticazione è stato restituito come **Non autenticato** o **Disattivato**, seleziona entrambe queste opzioni e scegli **Applica**.
+ **Risultato del rilevamento delle frodi**: usa questo filtro per cercare i contatti in cui l'analisi delle frodi di Voice ID ha restituito i seguenti risultati:
+ Rischio elevato di frode
+ Rischio basso di frode
+ Senza risultati
+ **Motivo del rilevamento delle frodi**: usa questo filtro per cercare i contatti in cui sono stati rilevati specifici meccanismi di rischio di frode:
+ Truffatore noto: la voce del chiamante corrisponde a quella di un truffatore presente nella lista di controllo di truffatori creata.
+ Spoofing vocale: il chiamante sta modificando la propria voce o sta usando la sintesi vocale per ingannare l'agente.
## Risultati di Voice ID in un record di contatto
Dopo aver cercato un contatto, puoi scegliere un ID per visualizzare il relativo record. L'immagine seguente mostra un esempio dei campi della sezione Voice ID del record del contatto:
![\[Sezione Voice ID di un record di contatto che mostra i risultati di autenticazione, lo stato di rilevamento del truffatore e i campi ID del truffatore e ID della lista di controllo.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/voiceid-ctr-nospoofing.png)
# Gestisci l'ID vocale di Amazon Connect con l'ID vocale APIs
**Nota**
Avviso di fine del supporto: il 20 maggio 2026, AWS terminerà il supporto per Amazon Connect Voice ID. Dopo il 20 maggio 2026, non potrai più accedere a Voice ID sulla console Amazon Connect, accedere alle funzionalità Voice ID sul sito Web di Amazon Connect amministrazione o nel Pannello di controllo dei contatti o accedere alle risorse Voice ID. Per ulteriori informazioni, consulta [Fine del supporto di Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
Per gestire Voice ID a livello di codice, consulta [Amazon Connect Voice](https://docs.aws.amazon.com/voiceid/latest/APIReference/) ID. APIs
Questa sezione spiega come eseguire scenari comuni utilizzando Voice ID. APIs
**Topics**
+ [
# Gestire i domini Amazon Connect Voice ID
](voiceid-domain-operations.md)
+ [Associazione di integrazione Amazon Connect APIs](voiceid-integration-association-apis.md)
+ [Gestione degli altoparlanti, della lista di controllo e dei truffatori APIs](voiceid-speaker-fraudster-management-apis.md)
+ [
# Iscrizione in batch in Amazon Connect Voice ID utilizzando i dati audio di chiamate precedenti
](voiceid-batch-enrollment.md)
+ [Schema dei file per il processo di registrazione del parlante](speaker-enrollment-job-schema.md)
+ [
# Creare e modificare una lista di controllo di truffatori in Amazon Connect Voice ID
](voiceid-fraudster-watchlist.md)
+ [Schema del file per il processo di registrazione dei truffatori](fraudster-registration-schema.md)
+ [
# Amazon Connect Streams APIs per integrare Voice ID
](voiceid-streams-apis.md)
# Gestire i domini Amazon Connect Voice ID
**Nota**
Avviso di fine del supporto: il 20 maggio 2026, AWS terminerà il supporto per Amazon Connect Voice ID. Dopo il 20 maggio 2026, non potrai più accedere a Voice ID sulla console Amazon Connect, accedere alle funzionalità Voice ID sul sito Web di Amazon Connect amministrazione o nel Pannello di controllo dei contatti o accedere alle risorse Voice ID. Per ulteriori informazioni, consulta [Fine del supporto di Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
Amazon Connect Voice ID consente APIs di gestire i domini Voice ID. Puoi trovare gli equivalenti di Create, Descrivi, List e Update nella AWS console.
1. [CreateDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_CreateDomain.html): Per creare un nuovo dominio Voice ID, utilizza l'API `CreateDomain` Voice ID. Quando viene creato il dominio Voice ID, viene creata contemporaneamente una lista di controllo di truffatori predefinita in cui archiviare i truffatori.
Ecco alcune linee guida per l'uso dell'API `CreateDomain`:
+ Puoi richiamarlo per il tuo account solo dopo aver riconosciuto il consenso BIPA nella console. AWS
+ Al momento della creazione, è inoltre necessario specificare la chiave KMS per il dominio Voice ID.
+ Dopo aver creato un dominio Voice ID, utilizza l'[associazione Amazon Connect APIs](https://docs.aws.amazon.com/connect/latest/APIReference/) per associarlo a un'istanza Amazon Connect.
1. [DeleteDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteDomain.html): Per eliminare un dominio Voice ID, devi richiamare l'API `DeleteDomain` Voice ID e fornire l'ID del dominio. Se questo dominio è stato associato a un'istanza Amazon Connect, le chiamate API di Voice ID e i blocchi di flusso di Voice ID restituiranno un errore di runtime. L'eliminazione di un dominio Voice ID elimina tutti i dati dei clienti archiviati, come registrazioni audio, impronte vocali e identificatori dei parlanti, nonché le liste di controllo di truffatori gestite.
1. [DescribeDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DescribeDomain.html): utilizza questa API per restituire il nome, la descrizione e la configurazione di crittografia di un dominio esistente identificato dal suo`DomainID`.
1. [ListDomains](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_ListDomains.html): Utilizza questa API per elencare tutti i domini Voice ID di proprietà del tuo account nella regione.
1. [UpdateDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_UpdateDomain.html): Per aggiornare il nome e la configurazione di crittografia per un dominio, puoi utilizzare l'API `UpdateDomain` Voice ID. Quest'API modifica gli attributi esistenti ed è necessario fornire entrambi i campi.
Quando modifichi la chiave KMS associata al dominio Voice ID, dopo la chiamata di `UpdateDomain` i dati esistenti del dominio verranno crittografati di nuovo in modo asincrono con la nuova chiave KMS. È possibile controllare lo stato del processo dall'attributo `ServerSideEncryptionUpdateDetails` del dominio usando l'API `DescribeDomain`. Durante questo processo di aggiornamento, è necessario mantenere la chiave KMS precedente in uno stato accessibile per evitare che si verifichi un errore nel processo. Una volta completato il processo, la chiave KMS precedente può essere ritirata.
# Voice ID e Amazon Connect Integration Association APIs
**Nota**
Avviso di fine del supporto: il 20 maggio 2026, AWS terminerà il supporto per Amazon Connect Voice ID. Dopo il 20 maggio 2026, non potrai più accedere a Voice ID sulla console Amazon Connect, accedere alle funzionalità Voice ID sul sito Web di Amazon Connect amministrazione o nel Pannello di controllo dei contatti o accedere alle risorse Voice ID. Per ulteriori informazioni, consulta [Fine del supporto di Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
Puoi utilizzare quanto segue APIs per gestire le associazioni con le istanze Amazon Connect. Puoi eseguire queste operazioni anche sulla AWS console.
1. [CreateIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateIntegrationAssociation.html): per abilitare Voice ID su un'istanza Amazon Connect, dovrai associare un dominio Voice ID a un'istanza Amazon Connect utilizzando una `CreateIntegrationAssociation` richiesta. È possibile associare solo un dominio Voice ID a un'istanza Amazon Connect. Se l'istanza è già associata a un dominio, l'API restituisce il seguente errore:
`DuplicateResourceException` (409) - Request is trying to created a duplicate resource.
**Nota**
Quando abiliti Voice ID per un'istanza Amazon Connect (utilizzando la console Amazon Connect o l'[CreateIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateIntegrationAssociation.html)API), Amazon Connect crea una EventBridge regola Amazon gestita nel tuo account. Questa regola viene usata per importare eventi Voice ID per creare record di contatti relativi a Voice ID. Amazon Connect aggiunge inoltre le [autorizzazioni di Voice ID](connect-slr.md) al ruolo collegato al servizio per Amazon Connect.
1. [DeleteIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_DeleteIntegrationAssociation.html): per eliminare un'associazione esistente tra un'istanza Amazon Connect e un dominio Voice ID, dovrai richiamarla `DeleteIntegrationAssociation` APIs insieme all'Amazon Connect InstanceID e `IntegrationAssociationID` al comando restituito da. `CreateIntegrationAssociation` Questo passaggio è obbligatorio se desideri associare un dominio Voice ID diverso a questa istanza Amazon Connect. Non è consigliabile eliminare le associazioni in una configurazione di produzione in quanto ciò può causare un comportamento imprevedibile per Voice ID nell'istanza Amazon Connect.
1. [ListIntegrationAssociations](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListIntegrationAssociations.html): per elencare tutte le associazioni tra istanze Amazon Connect e domini Voice ID per il tuo account in questa regione, puoi richiamare `ListIntegrationAssociations` l'API.
# Gestione degli altoparlanti, della lista di controllo e delle frodi con Amazon Connect Voice ID APIs
**Nota**
Avviso di fine del supporto: il 20 maggio 2026, AWS terminerà il supporto per Amazon Connect Voice ID. Dopo il 20 maggio 2026, non potrai più accedere a Voice ID sulla console Amazon Connect, accedere alle funzionalità Voice ID sul sito Web di Amazon Connect amministrazione o nel Pannello di controllo dei contatti o accedere alle risorse Voice ID. Per ulteriori informazioni, consulta [Fine del supporto di Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
Amazon Connect Voice ID include APIs la gestione degli altoparlanti registrati in un dominio Voice ID e dei truffatori registrati nel dominio. Tutti gli oratori APIs, tranne`ListSpeakers`, accettano o. `CustomerSpeakerId` `GeneratedSpeakerId`
## Gestione degli altoparlanti APIs
1. [DescribeSpeaker](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DescribeSpeaker.html): Descrivi [lo stato di un oratore in un dominio (ENROLLED, OPTED\$1OUT, EXPIRED)](voiceid-domain.md#voiceid-speaker-enrollments) e associa a a a e `GeneratedSpeakerId` viceversa. `CustomerSpeakerId`
1. [DeleteSpeaker](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteSpeaker.html): Rimuovi completamente tutti i record relativi a caller/speaker da un dominio Voice ID. Tutte le impronte vocali e lo stato di registrazione vengono eliminati immediatamente e le registrazioni audio associate vengono rimosse entro 24 ore.
1. [ListSpeakers](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_ListSpeakers.html): Elenca tutti gli altoparlanti le cui voci sono presenti in un dominio Voice ID. Quest'API restituisce entrambi gli attributi `CustomerSpeakerId` e `GeneratedSpeakerId` di un parlante. Restituisce un output impaginato con le dimensioni di pagina indicate nella richiesta API.
1. [OptOutSpeaker](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_OptOutSpeaker.html): Disattiva un chiamante da un dominio Voice ID. Quest'API non richiede che il parlante sia presente in Voice ID. È possibile eseguire l'opt-out di un parlante non esistente usando quest'API e Voice ID mantiene lo stato di disattivazione e rifiuta le richieste di registrazione future per tale parlante. L'opt-out rimuove anche le impronte vocali e tutte le registrazioni audio archiviate per il chiamante.
## Gestione delle watchlist APIs
1. [CreateWatchlist](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_CreateWatchlist.html): Crea una lista di controllo di cui possano far parte i truffatori.
1. [DeleteWatchlist](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteWatchlist.html): Rimuovi una lista di controllo personalizzata per i truffatori dal dominio Voice ID. Per poter essere eliminata, una lista di controllo deve essere vuota. Non deve cioè avere truffatori associati. Puoi utilizzare [DeleteFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteFraudster.html)o [DisassociateFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DisassociateFraudster.html) APIs per rimuovere tutti i truffatori da una lista di controllo.
Non è possibile eliminare la lista di controllo predefinita da un dominio Voice ID.
1. [DescribeWatchlist](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DescribeWatchlist.html): Stabilisci se si tratta di una lista di controllo predefinita per i truffatori o di una lista di controllo personalizzata che hai creato e ottieni i dettagli della lista di controllo.
1. [ListWatchlists](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_ListWatchlists.html): Elenca tutte le watchlist nel dominio Voice ID.
1. [UpdateWatchlist](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_UpdateWatchlist.html): Aggiorna il nome e la descrizione di una watchlist personalizzata per i truffatori. Non è possibile modificare i dettagli della lista di controllo predefinita perché è gestita da Voice ID.
## Gestione delle frodi APIs
1. [AssociateFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_AssociateFraudster.html): Associa un truffatore a una lista di controllo nello stesso dominio. È possibile associare un truffatore a più liste di controllo in un dominio.
1. [DeleteFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteFraudster.html): Elimina un truffatore da un dominio Voice ID. L'eliminazione rimuove il truffatore da tutte le liste di controllo di cui fa parte. Elimina inoltre tutte le impronte vocali e le registrazioni audio associate entro 24 ore.
1. [DescribeFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DescribeFraudster.html): Descrivi lo stato di un truffatore nel dominio Voice ID.
1. [DisassociateFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DisassociateFraudster.html): Annulla l'associazione di un truffatore dalla lista di controllo specificata. Tieni presente che un truffatore deve sempre essere associato ad almeno una lista di controllo di truffatori. Se cerchi di annullare l'associazione di un truffatore alla sua unica lista di controllo, viene generata un'eccezione.
Per rimuovere completamente il truffatore, usa `DeleteFraudster`.
1. [ListFraudsters](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_ListFraudsters.html): Elenca tutti i truffatori presenti in un dominio o in una lista di controllo specifica. Quest'API restituisce anche le liste di controllo di cui fa parte il truffatore. Restituisce un output impaginato con le dimensioni di pagina indicate nella richiesta API.
# Iscrizione in batch in Amazon Connect Voice ID utilizzando i dati audio di chiamate precedenti
**Nota**
Avviso di fine del supporto: il 20 maggio 2026, AWS terminerà il supporto per Amazon Connect Voice ID. Dopo il 20 maggio 2026, non potrai più accedere a Voice ID sulla console Amazon Connect, accedere alle funzionalità Voice ID sul sito Web di Amazon Connect amministrazione o nel Pannello di controllo dei contatti o accedere alle risorse Voice ID. Per ulteriori informazioni, consulta [Fine del supporto di Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
Puoi iniziare subito a usare la biometria registrando in batch i clienti che hanno già acconsentito al suo utilizzo. [Utilizzando le registrazioni audio archiviate nel tuo bucket S3 e un file di input JSON che fornisce l'identificatore dell'altoparlante e un collegamento alle registrazioni audio, puoi richiamare il batch Voice ID.](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_StartSpeakerEnrollmentJob.html) APIs
Per registrare i clienti a livello di programmazione, passa i seguenti dati all'API:
1. ID del dominio a cui associare le registrazioni.
1. Posizione del file di output.
1. File di input contenente un elenco di parlanti. Per informazioni, consulta [Schema dei file di input e output per il processo di iscrizione dei parlanti in Amazon Connect Voice ID](speaker-enrollment-job-schema.md).
Per ogni parlante il file deve includere:
+ Un collegamento alla registrazione audio di una chiamata in un file.wav con frequenza di campionamento 8 e codifica PCM-16. KHz
+ L'attributo `CustomerSpeakerId` corrispondente per il cliente.
+ Un canale per il chiamante nella registrazione audio. Se l'audio ha più canali, è possibile selezionarne solo uno.
1. Una chiave KMS da usare durante la scrittura dell'output.
1. Un ruolo che Voice ID può assumere. Deve avere accesso al bucket S3 in cui sono archiviati i file audio. Il ruolo deve avere accesso a qualsiasi chiave KMS usata per crittografare i file. Deve anche poter scrivere nella posizione di output specificata e usare la chiave KMS richiesta per scrivere l'output. In particolare, deve disporre delle seguenti autorizzazioni:
+ `s3:GetObject` per il bucket di input.
+ `s3:PutObject` per il bucket di output.
+ `kms:Decrypt` per la chiave KMS usata per la crittografia predefinita del bucket di input.
+ `kms:Decrypt` e `kms:GenerateDataKey` per la chiave KMS fornita nell'input che verrà usata per scrivere il file di output nel bucket di output.
È necessario disporre delle autorizzazioni `iam:PassRole` per effettuare la chiamata e fornire `dataAccessRole`. Per abilitare la prevenzione dei problemi di "confused deputy" per `dataAccessRole`, consulta [Prevenzione del problema "confused deputy" tra servizi per Amazon Connect Voice ID](cross-service-confused-deputy-prevention.md#voiceid-cross-service).
1. Facoltativamente, un flag per indicare di ignorare i controlli dei casi di frode e spoofing vocale nell'audio di registrazione.
1. Facoltativamente, una lista di controllo di truffatori per i quali eseguire i controlli. Se non viene specificata alcuna lista di controllo, Voice ID usa la lista di controllo di truffatori predefinita per il dominio.
1. Facoltativamente, la soglia di frode nel caso in cui desideri aumentare o ridurre il rischio.
1. Facoltativamente, un flag per ripetere la registrazione dei clienti registrati. Ciò è utile se desideri aggiornare la registrazione audio, poiché l'impostazione predefinita prevede di ignorare i clienti precedentemente registrati.
La registrazione in batch restituisce `CustomerSpeakerId`, `GeneratedSpeakerId` e lo stato associato per ogni voce. Archivia questi dati in un file JSON nel percorso di output specificato nell'API.
**Nota**
La registrazione dei parlanti prevede l'addebito di un costo. Per ulteriori informazioni, consulta [Prezzi di Amazon Connect Voice ID](https://aws.amazon.com/connect/pricing/).
# Schema dei file di input e output per il processo di iscrizione dei parlanti in Amazon Connect Voice ID
**Nota**
Avviso di fine del supporto: il 20 maggio 2026, AWS terminerà il supporto per Amazon Connect Voice ID. Dopo il 20 maggio 2026, non potrai più accedere a Voice ID sulla console Amazon Connect, accedere alle funzionalità Voice ID sul sito Web di Amazon Connect amministrazione o nel Pannello di controllo dei contatti o accedere alle risorse Voice ID. Per ulteriori informazioni, consulta [Fine del supporto di Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
## Schema del file di input
Di seguito è riportato lo schema del file manifesto di input per il processo di registrazione del parlante:
```
{
"Version": "string",
"SpeakerEnrollmentRequests": [
{
"RequestId": "string",
"SpeakerId": "string",
"AudioSpecifications": [
{
"S3Uri": "string",
"ChannelId": number
}
]
}
]
}
```
**Nota**
Tutti i campi dello schema sono **obbligatori**.
Di seguito è riportata una descrizione di ogni attributo dello schema di input.
+ `Version`: versione del documento dello schema di input. Al momento, è `1.0`.
+ `SpeakerEnrollmentRequests`: elenco delle richieste di registrazione dei parlanti da gestire nell'ambito del processo.
+ `RequestId`: identificatore per la richiesta di registrazione del parlante. Il nome deve essere univoco all'interno del file di input. Viene usato per mappare e identificare le voci nel file di output.
+ `SpeakerId`: identificatore fornito dal cliente del parlante che deve essere registrato. In questo campo è necessario passare `CustomerSpeakerId`. Attualmente, `GeneratedSpeakerId` non è supportato.
+ `AudioSpecifications`: elenco dei file audio che Voice ID può usare per registrare il parlante. Voice ID usa questi file audio insieme per raccogliere la quantità di parlato necessaria per la registrazione. Attualmente, il numero massimo di file audio consentito per una richiesta di registrazione è **10**. Ogni file può essere un file.wav fino a 20 MB, contenente audio con 8 frequenze di KHz campionamento e codifica PCM-16.
+ `S3URI`: posizione in Amazon S3 del file audio in formato WAV da usare per registrare il parlante.
+ `ChannelId`: canale audio da usare per registrare il parlante in un file audio multicanale. Voice ID supporta i file audio con un massimo di due canali, quindi questo valore è limitato a **0** o **1**.
## Schema del file di output
Di seguito è riportato lo schema del file di output generato per il processo di registrazione del parlante:
```
{
"Version": "string",
"Errors": [
{
"RequestId": "string",
"ErrorCode": number,
"ErrorMessage": "string"
}
],
"SuccessfulEnrollments": [
{
"RequestId": "string",
"GeneratedSpeakerId": "string",
"CustomerSpeakerId": "string",
"EnrollmentStatus": "DUPLICATE_SKIPPED" | "NEW_ENROLLMENT" | "ENROLLMENT_OVERWRITE"
}
]
}
```
Di seguito è riportata una descrizione di ogni attributo dello schema di output.
+ `Version`: versione del documento dello schema di output. Al momento, è `1.0`.
+ `Errors`: elenco degli errori relativi alle richieste di registrazione del parlante che non sono andate a buon fine.
+
+ `RequestId`: identificatore associato alla richiesta. Corrisponde all’attributo `RequestId` specificato nel file di input per la richiesta.
+ `ErrorCode`: codice di errore HTTP che rappresenta il tipo di errore. Di seguito sono descritti alcuni scenari di errore di esempio.
**Nota**
Questo elenco non è esaustivo.
+ 400 (eccezione di richiesta non valida):
+ Il file JSON di input non è valido e non può essere analizzato.
+ I file audio forniti non contengono abbastanza parlato per la registrazione.
+ I controlli di verifica delle frodi non sono riusciti per il parlante specificato.
+ 402 (): ServiceQuotaLimitExceededException
+ Limite di parlanti superato.
+ 409 (eccezione di conflitto):
+ Azione in conflitto: non è possibile richiedere la registrazione di un parlante di cui è stato eseguito l'opt-out.
+ 500 (errore interno):
+ Errore interno del server (errore imprevisto sul lato del servizio).
+ `ErrorMessage`: messaggio che descrive la causa dell'errore di registrazione.
+ `SuccessfulEnrollments`: elenco delle richieste di registrazione che hanno avuto esito positivo.
+ `RequestId`: identificatore associato alla richiesta. Corrisponde all’attributo `RequestId` specificato nel file di input per la richiesta.
+ `CustomerSpeakerId`: identificatore fornito dal cliente per il parlante che è stato registrato.
+ `GeneratedSpeakerId`: identificatore generato dal servizio per il parlante che è stato registrato.
+ `EnrollmentStatus`: stato dell'avvenuta registrazione del parlante.
+ `DUPLICATE_SKIPPED`: il parlante è già iscritto e la registrazione è stata ignorata.
+ `NEW_ENROLLMENT`: il parlante è stato appena registrato nel sistema.
+ `ENROLLMENT_OVERWRITE`: il parlante era già registrato, ma è stato nuovamente registrato/sovrascritto usando il nuovo audio.
# Creare e modificare una lista di controllo di truffatori in Amazon Connect Voice ID
**Nota**
Avviso di fine del supporto: il 20 maggio 2026, AWS terminerà il supporto per Amazon Connect Voice ID. Dopo il 20 maggio 2026, non potrai più accedere a Voice ID sulla console Amazon Connect, accedere alle funzionalità Voice ID sul sito Web di Amazon Connect amministrazione o nel Pannello di controllo dei contatti o accedere alle risorse Voice ID. Per ulteriori informazioni, consulta [Fine del supporto di Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
Utilizza quanto segue APIs per creare una lista di controllo dei truffatori e registrarli:
1. Utilizza l'[CreateWatchlist](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_CreateWatchlist.html)API per creare nuove liste di controllo dei truffatori.
1. Utilizza l'[StartFraudsterRegistrationJob](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_StartFraudsterRegistrationJob.html)API per la registrazione in batch. Puoi registrare nuovi truffatori nella nuova lista di controllo oppure registrarli nella lista di controllo predefinita associata al dominio Voice ID.
Quando registri un nuovo truffatore, Voice ID confronta l'impronta vocale con quella di tutti i truffatori registrati nel dominio Voice ID per determinare se si tratta di un duplicato di un truffatore esistente.
Per aggiungere i truffatori a una determinata lista di controllo di truffatori, passa i seguenti dati all'API:
1. ID del dominio a cui associare le registrazioni.
1. File di input contenente un elenco di truffatori. Per informazioni, consulta [Schema dei file di input e output per il processo di registrazione dei truffatori in Amazon Connect Voice ID](fraudster-registration-schema.md).
1. Posizione del file di output.
1. Una chiave KMS da usare durante la scrittura dell'output.
1. Un ruolo che Voice ID può assumere. Deve avere accesso al bucket S3 in cui sono archiviati i file audio. Il ruolo deve avere accesso a qualsiasi chiave KMS usata per crittografare i file. Deve anche poter scrivere nella posizione di output specificata e usare la chiave KMS richiesta per scrivere l'output. In particolare, deve disporre delle seguenti autorizzazioni:
+ `s3:GetObject` per il bucket di input.
+ `s3:PutObject` per il bucket di output.
+ `kms:Decrypt` per la chiave KMS usata per la crittografia predefinita del bucket di input.
+ `kms:Decrypt` e `kms:GenerateDataKey` per la chiave KMS fornita nell'input che verrà usata per scrivere il file di output nel bucket di output.
È necessario disporre delle autorizzazioni `iam:PassRole` per effettuare la chiamata e fornire `dataAccessRole`. Per abilitare la prevenzione dei problemi di "confused deputy" per `dataAccessRole`, consulta [Prevenzione del problema "confused deputy" tra servizi per Amazon Connect Voice ID](cross-service-confused-deputy-prevention.md#voiceid-cross-service).
1. Una lista di controllo in cui registrare il truffatore. Se non viene specificata alcuna lista di controllo, i truffatori vengono registrati nella lista di controllo predefinita per il dominio Voice ID.
1. La soglia per stabilire lo stato duplicato dei truffatori.
1. Un flag per ignorare i duplicati dei truffatori.
Voice ID aggiorna l'elenco dei truffatori con le aggiunte riuscite e restituisce un attributo `GeneratedFraudsterID` associato alla voce nella stessa posizione di S3. Se vengono identificati duplicati, Voice ID restituisce lo stato "duplicato" per la voce e fornisce l'attributo `GeneratedFraudsterId` con il livello di corrispondenza maggiore. Dopo che un truffatore è stato registrato con successo, puoi associarlo a una nuova lista di controllo utilizzando l'API. `GeneratedFraudsterID` [AssociateFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_AssociateFraudster.html)
Voice ID non è in grado di rilevare i truffatori in una lista di controllo prima della creazione della lista.
Per le quote per la lista di truffatori, consulta [Amazon Connect quote di servizio](amazon-connect-service-limits.md).
**Nota**
L'aggiunta di voci all'elenco dei truffatori prevede l'addebito di un costo. Per ulteriori informazioni, consulta [Prezzi di Amazon Connect Voice ID](https://aws.amazon.com/connect/voice-id/).
# Schema dei file di input e output per il processo di registrazione dei truffatori in Amazon Connect Voice ID
**Nota**
Avviso di fine del supporto: il 20 maggio 2026, AWS terminerà il supporto per Amazon Connect Voice ID. Dopo il 20 maggio 2026, non potrai più accedere a Voice ID sulla console Amazon Connect, accedere alle funzionalità Voice ID sul sito Web di Amazon Connect amministrazione o nel Pannello di controllo dei contatti o accedere alle risorse Voice ID. Per ulteriori informazioni, consulta [Fine del supporto di Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
## Schema del file di input
Di seguito è riportato lo schema del file manifesto di input per i processi di registrazione dei truffatori:
```
{
"Version": "string",
"FraudsterRegistrationRequests": [
{
"RequestId": "string",
"AudioSpecifications": [
{
"S3Uri": "string",
"ChannelId": number
}
]
}
]
}
```
**Nota**
Tutti i campi dello schema sono **obbligatori**.
Di seguito è riportata una descrizione di ogni attributo dello schema di input.
+ `Version`: versione del documento dello schema. Al momento, è `1.0`.
+ `FraudsterRegistrationRequests`: elenco delle richieste di registrazione dei truffatori da gestire nell'ambito del processo.
+ `RequestId`: identificatore per la richiesta di registrazione del truffatore. Il nome deve essere univoco all'interno del file di input. Viene usato per mappare e identificare le voci nel file di output.
+ `AudioSpecifications`: elenco dei file audio che Voice ID può usare per registrare il truffatore. Voice ID usa questi file audio insieme per raccogliere la quantità di parlato necessaria per la registrazione. Attualmente, il numero massimo di file audio consentito per una richiesta di registrazione è **10**. Ogni file può essere un file.wav fino a 20 MB, contenente audio con 8 frequenze di KHz campionamento e codifica PCM-16.
+ `S3URI`: posizione in Amazon S3 del file audio in formato WAV da usare per registrare il truffatore.
+ `ChannelId`: canale audio da usare per registrare il truffatore in un file audio multicanale. Voice ID supporta i file audio con un massimo di due canali, quindi questo valore è limitato a **0** o **1**.
## Schema del file di output
Di seguito è riportato lo schema del file manifesto di output per i processi di registrazione dei truffatori:
```
{
"Version": "string",
"Errors": [
{
"RequestId": "string",
"ErrorCode": number,
"ErrorMessage": "string"
}
],
"SuccessfulRegistrations": [
{
"RequestId": "string",
"GeneratedFraudsterId": "string",
"RegistrationStatus": "DUPLICATE_SKIPPED" | "NEW_REGISTRATION",
"FraudsterSimilarityScore": number
}
]
}
```
Di seguito è riportata una descrizione di ogni attributo dello schema di output.
+ `Version`: versione del documento dello schema di output. Al momento, è `1.0`.
+ `Errors`: elenco degli errori relativi alle richieste di registrazione del truffatore che non sono andate a buon fine.
+
+ `RequestId`: identificatore associato alla richiesta. Corrisponde all’attributo `RequestId` specificato nel file di input per la richiesta.
+ `ErrorCode`: codice di errore HTTP che rappresenta il tipo di errore. Di seguito sono descritti alcuni scenari di errore di esempio.
**Nota**
Questo elenco non è esaustivo.
+ 400 (eccezione di richiesta non valida):
+ Il file JSON di input non è valido e non può essere analizzato.
+ I file audio forniti non contengono abbastanza parlato per la registrazione.
+ 402 (): ServiceQuotaLimitExceededException
+ Limite di truffatori superato.
+ 500 (errore interno):
+ Errore interno del server (errore imprevisto sul lato del servizio).
+ `ErrorMessage`: messaggio che descrive la causa dell'errore di registrazione del truffatore.
+ `SuccessfulRegistrations`: elenco delle richieste di registrazione che hanno avuto esito positivo.
+ `RequestId`: identificatore associato alla richiesta. Corrisponde all'attributo `RequestId` specificato nel file di input per la richiesta.
+ `RegistrationStatus`: stato dell'avvenuta registrazione del truffatore.
+ `DUPLICATE_SKIPPED`: il truffatore è stato identificato come duplicato e la registrazione è stata ignorata.
+ `NEW_FRAUDSTER`: il truffatore è stato appena registrato nel sistema.
+ `GeneratedFraudsterId`: identificatore generato dal servizio per il truffatore registrato. Se `RegistrationStatus` è `DUPLICATE_SKIPPED`, si tratta dell'identificatore del truffatore già presente nel dominio che corrisponde maggiormente al truffatore in questione.
+ `FraudsterSimilarityScore`: campo facoltativo che viene popolato quando la registrazione del truffatore viene ignorata in quanto si tratta di un duplicato. Indica il livello di somiglianza tra il truffatore in questione e il truffatore più simile già esistente nel dominio.
# Amazon Connect Streams APIs per integrare Voice ID
**Nota**
Avviso di fine del supporto: il 20 maggio 2026, AWS terminerà il supporto per Amazon Connect Voice ID. Dopo il 20 maggio 2026, non potrai più accedere a Voice ID sulla console Amazon Connect, accedere alle funzionalità Voice ID sul sito Web di Amazon Connect amministrazione o nel Pannello di controllo dei contatti o accedere alle risorse Voice ID. Per ulteriori informazioni, consulta [Fine del supporto di Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
Usa i seguenti [Amazon Connect Streams](https://github.com/aws/amazon-connect-streams) APIs per integrare Voice ID nelle tue applicazioni web per agenti esistenti.
+ `enrollSpeakerInVoiceId`: registra un cliente in Voice ID dopo aver ottenuto il suo consenso alla registrazione.
+ `evaluateSpeakerWithVoiceId`: controlla lo stato di autenticazione del cliente in Voice ID e individua i truffatori.
+ `optOutVoiceIdSpeaker`: esegue l'opt-out di un cliente da Voice ID.
+ `getVoiceIdSpeakerStatus`: descrive lo stato di registrazione di un cliente.
+ `getVoiceIdSpeakerId`: ottiene l'attributo `SpeakerID` per un cliente.
+ `updateVoiceIdSpeakerId`: aggiorna l'attributo `SpeakerID` per un cliente.
È anche possibile usare il widget Voice ID nel Pannello di controllo dei contatti (CCP) se non si desidera creare un'interfaccia agente personalizzata. Per ulteriori informazioni su Voice ID nel Pannello di controllo dei contatti, consulta [Registrazione dei chiamanti in Voice ID nel Contact Control Panel (CCP)](use-voiceid.md).
# Schema degli eventi di Amazon Connect Voice ID
**Nota**
Avviso di fine del supporto: il 20 maggio 2026, AWS terminerà il supporto per Amazon Connect Voice ID. Dopo il 20 maggio 2026, non potrai più accedere a Voice ID sulla console Amazon Connect, accedere alle funzionalità Voice ID sul sito Web di Amazon Connect amministrazione o nel Pannello di controllo dei contatti o accedere alle risorse Voice ID. Per ulteriori informazioni, consulta [Fine del supporto di Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
Voice ID genera eventi per ogni transazione: registrazione, autenticazione o rilevamento di truffatori in una lista di controllo. Gli eventi vengono inviati al bus degli eventi EventBridge predefinito.
Puoi creare una pipeline di analisi per i risultati dell'autenticazione Voice ID e l'individuazione dei truffatori in una lista di controllo utilizzandola EventBridge per monitorare gli eventi Voice ID. Utilizzando lo schema disponibile in questo argomento, puoi configurare EventBridge le regole per ascoltare e filtrare gli eventi Voice ID pertinenti, quindi elaborarli tramite Amazon Data Firehose per archiviarli in un data warehouse di tua scelta.
È ad esempio possibile tracciare quasi in tempo reale l'analisi di Voice ID. A tale scopo, è necessario eseguire il pull di tutti gli eventi `Evaluate-Session` e ottenere `authenticationResult` e `fraudDetectionResult`.
Gli eventi vengono emessi secondo il principio del [massimo sforzo](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html).
## Campi comuni dell'evento
+ `version`: versione dei dati dell'evento.
+ `id`- Un identificatore univoco dell'evento generato da EventBridge
+ `detail-type`: identificatore dei dettagli dell'evento.
+ `source`: origine dell'evento. Il valore è sempre `aws.voiceid`.
+ `account`- ID AWS dell'account.
+ `timestamp`: data e ora in cui l'evento è stato pubblicato nel fuso UTC.
+ `region`- La AWS regione in cui è stata effettuata la chiamata API.
+ `resources`: risorse usate dalla chiamata API.
+ `detail`: dettagli sull'evento:
+ `detail.sourceId`: ID univoco generato da Voice ID che è possibile usare per la deduplicazione.
+ `detail.action`: analogo all'API richiamata.
+ `detail.status`: specifica lo stato dell'azione: riuscita o non riuscita.
+ `detail.errorInfo`: popolato quando l'azione specificata genera un errore in Voice ID.
Di seguito sono riportati gli schemi relativi agli eventi emessi.
## Start Session Action
Vengono emessi eventi all'inizio del flusso (dopo la configurazione), alla fine del flusso e in caso di errori.
```
{...commonfields
"detail-type": "VoiceId Start Session Action",
"detail": {
"sourceId": String,
"action": "START_SESSION",
"status": String,
"domainId": String,
"session": {
"sessionId": String,
"sessionName": String,
"authenticationConfiguration": {
"acceptanceThreshold":Integer
},
"fraudDetectionConfiguration": {
"riskThreshold":Integer,
"watchlistId": String
},
"streamingConfiguration": {
"authenticationMinimumSpeechInSeconds": Integer
},
"enrollmentAudioProgress": {
"audioAggregationStatus": String,
"audioAggregationStartedAt": "Timestamp",
"audioAggregationEndedAt": "Timestamp"
},
"authenticationAudioProgress": {
"audioAggregationStartedAt": "Timestamp",
"audioAggregationEndedAt": "Timestamp"
},
"fraudDetectionAudioProgress": {
"audioAggregationStartedAt": "Timestamp",
"audioAggregationEndedAt": "Timestamp"
},
"generatedSpeakerId": String
},
"errorInfo": {
"errorMessage": String,
"errorType": String,
"errorCode": Integer
}
}
}
```
## Update Session Action
Vengono emessi eventi quando l'aggiornamento della sessione interna ha esito positivo o negativo.
```
{...commonfields
"detail-type": "VoiceId Update Session Action",
"detail": {
"sourceId": String,
"action": "UPDATE_SESSION",
"status": String,
"domainId": String,
"session": {
"sessionId": String,
"sessionName": String,
"authenticationConfiguration": {
"acceptanceThreshold": Integer
},
"fraudDetectionConfiguration": {
"riskThreshold": Integer,
"watchlistId": String
},
"streamingConfiguration": {
"authenticationMinimumSpeechInSeconds": Integer
},
"generatedSpeakerId": String
},
"errorInfo": {
"errorMessage": String,
"errorType": String,
"errorCode": Integer
}
}
}
```
## Evaluate Session Action
Vengono emessi eventi quando la valutazione della sessione ha esito positivo o negativo. I motivi possono essere KNOWN\$1FRAUDSTER o VOICE\$1SPOOFING.
```
{...commonfields
"detail-type": "VoiceId Evaluate Session Action",
"detail": {
"sourceId": String,
"action": "EVALUATE_SESSION",
"status": String,
"domainId": String,
"session": {
"sessionId": String,
"sessionName": String,
"generatedSpeakerId": String,
"streamingStatus": String,
"authenticationResult": {
"authenticationResultId": String,
"decision": String,
"score": Integer,
"audioAggregationStartedAt": "Timestamp",
"audioAggregationEndedAt": "Timestamp",
"configuration": {
"acceptanceThreshold": Integer
}
},
"fraudDetectionResult": {
"fraudDetectionResultId": String,
"decision": String,
"reasons": [String],
"audioAggregationStartedAt": "Timestamp",
"audioAggregationEndedAt": "Timestamp",
"configuration": {
"riskThreshold": Integer
},
"riskDetails": {
"knownFraudsterRisk": {
"generatedFraudsterId": String,
"riskScore": Integer,
"watchlistId": String
},
"voiceSpoofingRisk": {
"riskScore": Integer
}
}
}
},
"errorInfo": {
"errorMessage": String,
"errorType": String,
"errorCode": Integer
}
}
}
```
## Speaker Action
Vengono emessi eventi in base all'esito positivo o negativo dell'operazione di opt-out, eliminazione o registrazione di un parlante.
```
{...commonfields
"detail-type": "VoiceId Speaker Action",
"detail": {
"sourceId": String,
"domainID": String,
"action": String,
"status": String,
"generatedSpeakerId": String,
"data": {
"enrollmentSource": String,
"enrollmentSourceId": String,
"enrollmentStatus": String
},
"errorInfo": {
"errorMessage": String,
"errorType": String,
"errorCode": Integer
}
}
}
```
## Fraudster Action
Vengono emessi eventi quando un truffatore viene registrato o eliminato.
Gli eventi non vengono inviati in caso di associazione o annullamento dell'associazione di un truffatore a una lista di controllo.
```
{...commonfields
"detail-type": "VoiceId Fraudster Action",
"detail": {
"sourceId": String,
"domainID": String,
"action": String,
"status": String,
"generatedFraudsterId": String,
"watchlistIds": [String],
"data": {
"registrationSource": String,
"registrationSourceId": String,
"registrationStatus": String
},
"errorInfo": {
"errorMessage": String,
"errorType": String,
"errorCode": Integer
}
}
}
```
## EnrollBySession
Questo evento viene emesso quando viene inviata una richiesta di registrazione. Viene emesso un evento `Speaker` quando la registrazione effettiva ha esito positivo o negativo.
```
{...commonfields
"detail-type": "VoiceId Session Speaker Enrollment Action",
"detail": {
"sourceId": String,
"domainId": String,
"action": "SESSION_ENROLLMENT_REQUEST",
"status": String,
"sessionId": String,
"sessionName": String,
"errorInfo": {
"errorMessage": String,
"errorType": String,
"errorCode": Integer
}
}
}
```
## StartSpeakerEnrollmentJob
Questo evento viene emesso quando una richiesta di registrazione in batch viene inviata, ha esito positivo o ha esito negativo. Viene emesso un evento `Speaker` per ciascuno dei singoli parlanti per indicare se la registrazione corrispondente ha esito positivo o negativo.
```
{...commonfields
"detail-type": "VoiceID Batch Speaker Enrollment Action",
"detail": {
"sourceId": String,
"domainId": String,
"action": "BATCH_ENROLLMENT_REQUEST",
"status": String,
"batchJobId": String,
"data": {
"dataAccessRoleArn": String,
"enrollmentConfig": {
"existingEnrollmentAction": String,
"fraudDetectionConfig": {
"fraudDetectionAction": String,
"riskThreshold": Integer,
"watchlistIds": [String],
}
},
"inputDataConfig": {
"s3Uri": String
},
"outputDataConfig": {
"s3Uri": String,
"kmsKeyId": String
}
},
"errorInfo": {
"errorMessage": String,
"errorType": String,
"errorCode": Integer
}
}
}
```
## StartFraudsterRegistrationJob
Questo evento viene emesso quando una richiesta di registrazione in batch viene inviata, ha esito positivo o ha esito negativo. Viene emesso un evento `Fraudster` per ciascuno dei singoli truffatori per indicare se la registrazione corrispondente ha esito positivo o negativo.
```
{...commonfields
"detail-type": "VoiceId Batch Fraudster Registration Action",
"detail": {
"sourceId": String,
"domainId": String,
"action": "BATCH_REGISTRATION_REQUEST",
"status": String,
"batchJobId": String,
"data": {
"dataAccessRoleArn": String,
"registrationConfig": {
"duplicateRegistrationAction": String,
"fraudsterSimilarityThreshold": Integer,
"watchlistIds": [String],
}
"inputDataConfig": {
"s3Uri": String
},
"outputDataConfig": {
"s3Uri": String,
"kmsKeyId": String
}
},
"errorInfo": {
"errorMessage": String,
"errorType": String,
"errorCode": Integer
}
}
}
```