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.
# Verwenden der Anruferauthentifizierung in Echtzeit mit Sprach-ID in Amazon Connect
**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 Amazon Connect 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](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
Amazon Connect Voice ID bietet Anruferauthentifizierung in Echtzeit und Erkennung von Betrugsrisiken, wodurch Sprachinteraktionen in Kontaktzentren sicherer und effizienter werden. Sprach-ID verwendet maschinelles Lernen, um die Identität von echten Kunden zu überprüfen, indem die einzigartigen Sprachmerkmale eines Anrufers analysiert werden. Auf diese Weise können Kontaktzentren eine zusätzliche Sicherheitsebene verwenden, die nicht darauf angewiesen ist, dass der Anrufer mehrere Sicherheitsfragen beantwortet, und es ist einfach, Kunden zu registrieren und zu verifizieren, ohne den natürlichen GesprächsFlow zu verändern. Sprach-ID ermöglicht außerdem die Echtzeiterkennung von Betrügern, die es häufig auf Ihr Contact Center abgesehen haben, und reduziert so die durch Betrug verursachten Verluste.
Mit Amazon Connect Voice ID können Sie:
+ Kunden passiv für die Sprachauthentifizierung registrieren, ohne dass sie ein bestimmtes Wort oder einen bestimmten Satz wiederholen müssen.
+ Migrieren Sie Kunden zu Sprach-ID, indem Sie sie stapelweise registrieren.
+ Überprüfen Sie die Identität der registrierten Kunden, indem Sie ihre individuellen Sprachmerkmale analysieren.
+ Erkennen Sie Betrüger anhand einer von Ihnen erstellten Watchlist.
+ Erkennen Sie Sprach-Spoofing.
## So funktioniert Sprach-ID
### Kundenregistrierung
1. Wenn ein Kunde zum ersten Mal anruft, bestätigt der Mitarbeiter die Identität des Anrufers mithilfe vorhandener Sicherheitsmaßnahmen, z. B. nach dem Mädchennamen der Mutter oder nach einem Einmalpasscode (OTP), der per SMS zugestellt wird. Dadurch wird sichergestellt, dass nur echte Kunden bei Sprach-ID registriert sind.
1. Sprach-ID beginnt mit der Spracherkennung des Kunden, nachdem der Kontakt auf den [Sprach-ID einrichten](set-voice-id.md)-Block gestoßen ist, in dem Sprach-ID aktiviert ist. Sprach-ID hört den Anruf ab, bis eines der folgenden Ereignisse eintritt:
+ Die Audiowiedergabe reicht aus, um den Sprecher auf Authentifizierung und Betrug hin zu bewerten und den Sprecher anzumelden (falls gewünscht). Dabei handelt es sich um eine 30-sekündige Kundenansprache, ohne Stille.
+ Der Anruf wird beendet.
1. Sprach-ID erstellt dann den Stimmabdruck für die Registrierung. Ein Stimmabdruck ist eine mathematische Darstellung, die implizit einzigartige Aspekte der Stimme einer Person wie Sprachrhythmus, Tonhöhe, Intonation und Lautstärke erfasst.
Der Anrufer muss keine bestimmten Sätze sagen oder wiederholen, um sich für Sprach-ID anzumelden.
### Kundenauthentifizierung
1. Wenn der registrierte Kunde erneut anruft, wird er durch eine Interaktion mit einem IVR oder während seiner Interaktion mit einem Kundendienstmitarbeiter verifiziert.
Standardmäßig ist Sprach-ID so konfiguriert, dass für die Authentifizierung 10 Sekunden Spracheingabe eines Anrufers erforderlich sind. Dies kann im Rahmen einer typischen Kundeninteraktion in der IVR oder mit dem Kundendienstmitarbeiter erfolgen (z. B. „Was ist Ihr Vor- und Nachname?“) und „Warum rufen Sie an?“). Sie können die Menge der benötigten Sprache mithilfe der [Reaktionszeit bei der Authentifizierung](set-voice-id.md#set-voice-id-properties-authentication-response-time)-Eigenschaft im [Sprach-ID einrichten](set-voice-id.md)-Block anpassen.
1. Sprach-ID generiert anhand des Audios den Stimmabdruck des Anrufers und vergleicht ihn mit dem registrierten Stimmabdruck, der der behaupteten Identität entspricht, und gibt ein Authentifizierungsergebnis zurück.
Weitere Informationen über die Kundendienstmitarbeitererfahrung finden Sie unter [Registrieren von Anrufern in Voice ID im Contact Control Panel (CCP)](use-voiceid.md).
## Wie viel Spracheingabe ist für die Registrierung und Authentifizierung erforderlich
+ Registrierung: 30 Sekunden Netzsprache des Kunden (Sprache, die jegliche Stille ausschließt), um einen Stimmabdruck zu erstellen und einen Kunden zu registrieren.
+ Überprüfung: Standardmäßig 10 Sekunden Netzansprache des Kunden, um zu überprüfen, ob die Stimme der angegebenen Identität entspricht. Die Sprache kann aus der Interaktion mit einem IVR oder einem Kundendienstmitarbeiter stammen. Sie können die Menge der erforderlichen Sprache mithilfe der [Reaktionszeit bei der Authentifizierung](set-voice-id.md#set-voice-id-properties-authentication-response-time)-Eigenschaft in [Sprach-ID einrichten](set-voice-id.md) anpassen.
## Batch-Registrierung
Sie können einen schnellen Einstieg in die Nutzung von Biometrie erhalten, indem Sie Kunden, die bereits der Nutzung von Biometrie zugestimmt haben, stapelweise registrieren. Mithilfe von gespeicherten Audioaufnahmen in Ihrem S3-Bucket und einer JSON-Eingabedatei, die die Lautsprecher-ID und einen Link zu den Audioaufnahmen enthält, können Sie den Voice ID-Batch aufrufen. APIs
Weitere Informationen finden Sie unter [Batch-Registrierung bei Amazon Connect Voice ID mit Audiodaten aus früheren Anrufen](voiceid-batch-enrollment.md).
## Bekannte Betrügererkennung
Es gibt einige Schritte, um die Erkennung von Betrügern in Echtzeit einzurichten:
1. [Erstellen Sie eine neue Watchlist](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_CreateWatchlist.html) zur Speicherung bekannter Betrüger. Oder verwenden Sie die Standard-Watchlist, die erstellt wird, wenn Sprach-ID aktiviert ist.
1. [Registrieren Sie Betrüger](voiceid-fraudster-watchlist.md) auf der neuen Watchlist bzw. der Standard-Watchlist.
1. Geben Sie im [Sprach-ID einrichten](set-voice-id.md)-Block an, welche Watchlist Sie verwenden möchten.
Wenn einer der Betrüger aus der im Flow angegebenen Watchlist Ihr Kontaktzentrum anruft, analysiert Sprach-ID den Ton des Anrufs, um eine Risikobewertung und ein Ergebnis zurückzugeben. Dieser Wert gibt an, wie genau der Stimmabdruck des Anrufers mit dem des Betrügers auf der Watchlist übereinstimmt. Sprach-ID benötigt 10 Sekunden Audio, um den Ton des Anrufs auf das Betrugsrisiko durch bekannte Betrüger zu überprüfen.
### Standard-Watchlist
Wenn die Sprach-ID-Domain erstellt wird, erstellt Sprach-ID eine Standard-Watchlist für Betrüger für diese Domain. Der Name und die Beschreibung der Standard-Watchlist für Betrüger werden mit dem KMS-Schlüssel verschlüsselt, der in der Domain bereitgestellt und in Sprach-ID gespeichert ist.
Wenn Sie die WatchListID für Betrüger nicht zur Betrugserkennung oder Registrierung von Betrügern angeben, verwendet Sprach-ID die standardmäßige Betrugsüberwachungsliste für Betrüger.
Sie können die Metadaten der Standard-Watchlist für Betrüger nicht aktualisieren, aber Sie können Betrüger dieser Liste zuordnen oder die Zuordnung zu ihr trennen.
**Anmerkung**
Wenn Ihre Sprach-ID-Domain vor März 2023 erstellt wurde, als die Watchlists für Betrüger eingeführt wurden: Es wurde eine Standard-Watchlist erstellt, in die alle vorhandenen Betrüger aufgenommen wurden.
## Erkennung von Sprach-Spoofing
1. Wenn ein potenzieller Betrüger versucht, den Ton des Anrufers mithilfe von Audiowiedergabe oder synthetisierter Sprache zu fälschen, gibt Sprach-ID eine Risikobewertung und ein Ergebnis zurück, um anzugeben, wie wahrscheinlich es ist, dass die Stimme gefälscht wurde.
1. Sprach-Spoofing ist nur aktiviert, wenn Sie die Betrugserkennungs-Features in Ihrem Gesprächsablauf aktivieren. Wenn nur die Sprecherauthentifizierung aktiviert ist, werden keine Ergebnisse für Sprach-Spoofing zurückgegeben.
1. Sprach-ID benötigt 10 Sekunden Audio, um den Ton des Anrufs auf das Betrugsrisiko durch Sprachfälschung zu überprüfen.
## Welche Daten werden gespeichert?
Sprach-ID speichert Audiodateien mit der Stimme, den Stimmabdrücken und den Sprecher-IDs des Sprechers. Diese Daten werden mit einem von Ihnen bereitgestellten KMS-Schlüssel verschlüsselt.
Wenn Sie die Erkennung von Betrügern in einer Watchlist aktivieren, speichert Sprach-ID auch das Audio und die Stimmabdrücke des Betrügers. Weitere Informationen finden Sie unter [Von Amazon Connect verarbeitete Daten](data-handled-by-connect.md).
# Ende des Supports von Amazon Connect Voice ID
Nach reiflicher Überlegung haben wir beschlossen, den Support für Amazon Connect Voice ID mit Wirkung zum 20. Mai 2026 einzustellen. Amazon Connect Voice ID akzeptiert ab dem 20. Mai 2025 keine Neukunden mehr. Als Bestandskunde mit einem Konto, das vor dem 20. Mai 2025 für den Service registriert wurde, können Sie die Features von Amazon Connect Voice ID weiterhin nutzen. Nach dem 20. Mai 2026 können Sie Amazon Connect Voice ID nicht mehr verwenden.
Auf dieser Seite finden Sie Anleitungen und bewährte Methoden für IT-Administratoren und Benutzer von Amazon Connect, um Voice ID auf alternative Lösungen umzustellen, die Ihren Geschäftsanforderungen entsprechen. Dies kann Lösungen von AWS Partnern umfassen, die auf dem AWS Marketplace verfügbar sind, wie [Pindrop®](https://aws.amazon.com/marketplace/pp/prodview-f7rqlwjby3er4), oder do-it-yourself Lösungen mit AWS End User Messaging SMS.
## Do-it-yourself Lösungen mit AWS End User Messaging SMS
Sie können die Sicherheit Ihres Kontaktzentrums verbessern, indem Sie die One-Time-Pin (OTP) -basierte Authentifizierung für Ihr Contact Center mit AWS End User Messaging SMS aktivieren. Sie können ein Lösungsbeispiel für die Aktivierung OTPs verwenden, AWS End User Messaging SMS um eine Lösung für Ihr Contact Center zu erstellen. Weitere Informationen zu dieser Lösung finden Sie im folgenden Blogbeitrag: [Erstellen Sie eine sichere Einmalkennwortarchitektur mit AWS](https://aws.amazon.com/blogs/messaging-and-targeting/build-a-secure-one-time-password-architecture-with-aws/). Weitere Informationen zu AWS End User Messaging SMS finden Sie unter [Was ist AWS End User Messaging SMS?](https://docs.aws.amazon.com/sms-voice/latest/userguide/what-is-sms-mms.html)
## Verwalten Ihrer Voice-ID-Daten
Mithilfe der Voice ID-API in Verbindung mit der `ListDomains` API können Sie Informationen zu all Ihren Voice ID-Domains in Ihrer AWS Buchhaltung abrufen. `DescribeDomain` Weitere Informationen zum Verwalten Ihrer Domains von Amazon Connect Voice ID finden Sie unter [Verwalten von Domains von Amazon Connect Voice ID](voiceid-domain-operations.md).
Für eine bestimmte Voice-ID-Domain können Sie Daten über registrierte Anrufer mithilfe der `ListSpeakers`-API und über registrierte Betrüger mithilfe der `ListFraudsters`-API herunterladen. Weitere Informationen zur Verwaltung von Sprechern und Betrügern finden Sie unter [Amazon Connect Voice ID Lautsprecher, Beobachtungsliste und Verwaltung von Betrügern APIs](voiceid-speaker-fraudster-management-apis.md). Mithilfe der Voice-ID-`DeleteDomain`-API können Sie sicherstellen, dass alle Ihre Kundendaten auf Voice ID gelöscht werden. Sie müssen diesen Vorgang für jede Voice ID-Domain in jeder AWS Region und für jedes Konto durchführen.
# Sprach-ID-Domains in Amazon Connect 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 Amazon Connect 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](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
Wenn Sie Amazon Connect Voice ID aktivieren, erstellen Sie eine Sprach-ID-Domain: einen Container für alle Sprach-ID-Daten, wie Sprecher-IDs (die als Kunden-ID dienen), die Sprachabdrücke, das Kundenaudio, das für die Erstellung der Stimmabdrücke verwendet wurde, und den Anmeldestatus (angemeldet, abgemeldet usw.), der mit den Sprecher-IDs verknüpft ist. Zur Erkennung von Betrügern in einer Watchlist speichert die Sprach-ID-Domain die Betrügerkennungen, Stimmabdrücke und Audiodaten, die für die Erstellung der Stimmabdrücke verwendet wurden.
Im Folgenden finden Sie Richtlinien für die Erstellung von Sprach-ID-Domains:
+ Jede Amazon Connect Instance kann nur einer Sprach-ID Domain zugeordnet werden.
+ Jede Sprach-ID Domain kann mehreren Amazon Connect Instances zugeordnet werden. Auf diese Weise können Sie dieselben gespeicherten Kundendaten für mehrere Amazon-Connect-Instances verwenden.
+ Sie können mehrere Domains erstellen, aber sie teilen keine Kundendaten untereinander.
+ Wir empfehlen, eine neue Sprach-ID-Domain zu erstellen, die mit einer Amazon-Connect-Instance verknüpft werden soll, wenn:
+ Sie aktivieren Sprach-ID zum ersten Mal für Ihr Konto in einer AWS -Region.
+ Sie möchten sicherstellen, dass Sie die Sprach-ID-Domains isolieren, die für Ihre Test- und Produktionsumgebungen verwendet werden.
+ Wir empfehlen, eine bestehende Sprach-ID-Domain zu verwenden, wenn:
+ Sie möchten dieselbe Gruppe registrierter Anrufer und Betrüger für verschiedene Amazon-Connect-Instances verwenden (die möglicherweise zu unterschiedlichen Kundenservice-Teams gehören)
+ Sie möchten dieselbe Testumgebung für verschiedene Amazon-Connect-Test-Instances verwenden.
**Anmerkung**
Nur bestehende Sprach-ID-Domains in derselben Region in Ihrem Amazon-Connect-Konto können von Amazon-Connect-Instances in dieser Region gemeinsam genutzt werden.
+ Sie können die Zuordnung Ihrer Amazon-Connect-Instance von Ihrer aktuellen Domain zu einer neuen Domain jederzeit ändern, indem Sie eine andere Domain auswählen.
+ Verwenden Sie die Voice ID-API, um eine [DeleteDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteDomain.html)Voice ID-Domain zu löschen. `DeleteDomain`löscht die Domain soft. Amazon Connect wartet 30 Tage, bevor die Domaindaten vollständig gelöscht werden. Während dieses Zeitraums ist Sprach-ID; für alle Amazon-Connect-Instances deaktiviert, mit denen es verknüpft ist. Um eine Domain während dieses Zeitfensters wiederherzustellen, reichen Sie ein Support Ticket ein und geben Sie die Domain-ID an. Sie finden die ID der Domain ID im Sprach-ID -Bereich der Amazon Connect, wie im folgenden Beispiel dargestellt:
![\[Der Abschnitt „Sprach-ID“ von Amazon Connect, in dem das Domain-ID-Feld von Amazon Connect angezeigt wird, das für die Wiederherstellung der Domain benötigt wird.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/voiceid-domain.png)
Durch das Löschen einer Sprach-ID-Domain werden alle gespeicherten Kundendaten wie Audioaufnahmen, Stimmabdrücke und Sprecher-Identifikatoren sowie alle von Ihnen verwalteten Watchlists für Betrüger gelöscht.
## Registrierungsstatus
Sprach-ID speichert drei verschiedene Anmeldestatus für einen Sprecher: `ENROLLED`, ` OPTED_OUT` und `EXPIRED`. Sie können diesen Lautsprecherstatus mithilfe der [Amazon Connect Voice ID APIs](https://docs.aws.amazon.com/voiceid/latest/APIReference/) und mithilfe von Kontaktflussblöcken abrufen, um entsprechende Maßnahmen zu ergreifen.
+ `ENROLLED`: Wenn Sie sich registrieren, wird ein neuer Anrufer bei Sprach-ID registriert, erstellt Sprach-ID einen neuen Sprachabdruck und legt den Lautsprecherstatus auf fest. `ENROLLED` Auch wenn Sie denselben Anrufer erneut bei Sprach-ID registrieren, bleibt der Status `ENROLLED`.
+ `OPTED_OUT`: Wenn ein Anrufer der Registrierung für Biometrie nicht zustimmt, können Sie den Anrufer abbestellen (im Contact Control Panel) oder über. APIs Sprach-ID erstellt einen neuen Eintrag für diesen Anrufer und legt den Status des Sprechers als `OPTED_OUT` fest. Sprach-ID generiert keinen Stimmabdruck und speichert keine Audioaufnahme für den Sprecher. Künftige Registrierungsanfragen für diesen Sprecher werden abgelehnt, sofern der Eintrag nicht gelöscht wird.
+ `EXPIRED`: Wenn seit 3 Jahren nicht auf den Sprachabdruck eines Anrufers zugegriffen oder dieser aktualisiert wurde, ändert Sprach-ID den Status auf `EXPIRED`, und Sie können für diesen Anrufer keine Authentifizierungen mehr durchführen. Sie können den Anrufer erneut registrieren oder den Anrufer aus Sprach-ID löschen.
## Abgelaufene Sprecher
Aus Gründen der BIPA-Konformität verfallen bei Sprach-ID automatisch Sprecher, auf die seit drei Jahren kein Zugriff mehr für die Registrierung, erneute Registrierung oder erfolgreiche Authentifizierung erfolgt ist.
Um den letzten Zugriff eines Sprechers einzusehen, schauen Sie sich das `lastAccessedAt` Attribut an, das von und zurückgegeben wird. `DescribeSpeaker` `ListSpeakers` APIs
Wenn Sie versuchen, die `EvaluateSesssion`-API zur Authentifizierung eines abgelaufenen Sprechers zu verwenden, wird eine `SPEAKER_EXPIRED`-Authentifizierungsentscheidung zurückgegeben.
Um den abgelaufenen Sprecher erneut verwenden zu können, muss er erneut registriert werden.
## Identifikatoren für Sprecher und Betrüger
Sprach-ID verwendet Sprecher-Identifikatoren, um auf die Stimmabdrücke in einer Sprach-ID-Domain zu verweisen und diese abzurufen. Wir empfehlen Ihnen, Identifikatoren zu verwenden, die keine persönlich identifizierbaren Informationen (PII) in den Identifikatoren enthalten.
Sprach-ID erstellt zwei Felder, die auf einen Anrufer verweisen:
+ `CustomerSpeakerId`: Eine vom Kunden bereitgestellte Kennung. Sie kann zwischen 1 und 256 Zeichen lang sein und darf nur Folgendes enthalten: **a-z**, **A-Z**, **0-9**, – ****und **\$1**
+ `GeneratedSpeakerId`: Eine eindeutige 22-stellige alphanumerische Zeichenfolge, die Sprach-ID bei der Registrierung des Anrufers erstellt und zurückgibt.
[Amazon Connect Voice ID-Lautsprecher APIs](https://docs.aws.amazon.com/voiceid/latest/APIReference/Welcome.html) akzeptieren beide Arten von Lautsprecher-IDs, geben sie jedoch nur `GeneratedSpeakerId` in den Voice ID-Event-Streams und Kontaktdatensätzen aus. Wenn Sie den Anrufer erneut aufnehmen möchten, um den Sprachabdruck zu wiederholen, können Sie den Anrufer mit demselben `CustomerSpeakerId` registrieren.
In ähnlicher Weise erstellt Sprach-ID eindeutige Betrüger-Identifikatoren, die `GeneratedFraudsterID` genannt werden, für jeden Betrüger, den Sie zu einer Watchlist in der Domain hinzufügen. Sprach-ID gibt die Betrüger-ID zurück, wenn bei der Erkennung eines Betrugsrisikos ein Betrüger in einem Anruf erkannt wird.
# Erste Schritte zur Aktivierung der Sprach-ID in Amazon Connect
**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 Amazon Connect 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](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
## Bevor Sie beginnen
Bevor Sie beginnen, sollten Sie die folgenden Aufgaben erledigen.
**Topics**
+ [Sie müssen die erforderlichen Berechtigungen erteilen.](#enable-voiceid-permissions)
+ [Entscheiden Sie, wie Sie Ihre Sprach-ID-Domain benennen möchten](#enable-voiceid-domains)
+ [Erstellen Sie einen AWS KMS key , um in der Domain gespeicherte Daten zu verschlüsseln](#enable-voiceid-awsmanagedkey)
### Sie müssen die erforderlichen Berechtigungen erteilen.
Sie müssen den Benutzern, Gruppen oder Rollen die erforderlichen Berechtigungen erteilen. Weitere Informationen finden Sie unter [AmazonConnectVoiceIDFullAccess](security_iam_awsmanpol.md#amazonconnectvoiceidfullaccesspolicy).
Der Zugriff auf Voice ID APIs über das Contact Control Panel (CCP) ist standardmäßig deaktiviert.
### Entscheiden Sie, wie Sie Ihre Sprach-ID-Domain benennen möchten
Wenn Sie Voice ID aktivieren, werden Sie aufgefordert, einen benutzerfreundlichen Domainnamen anzugeben, der für Sie von Bedeutung ist, z. B. den Namen Ihres Unternehmens, z. B. *Voice ID- ExampleCorp*.
### Erstellen Sie einen AWS KMS key , um in der Domain gespeicherte Daten zu verschlüsseln
Wenn Sie Sprach-ID aktivieren, werden Sie aufgefordert, eine [AWS KMS key](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#kms_keys) zu erstellen oder anzugeben. Es verschlüsselt die von Sprach-ID gespeicherten Kundendaten wie Audiodateien, Stimmabdrücke und die Sprecher-IDs.
Step-by-step Anweisungen zum Erstellen dieser KMS-Schlüssel finden Sie unter[Schritt 2: Erstellen einer neuen Sprach-ID-Domain und eines neuen Verschlüsselungsschlüssels](#enable-voiceid-step2).
Daten im Ruhezustand – insbesondere die von Ihnen bereitgestellten Freiformfelder sowie Audiodateien/Sprachausdrucke – werden unter dem von Ihnen ausgewählten KMS-Schlüssel verschlüsselt. Kundenverwalteter Schlüssel – Der Schlüssel wird in Ihrem Konto gespeichert und von Ihnen erstellt, besessen und verwaltet. Sie haben die volle Kontrolle über den KMS-Schlüssel (es AWS KMS fallen Gebühren an).
Wenn Sie Sprach-ID für etwas anderes als `CreateDomain` oder `UpdateDomain` aufrufen, benötigt der Benutzer, der den Anruf tätigt, `kms:Decrypt`-Berechtigungen für den Schlüssel, der der Domain zugeordnet ist. Beim Aufrufen von `CreateDomain` oder `UpdateDomain` benötigt der Benutzer auch – `kms:DescribeKey`und `kms:CreateGrant`-Berechtigungen für den Schlüssel. Wenn Sie eine Sprach-ID-Domain erstellen (oder aktualisieren), wird ein Grant für den KMS-Schlüssel erstellt, sodass dieser von asynchronen Sprach-ID-Prozessen (wie der Sprecherregistrierung) und von der mit dem Amazon-Connect-Dienst verknüpften Rolle während Ihrer Flows verwendet werden kann. Dieser Zuschuss beinhaltet einen Verschlüsselungskontext, der die Domain angibt, der der Schlüssel zugeordnet ist. Weitere Informationen zu Erteilungen finden Sie unter [Verwenden von Erteilungen](https://docs.aws.amazon.com/kms/latest/developerguide/grants.html) im AWS Key Management Service -Entwicklerhandbuch.
Wenn Sie eine Domain erstellen und sie einem Schlüssel zuordnen, einige Daten speichern und dann den KMS-Schlüssel in einen anderen Schlüssel ändern, wird ein asynchroner Prozess ausgelöst, um die alten Daten mit dem neuen KMS-Schlüssel erneut zu verschlüsseln. Nach Abschluss dieses Vorgangs werden alle Daten Ihrer Domain mit dem neuen KMS-Schlüssel verschlüsselt, und Sie können den alten Schlüssel problemlos zurückziehen. Weitere Informationen finden Sie unter [UpdateDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_UpdateDomain).
**Tipp**
Sie können KMS-Schlüssel erstellen oder einen vorhandenen KMS-Schlüssel programmgesteuert bereitstellen. Weitere Informationen finden Sie unter [Amazon Connect Voice ID APIs](https://docs.aws.amazon.com/voiceid/latest/APIReference/).
## Schritt 1: Die BIPA-Einwilligungsbestätigung lesen
Für die Aktivierung von Sprach-ID ist es erforderlich, die Einwilligungsbestätigung des Biometric Privacy Act (BIPA) zu lesen. Sie müssen dies nur einmal pro Konto in allen Regionen tun. Sie können diesen Schritt nicht mithilfe von ausführen APIs. Weitere Informationen zu BIPA finden Sie in diesem Wikipedia-Artikel: [Biometric Information Privacy Act](https://en.wikipedia.org/wiki/Biometric_Information_Privacy_Act).
1. Öffnen Sie die Amazon Connect Connect-Konsole unter [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. Wählen Sie auf der Seite „Instances“ den Instance-Alias aus. Der Instance-Alias ist auch Ihr **Instance-Name**, der in Ihrer Amazon-Connect-URL erscheint. In der folgenden Abbildung sehen Sie die Seite **Instances des virtuellen Contact Centers für Amazon Connect** mit einem Rahmen um den Instance-Alias.
![\[Die Seite „Instances des virtuellen Contact Centers für Amazon Connect“, „Instance Alias“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/instance.png)
1. Wählen Sie im Navigationsbereich die Option **Sprach-ID**. Lesen Sie die BIPA-Einwilligungserklärung und akzeptieren Sie sie, wenn Sie damit einverstanden sind.
![\[Auf der Seite „Sprach-ID aktivieren“ wird die Schaltfläche zur Bestätigung der Zustimmung nach dem BIPA-Gesetz (Biometric Information Privacy Act) angezeigt, die Benutzer lesen und akzeptieren müssen, bevor sie die Sprach-ID aktivieren können.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/voiceid-bipa.png)
## Schritt 2: Erstellen einer neuen Sprach-ID-Domain und eines neuen Verschlüsselungsschlüssels
Sie können diesen Schritt mit der Amazon Connect-Konsole oder mit Amazon Connect und Voice ID ausführen APIs.
------
#### [ Amazon Connect console instructions ]
1. Wählen Sie im Bereich **Domain-Setup** die Option **Neue Domain erstellen** aus.
![\[Oberfläche des Domain-Setups mit Optionen zum Erstellen einer neuen Domain oder Auswahl einer vorhandenen Domain\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/voiceid-enable-domain.png)
1. Geben Sie im Feld **Domainname** einen benutzerfreundlichen Namen ein, der für Sie von Bedeutung ist, z. B. den Namen Ihrer Organisation, zum Beispiel *VoiceID* -. ExampleCorp
1. Erstellen Sie unter **Verschlüsselung** eine eigene AWS KMS key , um Ihre Voice ID-Domain zu verschlüsseln, oder geben Sie sie ein. Im Folgenden finden Sie die Schritte zum Erstellen Ihres KMS-Schlüsselschlüssels:
1. Wählen Sie **KMS-Schlüssel erstellen**.
![\[Der Abschnitt „Verschlüsselung“ auf der Seite zum Einrichten der Sprach-ID enthält die Schaltfläche „AWS-KMS-Schlüssel erstellen“ zum Erstellen eines neuen Verschlüsselungsschlüssels.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/voiceid-create-kms-key.png)
1. In Ihrem Browser wird eine neue Registerkarte für die Konsole „Key Management Service (KMS)“ geöffnet. Klicken Sie auf der Seite **Schlüssel konfigurieren** auf **Symmetrisch** und dann auf **Weiter**.
![\[Konfigurieren Sie die Schlüsselseite so, dass der symmetrische Schlüsseltyp für die Verschlüsselung und Entschlüsselung ausgewählt ist.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/customer-profiles-create-kms-key-configure-key.png)
1. Fügen Sie auf der Seite **Labels hinzufügen** einen Namen und eine Beschreibung für den KMS-Schlüssel hinzu, und klicken Sie dann auf **Weiter**.
1. Wählen Sie auf der Seite **Definieren wichtiger administrativer Berechtigungen** die Option **Weiter** aus.
1. Klicken Sie auf der Seite **Schlüsselnutzungsberechtigungen definieren** auf **Weiter**.
1. Wählen Sie auf der Seite **Überprüfung und Bearbeitung der wichtigsten Richtlinien** die Option **Fertigstellen** aus.
1. Kehren Sie in Ihrem Browser zur Seite **Sprach-ID** für die Amazon-Connect-Konsole zurück. Klicken oder tippen Sie darauf, **AWS KMS key** damit der Schlüssel, den Sie erstellt haben, in einer Dropdownliste angezeigt wird. Wählen Sie den von Ihnen erstellten Schlüssel.
1. Wählen Sie **Sprach-ID aktivieren**.
------
#### [ API instructions ]
1. Rufen Sie die [CreateDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_CreateDomain.html)API auf, um eine neue Voice ID-Domain zu erstellen.
1. Rufen Sie die [CreateIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateIntegrationAssociation.html)API auf, um die Voice ID-Domain mit der Amazon Connect Connect-Instance zu verknüpfen.
1. Übergeben Sie den ARN der soeben erstellten Sprach-ID-Domain in den `IntegrationArn`-Parameter. Verwenden Sie `VOICE_ID` für `IntegrationType`.
------
Sie haben Sprach-ID für Ihre Instance aktiviert. Folgendes wurde erstellt:
+ Ihre Sprach-ID-Domain und eine Standard-Watchlist für Betrüger, auf der Ihre Betrüger gespeichert sind.
+ Eine verwaltete EventBridge Amazon-Regel in Ihrem Konto. Diese Regel wird verwendet, um Sprach-ID-Ereignisse zu erfassen, um Kontaktdatensätze im Zusammenhang mit Sprach-ID zu erstellen. Darüber hinaus fügt Amazon Connect der serviceverknüpften Rolle für Amazon Connect Voice ID[-Berechtigungen](connect-slr.md) hinzu.
Als Nächstes konfigurieren Sie in Schritt 3, wie Sprach-ID in Ihrem Flow funktionieren soll.
## Schritt 3: Konfigurieren Sie Sprach-ID in Ihrem Flow
In diesem Schritt fügen Sie Ihrem Flow die erforderlichen Blöcke hinzu und konfigurieren, wie Sprach-ID funktionieren soll.
+ [Play prompt (Telefonansage wiedergeben)](play.md): Fügen Sie diesen Block vor dem [Sprach-ID einrichten](set-voice-id.md)-Block hinzu, um Audio richtig zu streamen. Sie können ihn so bearbeiten, dass er eine einfache Nachricht wie „Willkommen“ enthält.
+ [Sprach-ID einrichten](set-voice-id.md): Fügen Sie nach dem [Play prompt (Telefonansage wiedergeben)](play.md)-Block den [Sprach-ID einrichten](set-voice-id.md)-Block hinzu. Es sollte zu Beginn eines Anrufs sein. Verwenden Sie diesen Block, um mit dem Streamen von Audio zu Amazon Connect Voice ID zu beginnen, um die Identität des Anrufers zu überprüfen, sobald der Anruf mit einem Flow verbunden ist.
Unter **Sprach-ID-Block festlegen** konfigurieren Sie den Authentifizierungsschwellenwert, die Antwortzeit, die Betrugsschwelle und die Betrugsüberwachungsliste, die für die Erkennung bekannter Betrüger verwendet werden sollen.
+ [Set contact attributes (Kontaktattribute festlegen)](set-contact-attributes.md): Wird verwendet, um das `CustomerId`-Attribut an Sprach-ID zu übergeben. `CustomerId` kann beispielsweise eine Kundennummer aus Ihrem CRM sein. Sie können eine Lambda-Funktion erstellen, um die eindeutige Kunden-ID des Anrufers aus Ihrem CRM-System abzurufen. Sprach-ID verwendet dieses Attribut als `CustomerSpeakerId` für den Anrufer.
**Anmerkung**
`CustomerId` kann ein alphanumerischer Wert sein. Es unterstützt nur die Sonderzeichen „\$1“ und „-“ (Unterstrich und Bindestrich). Es muss keine UUID sein. Da Voice ID biometrische Informationen für jeden Sprecher speichert, empfehlen wir dringend, eine Kennung zu verwenden, die keine personenbezogenen Daten in dem CustomerSpeakerId Feld enthält. Weitere Informationen finden Sie in `CustomerSpeakerId` unter dem Datentyp [Speaker](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_Speaker.html).
+ [„Voice-ID prüfen“](check-voice-id.md): Wird verwendet, um die Antwort von Sprach-ID auf den Anmeldestatus, die Sprachauthentifizierung und die Betrugserkennung zu überprüfen und dann anhand eines der zurückgegebenen Status zu verzweigen.
### Sprach-ID – Beispiel
**Der Anrufer ist nicht registriert**
1. Wenn ein Kunde zum ersten Mal anruft, wird seine `CustomerId` mithilfe des [Set contact attributes (Kontaktattribute festlegen)](set-contact-attributes.md)-Blocks an Sprach-ID weitergeleitet.
1. Sprach-ID sucht `CustomerId` in der Datenbank. Da sie nicht dort ist, sendet sie die Ergebnismeldung **Nicht registriert**. Der [„Voice-ID prüfen“](check-voice-id.md)-Block verzweigt sich auf der Grundlage dieses Ergebnisses, und Sie können entscheiden, was der nächste Schritt sein soll. Beispielsweise möchten Sie möglicherweise, dass Kundendienstmitarbeiter den Kunden für die Sprach-ID registrieren.
1. Sprach-ID beginnt mit der Spracherkennung des Kunden, nachdem der Kontakt auf den [Sprach-ID einrichten](set-voice-id.md)-Block gestoßen ist, in dem Sprach-ID aktiviert ist. Es hört zu, bis es 30 Sekunden Netzsprache gesammelt hat oder der Anruf beendet wird, je nachdem, was zuerst eintritt.
**Anrufer ist registriert**
1. Wenn der Kunde das nächste Mal anruft, findet Sprach-ID seine `CustomerId` in der Datenbank.
1. Sprach-ID beginnt mit dem Abhören des Audios, um einen Stimmabdruck zu erstellen. Der Sprachabdruck, der dieses Mal erstellt wird, wird zu Authentifizierungszwecken verwendet, sodass Sprach-ID vergleichen kann, ob der Anrufer zuvor registriert war.
1. Dabei wird der aktuelle Stimmabdruck des Anrufers mit dem gespeicherten Stimmabdruck verglichen, der der beanspruchten Identität zugeordnet ist. Es gibt ein Ergebnis zurück, das auf der Eigenschaft **Authentifizierungsschwellenwert** basiert, die Sie im [Sprach-ID einrichten](set-voice-id.md)-Block konfiguriert haben.
1. Nach der Auswertung der Sprache wird die Meldung **Authentifiziert** zurückgegeben, wenn die Stimmabdrücke ähnlich sind. Oder es gibt einen der anderen Status zurück.
1. Der Kontakt wird dann vom [„Voice-ID prüfen“](check-voice-id.md)-Block an den entsprechenden Zweig weitergeleitet.
# Sicherheitsprofilberechtigungen für Amazon Connect 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 Amazon Connect 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](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
+ Damit Benutzer anhand ihres Sprach-ID-Status nach Kontakten suchen können, weisen Sie ihrem Sicherheitsprofil die folgende **Analyse- und Optimierungsberechtigung** zu:
+ **Sprach-ID – Attribute und Suche**: Ermöglicht es Benutzern, auf der Seite **Kontaktdetails** nach Sprach-ID-Ergebnissen zu suchen und diese anzuzeigen.
+ Um Kundendienstmitarbeiter Zugriff auf Sprach-ID im Contact Control Panel zu gewähren, weisen Sie der Gruppe **Contact Control Panel** die folgende Berechtigung zu:
+ **Sprach-ID – Zugriff**: Aktiviert Steuerungen im Contact Control Panel, sodass Kundendienstmitarbeiter:
+ Authentifizierungsergebnisse anzeigen.
+ Melden Sie sich ab oder authentifizieren Sie einen Anrufer erneut.
+ Aktualisieren von `SpeakerID`.
+ Sehen Sie sich die Ergebnisse der Betrugserkennung an und führen Sie die Betrugsanalyse erneut durch (Entscheidung zur Betrugserkennung, Betrugstyp und -bewertung).
**Anmerkung**
Die Funktion zum Eingeben oder Aktualisieren von `SpeakerID` ist mit dem Standard-Sprach-ID-Widget im CCP nicht verfügbar. Um die Option zur Aktualisierung von `SpeakerID` einzubeziehen, implementieren Sie die `updateVoiceIdSpeakerId`-[Amazon-Connect-Streams](https://github.com/aws/amazon-connect-streams)-API in Ihrem benutzerdefinierten CCP.
Die folgende Abbildung zeigt ein Beispiel für diese Steuerelemente auf dem CCP:
![\[Control Panel (CCP) mit Sprach-ID-Steuerelementen wie Anmeldestatus, Authentifizierungsergebnis und Schaltflächen für die Registrierung oder Abmeldung von Kunden\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/voiceid-ccp-controls.png)
Weitere Informationen zum Hinzufügen weiterer Berechtigungen zu einem vorhandenen Sicherheitsprofil finden Sie unter [Aktualisieren von Sicherheitsprofilen in Amazon Connect](update-security-profiles.md).
Standardmäßig verfügt das **Admin**-Sicherheitsprofil bereits über Berechtigungen zur Durchführung aller Sprach-ID-Aktivitäten.
# Suchen und Überprüfen der Ergebnisse der Sprach-ID-Authentifizierung
**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 Amazon Connect 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](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
Verwenden Sie die Seite [Kontaktsuche](contact-search.md), um in einer Watchlist nach den Ergebnissen für den Anmeldestatus, die Sprachauthentifizierung und die Erkennung von Betrügern zu suchen und diese zu überprüfen. Mit den erforderlichen [Sicherheitsprofilberechtigungen](contact-search.md#required-permissions-search-contacts) (**Analytik und Optimierung** – **Sprach-ID – Attribute und Suche – Ansicht**) können Sie mithilfe der folgenden Filter nach Sprach-ID-Ergebnissen suchen:
+ **Aktionen des Sprechers**: Verwenden Sie diesen Filter, um nach Kontakten zu suchen, bei denen der Anrufer bei Sprach-ID registriert war, oder entscheiden Sie sich dafür, Sprach-ID ganz zu deaktivieren.
+ **Authentifizierungsergebnis**: Verwenden Sie diesen Filter, um nach Kontakten zu suchen, bei denen die Sprach-ID-Authentifizierung zu folgenden Ergebnissen geführt hat:
+ Authentifiziert
+ Nicht authentifiziert
+ Abgemeldet
+ Nicht schlüssig
+ Nicht registriert
**Wenn Sie beispielsweise nach allen Kontakten suchen möchten, bei denen der Authentifizierungsstatus „**Nicht authentifiziert**“ oder „Abgemeldet“ zurückgegeben wurde, wählen Sie beide Optionen **aus** und klicken Sie auf Anwenden.**
+ **Ergebnis der Betrugserkennung**: Verwenden Sie diesen Filter, um nach Kontakten zu suchen, bei denen die Sprach-ID-Betrugsanalyse zu folgenden Ergebnissen geführt hat:
+ Hohes Betrugsrisiko
+ Geringes Betrugsrisiko
+ Nicht schlüssig
+ **Grund für die Betrugserkennung**: Verwenden Sie diesen Filter, um nach Kontakten zu suchen, bei denen bestimmte Betrugsrisikomechanismen entdeckt wurden:
+ Bekannter Betrüger: Die Stimme des Anrufers entspricht einem Betrüger aus der von Ihnen erstellten Betrüger-Watchlist.
+ Sprachfälschung: Der Anrufer verändert seine Stimme oder verwendet Sprachsynthese, um den Kundendienstmitarbeiter zu fälschen.
## Sprach-ID führt zu einem Kontaktdatensatz
Nachdem Sie nach einem Kontakt gesucht haben, können Sie eine ID auswählen, um dessen Kontaktdatensatz anzuzeigen. Die folgende Abbildung zeigt ein Beispiel für die Felder im Sprach-ID -Bereich des Kontaktdatensatzes:
![\[Sprach-ID-Bereich eines Kontaktdatensatzes mit den Feldern für Authentifizierungsergebnisse, Status der Betrügererkennung, Betrüger-ID und Watchlist-ID.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/voiceid-ctr-nospoofing.png)
# Amazon Connect Voice ID mit der Voice ID verwalten APIs
**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 Amazon Connect 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](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
Informationen zur programmgesteuerten Verwaltung von Voice ID finden Sie unter [Amazon Connect Voice](https://docs.aws.amazon.com/voiceid/latest/APIReference/) ID. APIs
In diesem Abschnitt wird erklärt, wie allgemeine Szenarien mit der Voice ID durchgeführt werden. APIs
**Topics**
+ [Verwalten von Domains von Amazon Connect Voice ID](voiceid-domain-operations.md)
+ [Amazon Connect Connect-Integrationsvereinigung APIs](voiceid-integration-association-apis.md)
+ [Verwaltung von Lautsprechern, Beobachtungslisten und Betrügern APIs](voiceid-speaker-fraudster-management-apis.md)
+ [Batch-Registrierung bei Amazon Connect Voice ID mit Audiodaten aus früheren Anrufen](voiceid-batch-enrollment.md)
+ [Dateischema für den Speaker Enrollment Job](speaker-enrollment-job-schema.md)
+ [Erstellen und Bearbeiten einer Betrüger-Watchlist in Amazon Connect Voice ID](voiceid-fraudster-watchlist.md)
+ [Dateischema für den Job zur Registrierung von Betrügern](fraudster-registration-schema.md)
+ [Amazon Connect Streams APIs zur Integration von Voice ID](voiceid-streams-apis.md)
# Verwalten von Domains von Amazon Connect 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 Amazon Connect 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](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
Amazon Connect Voice ID ermöglicht Ihnen APIs die Verwaltung von Voice ID-Domains. Entsprechungen für „Erstellen“, „Beschreiben“, „Auflisten“ und „Aktualisieren“ finden Sie in der AWS Konsole.
1. [CreateDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_CreateDomain.html): Verwenden Sie die Voice ID-API, um eine neue `CreateDomain` Voice ID-Domain zu erstellen. Wenn die Sprach-ID-Domain erstellt wird, wird gleichzeitig eine Standard-Watchlist für Betrüger erstellt, auf der Ihre Betrüger gespeichert sind.
Beachten Sie bei der Verwendung der `CreateDomain`-API die folgenden Richtlinien:
+ Sie können dies für Ihr Konto erst aufrufen, nachdem Sie die BIPA-Zustimmung in der AWS Konsole bestätigt haben.
+ Sie müssen bei der Erstellung auch den KMS-Schlüssel für die Sprach-ID-Domain angeben.
+ Nachdem Sie eine Voice ID-Domain erstellt haben, verwenden Sie die [Amazon Connect Connect-Verknüpfung APIs](https://docs.aws.amazon.com/connect/latest/APIReference/), um sie einer Amazon Connect Connect-Instance zuzuordnen.
1. [DeleteDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteDomain.html): Um eine Voice ID-Domain zu löschen, müssen Sie die `DeleteDomain` Voice ID-API aufrufen und die Domain-ID angeben. Wenn diese Domain mit einer Amazon-Connect-Instance verknüpft war, geben Sprach-ID-API-Aufrufe und Sprach-ID-Flow-Blöcke einen Laufzeitfehler zurück. Durch das Löschen einer Sprach-ID-Domain werden alle gespeicherten Kundendaten wie Audioaufnahmen, Stimmabdrücke und Sprecherkennungen sowie von Ihnen verwaltete Betrügerlisten gelöscht.
1. [DescribeDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DescribeDomain.html): Verwenden Sie diese API, um den Namen, die Beschreibung und die Verschlüsselungskonfiguration einer vorhandenen Domain zurückzugeben, die durch ihre `DomainID` identifiziert wurde.
1. [ListDomains](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_ListDomains.html): Verwenden Sie diese API, um alle Ihre Voice ID-Domains aufzulisten, die Ihrem Konto in der Region gehören.
1. [UpdateDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_UpdateDomain.html): Um den Namen und die Verschlüsselungskonfiguration für eine Domain zu aktualisieren, können Sie die `UpdateDomain` Voice ID-API verwenden. Diese API blockiert vorhandene Attribute, und Sie müssen beide Felder angeben.
Wenn Sie den KMS-Schlüssel ändern, der der Sprach-ID-Domain zugeordnet ist, werden die vorhandenen Daten Ihrer Domain nach dem `UpdateDomain`-Auruf asynchron unter dem neuen KMS-Schlüssel erneut verschlüsselt. Sie können den Status dieses Vorgangs mithilfe der `DescribeDomain`-API anhand des `ServerSideEncryptionUpdateDetails`-Attributs Ihrer Domain überprüfen. Während dieses Aktualisierungsvorgangs müssen Sie Ihren alten KMS-Schlüssel in einem zugänglichen Zustand aufbewahren, da dieser Vorgang andernfalls fehlschlagen kann. Nach Abschluss dieses Vorgangs kann der alte KMS-Schlüssel sicher zurückgezogen werden.
# Voice ID und Amazon Connect Integration Association APIs
**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 Amazon Connect 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](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
Sie können Folgendes verwenden APIs , um Verknüpfungen mit Amazon Connect Connect-Instances zu verwalten. Sie können diese Operationen auch auf der AWS Konsole ausführen.
1. [CreateIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateIntegrationAssociation.html): Um Voice ID auf einer Amazon Connect Connect-Instance zu aktivieren, müssen Sie mithilfe einer `CreateIntegrationAssociation` Anfrage eine Voice ID-Domain mit einer Amazon Connect Connect-Instance verknüpfen. Sie können einer Amazon-Connect-Instance nur eine Sprach-ID-Domain zuordnen. Wenn die Instance bereits mit einer Domain verknüpft ist, gibt die API den folgenden Fehler zurück:
`DuplicateResourceException` (409) – Die Anfrage versucht, eine doppelte Ressource zu erstellen.
**Anmerkung**
Wenn Sie Voice ID für eine Amazon Connect-Instance aktivieren (entweder mithilfe der Amazon Connect Connect-Konsole oder der [CreateIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateIntegrationAssociation.html)API), erstellt Amazon Connect eine verwaltete EventBridge Amazon-Regel in Ihrem Konto. Diese Regel wird verwendet, um Sprach-ID-Ereignisse zu erfassen, um Kontaktdatensätze im Zusammenhang mit Sprach-ID zu erstellen. Darüber hinaus fügt Amazon Connect der serviceverknüpften Rolle für Amazon Connect Voice ID[-Berechtigungen](connect-slr.md) hinzu.
1. [DeleteIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_DeleteIntegrationAssociation.html): Um eine bestehende Verknüpfung zwischen einer Amazon Connect Connect-Instance und einer Voice ID-Domain zu löschen, müssen Sie die `DeleteIntegrationAssociation` APIs zusammen mit der Amazon Connect Connect-InstanceID und der `IntegrationAssociationID` zurückgesendeten von aufrufen. `CreateIntegrationAssociation` Dieser Schritt ist erforderlich, wenn Sie dieser Amazon-Connect-Instance eine andere Sprach-ID-Domain zuordnen möchten. Wir empfehlen nicht, Verknüpfungen in einem Produktionssetup zu löschen, da dies zu unvorhersehbarem Verhalten der Sprach-ID in Ihrer Amazon-Connect-Instance führen kann.
1. [ListIntegrationAssociations](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListIntegrationAssociations.html): Um alle Verknüpfungen zwischen Amazon Connect Connect-Instance und Voice ID-Domains für Ihr Konto in dieser Region aufzulisten, können Sie die `ListIntegrationAssociations` API aufrufen.
# Amazon Connect Voice ID Lautsprecher, Beobachtungsliste und Verwaltung von Betrügern APIs
**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 Amazon Connect 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](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
Amazon Connect Voice ID umfasst die Verwaltung von Lautsprechern APIs , 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 das Oder. `CustomerSpeakerId` `GeneratedSpeakerId`
## Verwaltung der Lautsprecher APIs
1. [DescribeSpeaker](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DescribeSpeaker.html): Beschreiben Sie [den Status eines Sprechers in einer Domain (ENROLLED, OPTED\$1OUT, EXPIRED)](voiceid-domain.md#voiceid-speaker-enrollments) und ordnen Sie a einer `GeneratedSpeakerId` zu und umgekehrt`CustomerSpeakerId`.
1. [DeleteSpeaker](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteSpeaker.html): 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.
1. [ListSpeakers](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_ListSpeakers.html): 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.
1. [OptOutSpeaker](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_OptOutSpeaker.html): 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.
## Verwaltung von Beobachtungslisten APIs
1. [CreateWatchlist](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_CreateWatchlist.html): Erstellen Sie eine Beobachtungsliste, an der Betrüger teilnehmen können.
1. [DeleteWatchlist](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteWatchlist.html): 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 das [DeleteFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteFraudster.html)oder verwenden, [DisassociateFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DisassociateFraudster.html) APIs um alle Betrüger von einer Beobachtungsliste zu entfernen.
Sie können die Standard-Watchlist nicht aus einer Sprach-ID-Domain löschen.
1. [DescribeWatchlist](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DescribeWatchlist.html): 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.
1. [ListWatchlists](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_ListWatchlists.html): Listet alle Beobachtungslisten in der Voice ID-Domain auf.
1. [UpdateWatchlist](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_UpdateWatchlist.html): 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.
## Verwaltung von Betrügern APIs
1. [AssociateFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_AssociateFraudster.html): Ordnen Sie einen Betrüger einer Beobachtungsliste in derselben Domain zu. Sie können einen Betrüger mehreren Watchlists in einer Domain zuordnen.
1. [DeleteFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteFraudster.html): 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.
1. [DescribeFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DescribeFraudster.html): Beschreiben Sie den Status eines Betrügers in der Voice ID-Domain.
1. [DisassociateFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DisassociateFraudster.html): 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.
1. [ListFraudsters](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_ListFraudsters.html): 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.
# Batch-Registrierung bei Amazon Connect Voice ID mit Audiodaten aus früheren Anrufen
**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 Amazon Connect 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](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
Sie können einen schnellen Einstieg in die Nutzung von Biometrie erhalten, indem Sie Kunden, die bereits der Nutzung von Biometrie zugestimmt haben, stapelweise registrieren. Mithilfe von gespeicherten Audioaufnahmen in Ihrem S3-Bucket und einer JSON-Eingabedatei, die die Lautsprecher-ID und einen Link zu den Audioaufnahmen enthält, können Sie den [Voice ID-Batch](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_StartSpeakerEnrollmentJob.html) aufrufen. APIs
Um Kunden programmgesteuert zu registrieren, übergeben Sie die folgenden Daten an die API:
1. Die Domain-ID, um die Domain anzugeben, der Aufzeichnungen zugeordnet werden sollen.
1. Der Speicherort für die Ausgabedatei.
1. Eine Eingabedatei mit einer Liste von Sprechern. Siehe [Eingabe- und Ausgabedateischema für den Speaker Enrollment Job in Amazon Connect Voice ID](speaker-enrollment-job-schema.md).
Für jeden Sprecher muss die Datei Folgendes enthalten:
+ Ein Link zu einer Audioaufzeichnung eines Anrufs in einer WAV-Datei mit einer KHz Samplerate von 8 und PCM-16-Kodierung.
+ Das entsprechende `CustomerSpeakerId` für den Kunden.
+ Ein Kanal für den Anrufer in der Audioaufnahme. Wenn das Audio mehrere Kanäle hat, können Sie nur einen auswählen.
1. Ein KMS-Schlüssel, der beim Schreiben der Ausgabe verwendet werden soll.
1. Eine Rolle, die Sprach-ID übernehmen kann. Sie muss Zugriff auf den S3-Bucket haben, in dem die Audiodateien gespeichert sind. Diese Rolle muss Zugriff auf jeden KMS-Schlüssel haben, der zum Verschlüsseln der Dateien verwendet wird. Sie muss auch in der Lage sein, in den angegebenen Ausgabespeicherort zu schreiben und den für das Schreiben der Ausgabe angeforderten KMS-Schlüssel zu verwenden. Insbesondere muss es sich um die folgenden Berechtigungen handeln:
+ `s3:GetObject` auf dem Eingabe-Bucket.
+ `s3:PutObject` auf dem Ausgabe-Bucket.
+ `kms:Decrypt` auf dem KMS-Schlüssel, der für die Standardverschlüsselung des Eingabe-Buckets verwendet wird.
+ `kms:Decrypt` und `kms:GenerateDataKey` auf dem in der Eingabe angegebenen KMS-Schlüssel, der zum Schreiben der Ausgabedatei in den Ausgabe-Bucket verwendet wird.
Sie müssen über `iam:PassRole`-Berechtigungen verfügen, um den Anruf tätigen und bereitstellen zu können`dataAccessRole`. Informationen zum Aktivieren des Schutzes für verwirrte Stellvertreter für `dataAccessRole` finden Sie unter [Vermeidung des dienstübergreifenden Confused-Deputy-Problems für Amazon Connect Voice ID](cross-service-confused-deputy-prevention.md#voiceid-cross-service).
1. Optional können Sie eine Markierung zum Überspringen von Betrugsschecks angeben, falls Sie Prüfungen auf Betrug und Voice-Spoofing in der Audiodatei bei der Registrierung überspringen möchten.
1. Geben Sie optional eine Betrugsüberwachungsliste an, anhand derer Sie Betrugsüberprüfungen durchführen möchten. Wenn keine Watchlist angegeben ist, verwendet Sprach-ID die Standard-Überwachungsliste für Betrüger für die Domain.
1. Optional die Betrugsschwelle für den Fall, dass Sie das Risiko erhöhen oder senken möchten.
1. Optional eine Markierung zur erneuten Registrierung registrierter Kunden. Dies ist nützlich, wenn Sie die Audioaufnahme aktualisieren möchten, da zuvor registrierte Kunden standardmäßig ignoriert werden.
Bei der Batch-Registrierung werden für jeden Eintrag `CustomerSpeakerId`, `GeneratedSpeakerId` und der zugehörige Status zurückgegeben. Diese Daten werden in einer JSON-Datei unter dem Ausgabepfad gespeichert, den Sie in der API angeben.
**Anmerkung**
Die Registrierung von Rednern wird Ihnen in Rechnung gestellt. Weitere Informationen finden Sie unter [Amazon Connect Voice ID Preise](https://aws.amazon.com/connect/pricing/).
# Eingabe- und Ausgabedateischema für den Speaker Enrollment Job in Amazon Connect 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 Amazon Connect 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](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
## Schema der Eingabedatei
Im Folgenden finden Sie das Schema der Eingabemanifestdatei für den Speaker Enrollment Job:
```
{
"Version": "string",
"SpeakerEnrollmentRequests": [
{
"RequestId": "string",
"SpeakerId": "string",
"AudioSpecifications": [
{
"S3Uri": "string",
"ChannelId": number
}
]
}
]
}
```
**Anmerkung**
Alle Felder im Schema sind **Pflichtfelder**.
Im Folgenden finden Sie eine Beschreibung der einzelnen Attribute des Eingabeschemas.
+ `Version`: Die Version des Eingabeschemadokuments. Derzeit sollte es `1.0` sein.
+ `SpeakerEnrollmentRequests`: Liste der Anfragen zur Registrierung von Sprechern, die im Rahmen des Jobs erfüllt werden müssen.
+ `RequestId`: Eine Kennung für diese Anfrage zur Registrierung von Sprechern. Es muss innerhalb der Eingabedatei eindeutig sein. Es wird für die Zuordnung und Identifizierung von Einträgen in der Ausgabedatei verwendet.
+ `SpeakerId`: Die vom Kunden bereitgestellte Kennung des Sprechers, der angemeldet werden muss. Sie müssen das `CustomerSpeakerId` in diesem Feld eingeben. `GeneratedSpeakerId` wird derzeit nicht unterstützt.
+ `AudioSpecifications`: Die Liste der Audiodateien, die Sprach-ID für die Registrierung dieses Sprechers verwenden kann. Sprach-ID verwendet diese Audiodateien zusammen, um die für die Registrierung erforderliche Sprachmenge zu sammeln. Derzeit sind maximal **10** Audiodateien für eine Registrierungsanfrage zulässig. Bei jeder Datei kann es sich um eine WAV-Datei mit einer Größe von bis zu 20 MB handeln, die Audio mit einer KHz Samplerate von 8 und PCM-16-Kodierung enthält.
+ `S3URI`: Der Amazon-S3-Speicherort der Audiodatei im WAV-Format, die für die Registrierung des Sprechers verwendet werden muss.
+ `ChannelId`: Der Audiokanal, der für die Registrierung des Sprechers in eine Mehrkanal-Audiodatei verwendet werden soll. Sprach-ID unterstützt Audiodateien mit bis zu zwei Kanälen, daher ist dieser Wert auf **0** oder **1** beschränkt.
## Schema der Ausgabedatei
Im Folgenden finden Sie das Schema der Ausgabedatei, die für den Speaker Enrollment Job generiert wurde:
```
{
"Version": "string",
"Errors": [
{
"RequestId": "string",
"ErrorCode": number,
"ErrorMessage": "string"
}
],
"SuccessfulEnrollments": [
{
"RequestId": "string",
"GeneratedSpeakerId": "string",
"CustomerSpeakerId": "string",
"EnrollmentStatus": "DUPLICATE_SKIPPED" | "NEW_ENROLLMENT" | "ENROLLMENT_OVERWRITE"
}
]
}
```
Es folgt eine Beschreibung der einzelnen Attribute des Ausgabeschemas.
+ `Version`: Die Version des Ausgabeschemadokuments. Derzeit sollte es `1.0` sein.
+ `Errors`: Die Liste der Fehler für die Anfragen zur Registrierung von Sprechern, die zu einem bestimmten Zeitpunkt während der Registrierung fehlgeschlagen sind.
+
+ `RequestId`: Die mit dieser Anfrage verbundene Anfragekennung. Dies entspricht der `RequestId` in der Eingabedatei für diese Anfrage.
+ `ErrorCode`: Der HTTP-Fehlercode, der die Art des Fehlers darstellt. Im Folgenden werden einige Beispielfehlerszenarien beschrieben.
**Anmerkung**
Dies ist keine vollständige Liste.
+ 400 (Bad Request Exception):
+ Die JSON-Eingabedatei ist fehlerhaft und kann nicht analysiert werden.
+ Die bereitgestellten Audiodateien verfügen nicht über ausreichend Sprachkenntnisse für die Registrierung.
+ Die Überprüfung der Betrugsversuche für den angegebenen Sprecher ist fehlgeschlagen.
+ 402 (): ServiceQuotaLimitExceededException
+ Die Lautsprecherbegrenzung wurde überschritten.
+ 409 (Konfliktausnahme):
+ Widersprüchliche Aktion: Sie können keine Registrierung für einen Sprecher beantragen, für den Sie sich abmelden möchten.
+ 500 (Interner Fehler):
+ Interner Serverfehler (Unerwarteter Fehler auf der Serviceseite).
+ `ErrorMessage`: Eine Meldung, in der die Ursache des Registrierungsfehlers beschrieben wird.
+ `SuccessfulEnrollments`: Die Liste der Registrierungsanfragen, die erfolgreich waren.
+ `RequestId`: Die mit dieser Anfrage verbundene Anfragekennung. Dies entspricht der `RequestId` in der Eingabedatei für diese Anfrage.
+ `CustomerSpeakerId`: Die vom Kunden bereitgestellte Kennung für den Sprecher, der angemeldet war.
+ `GeneratedSpeakerId`: Die vom Dienst generierte Kennung für den Sprecher, der angemeldet war.
+ `EnrollmentStatus`: Der Status der erfolgreichen Rednerregistrierung
+ `DUPLICATE_SKIPPED`: Der Sprecher ist bereits angemeldet und die Registrierung wurde übersprungen.
+ `NEW_ENROLLMENT`: Der Sprecher wurde neu im System registriert.
+ `ENROLLMENT_OVERWRITE`: Der Sprecher ist bereits registriert, wurde aber mit dem neuen Audio erneut registriert/überschrieben.
# Erstellen und Bearbeiten einer Betrüger-Watchlist in Amazon Connect 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 Amazon Connect 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](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
Gehen Sie wie folgt vor APIs , um eine Beobachtungsliste für Betrüger zu erstellen und Betrüger zu registrieren:
1. Verwenden Sie die [CreateWatchlist](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_CreateWatchlist.html)API, um neue Beobachtungslisten für Betrüger zu erstellen.
1. Verwenden Sie die [StartFraudsterRegistrationJob](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_StartFraudsterRegistrationJob.html)API für die Batch-Registrierung. Sie können neue Betrüger auf der neuen Watchlist registrieren oder sie auf der Standard-Watchlist registrieren, die der Sprach-ID-Domain zugeordnet ist.
Bei der Registrierung eines neuen Betrügers vergleicht Sprach-ID den Stimmabdruck mit allen registrierten Betrügern in Ihrer Sprach-ID-Domain, um festzustellen, ob es sich um ein Duplikat eines bestehenden Betrügers handelt.
Um Betrüger zu einer bestimmten Watchlist für Betrüger hinzuzufügen, übergeben Sie die folgenden Daten an die API:
1. Die Domain-ID, um die Domain anzugeben, der Aufzeichnungen zugeordnet werden sollen.
1. Eine Eingabedatei mit einer Liste von Betrügern. Siehe [Eingabe- und Ausgabedateischema für den Job zur Registrierung von Betrügern in Amazon Connect Voice ID](fraudster-registration-schema.md).
1. Der Speicherort für die Ausgabedatei.
1. Ein KMS-Schlüssel, der beim Schreiben der Ausgabe verwendet werden soll.
1. Eine Rolle, die Sprach-ID übernehmen kann. Sie muss Zugriff auf den S3-Bucket haben, in dem die Audiodateien gespeichert sind. Diese Rolle muss Zugriff auf jeden KMS-Schlüssel haben, der zum Verschlüsseln der Dateien verwendet wird. Sie muss auch in der Lage sein, in den angegebenen Ausgabespeicherort zu schreiben und den für das Schreiben der Ausgabe angeforderten KMS-Schlüssel zu verwenden. Insbesondere muss es sich um die folgenden Berechtigungen handeln:
+ `s3:GetObject` auf dem Eingabe-Bucket.
+ `s3:PutObject` auf dem Ausgabe-Bucket.
+ `kms:Decrypt` auf dem KMS-Schlüssel, der für die Standardverschlüsselung des Eingabe-Buckets verwendet wird.
+ `kms:Decrypt` und `kms:GenerateDataKey` auf dem in der Eingabe angegebenen KMS-Schlüssel, der zum Schreiben der Ausgabedatei in den Ausgabe-Bucket verwendet wird.
Sie müssen über `iam:PassRole`-Berechtigungen verfügen, um den Anruf tätigen und bereitstellen zu können`dataAccessRole`. Informationen zum Aktivieren des Schutzes für verwirrte Stellvertreter für `dataAccessRole` finden Sie unter [Vermeidung des dienstübergreifenden Confused-Deputy-Problems für Amazon Connect Voice ID](cross-service-confused-deputy-prevention.md#voiceid-cross-service).
1. Eine WatchList-ID, bei der der Betrüger registriert wird. Wenn keine WatchListID angegeben ist, werden Betrüger auf der Standard-Watchlist für diese Sprach-ID-Domain registriert.
1. Der Schwellenwert für die Feststellung des doppelten Status von Betrügern.
1. Eine Markierung, um Duplikate von Betrügern zu ignorieren.
Sprach-ID aktualisiert die Liste der Betrüger mit erfolgreichen Hinzufügungen und sendet einen mit einem `GeneratedFraudsterID` verknüpften Eintrag zurück an denselben S3-Standort. Wenn Duplikate identifiziert werden, gibt Sprach-ID den Status „Duplikat“" für den Eintrag zurück und liefert den am besten passenden `GeneratedFraudsterId`. Nachdem ein Betrüger erfolgreich registriert wurde, können Sie diesen von der identifizierten Betrüger mithilfe der API einer `GeneratedFraudsterID` neuen Beobachtungsliste zuordnen. [AssociateFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_AssociateFraudster.html)
Sprach-ID ist nicht in der Lage, Betrüger in einer Watchlist zu erkennen, bevor die Betrügerliste erstellt wurde.
Die Kontingente für die Betrügerliste finden Sie unter [Amazon Connect Servicekontingenten](amazon-connect-service-limits.md).
**Anmerkung**
Das Hinzufügen zur Liste der Betrüger wird Ihnen in Rechnung gestellt. Weitere Informationen finden Sie unter [Amazon Connect Voice ID Preise](https://aws.amazon.com/connect/voice-id/).
# Eingabe- und Ausgabedateischema für den Job zur Registrierung von Betrügern in Amazon Connect 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 Amazon Connect 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](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
## Schema der Eingabedatei
Im Folgenden finden Sie das Schema der Eingabe-Manifestdatei für Fraudster Registration Jobs:
```
{
"Version": "string",
"FraudsterRegistrationRequests": [
{
"RequestId": "string",
"AudioSpecifications": [
{
"S3Uri": "string",
"ChannelId": number
}
]
}
]
}
```
**Anmerkung**
Alle Felder im Schema sind **Pflichtfelder**.
Im Folgenden finden Sie eine Beschreibung der einzelnen Attribute des Eingabeschemas.
+ `Version`: Die Version des Schemadokuments. Derzeit sollte es `1.0` sein.
+ `FraudsterRegistrationRequests`: Liste der Registrierungsanfragen von Betrügern, die im Rahmen des Jobs erfüllt werden müssen.
+ `RequestId`: Eine Kennung für diese Registrierungsanfrage des Betrügers. Es muss innerhalb der Eingabedatei eindeutig sein. Es wird für die Zuordnung und Identifizierung von Einträgen in der Ausgabedatei verwendet.
+ `AudioSpecifications`: Die Liste der Audiodateien, die Sprach-ID für die Registrierung dieses Betrügers verwenden kann. Sprach-ID verwendet diese Audiodateien zusammen, um die für die Registrierung erforderliche Sprachmenge zu sammeln. Derzeit sind maximal **10** Audiodateien für eine Registrierungsanfrage zulässig. Bei jeder Datei kann es sich um eine WAV-Datei mit einer Größe von bis zu 20 MB handeln, die Audio mit einer KHz Samplerate von 8 und PCM-16-Kodierung enthält.
+ `S3URI`: Der Amazon-S3-Speicherort der Audiodatei im WAV-Format, die für die Registrierung des Betrügers verwendet werden muss.
+ `ChannelId`: Der Audiokanal, der für die Registrierung des Betrügers in einer Mehrkanal-Audiodatei verwendet werden soll. Sprach-ID unterstützt Audiodateien mit bis zu zwei Kanälen, daher ist dieser Wert auf **0** oder **1** beschränkt.
## Schema der Ausgabedatei
Im Folgenden finden Sie das Schema der Ausgabe-Manifestdatei für Fraudster Registration Jobs:
```
{
"Version": "string",
"Errors": [
{
"RequestId": "string",
"ErrorCode": number,
"ErrorMessage": "string"
}
],
"SuccessfulRegistrations": [
{
"RequestId": "string",
"GeneratedFraudsterId": "string",
"RegistrationStatus": "DUPLICATE_SKIPPED" | "NEW_REGISTRATION",
"FraudsterSimilarityScore": number
}
]
}
```
Es folgt eine Beschreibung der einzelnen Attribute des Ausgabeschemas.
+ `Version`: Die Version des Ausgabeschemadokuments. Derzeit sollte es `1.0` sein.
+ `Errors`: Die Liste der Fehler für Registrierungsanfragen von Betrügern, die zu einem bestimmten Zeitpunkt während der Registrierung fehlgeschlagen sind.
+
+ `RequestId`: Die mit dieser Anfrage verbundene Anfragekennung. Dies entspricht der `RequestId` in der Eingabedatei für diese Anfrage.
+ `ErrorCode`: Der HTTP-Fehlercode, der die Art des Fehlers darstellt. Im Folgenden werden einige Beispielfehlerszenarien beschrieben.
**Anmerkung**
Dies ist keine vollständige Liste.
+ 400 (Bad Request Exception):
+ Die JSON-Eingabedatei ist fehlerhaft und kann nicht analysiert werden.
+ Die bereitgestellten Audiodateien verfügen nicht über ausreichend Sprachausgabe für die Registrierung.
+ 402 (): ServiceQuotaLimitExceededException
+ Das Betrügerlimit wurde überschritten.
+ 500 (Interner Fehler):
+ Interner Serverfehler (Unerwarteter Fehler auf der Serviceseite).
+ `ErrorMessage`: Eine Meldung, die die Ursache für den Fehler bei der Registrierung des Betrügers beschreibt.
+ `SuccessfulRegistrations`: Die Liste der Registrierungsanfragen, die erfolgreich waren.
+ `RequestId`: Die mit dieser Anfrage verbundene Anfragekennung. Dies entspricht der `RequestId` in der Eingabedatei für diese Anfrage.
+ `RegistrationStatus`: Der Status der erfolgreichen Registrierung eines Betrügers.
+ `DUPLICATE_SKIPPED`: Der Betrüger wurde als Duplikat identifiziert und die Registrierung wurde übersprungen.
+ `NEW_FRAUDSTER`: Der Betrüger wurde neu im System registriert.
+ `GeneratedFraudsterId`: Die vom Dienst generierte Kennung für den registrierten Betrüger. Falls `RegistrationStatus` `DUPLICATE_SKIPPED` ist, ist dies die Kennung des Betrügers, der sich bereits in der Domain befindet, die dem angegebenen Betrüger am nächsten kommt.
+ `FraudsterSimilarityScore`: Ein optionales Feld, das ausgefüllt wird, wenn die Registrierung des Betrügers übersprungen wird, weil es sich um ein Duplikat handelt. Dies stellt die Ähnlichkeit des angegebenen Betrügers mit dem Betrüger dar, der am ehesten auf der Domain existiert.
# Amazon Connect Streams APIs zur Integration von 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 Amazon Connect 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](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
Verwenden Sie die folgenden [Amazon Connect Streams](https://github.com/aws/amazon-connect-streams) APIs , um Voice ID in Ihre bestehenden Agenten-Webanwendungen zu integrieren.
+ `enrollSpeakerInVoiceId`: Melden Sie einen Kunden bei Sprach-ID an, nachdem Sie dessen Zustimmung zur Registrierung eingeholt haben.
+ `evaluateSpeakerWithVoiceId`: Überprüfen Sie den Sprach-ID-Authentifizierungsstatus des Kunden und erkennen Sie Betrüger.
+ `optOutVoiceIdSpeaker`: Einen Kunden von Sprach-ID abmelden.
+ `getVoiceIdSpeakerStatus`: Beschreiben Sie den Anmeldestatus eines Kunden.
+ `getVoiceIdSpeakerId`: Holen Sie sich das `SpeakerID` für einen Kunden.
+ `updateVoiceIdSpeakerId`: Aktualisieren Sie das `SpeakerID` für einen Kunden.
Sie können auch das Sprach-ID-Widget im Contact Control Panel (CCP) verwenden, wenn Sie keine benutzerdefinierte Kundendienstmitarbeiternoberfläche erstellen möchten. Weitere Informationen zur Sprach-ID im CCP finden Sie unter [Registrieren von Anrufern in Voice ID im Contact Control Panel (CCP)](use-voiceid.md).
# Ereignisschema von Amazon Connect 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 Amazon Connect 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](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
Sprach-ID generiert Ereignisse für jede Transaktion: Registrierung, Authentifizierung oder Erkennung von Betrügern auf einer Watchlist. Ereignisse werden an den EventBridge Standard-Event-Bus gesendet.
Sie können eine Analysepipeline für die Ergebnisse der Voice ID-Authentifizierung und die Erkennung von Betrügern in einer Beobachtungsliste einrichten, indem Sie sie EventBridge zur Überwachung von Voice ID-Ereignissen verwenden. Mithilfe des in diesem Thema verfügbaren Schemas können Sie EventBridge Regeln konfigurieren, um relevante Voice ID-Ereignisse abzuhören und zu filtern und sie dann über Amazon Data Firehose zu verarbeiten, um sie in einem Data Warehouse Ihrer Wahl zu speichern.
Möglicherweise möchten Sie beispielsweise die Sprach-ID-Analyse nahezu in Echtzeit verfolgen. Dazu können Sie alle `Evaluate-Session`-Ereignisse sowie `authenticationResult` und `fraudDetectionResult` abrufen.
Ereignisse werden auf [bestmögliche](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html) Weise ausgegeben.
## Allgemeine Felder in der Veranstaltung
+ `version` – Die Version der Ereignisdaten.
+ `id`- Eine eindeutige Kennung des Ereignisses, generiert von EventBridge
+ `detail-type` – Ein Bezeichner für die Details des Ereignisses.
+ `source` – Die Quelle des Ereignisses. Dies ist immer `aws.voiceid`.
+ `account`- AWS Konto-ID.
+ `timestamp` – Das Datum und die Uhrzeit der Veröffentlichung des Ereignisses in UTC.
+ `region`- Die AWS Region, in der der API-Aufruf getätigt wurde.
+ `resources` – Vom API-Aufruf verwendete Ressourcen.
+ `detail` – Details zum Ereignis:
+ `detail.sourceId` – Eine von Sprach-ID generierte eindeutige ID, die Sie für die Deduplizierung verwenden können.
+ `detail.action` – Analog zur aufgerufenen API.
+ `detail.status` – Gibt den Status der Aktion an: Erfolg oder Fehlschlag.
+ `detail.errorInfo` – Wird aufgefüllt, wenn bei der angegebenen Aktion bei Sprach-ID ein Fehler auftritt.
Im Folgenden sind die Schemas für die ausgegebenen Ereignisse aufgeführt.
## Sitzungsaktion starten
Gibt Ereignisse beim Start des Streams (nach der Einrichtung), beim Stream-Ende und bei Fehlern aus.
```
{...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
}
}
}
```
## Aktion „Sitzung aktualisieren“
Gibt Ereignisse aus, wenn das interne Sitzungsupdate erfolgreich ist oder fehlschlägt.
```
{...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
}
}
}
```
## Bewerten der Sitzungsaktion
Gibt Ereignisse aus, wenn die Sitzungsauswertung erfolgreich ist oder fehlschlägt. Die Gründe können KNOWN\$1FRAUDSTER oder VOICE\$1SPOOFING sein.
```
{...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
}
}
}
```
## Aktion des Sprechers
Gibt Ereignisse aus, wenn ein Sprecher erfolgreich abbestellt, gelöscht oder angemeldet wurde.
```
{...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
}
}
}
```
## Aktion eines Betrügers
Gibt Ereignisse aus, wenn ein Betrüger erfolgreich registriert oder gelöscht wurde.
Es werden keine Ereignisse gesendet, wenn ein Betrüger mit einer Watchlist verknüpft oder deren Verknüpfung aufgehoben wird.
```
{...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
Gibt dieses Ereignis aus, wenn eine Registrierungsanfrage eingereicht wird. Ein `Speaker`-Ereignis wird ausgelöst, wenn die tatsächliche Registrierung erfolgreich ist oder fehlschlägt.
```
{...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
Gibt dieses Ereignis aus, wenn eine Batch-Registrierungsanfrage eingereicht wurde, erfolgreich ist oder fehlschlägt. Für jeden einzelnen Sprecher wird ein `Speaker`-Ereignis ausgelöst, das angibt, ob die entsprechende Registrierung erfolgreich war oder nicht.
```
{...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
Gibt dieses Ereignis aus, wenn eine Batch-Registrierungsanfrage eingereicht wurde, erfolgreich ist oder fehlschlägt. Für jeden einzelnen Betrüger wird ein `Fraudster`-Ereignis ausgelöst, das anzeigt, ob die entsprechende Registrierung erfolgreich war oder fehlschlägt.
```
{...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
}
}
}
```