API de gestion des locuteurs, des listes de surveillance et des fraudeurs Amazon Connect Voice ID - Amazon Connect
API de gestion des locuteursAPI de gestion des listes de surveillanceAPI de gestion des fraudeurs

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

API de gestion des locuteurs, des listes de surveillance et des fraudeurs Amazon Connect Voice ID

Note

Avis de fin de prise en charge : le 20 mai 2026, AWS cessera de prendre en charge Amazon Connect Voice ID. Après le 20 mai 2026, vous ne pourrez plus accéder à Voice ID sur la console Amazon Connect, accéder aux fonctionnalités Voice ID sur le site Web d’administration Amazon Connect ou sur le panneau de configuration des contacts, ni accéder aux ressources Voice ID. Pour plus d’informations, consultez Fin de la prise en charge d’Amazon Connect Voice ID.

Amazon Connect Voice ID propose des API pour gérer les locuteurs inscrits dans un domaine Voice ID ainsi que les fraudeurs enregistrés dans ce domaine. Toutes les API « speaker », à l'exception de ListSpeakers, acceptent le CustomerSpeakerId ou le GeneratedSpeakerId.

API de gestion des locuteurs

  1. DescribeSpeaker : décrit le statut d'un locuteur dans un domaine (ENROLLED, OPTED_OUT, EXPIRED) et mappe un GeneratedSpeakerId à un CustomerSpeakerId, et inversement.

  2. DeleteSpeaker : supprime complètement tous les enregistrements d'un appelant/locuteur d'un domaine Voice ID. Toutes les empreintes vocales et le statut d'inscription sont supprimés immédiatement, et les enregistrements audio associés sont retirés dans les 24 heures.

  3. ListSpeakers : répertorie tous les locuteurs dont les entrées sont présentes dans un domaine Voice ID. Cette API renvoie à la fois le CustomerSpeakerId et le GeneratedSpeakerId d'un locuteur. Elle renvoie une sortie paginée, la taille de page étant définie dans la demande d'API.

  4. OptOutSpeaker : désinscrit un appelant d'un domaine Voice ID. Cette API n'exige pas que le locuteur soit présent dans Voice ID. Un locuteur qui n'existe pas peut être désinscrit à l'aide de cette API ; Voice ID conserve alors le statut désinscrit et rejette les futures demandes d'inscription pour ce locuteur. La désinscription a également pour effet de supprimer les empreintes vocales et les enregistrements audio éventuellement stockés pour cet appelant.

API de gestion des listes de surveillance

  1. CreateWatchlist : crée une liste de surveillance dont certains fraudeurs peuvent faire partie.

  2. DeleteWatchlist : supprime une liste de surveillance des fraudeurs personnalisée du domaine Voice ID. Pour pouvoir supprimer une liste de surveillance, celle-ci doit être vide. Autrement dit, aucun fraudeur ne doit y être associé. Vous pouvez utiliser les API DeleteFraudster ou DisassociateFraudster pour supprimer tous les fraudeurs d'une liste de surveillance.

    Vous ne pouvez pas supprimer la liste de surveillance par défaut d'un domaine Voice ID.

  3. DescribeWatchlist : détermine s'il s'agit d'une liste de surveillance par défaut des fraudeurs ou d'une liste de surveillance personnalisée que vous avez créée, et obtient les détails sur la liste de surveillance.

  4. ListWatchlists : répertorie toutes les listes de surveillance du domaine Voice ID.

  5. UpdateWatchlist : met à jour le nom et la description d'une liste de surveillance des fraudeurs personnalisée. Vous ne pouvez pas modifier les détails de la liste de surveillance par défaut, car elle est gérée par Voice ID.

API de gestion des fraudeurs

  1. AssociateFraudster : associe un fraudeur à une liste de surveillance du même domaine. Vous pouvez associer un fraudeur à plusieurs listes de surveillance d'un domaine.

  2. DeleteFraudster : supprime un fraudeur d'un domaine Voice ID. La suppression du fraudeur a pour effet de le retirer de toutes les listes de surveillance dont il fait partie. En outre, toutes les empreintes vocales et les enregistrements audio associés sont supprimés dans les 24 heures.

  3. DescribeFraudster : décrit le statut d'un fraudeur dans le domaine Voice ID.

  4. DisassociateFraudster : dissocie un fraudeur de la liste de surveillance spécifiée. Notez qu'un fraudeur doit toujours être associé à au moins une liste de surveillance des fraudeurs ; une exception est générée si vous essayez de dissocier un fraudeur de la seule liste de surveillance à laquelle il appartient.

    Pour supprimer complètement le fraudeur, utilisez DeleteFraudster.

  5. ListFraudsters : répertorie tous les fraudeurs d'un domaine ou d'une liste de surveillance spécifique. Cette API renvoie également les listes de surveillance dont fait partie le fraudeur. Elle renvoie une sortie paginée, la taille de page étant définie dans la demande d'API.