Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Schema degli eventi di Amazon Connect Voice ID
**Nota**
Avviso di fine del supporto: il 20 maggio 2026, AWS terminerà il supporto per Amazon Connect Voice ID. Dopo il 20 maggio 2026, non potrai più accedere a Voice ID sulla console Amazon Connect, accedere alle funzionalità Voice ID sul sito Web di Amazon Connect amministrazione o nel Pannello di controllo dei contatti o accedere alle risorse Voice ID. Per ulteriori informazioni, consulta [Fine del supporto di Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
Voice ID genera eventi per ogni transazione: registrazione, autenticazione o rilevamento di truffatori in una lista di controllo. Gli eventi vengono inviati al bus degli eventi EventBridge predefinito.
Puoi creare una pipeline di analisi per i risultati dell'autenticazione Voice ID e l'individuazione dei truffatori in una lista di controllo utilizzandola EventBridge per monitorare gli eventi Voice ID. Utilizzando lo schema disponibile in questo argomento, puoi configurare EventBridge le regole per ascoltare e filtrare gli eventi Voice ID pertinenti, quindi elaborarli tramite Amazon Data Firehose per archiviarli in un data warehouse di tua scelta.
È ad esempio possibile tracciare quasi in tempo reale l'analisi di Voice ID. A tale scopo, è necessario eseguire il pull di tutti gli eventi `Evaluate-Session` e ottenere `authenticationResult` e `fraudDetectionResult`.
Gli eventi vengono emessi secondo il principio del [massimo sforzo](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html).
## Campi comuni dell'evento
+ `version`: versione dei dati dell'evento.
+ `id`- Un identificatore univoco dell'evento generato da EventBridge
+ `detail-type`: identificatore dei dettagli dell'evento.
+ `source`: origine dell'evento. Il valore è sempre `aws.voiceid`.
+ `account`- ID AWS dell'account.
+ `timestamp`: data e ora in cui l'evento è stato pubblicato nel fuso UTC.
+ `region`- La AWS regione in cui è stata effettuata la chiamata API.
+ `resources`: risorse usate dalla chiamata API.
+ `detail`: dettagli sull'evento:
+ `detail.sourceId`: ID univoco generato da Voice ID che è possibile usare per la deduplicazione.
+ `detail.action`: analogo all'API richiamata.
+ `detail.status`: specifica lo stato dell'azione: riuscita o non riuscita.
+ `detail.errorInfo`: popolato quando l'azione specificata genera un errore in Voice ID.
Di seguito sono riportati gli schemi relativi agli eventi emessi.
## Start Session Action
Vengono emessi eventi all'inizio del flusso (dopo la configurazione), alla fine del flusso e in caso di errori.
```
{...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
}
}
}
```
## Update Session Action
Vengono emessi eventi quando l'aggiornamento della sessione interna ha esito positivo o negativo.
```
{...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
}
}
}
```
## Evaluate Session Action
Vengono emessi eventi quando la valutazione della sessione ha esito positivo o negativo. I motivi possono essere KNOWN\$1FRAUDSTER o VOICE\$1SPOOFING.
```
{...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
}
}
}
```
## Speaker Action
Vengono emessi eventi in base all'esito positivo o negativo dell'operazione di opt-out, eliminazione o registrazione di un parlante.
```
{...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
}
}
}
```
## Fraudster Action
Vengono emessi eventi quando un truffatore viene registrato o eliminato.
Gli eventi non vengono inviati in caso di associazione o annullamento dell'associazione di un truffatore a una lista di controllo.
```
{...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
Questo evento viene emesso quando viene inviata una richiesta di registrazione. Viene emesso un evento `Speaker` quando la registrazione effettiva ha esito positivo o negativo.
```
{...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
Questo evento viene emesso quando una richiesta di registrazione in batch viene inviata, ha esito positivo o ha esito negativo. Viene emesso un evento `Speaker` per ciascuno dei singoli parlanti per indicare se la registrazione corrispondente ha esito positivo o negativo.
```
{...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
Questo evento viene emesso quando una richiesta di registrazione in batch viene inviata, ha esito positivo o ha esito negativo. Viene emesso un evento `Fraudster` per ciascuno dei singoli truffatori per indicare se la registrazione corrispondente ha esito positivo o negativo.
```
{...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
}
}
}
```