API di Amazon Connect Voice ID per la gestione di parlanti, liste di controllo e truffatori - Amazon Connect
API di gestione dei parlantiAPI di gestione delle liste di controlloAPI di gestione dei truffatori

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à.

API di Amazon Connect Voice ID per la gestione di parlanti, liste di controllo e truffatori

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 sarà più possibile accedere a Voice ID nella console di Amazon Connect, accedere alle funzionalità Voice ID sul sito web di amministrazione di Amazon Connect o su Contact Control Panel, né accedere alle risorse Voice ID. Per ulteriori informazioni, consulta Fine del supporto di Amazon Connect Voice ID.

Amazon Connect Voice ID include API per gestire i parlanti registrati in un dominio Voice ID e i truffatori registrati nel dominio. Tutte le API relative ai parlanti, eccetto ListSpeakers, accettano CustomerSpeakerId o GeneratedSpeakerId.

API di gestione dei parlanti

  1. DescribeSpeaker: descrive lo stato di un parlante in un dominio (ENROLLED, OPTED_OUT, EXPIRED) e consente di mappare un attributo GeneratedSpeakerId a un attributo CustomerSpeakerId e viceversa.

  2. DeleteSpeaker: rimuove completamente tutti i record di un chiamante/parlante 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.

  3. ListSpeakers: elenca tutti i parlanti 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.

  4. OptOutSpeaker: esegue l'opt-out di 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.

API di gestione delle liste di controllo

  1. CreateWatchlist: crea una lista di controllo di cui possono far parte i truffatori.

  2. DeleteWatchlist: rimuove una lista di controllo di truffatori personalizzata dal dominio Voice ID. Per poter essere eliminata, una lista di controllo deve essere vuota. Non deve cioè avere truffatori associati. È possibile usare l'API DeleteFraudster o DisassociateFraudster per rimuovere tutti i truffatori da una lista di controllo.

    Non è possibile eliminare la lista di controllo predefinita da un dominio Voice ID.

  3. DescribeWatchlist: determina se si tratta di una lista di controllo di truffatori predefinita o di una lista di controllo personalizzata creata e consente di ottenere i dettagli della lista di controllo.

  4. ListWatchlists: elenca tutte le liste di controllo nel dominio Voice ID.

  5. UpdateWatchlist: aggiorna il nome e la descrizione di una lista di controllo di truffatori personalizzata. Non è possibile modificare i dettagli della lista di controllo predefinita perché è gestita da Voice ID.

API di gestione dei truffatori

  1. AssociateFraudster: associa un truffatore a una lista di controllo nello stesso dominio. È possibile associare un truffatore a più liste di controllo in un dominio.

  2. DeleteFraudster: 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.

  3. DescribeFraudster: descrive lo stato di un truffatore nel dominio Voice ID.

  4. DisassociateFraudster: annulla l'associazione di un truffatore alla 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.

  5. ListFraudsters: 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.