Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Skema acara ID Suara Amazon Connect
**catatan**
Pemberitahuan akhir dukungan: Pada 20 Mei 2026, AWS akan mengakhiri dukungan untuk Amazon Connect Voice ID. Setelah 20 Mei 2026, Anda tidak lagi dapat mengakses ID Suara di konsol Amazon Connect, mengakses fitur ID Suara di situs web Amazon Connect admin atau Panel Kontrol Kontak, atau mengakses sumber daya ID Suara. Untuk informasi selengkapnya, kunjungi [bagian akhir dukungan Amazon Connect Voice ID](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html).
ID Suara menghasilkan peristiwa untuk setiap transaksi: pendaftaran, otentikasi, atau deteksi penipu dalam daftar pantauan. Acara dikirim ke bus acara EventBridge default.
Anda dapat membuat pipeline analitik untuk hasil autentikasi ID Suara dan deteksi penipu dalam daftar pantauan menggunakan EventBridge untuk memantau peristiwa ID Suara. Menggunakan skema yang tersedia dalam topik ini, Anda dapat mengonfigurasi EventBridge aturan untuk mendengarkan dan memfilter peristiwa ID Suara yang relevan, lalu memprosesnya melalui Amazon Data Firehose untuk disimpan di gudang data pilihan Anda.
Misalnya, Anda mungkin ingin melacak analisis ID Suara yang hampir real-time. Untuk melakukan itu, Anda dapat menarik semua `Evaluate-Session` acara, dan mendapatkan `authenticationResult` dan`fraudDetectionResult`.
Acara dipancarkan atas dasar [upaya terbaik](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html).
## Bidang umum dalam acara tersebut
+ `version`- Versi data acara.
+ `id`- Pengidentifikasi unik dari peristiwa yang dihasilkan oleh EventBridge
+ `detail-type`- Pengidentifikasi untuk detail acara.
+ `source`- Sumber acara. Ini selalu`aws.voiceid`.
+ `account`- ID AWS akun.
+ `timestamp`- Tanggal dan waktu acara diterbitkan di UTC.
+ `region`- AWS Wilayah tempat panggilan API dilakukan.
+ `resources`- Sumber daya yang digunakan oleh panggilan API.
+ `detail`- Detail tentang acara:
+ `detail.sourceId`- ID unik yang dihasilkan oleh ID Suara yang dapat Anda gunakan untuk de-duplikasi.
+ `detail.action`- Analog dengan API yang dipanggil.
+ `detail.status`- Menentukan status tindakan: sukses atau gagal.
+ `detail.errorInfo`- Diisi saat kesalahan tindakan yang ditentukan keluar di ID Suara.
Berikut adalah skema untuk acara yang dipancarkan.
## Mulai Aksi Sesi
Memancarkan peristiwa saat streaming mulai (setelah penyiapan), streaming berakhir, dan pada kegagalan.
```
{...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
}
}
}
```
## Perbarui Tindakan Sesi
Memancarkan peristiwa ketika pembaruan sesi internal berhasil atau gagal.
```
{...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
}
}
}
```
## Evaluasi Tindakan Sesi
Memancarkan peristiwa ketika evaluasi sesi berhasil atau gagal. Alasannya bisa KNOWN\$1FRAUDSTER atau 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
}
}
}
```
## Aksi Pembicara
Memancarkan peristiwa tentang keberhasilan atau kegagalan untuk memilih keluar dari pembicara, menghapus pembicara, atau mendaftarkan pembicara.
```
{...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
}
}
}
```
## Tindakan Penipu
Memancarkan peristiwa ketika penipu berhasil didaftarkan atau dihapus.
Acara tidak dikirim ketika penipu dikaitkan atau dipisahkan dengan daftar pantauan.
```
{...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
Memancarkan acara ini ketika permintaan pendaftaran diajukan. Sebuah `Speaker` peristiwa dipancarkan ketika pendaftaran aktual berhasil atau gagal.
```
{...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
Memancarkan acara ini ketika permintaan pendaftaran batch dikirimkan, berhasil, atau gagal. Sebuah `Speaker` acara dipancarkan untuk masing-masing pembicara individu untuk menunjukkan apakah pendaftaran yang sesuai berhasil atau gagal.
```
{...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
Memancarkan acara ini ketika permintaan pendaftaran batch dikirimkan, berhasil, atau gagal. Suatu `Fraudster` peristiwa dipancarkan untuk masing-masing penipu individu untuk menunjukkan apakah pendaftaran yang sesuai berhasil atau gagal.
```
{...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
}
}
}
```