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 Customer Voice ID-Ereignisschema
**Anmerkung**
Hinweis zum Ende des Supports: Am 20. Mai 2026 AWS wird der Support für Amazon Connect Customer Voice ID eingestellt. Nach dem 20. Mai 2026 können Sie nicht mehr auf Voice ID auf der Amazon Connect Customer Konsole zugreifen, auf die Voice ID-Funktionen auf der Connect Customer Admin-Website oder im Contact Control Panel zugreifen und auch nicht mehr auf Voice ID-Ressourcen zugreifen. Weitere Informationen finden Sie unter Ende des Supports [ für ](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html)Amazon Connect Customer Voice ID.
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.
Mithilfe EventBridge der Überwachung von Voice ID-Ereignissen können Sie eine Analysepipeline für die Ergebnisse der Voice ID-Authentifizierung und die Erkennung von Betrügern in einer Beobachtungsliste erstellen. Mithilfe des in diesem Thema verfügbaren Schemas können Sie EventBridge Regeln zum Abhören und Filtern relevanter Voice-ID-Ereignisse konfigurieren und diese dann über Amazon Data Firehose verarbeiten, um sie in einem Data Warehouse Ihrer Wahl zu speichern.
Vielleicht möchten Sie beispielsweise die Voice-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\_FRAUDSTER oder VOICE\_SPOOFING 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
}
}
}
```