View a markdown version of this page

Connect die APIs für den Lautsprecher, die Watchlist und die Verwaltung von Betrügern von Customer Voice ID - Amazon Connect Connect-Kunde
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.

Connect die APIs für den Lautsprecher, die Watchlist und die Verwaltung von Betrügern von Customer Voice ID

Anmerkung

Hinweis zum Ende des Supports: Am 20. Mai 2026 AWS wird der Support für Amazon Connect Voice ID eingestellt. Nach dem 20. Mai 2026 können Sie nicht mehr auf Voice ID in der Amazon Connect Connect-Konsole, auf Voice ID-Funktionen auf der Connect Customer Admin-Website oder im Contact Control Panel zugreifen oder auf Voice ID-Ressourcen zugreifen. Weitere Informationen finden Sie unter Ende des Supports für Amazon Connect Voice ID.

Connect Customer Voice ID umfasst APIs zur Verwaltung von Lautsprechern, die in einer Voice 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 a einer GeneratedSpeakerId zu und umgekehrt. CustomerSpeakerId

  2. DeleteSpeaker: Entfernt vollständig alle Datensätze für eine caller/speaker aus einer Voice 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 Voice 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 Voice 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 Beobachtungsliste, zu der auch Betrüger gehören können.

  2. DeleteWatchlist: Entferne eine benutzerdefinierte Beobachtungsliste für Betrüger aus der Voice 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 DisassociateFraudsterAPIs DeleteFraudsteroder verwenden, um alle Betrüger aus einer Beobachtungsliste 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-Beobachtungsliste für Betrüger oder um eine benutzerdefinierte Beobachtungsliste handelt, die Sie erstellt haben, und rufen Sie die Details der Beobachtungsliste ab.

  4. ListWatchlists: Listet alle Beobachtungslisten in der Voice ID-Domain auf.

  5. UpdateWatchlist: Aktualisieren Sie den Namen und die Beschreibung einer benutzerdefinierten Beobachtungsliste 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 Beobachtungsliste 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 Voice 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 Voice ID-Domain.

  4. DisassociateFraudster: Trennen Sie einen Betrüger von der angegebenen Beobachtungsliste. 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 Beobachtungsliste 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.