APIs zur Verwaltung von Sprechern, Watchlists und Betrügern in Amazon Connect Voice ID - Amazon Connect
Speaker-Management-APIsAPIs zur Watchlist-VerwaltungAPIs zur Fraudster-Verwaltung

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

APIs zur Verwaltung von Sprechern, Watchlists und Betrügern in Amazon Connect Voice ID

Anmerkung

Hinweis zum Ende des Supports: AWS stellt den Support für Amazon Connect Voice ID am 20. Mai 2026 ein. Nach dem 20. Mai 2026 können Sie nicht mehr über die Amazon-Connect-Konsole auf Voice ID zugreifen. Sie können auch nicht mehr über die Administrator-Website von Amazon Connect oder im Contact Control Panel auf Voice-ID-Features zugreifen und die Voice-ID-Ressourcen stehen ebenfalls nicht mehr zur Verfügung. Weitere Informationen finden Sie unter Ende des Supports für Amazon Connect Voice ID.

Amazon Connect Voice ID umfasst APIs zur Verwaltung von Sprechern, die in einer Sprach-ID-Domain registriert sind, und von Betrügern, die in der Domain registriert sind. Alle Sprecher-APIs, außer ListSpeakers, akzeptieren entweder CustomerSpeakerId oder GeneratedSpeakerId.

Speaker-Management-APIs

  1. DescribeSpeaker: Beschreiben Sie den Status eines Sprechers in einer Domain (ENROLLED, OPTED_OUT, EXPIRED), und ordnen Sie GeneratedSpeakerId einer CustomerSpeakerId zu und umgekehrt.

  2. DeleteSpeaker: Entfernt vollständig alle Datensätze für einen Anrufer/Sprecher aus einer Sprach-ID-Domain. Alle Sprachabdrücke und der Anmeldestatus werden sofort gelöscht, und die zugehörigen Audioaufnahmen werden innerhalb von 24 Stunden entfernt.

  3. ListSpeakers: Listet alle Sprecher auf, deren Einträge in einer Sprach-ID-Domain vorhanden sind. Diese API gibt sowohl CustomerSpeakerId als auch GeneratedSpeakerId für einen Sprecher zurück. Sie gibt eine paginierte Ausgabe mit der in der API-Anfrage angegebenen Seitengröße zurück.

  4. optOutSpeaker: Einen Anrufer von einer Sprach-ID-Domain abmelden. Für diese API muss der Sprecher nicht in Sprach-ID präsent sein. Ein nicht vorhandener Sprecher kann mithilfe dieser API deaktiviert werden. Sprach-ID behält den Status „Abgemeldet“ bei und lehnt future Registrierungsanfragen für diesen Sprecher ab. Wenn Sie sich abmelden, werden auch Sprachabdrücke und alle gespeicherten Audioaufnahmen für diesen Anrufer entfernt.

APIs zur Watchlist-Verwaltung

  1. createWatchlist: Erstellen Sie eine Watchlist, an der Betrüger teilnehmen können.

  2. deleteWatchlist: Entfernt eine benutzerdefinierte Watchlist für Betrüger aus der Sprach-ID-Domain. Um eine Watchlist zu löschen, muss sie leer sein. Das heißt, es dürfen keine Betrüger damit in Verbindung gebracht werden. Sie können die APIs DeleteFraudster oder DisassociateFraudster verwenden, um alle Betrüger aus einer Watchlist zu entfernen.

    Sie können die Standard-Watchlist nicht aus einer Sprach-ID-Domain löschen.

  3. DescribeWatchlist: Stellen Sie fest, ob es sich um eine Standard-Watchlist für Betrüger oder um eine von Ihnen erstellte benutzerdefinierte Watchlist handelt, und rufen Sie die Details der Watchlist ab.

  4. ListWatchlists: Listet alle Watchlists in der Sprach-ID-Domain auf.

  5. updateWatchlist: Aktualisieren Sie den Namen und die Beschreibung einer benutzerdefinierten Watchlist für Betrüger. Sie können die Details der Standard-Watchlist nicht ändern, da sie von Sprach-ID verwaltet wird.

APIs zur Fraudster-Verwaltung

  1. AssociateFraudster: Ordnen Sie einen Betrüger einer Watchlist in derselben Domain zu. Sie können einen Betrüger mehreren Watchlists in einer Domain zuordnen.

  2. DeleteFraudster: Löscht einen Betrüger aus einer Sprach-ID-Domain. Durch das Löschen des Betrügers wird der Betrüger aus allen Watchlists entfernt, zu denen er gehört. Außerdem werden alle Stimmabdrücke und die zugehörigen Audioaufnahmen innerhalb von 24 Stunden gelöscht.

  3. DescribeFraudster: Beschreiben Sie den Status eines Betrügers in der Sprach-ID-Domain.

  4. DisassociateFraudster: Trennen Sie einen Betrüger von der angegebenen Watchlist. Beachten Sie, dass ein Betrüger immer mit mindestens einer Betrugs-Watchlist verknüpft sein muss. Eine Ausnahme wird ausgelöst, wenn Sie versuchen, einen Betrüger von seiner einzigen Watchlist zu trennen.

    Verwenden Sie DeleteFraudster, um den Betrüger vollständig zu entfernen.

  5. ListFraudsters: Listet alle Betrüger in einer Domain oder einer bestimmten Watchlist auf. Diese API gibt auch die Watchlists zurück, zu denen der Betrüger gehört. Sie gibt eine paginierte Ausgabe mit der in der API-Anfrage angegebenen Seitengröße zurück.