Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menggunakan otentikasi pemanggil waktu nyata dengan ID Suara di 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).
Amazon Connect Voice ID menyediakan otentikasi penelepon real-time dan deteksi risiko penipuan yang membuat interaksi suara di pusat kontak lebih aman dan efisien. Voice ID menggunakan pembelajaran mesin untuk memverifikasi identitas pelanggan asli dengan menganalisis karakteristik suara unik penelepon. Hal ini memungkinkan pusat kontak untuk menggunakan lapisan keamanan tambahan yang tidak bergantung pada penelepon yang menjawab beberapa pertanyaan keamanan, dan membuatnya mudah untuk mendaftarkan dan memverifikasi pelanggan tanpa mengubah aliran alami percakapan mereka. Voice ID juga menawarkan deteksi real-time penipu yang sering menargetkan pusat kontak Anda, sehingga mengurangi kerugian akibat penipuan.
Dengan Amazon Connect Voice ID Anda dapat:
+ Mendaftarkan pelanggan secara pasif untuk otentikasi suara tanpa mengharuskan mereka mengulangi kata atau frasa tertentu.
+ Migrasikan pelanggan ke ID Suara dengan mendaftarkannya dalam batch.
+ Verifikasi identitas pelanggan yang terdaftar dengan menganalisis karakteristik suara unik mereka.
+ Deteksi penipu dari daftar pantauan yang telah Anda buat.
+ Mendeteksi spoofing suara.
## Cara kerja ID Suara
### Pendaftaran pelanggan
1. Ketika pelanggan menelepon untuk pertama kalinya, agen mengkonfirmasi identitas penelepon dengan menggunakan langkah-langkah keamanan yang ada, seperti meminta nama gadis ibu atau kode sandi satu kali (OTP) yang dikirimkan melalui SMS. Ini memastikan bahwa hanya pelanggan asli yang terdaftar di Voice ID.
1. ID Suara mulai mendengarkan ucapan pelanggan setelah kontak mengalami [Setel ID Suara](set-voice-id.md) pemblokiran, tempat ID Suara diaktifkan. ID Suara mendengarkan panggilan hingga salah satu hal berikut terjadi:
+ Ini mendapat audio yang cukup untuk mengevaluasi speaker untuk otentikasi, penipuan, dan mendaftarkan speaker (jika diminta). Ini adalah 30 detik pidato pelanggan, tidak termasuk keheningan.
+ Panggilan berakhir.
1. ID Suara kemudian membuat voiceprint pendaftaran. Voiceprint adalah representasi matematis yang secara implisit menangkap aspek unik dari suara individu seperti ritme bicara, nada, intonasi, dan kenyaringan.
Penelepon tidak perlu mengatakan atau mengulangi frasa tertentu untuk mendaftar di ID Suara.
### Otentikasi pelanggan
1. Ketika pelanggan yang terdaftar menelepon kembali, mereka diverifikasi melalui interaksi dengan IVR, atau selama interaksi mereka dengan agen.
Secara default ID Suara dikonfigurasi untuk memerlukan 10 detik pidato pemanggil untuk mengautentikasi, yang dapat dilakukan sebagai bagian dari interaksi pelanggan yang khas di IVR atau dengan agen (seperti “apa nama depan dan belakang Anda?” dan “apa yang kamu panggil?”). Anda dapat menyesuaikan jumlah ucapan yang diperlukan menggunakan [Waktu respons otentikasi](set-voice-id.md#set-voice-id-properties-authentication-response-time) properti di [Setel ID Suara](set-voice-id.md) blok.
1. ID Suara menggunakan audio untuk menghasilkan cetak suara pemanggil dan membandingkannya dengan voiceprint terdaftar yang sesuai dengan identitas yang diklaim, dan mengembalikan hasil otentikasi.
Untuk informasi lebih lanjut tentang pengalaman agen, lihat[Mendaftarkan penelepon di ID Suara di Panel Kontrol Kontak (CCP)](use-voiceid.md).
## Berapa banyak pidato yang dibutuhkan untuk pendaftaran dan otentikasi
+ Pendaftaran: 30 detik pidato bersih pelanggan (pidato yang tidak termasuk keheningan) untuk membuat cetak suara dan mendaftarkan pelanggan.
+ Verifikasi: Secara default, 10 detik dari net speech pelanggan untuk memverifikasi bahwa suara tersebut milik identitas yang diklaim. Pidato bisa dari berinteraksi dengan IVR atau agen. Anda dapat menyesuaikan jumlah ucapan yang diperlukan menggunakan [Waktu respons otentikasi](set-voice-id.md#set-voice-id-properties-authentication-response-time) properti di[Setel ID Suara](set-voice-id.md).
## Pendaftaran Batch
Anda dapat memulai penggunaan biometrik dengan mendaftarkan pelanggan secara batch yang telah menyetujui biometrik. Dengan menggunakan rekaman audio yang tersimpan di bucket S3, dan file input JSON yang menyediakan pengenal speaker dan tautan ke rekaman audio, Anda dapat memanggil kumpulan ID Suara. APIs
Untuk informasi selengkapnya, lihat [Pendaftaran batch di Amazon Connect Voice ID menggunakan data audio dari panggilan sebelumnya](voiceid-batch-enrollment.md).
## Deteksi penipu yang dikenal
Ada beberapa langkah untuk mengatur deteksi penipu secara real-time:
1. [Buat daftar pantauan baru](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_CreateWatchlist.html) untuk menyimpan penipu yang dikenal. Atau, gunakan daftar pantauan default yang dibuat saat ID Suara diaktifkan.
1. [Daftarkan penipu ke daftar](voiceid-fraudster-watchlist.md) pantauan baru atau daftar pantauan default.
1. Di [Setel ID Suara](set-voice-id.md) blok, tentukan daftar pantauan mana yang ingin Anda gunakan.
Ketika salah satu penipu dari daftar pantauan yang ditentukan dalam alur memanggil pusat kontak Anda, ID Suara menganalisis audio panggilan untuk mengembalikan skor risiko dan hasil. Skor ini menunjukkan seberapa dekat voiceprint penelepon cocok dengan penipu di daftar pantauan. Voice ID membutuhkan 10 detik audio untuk mengevaluasi audio panggilan untuk risiko penipuan dari penipu yang dikenal.
### Daftar pantauan default
Saat domain ID Suara dibuat, ID Suara akan membuat daftar pantauan penipu default untuk domain tersebut. Nama dan deskripsi daftar pantauan penipu default dienkripsi menggunakan kunci KMS yang disediakan di domain dan disimpan dalam ID Suara.
Jika Anda tidak memberikan penipu WatchListid untuk deteksi penipuan atau pendaftaran penipu, ID Suara menggunakan daftar pantauan penipu default.
Anda tidak dapat memperbarui metadata daftar pantauan penipu default, tetapi Anda dapat mengaitkan atau memisahkan penipu darinya.
**catatan**
Jika domain ID Suara Anda dibuat sebelum Maret 2023, saat daftar pantauan penipu diluncurkan: daftar pantauan default telah dibuat dan semua penipu yang ada telah ditempatkan di dalamnya.
## Deteksi spoofing suara
1. Ketika calon penipu mencoba menipu audio penelepon menggunakan pemutaran audio atau ucapan yang disintesis, ID Suara mengembalikan skor risiko dan hasil untuk menunjukkan seberapa besar kemungkinan suara itu dipalsukan.
1. Spoofing suara hanya diaktifkan saat Anda mengaktifkan fitur deteksi penipuan di alur kontak Anda. Skor spoofing suara tidak dikembalikan ketika hanya otentikasi speaker yang diaktifkan.
1. Voice ID membutuhkan 10 detik audio untuk mengevaluasi audio panggilan untuk risiko penipuan dari spoofing suara.
## Data apa yang disimpan?
ID Suara menyimpan file audio suara speaker, cetak suara, dan pengenal speaker. Data ini dienkripsi menggunakan kunci KMS yang Anda berikan.
Jika Anda mengaktifkan deteksi penipu dalam daftar pantauan, ID Suara juga menyimpan audio dan cetak suara penipu. Untuk informasi selengkapnya, lihat [Data ditangani oleh Amazon Connect](data-handled-by-connect.md).
# Dukungan Amazon Connect Voice ID akhir
Setelah mempertimbangkan dengan cermat, kami memutuskan untuk mengakhiri dukungan untuk Amazon Connect Voice ID, efektif 20 Mei 2026. Amazon Connect Voice ID tidak akan lagi menerima pelanggan baru mulai 20 Mei 2025. Sebagai pelanggan lama dengan akun yang mendaftar untuk layanan sebelum 20 Mei 2025, Anda dapat terus menggunakan fitur ID Suara Amazon Connect. Setelah 20 Mei 2026, Anda tidak akan lagi dapat menggunakan ID Suara Amazon Connect.
Halaman ini memberikan petunjuk dan praktik terbaik bagi administrator dan pengguna TI Amazon Connect untuk mentransisikan ID Suara ke solusi alternatif untuk memenuhi kebutuhan bisnis Anda. Ini mungkin termasuk solusi dari AWS Mitra yang tersedia di AWS Marketplace, seperti [Pindrop®](https://aws.amazon.com/marketplace/pp/prodview-f7rqlwjby3er4), atau do-it-yourself solusi dengan AWS Olah Pesan Pengguna Akhir SMS.
## Do-it-yourself solusi dengan AWS Olah Pesan Pengguna Akhir SMS
Anda dapat meningkatkan keamanan pusat kontak dengan mengaktifkan autentikasi berbasis One-Time-Pin (OTP) untuk pusat kontak Anda. AWS Olah Pesan Pengguna Akhir SMS Anda dapat mereferensikan contoh solusi untuk mengaktifkan OTPs penggunaan AWS Olah Pesan Pengguna Akhir SMS untuk membuat satu untuk pusat kontak Anda. Untuk informasi selengkapnya tentang solusi ini, lihat posting blog berikut: [Membangun Arsitektur Kata Sandi Satu Kali yang Aman dengan AWS](https://aws.amazon.com/blogs/messaging-and-targeting/build-a-secure-one-time-password-architecture-with-aws/). Untuk informasi lebih lanjut tentang AWS Olah Pesan Pengguna Akhir SMS, lihat [Apa itu AWS Olah Pesan Pengguna Akhir SMS?](https://docs.aws.amazon.com/sms-voice/latest/userguide/what-is-sms-mms.html)
## Mengelola data ID Suara
Anda bisa mendapatkan informasi tentang semua domain ID Suara di AWS akuntansi Anda menggunakan Voice ID `ListDomains` API bersama dengan API. `DescribeDomain` Untuk informasi selengkapnya tentang mengelola domain ID Suara Amazon Connect, lihat[Mengelola domain ID Suara Amazon Connect](voiceid-domain-operations.md).
Untuk domain ID Suara tertentu, Anda dapat mengunduh data tentang penelepon terdaftar menggunakan `ListSpeakers` API dan penipu terdaftar menggunakan API. `ListFraudsters` Untuk informasi lebih lanjut tentang manajemen pembicara dan penipu, lihat. [Speaker Amazon Connect Voice ID, daftar pantauan, dan manajemen penipu APIs](voiceid-speaker-fraudster-management-apis.md) Anda dapat memastikan bahwa semua data pelanggan Anda pada ID Suara dihapus dengan menggunakan `DeleteDomain` API ID Suara. Anda perlu melakukan operasi ini untuk setiap domain ID Suara di setiap AWS Wilayah dan setiap akun.
# Domain ID Suara di Amazon Connect Voice ID
**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).
Saat mengaktifkan ID Suara Amazon Connect, Anda membuat domain ID Suara: wadah untuk semua data ID Suara, seperti pengenal speaker (yang berfungsi sebagai pengenal pelanggan), cetak suara, audio pelanggan yang digunakan untuk membuat cetak suara pendaftaran, dan status pendaftaran (terdaftar, memilih keluar, dll.) yang terkait dengan pengenal speaker. Untuk mendeteksi penipu dalam daftar pantauan, domain ID Suara menyimpan pengidentifikasi penipu, cetak suara, dan audio yang digunakan untuk membuat cetak suara.
Berikut ini adalah panduan untuk membuat domain ID Suara:
+ Setiap instans Amazon Connect hanya dapat dikaitkan dengan satu domain ID Suara.
+ Setiap domain ID Suara dapat dikaitkan dengan beberapa instans Amazon Connect. Ini memungkinkan Anda untuk menggunakan data pelanggan tersimpan yang sama di beberapa instans Amazon Connect.
+ Anda dapat membuat beberapa domain, tetapi mereka tidak berbagi data pelanggan antara satu sama lain.
+ Sebaiknya buat domain ID Suara baru untuk diasosiasikan dengan instans Amazon Connect saat:
+ Anda mengaktifkan ID Suara untuk pertama kalinya di akun Anda di AWS Wilayah.
+ Anda ingin memastikan bahwa Anda mengisolasi domain ID Suara yang digunakan untuk lingkungan pengujian dan produksi Anda.
+ Sebaiknya gunakan domain ID Suara yang ada saat:
+ Anda ingin menggunakan kumpulan penelepon dan penipu terdaftar yang sama di berbagai instans Amazon Connect (yang mungkin milik tim layanan pelanggan yang berbeda)
+ Anda ingin menggunakan lingkungan pengujian yang sama di berbagai instance Amazon Connect pengujian.
**catatan**
Hanya domain ID Suara yang ada di Wilayah yang sama di akun Amazon Connect Anda yang dapat dibagikan di seluruh instans Amazon Connect di Wilayah tersebut.
+ Anda dapat mengubah asosiasi instans Amazon Connect dari domain saat ini ke domain baru kapan saja, dengan memilih domain yang berbeda.
+ Untuk menghapus domain ID Suara, gunakan API ID [DeleteDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteDomain.html)Suara. `DeleteDomain`soft menghapus domain. Amazon Connect menunggu 30 hari sebelum menghapus data domain sepenuhnya. Selama periode ini, ID Suara; dinonaktifkan untuk semua instans Amazon Connect yang terkait dengannya. Untuk memulihkan domain selama jendela ini, kirimkan Dukungan tiket dan berikan ID domain. Anda dapat menemukan ID domain di bagian ID Suara konsol Amazon Connect, seperti yang ditunjukkan pada contoh berikut:
![\[Bagian ID Suara pada konsol Amazon Connect yang menampilkan bidang ID domain yang diperlukan untuk pemulihan domain.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/voiceid-domain.png)
Menghapus domain ID Suara akan menghapus semua data pelanggan yang tersimpan, seperti rekaman audio, cetak suara, dan pengenal speaker, serta daftar pantauan penipu yang Anda kelola.
## Status pendaftaran
ID Suara menyimpan tiga status pendaftaran berbeda untuk pembicara:`ENROLLED`, ` OPTED_OUT` dan. `EXPIRED` Anda dapat mengingat status speaker ini menggunakan [Amazon Connect Voice ID APIs](https://docs.aws.amazon.com/voiceid/latest/APIReference/) dan menggunakan blok alur kontak untuk mengambil tindakan yang sesuai.
+ `ENROLLED`: Saat Anda mendaftarkan pemanggil baru terdaftar ke ID Suara, ID Suara akan membuat cetak suara baru dan menetapkan status pembicara sebagai. `ENROLLED` Meskipun Anda mendaftarkan ulang penelepon yang sama ke ID Suara, statusnya tetap seperti. `ENROLLED`
+ `OPTED_OUT`: Jika penelepon tidak memberikan persetujuan untuk mendaftar ke biometrik, Anda dapat memilih keluar dari penelepon (di Panel Kontrol Kontak) atau menggunakan. APIs ID Suara membuat entri baru untuk pemanggil ini dan mengatur status `OPTED_OUT` pembicara. ID Suara tidak menghasilkan cetak suara apa pun atau menyimpan rekaman audio apa pun untuk speaker. Permintaan pendaftaran di masa mendatang untuk pembicara ini ditolak kecuali entri mereka dihapus.
+ `EXPIRED`: Jika cetak suara pemanggil belum diakses atau di-refresh selama 3 tahun, ID Suara mengubah statusnya`EXPIRED`, dan Anda tidak lagi dapat melakukan autentikasi untuk pemanggil ini. Anda dapat mendaftarkan ulang penelepon lagi atau menghapus pemanggil dari ID Suara.
## Pembicara kedaluwarsa
Untuk kepatuhan BIPA, ID Suara secara otomatis akan kedaluwarsa speaker yang belum diakses untuk pendaftaran, pendaftaran ulang, atau otentikasi yang berhasil selama tiga tahun.
Untuk melihat akses terakhir pembicara, lihat `lastAccessedAt` atribut yang dikembalikan oleh `DescribeSpeaker` dan `ListSpeakers` APIs.
Jika Anda mencoba menggunakan `EvaluateSesssion` API untuk mengautentikasi speaker yang kedaluwarsa, keputusan `SPEAKER_EXPIRED` autentikasi akan ditampilkan.
Untuk menggunakan speaker yang kedaluwarsa lagi, mereka harus terdaftar ulang.
## Pengidentifikasi pembicara dan penipu
ID Suara menggunakan pengenal pembicara untuk merujuk dan mengambil cetak suara di domain ID Suara. Kami menyarankan Anda menggunakan pengenal yang tidak mengandung Informasi Identifikasi Pribadi (PII) dalam pengidentifikasi.
ID Suara membuat dua bidang untuk merujuk ke pemanggil:
+ `CustomerSpeakerId`: Pengenal yang disediakan oleh pelanggan. ****Itu bisa antara 1-256 karakter dan hanya dapat berisi: **a-z, **A-Z****, **0-9, -** dan \$1****
+ `GeneratedSpeakerId`: String alfanumerik 22 karakter unik yang dibuat dan dikembalikan Voice ID pada saat pendaftaran pemanggil.
[Speaker Amazon Connect Voice ID APIs](https://docs.aws.amazon.com/voiceid/latest/APIReference/Welcome.html) menerima salah satu bentuk pengenal speaker, tetapi hanya memancarkan `GeneratedSpeakerId` dalam aliran peristiwa ID Suara dan catatan kontak. Jika Anda ingin merekam ulang penelepon untuk mengulang cetak suara, Anda dapat mendaftarkan pemanggil dengan hal yang sama. `CustomerSpeakerId`
Demikian pula, ID Suara membuat pengidentifikasi penipu unik yang dipanggil `GeneratedFraudsterID` untuk setiap penipu yang Anda tambahkan ke daftar pantauan di domain. ID Suara mengembalikan pengenal penipu jika penipu terdeteksi dalam panggilan saat melakukan deteksi risiko penipuan.
# Mulai mengaktifkan ID Suara di 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).
## Sebelum Anda mulai
Sebelum Anda memulai, selesaikan tugas-tugas berikut.
**Topics**
+ [Berikan izin yang diperlukan](#enable-voiceid-permissions)
+ [Tentukan cara memberi nama domain ID Suara Anda](#enable-voiceid-domains)
+ [Buat AWS KMS key untuk mengenkripsi data yang disimpan dalam domain](#enable-voiceid-awsmanagedkey)
### Berikan izin yang diperlukan
Anda harus memberikan izin yang diperlukan kepada pengguna, grup, atau peran. Untuk informasi selengkapnya, lihat [AmazonConnectVoiceIDFullAkses](security_iam_awsmanpol.md#amazonconnectvoiceidfullaccesspolicy).
Akses ke ID Suara APIs menggunakan Contact Control Panel (CCP) dinonaktifkan secara default.
### Tentukan cara memberi nama domain ID Suara Anda
Saat mengaktifkan ID Suara, Anda akan diminta untuk memberikan nama domain ramah yang berarti bagi Anda seperti nama organisasi, misalnya, *ID Suara- ExampleCorp*.
### Buat AWS KMS key untuk mengenkripsi data yang disimpan dalam domain
Saat mengaktifkan ID Suara, Anda akan diminta untuk membuat atau memberikan [AWS KMS key](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#kms_keys). Ini mengenkripsi data pelanggan yang disimpan oleh ID Suara seperti file audio, cetak suara, dan pengidentifikasi speaker.
Step-by-step instruksi untuk membuat kunci KMS ini disediakan di[Langkah 2: Buat domain ID Suara dan kunci enkripsi baru](#enable-voiceid-step2).
Data saat istirahat—khususnya, bidang bentuk bebas yang Anda sediakan ditambah file audio/voiceprint — dienkripsi di bawah kunci KMS yang Anda pilih. Kunci yang dikelola pelanggan Anda dibuat, dimiliki, dan dikelola oleh Anda. Anda memiliki kontrol penuh atas kunci KMS (AWS KMS dikenakan biaya).
Saat melakukan panggilan ke ID Suara untuk apa pun selain `CreateDomain` atau`UpdateDomain`, pengguna yang melakukan panggilan memerlukan `kms:Decrypt` izin untuk kunci yang terkait dengan domain. Saat melakukan panggilan ke `CreateDomain` atau`UpdateDomain`, pengguna juga memerlukan `kms:DescribeKey` dan `kms:CreateGrant` izin untuk kunci tersebut. Saat Anda membuat (atau memperbarui) domain ID Suara, domain tersebut akan membuat hibah pada kunci KMS sehingga dapat digunakan oleh proses asinkron ID Suara (seperti pendaftaran speaker) dan oleh peran terkait layanan Amazon Connect selama alur Anda. Hibah ini mencakup konteks enkripsi yang menentukan domain yang terkait dengan kunci tersebut. Untuk informasi lebih lanjut tentang hibah, lihat [Menggunakan hibah](https://docs.aws.amazon.com/kms/latest/developerguide/grants.html) di Panduan AWS Key Management Service Pengembang.
Jika Anda membuat domain dan mengaitkannya dengan satu kunci, menyimpan beberapa data, dan kemudian mengubah kunci KMS ke kunci yang berbeda, proses asinkron akan dipicu untuk mengenkripsi ulang data lama dengan kunci KMS baru. Setelah proses ini selesai, semua data domain Anda akan dienkripsi di bawah kunci KMS baru, dan Anda dapat dengan aman menghentikan kunci lama. Untuk informasi selengkapnya, lihat [UpdateDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_UpdateDomain).
**Tip**
Anda dapat membuat kunci KMS atau memberikan kunci KMS yang ada secara terprogram. Untuk informasi selengkapnya, lihat [ID Suara Amazon Connect APIs](https://docs.aws.amazon.com/voiceid/latest/APIReference/).
## Langkah 1: Baca Pengakuan Persetujuan BIPA
Membaca Pengakuan Persetujuan Biometric Privacy Act (BIPA) adalah persyaratan untuk mengaktifkan ID Suara. Anda perlu melakukan ini sekali per akun, di semua Wilayah. Anda tidak dapat melakukan langkah ini dengan menggunakan APIs. Untuk informasi lebih lanjut tentang BIPA, lihat artikel Wikipedia ini: Undang-Undang Privasi Informasi [Biometrik](https://en.wikipedia.org/wiki/Biometric_Information_Privacy_Act).
1. Buka konsol Amazon Connect di [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. Pada halaman instance, pilih alias instance. Alias instance juga merupakan **nama instans** Anda, yang muncul di URL Amazon Connect Anda. Gambar berikut menunjukkan halaman **instance pusat kontak virtual Amazon Connect**, dengan kotak di sekitar alias instance.
![\[Halaman instans pusat kontak virtual Amazon Connect, alias instans.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/instance.png)
1. Di panel navigasi, pilih **ID Suara**. Baca Pengakuan Persetujuan BIPA, dan terima jika Anda setuju.
![\[Halaman Aktifkan ID Suara yang menampilkan tombol Pengakuan Persetujuan BIPA (Biometric Information Privacy Act) yang harus dibaca dan diterima pengguna sebelum mengaktifkan ID Suara.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/voiceid-bipa.png)
## Langkah 2: Buat domain ID Suara dan kunci enkripsi baru
Anda dapat melakukan langkah ini menggunakan konsol Amazon Connect atau dengan menggunakan Amazon Connect dan Voice ID APIs.
------
#### [ Amazon Connect console instructions ]
1. Di bagian **Pengaturan domain**, pilih **Buat domain baru**.
![\[Antarmuka pengaturan domain dengan opsi untuk membuat domain baru atau memilih yang sudah ada.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/voiceid-enable-domain.png)
1. Di kotak **Nama domain**, masukkan nama ramah yang berarti bagi Anda, seperti nama organisasi Anda, misalnya, *VoiceID* -. ExampleCorp
1. Di bawah **Enkripsi**, buat atau masukkan milik Anda sendiri AWS KMS key untuk mengenkripsi domain ID Suara Anda. Berikut adalah langkah-langkah untuk membuat kunci kunci KMS Anda:
1. Pilih **Buat tombol KMS**.
![\[Bagian enkripsi pada halaman penyiapan ID Suara yang menampilkan tombol 'Buat kunci AWS KMS' untuk membuat kunci enkripsi baru.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/voiceid-create-kms-key.png)
1. Tab baru di browser Anda terbuka untuk konsol Key Management Service (KMS). Pada halaman **tombol Configure**, pilih **Symmetric**, dan kemudian pilih **Next**.
![\[Konfigurasikan halaman kunci dengan tipe kunci simetris yang dipilih untuk enkripsi dan dekripsi.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-create-kms-key-configure-key.png)
1. Pada halaman **Tambahkan label**, tambahkan nama dan deskripsi untuk kunci KMS, lalu pilih **Berikutnya**.
1. Pada halaman **Tentukan izin administratif kunci**, pilih **Berikutnya**.
1. Pada halaman **Tentukan izin penggunaan kunci**, pilih **Berikutnya**.
1. Pada halaman **kebijakan kunci Tinjau dan edit**, pilih **Selesai**.
1. Kembali ke tab di browser Anda untuk konsol Amazon Connect, halaman **ID Suara**. Klik atau ketuk tombol yang Anda buat agar muncul di daftar dropdown. **AWS KMS key** Pilih kunci yang Anda buat.
1. Pilih **Aktifkan ID Suara**.
------
#### [ API instructions ]
1. Panggil [CreateDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_CreateDomain.html)API untuk membuat domain ID Suara baru.
1. Panggil [CreateIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateIntegrationAssociation.html)API untuk mengaitkan domain ID Suara dengan instans Amazon Connect.
1. Lewati ARN domain ID Suara yang baru saja dibuat ke dalam parameter. `IntegrationArn` Untuk `IntegrationType` digunakan`VOICE_ID`.
------
Anda telah mengaktifkan ID Suara untuk instans Anda. Berikut ini telah dibuat:
+ Domain ID Suara Anda dan daftar pantauan penipu default yang akan menampung penipu Anda.
+ EventBridge Aturan Amazon terkelola di akun Anda. Aturan ini digunakan untuk menyerap peristiwa ID Suara untuk membuat catatan kontak yang terkait dengan ID Suara. Selain itu, Amazon Connect menambahkan [izin ID Suara](connect-slr.md) ke peran terkait layanan untuk Amazon Connect.
Selanjutnya, pada Langkah 3 Anda mengonfigurasi bagaimana Anda ingin ID Suara bekerja di alur Anda.
## Langkah 3: Konfigurasikan ID Suara di alur kontak Anda
Pada langkah ini, Anda menambahkan blok yang diperlukan ke alur dan mengonfigurasi cara kerja ID Suara yang Anda inginkan.
+ [Mainkan prompt](play.md): Tambahkan blok ini sebelum [Setel ID Suara](set-voice-id.md) blok untuk mengalirkan audio dengan benar. Anda dapat mengeditnya untuk menyertakan pesan sederhana seperti “Selamat Datang.”
+ [Setel ID Suara](set-voice-id.md): Setelah [Mainkan prompt](play.md) blok, tambahkan [Setel ID Suara](set-voice-id.md) blok. Itu harus di awal panggilan. Gunakan blok ini untuk memulai streaming audio ke Amazon Connect Voice ID untuk memverifikasi identitas pemanggil, segera setelah panggilan terhubung ke aliran.
Di blok **Setel ID Suara**, Anda mengonfigurasi ambang autentikasi, waktu respons, ambang batas penipuan, dan daftar pantauan penipu yang akan digunakan untuk deteksi penipu yang diketahui.
+ [Tetapkan atribut kontak](set-contact-attributes.md): Gunakan untuk meneruskan `CustomerId` atribut ke ID Suara. `CustomerId`Mungkin nomor pelanggan dari CRM Anda, misalnya. Anda dapat membuat fungsi Lambda untuk menarik ID pelanggan unik pemanggil dari sistem CRM Anda. ID Suara menggunakan atribut ini sebagai `CustomerSpeakerId` pemanggil.
**catatan**
`CustomerId`bisa menjadi nilai alfanumerik. Ini hanya mendukung \$1 dan - (garis bawah dan tanda hubung) karakter khusus. Tidak perlu UUID. Karena ID Suara menyimpan informasi biometrik untuk setiap pembicara, kami sangat menyarankan Anda menggunakan pengenal yang tidak mengandung PII di bidang tersebut. CustomerSpeakerId Untuk informasi selengkapnya, lihat `CustomerSpeakerId` di tipe data [Speaker](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_Speaker.html).
+ [Periksa ID Suara](check-voice-id.md): Gunakan untuk memeriksa respons dari ID Suara untuk status pendaftaran, autentikasi suara, dan deteksi penipuan, lalu cabang berdasarkan salah satu status yang dikembalikan.
### Contoh aliran ID Suara
**Penelepon tidak terdaftar**
1. Ketika pelanggan menelepon untuk pertama kalinya, mereka `CustomerId` diteruskan ke ID Suara menggunakan [Tetapkan atribut kontak](set-contact-attributes.md) blok.
1. Voice ID dicari `CustomerId` dalam database-nya. Karena tidak ada di sana, ia mengirimkan pesan hasil **Tidak terdaftar**. Cabang [Periksa ID Suara](check-voice-id.md) blok berdasarkan hasil ini, dan Anda dapat memutuskan apa langkah selanjutnya. Misalnya, Anda mungkin ingin agen mendaftarkan pelanggan dalam autentikasi suara.
1. ID Suara mulai mendengarkan ucapan pelanggan setelah kontak mengalami [Setel ID Suara](set-voice-id.md) pemblokiran, tempat ID Suara diaktifkan. Itu mendengarkan sampai mengakummulasikan 30 detik dari net speech atau panggilan berakhir, mana yang terjadi lebih dulu.
**Penelepon terdaftar**
1. Lain kali pelanggan menelepon, ID Suara menemukan mereka `CustomerId` di database.
1. ID Suara mulai mendengarkan audio untuk membuat cetak suara. Voiceprint yang dibuat kali ini digunakan untuk tujuan otentikasi sehingga ID Suara dapat membandingkan jika pemanggil telah terdaftar sebelumnya.
1. Ini membandingkan cetak suara pemanggil saat ini dengan cetak suara tersimpan yang terkait dengan identitas yang diklaim. Ia mengembalikan hasil berdasarkan properti **ambang otentikasi** yang Anda konfigurasikan di [Setel ID Suara](set-voice-id.md) blok.
1. Setelah mengevaluasi pidato, ia mengembalikan pesan **Diautentikasi** jika cetak suara serupa. Atau mengembalikan salah satu status lainnya.
1. Kontak kemudian diarahkan ke cabang yang sesuai oleh [Periksa ID Suara](check-voice-id.md) blok.
# Izin profil keamanan untuk Amazon Connect Voice ID
**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).
+ Untuk memungkinkan pengguna mencari kontak berdasarkan status ID Suara mereka, tetapkan izin **Analytics dan Optimasi** berikut ke profil keamanan mereka:
+ **ID Suara - atribut dan pencarian**: Memungkinkan pengguna untuk mencari dan melihat hasil ID Suara di halaman **detail Kontak**.
+ Untuk memberi agen akses ke ID Suara di Panel Kontrol Kontak, tetapkan izin berikut di grup **Panel Kontrol Kontak**:
+ **ID Suara - Akses**: Mengaktifkan kontrol di Panel Kontrol Kontak sehingga agen dapat:
+ Lihat hasil otentikasi.
+ Menyisih atau mengautentikasi ulang penelepon.
+ Perbarui`SpeakerID`.
+ Lihat hasil deteksi penipuan, jalankan kembali analisis penipuan (keputusan deteksi penipuan, jenis dan skor penipuan).
**catatan**
Fungsionalitas untuk memasukkan atau memperbarui tidak `SpeakerID` tersedia dengan widget ID Suara default di CCP. Untuk menyertakan opsi untuk memperbarui`SpeakerID`, terapkan `updateVoiceIdSpeakerId` [Amazon Connect Streams](https://github.com/aws/amazon-connect-streams) API di CCP kustom Anda.
Gambar berikut menunjukkan contoh kontrol ini pada PKC:
![\[Contact Control Panel (CCP) yang menampilkan kontrol Voice ID termasuk status pendaftaran, hasil autentikasi, dan tombol untuk mendaftarkan atau memilih keluar pelanggan.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/voiceid-ccp-controls.png)
Untuk informasi tentang cara menambahkan izin lainnya ke profil keamanan yang ada, lihat[Perbarui profil keamanan di Amazon Connect](update-security-profiles.md).
Secara default, profil keamanan **Admin** sudah memiliki izin untuk melakukan semua aktivitas ID Suara.
# Cari dan tinjau hasil autentikasi Voice ID
**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).
Gunakan halaman [pencarian Kontak](contact-search.md) untuk mencari dan meninjau hasil status pendaftaran, otentikasi suara, dan deteksi penipu dalam daftar pantauan. Dengan [izin profil keamanan](contact-search.md#required-permissions-search-contacts) yang diperlukan (**Analytics and Optimization** **- Voice ID - atribut dan pencarian - View**), Anda dapat mencari hasil ID Suara menggunakan filter berikut:
+ **Tindakan pembicara**: Gunakan filter ini untuk mencari kontak tempat pemanggil terdaftar ke ID Suara atau memilih untuk tidak ikut serta dari ID Suara sama sekali.
+ **Hasil autentikasi**: Gunakan filter ini untuk mencari kontak tempat autentikasi ID Suara menampilkan hasil berikut:
+ Diautentikasi
+ Tidak diautentikasi
+ Memilih keluar
+ Tidak meyakinkan
+ Tidak terdaftar
**Misalnya, jika Anda ingin mencari semua kontak yang status autentikasi dikembalikan sebagai **Tidak diautentikasi atau Dipilih** **keluar, pilih kedua opsi ini dan pilih Terapkan**.**
+ **Hasil deteksi penipuan**: Gunakan filter ini untuk mencari kontak di mana analisis penipuan ID Suara menampilkan hasil berikut:
+ Risiko tinggi untuk penipuan
+ Risiko rendah untuk penipuan
+ Tidak meyakinkan
+ **Alasan deteksi penipuan**: Gunakan filter ini untuk mencari kontak di mana mekanisme risiko penipuan tertentu terdeteksi:
+ Penipu yang dikenal: suara penelepon cocok dengan penipu dari daftar pantauan penipu yang telah Anda buat.
+ Spoofing suara: penelepon memodifikasi suara mereka atau menggunakan sintesis ucapan untuk menipu agen.
## ID Suara menghasilkan rekaman kontak
Setelah Anda mencari kontak, Anda dapat memilih ID untuk melihat catatan kontak mereka. Gambar berikut menunjukkan contoh bidang di bagian ID Suara rekaman kontak:
![\[Bagian ID Suara pada catatan kontak yang menampilkan hasil autentikasi, status deteksi penipu, ID penipu, dan kolom ID daftar pantauan.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/voiceid-ctr-nospoofing.png)
# Kelola ID Suara Amazon Connect dengan ID Suara APIs
**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).
Untuk mengelola ID Suara secara terprogram, lihat ID [Suara Amazon Connect](https://docs.aws.amazon.com/voiceid/latest/APIReference/). APIs
Bagian ini menjelaskan cara melakukan skenario umum menggunakan ID Suara APIs.
**Topics**
+ [Mengelola domain ID Suara Amazon Connect](voiceid-domain-operations.md)
+ [Asosiasi Integrasi Amazon Connect APIs](voiceid-integration-association-apis.md)
+ [Pembicara, daftar pantauan, dan manajemen penipu APIs](voiceid-speaker-fraudster-management-apis.md)
+ [Pendaftaran batch di Amazon Connect Voice ID menggunakan data audio dari panggilan sebelumnya](voiceid-batch-enrollment.md)
+ [Skema file untuk Pekerjaan Pendaftaran Pembicara](speaker-enrollment-job-schema.md)
+ [Membuat dan mengedit daftar pantauan penipu di Amazon Connect Voice ID](voiceid-fraudster-watchlist.md)
+ [Skema file untuk Pekerjaan Pendaftaran Penipu](fraudster-registration-schema.md)
+ [Amazon Connect Streams APIs untuk mengintegrasikan ID Suara](voiceid-streams-apis.md)
# Mengelola domain 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).
Amazon Connect Voice ID menyediakan APIs untuk Anda mengelola domain ID Suara. Anda dapat menemukan padanan untuk Buat, Jelaskan, Daftar, dan Perbarui di Konsol. AWS
1. [CreateDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_CreateDomain.html): Untuk membuat domain ID Suara baru, gunakan API ID `CreateDomain` Suara. Saat domain ID Suara dibuat, daftar pantauan penipu default untuk menahan penipu dibuat secara bersamaan.
Perhatikan panduan berikut saat menggunakan `CreateDomain` API:
+ Anda hanya dapat memanggilnya untuk akun Anda setelah Anda mengakui Persetujuan BIPA di konsol. AWS
+ Anda juga harus menentukan kunci KMS untuk domain ID Suara pada saat pembuatan.
+ Setelah membuat domain ID Suara, gunakan [asosiasi Amazon Connect APIs](https://docs.aws.amazon.com/connect/latest/APIReference/) untuk mengaitkannya dengan instans Amazon Connect.
1. [DeleteDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteDomain.html): Untuk menghapus domain ID Suara, Anda harus memanggil API ID `DeleteDomain` Suara dan memberikan ID domain. Jika domain ini dikaitkan dengan instans Amazon Connect, panggilan API ID Suara, dan blok aliran ID Suara akan menampilkan kesalahan runtime. Menghapus domain ID Suara akan menghapus semua data pelanggan yang tersimpan seperti rekaman audio, cetak suara, dan pengenal speaker, serta daftar penipu yang Anda kelola.
1. [DescribeDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DescribeDomain.html): Gunakan API ini untuk mengembalikan nama, deskripsi, dan konfigurasi enkripsi domain yang ada yang diidentifikasi olehnya`DomainID`.
1. [ListDomains](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_ListDomains.html): Gunakan API ini untuk mencantumkan semua domain ID Suara yang dimiliki oleh akun Anda di Wilayah.
1. [UpdateDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_UpdateDomain.html): Untuk memperbarui konfigurasi nama dan enkripsi domain, Anda dapat menggunakan API ID `UpdateDomain` Suara. API ini mengalahkan atribut yang ada, dan Anda harus menyediakan kedua bidang ini.
Saat Anda mengubah kunci KMS yang terkait dengan domain ID Suara, mengikuti `UpdateDomain` panggilan data domain yang ada akan dienkripsi ulang secara asinkron di bawah kunci KMS baru. Anda dapat memeriksa status proses ini dari `ServerSideEncryptionUpdateDetails` atribut domain Anda menggunakan `DescribeDomain` API. Saat proses pembaruan ini sedang berlangsung, Anda harus mempertahankan kunci KMS lama Anda dalam keadaan yang dapat diakses, jika tidak proses ini mungkin gagal. Setelah proses ini selesai, kunci KMS lama dapat dihentikan dengan aman.
# ID Suara dan Asosiasi Integrasi Amazon Connect APIs
**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).
Anda dapat menggunakan yang berikut ini APIs untuk mengelola asosiasi dengan instans Amazon Connect. Anda juga dapat melakukan operasi ini di AWS Konsol.
1. [CreateIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateIntegrationAssociation.html): Untuk mengaktifkan ID Suara di instans Amazon Connect, Anda harus mengaitkan domain ID Suara dengan instans Amazon Connect menggunakan `CreateIntegrationAssociation` permintaan. Anda hanya dapat mengaitkan satu domain ID Suara ke instans Amazon Connect. Jika instance sudah dikaitkan dengan domain, API mengembalikan kesalahan berikut:
`DuplicateResourceException`(409) - Permintaan mencoba membuat sumber daya duplikat.
**catatan**
Saat Anda mengaktifkan ID Suara untuk instans Amazon Connect (dengan menggunakan konsol Amazon Connect atau [CreateIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateIntegrationAssociation.html)API), Amazon Connect akan membuat EventBridge aturan Amazon terkelola di akun Anda. Aturan ini digunakan untuk menyerap peristiwa ID Suara untuk membuat catatan kontak yang terkait dengan ID Suara. Selain itu, Amazon Connect menambahkan [izin ID Suara](connect-slr.md) ke peran terkait layanan untuk Amazon Connect.
1. [DeleteIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_DeleteIntegrationAssociation.html): Untuk menghapus asosiasi yang ada antara instans Amazon Connect dan domain Voice ID, Anda harus memanggil InstanceID Amazon Connect dan yang dikembalikan oleh. `DeleteIntegrationAssociation` APIs `IntegrationAssociationID` `CreateIntegrationAssociation` Ini adalah langkah wajib jika Anda ingin mengaitkan domain ID Suara yang berbeda ke instans Amazon Connect ini. Kami tidak menyarankan untuk menghapus asosiasi dalam penyiapan produksi karena dapat menyebabkan perilaku ID Suara yang tidak dapat diprediksi di instans Amazon Connect Anda.
1. [ListIntegrationAssociations](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListIntegrationAssociations.html): Untuk mencantumkan semua asosiasi antara instans Amazon Connect dan domain ID Suara untuk akun Anda di Wilayah ini, Anda dapat memanggil `ListIntegrationAssociations` API.
# Speaker Amazon Connect Voice ID, daftar pantauan, dan manajemen penipu APIs
**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).
Amazon Connect Voice ID termasuk APIs untuk mengelola speaker yang terdaftar ke domain ID Suara dan penipu yang terdaftar di domain. Semua pembicara APIs, kecuali`ListSpeakers`, menerima salah satu `CustomerSpeakerId` atau`GeneratedSpeakerId`.
## Manajemen pembicara APIs
1. [DescribeSpeaker](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DescribeSpeaker.html): Jelaskan [status pembicara dalam domain (TERDAFTAR, OPTED\$1OUT, EXPIRED),](voiceid-domain.md#voiceid-speaker-enrollments) dan untuk memetakan a `GeneratedSpeakerId` ke a, dan sebaliknya. `CustomerSpeakerId`
1. [DeleteSpeaker](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteSpeaker.html): Hapus sepenuhnya semua rekaman untuk caller/speaker dari domain ID Suara. Semua cetak suara dan status pendaftaran segera dihapus, dan rekaman audio terkait dihapus dalam waktu 24 jam.
1. [ListSpeakers](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_ListSpeakers.html): Buat daftar semua speaker yang entrinya ada di domain ID Suara. API ini mengembalikan keduanya `CustomerSpeakerId` dan `GeneratedSpeakerId` untuk speaker. Ini mengembalikan output paginasi dengan ukuran halaman yang ditentukan dalam permintaan API.
1. [OptOutSpeaker](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_OptOutSpeaker.html): Menyisih pemanggil dari domain ID Suara. API ini tidak mengharuskan speaker hadir di ID Suara. Speaker yang tidak ada dapat memilih keluar menggunakan API ini dan ID Suara mempertahankan status opted out dan menolak permintaan pendaftaran future untuk pembicara ini. Memilih keluar juga menghapus voiceprints dan rekaman audio yang tersimpan untuk penelepon ini.
## Manajemen daftar pantauan APIs
1. [CreateWatchlist](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_CreateWatchlist.html): Buat daftar pantauan yang dapat menjadi bagian dari penipu.
1. [DeleteWatchlist](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteWatchlist.html): Hapus daftar pantauan penipu khusus dari domain ID Suara. Untuk menghapus daftar pantauan, itu harus kosong. Artinya, ia tidak boleh memiliki penipu yang terkait dengannya. Anda dapat menggunakan [DeleteFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteFraudster.html)atau [DisassociateFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DisassociateFraudster.html) APIs untuk menghapus semua penipu dari daftar pantauan.
Anda tidak dapat menghapus daftar pantauan default dari domain ID Suara.
1. [DescribeWatchlist](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DescribeWatchlist.html): Tentukan apakah itu daftar pantauan penipu default, atau daftar pantauan khusus yang Anda buat, dan dapatkan detail daftar pantauan.
1. [ListWatchlists](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_ListWatchlists.html): Buat daftar semua daftar pantauan di domain ID Suara.
1. [UpdateWatchlist](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_UpdateWatchlist.html): Perbarui nama dan deskripsi daftar pantauan penipu khusus. Anda tidak dapat mengubah detail daftar pantauan default karena dikelola oleh ID Suara.
## Manajemen penipu APIs
1. [AssociateFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_AssociateFraudster.html): Kaitkan penipu ke daftar pantauan di domain yang sama. Anda dapat mengaitkan penipu ke beberapa daftar pantauan di domain.
1. [DeleteFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteFraudster.html): Hapus penipu dari domain ID Suara. Menghapus penipu menghapus penipu dari semua daftar pantauan itu adalah bagian dari. Ini juga menghapus semua cetak suara dan rekaman audio terkait dalam waktu 24 jam.
1. [DescribeFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DescribeFraudster.html): Jelaskan status penipu di domain ID Suara.
1. [DisassociateFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DisassociateFraudster.html): Lepaskan penipu dari daftar pantauan yang ditentukan. Perhatikan bahwa penipu selalu harus dikaitkan dengan setidaknya satu daftar pantauan penipu; pengecualian dilemparkan jika Anda mencoba memisahkan penipu dari satu-satunya daftar pantauan.
Untuk menghapus penipu sepenuhnya, gunakan. `DeleteFraudster`
1. [ListFraudsters](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_ListFraudsters.html): Buat daftar semua penipu dalam domain atau daftar pantauan tertentu. API ini juga mengembalikan daftar pantauan yang menjadi bagian dari penipu. Ini mengembalikan output paginasi dengan ukuran halaman yang ditentukan dalam permintaan API.
# Pendaftaran batch di Amazon Connect Voice ID menggunakan data audio dari panggilan sebelumnya
**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).
Anda dapat memulai penggunaan biometrik dengan mendaftarkan pelanggan secara batch yang telah menyetujui biometrik. [Dengan menggunakan rekaman audio yang tersimpan di bucket S3, dan file input JSON yang menyediakan pengenal speaker dan tautan ke rekaman audio, Anda dapat memanggil kumpulan ID Suara.](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_StartSpeakerEnrollmentJob.html) APIs
Untuk mendaftarkan pelanggan secara terprogram, teruskan data berikut ke API:
1. ID domain untuk menentukan domain untuk mengaitkan rekaman.
1. Lokasi untuk file output.
1. File input yang berisi daftar speaker. Lihat [Skema file input dan output untuk Pekerjaan Pendaftaran Speaker di Amazon Connect Voice ID](speaker-enrollment-job-schema.md).
Untuk setiap pembicara file harus mencakup:
+ Tautan ke rekaman audio panggilan dalam file.wav dengan kecepatan KHz sampel 8 dan pengkodean PCM-16.
+ Yang sesuai `CustomerSpeakerId` untuk pelanggan.
+ Saluran untuk penelepon dalam rekaman audio. Jika audio memiliki banyak saluran, Anda hanya dapat memilih satu.
1. Kunci KMS untuk digunakan saat menulis output.
1. Peran yang dapat diasumsikan oleh ID Suara. Itu harus memiliki akses ke ember S3 tempat file audio disimpan. Peran ini harus memiliki akses ke kunci KMS yang digunakan untuk mengenkripsi file. Itu juga harus dapat menulis ke lokasi output yang ditentukan dan menggunakan kunci KMS yang diminta untuk menulis output. Secara khusus, ia harus memiliki izin berikut:
+ `s3:GetObject`pada ember input.
+ `s3:PutObject`pada ember output.
+ `kms:Decrypt`pada kunci KMS yang digunakan untuk enkripsi default bucket input.
+ `kms:Decrypt`dan `kms:GenerateDataKey` pada kunci KMS yang disediakan dalam input yang akan digunakan untuk menulis file output ke bucket output.
Anda harus memiliki `iam:PassRole` izin saat melakukan panggilan dan memberikan. `dataAccessRole` Untuk mengaktifkan perlindungan wakil yang membingungkan untuk`dataAccessRole`, lihat[Amazon Connect Voice ID lintas layanan pencegahan wakil membingungkan](cross-service-confused-deputy-prevention.md#voiceid-cross-service).
1. Secara opsional, tanda lewati pemeriksaan penipuan jika Anda ingin melewati pemeriksaan penipuan dan spoofing suara pada audio pendaftaran.
1. Secara opsional, tentukan daftar pantauan penipu yang ingin Anda lakukan pemeriksaan penipuan. Jika tidak ada daftar pantauan yang ditentukan, ID Suara menggunakan daftar pantauan penipu default untuk domain tersebut.
1. Secara opsional, ambang penipuan jika Anda ingin menaikkan atau menurunkan risiko.
1. Secara opsional, bendera untuk mendaftarkan kembali pelanggan terdaftar. Ini berguna jika Anda ingin menyegarkan rekaman audio, karena defaultnya adalah mengabaikan pelanggan yang terdaftar sebelumnya.
Pendaftaran batch mengembalikan status`CustomerSpeakerId`,`GeneratedSpeakerId`, dan terkait untuk setiap entri. Ini menyimpan data ini dalam file JSON di jalur output yang Anda tentukan di API.
**catatan**
Anda dikenakan biaya untuk mendaftarkan speaker. Untuk informasi selengkapnya, lihat [Harga ID Suara Amazon Connect](https://aws.amazon.com/connect/pricing/).
# Skema file input dan output untuk Pekerjaan Pendaftaran Speaker di Amazon Connect Voice ID
**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).
## Skema file masukan
Berikut ini adalah skema file manifes masukan untuk Job Pendaftaran Pembicara:
```
{
"Version": "string",
"SpeakerEnrollmentRequests": [
{
"RequestId": "string",
"SpeakerId": "string",
"AudioSpecifications": [
{
"S3Uri": "string",
"ChannelId": number
}
]
}
]
}
```
**catatan**
Semua bidang dalam skema **diperlukan**.
Berikut ini adalah deskripsi dari setiap atribut skema masukan.
+ `Version`: Versi dokumen skema masukan. Saat ini, ini seharusnya`1.0`.
+ `SpeakerEnrollmentRequests`: Daftar permintaan pendaftaran pembicara yang harus dipenuhi sebagai bagian dari pekerjaan.
+ `RequestId`: Pengenal untuk permintaan pendaftaran pembicara ini. Itu harus unik dalam file input. Ini digunakan untuk memetakan dan mengidentifikasi entri dalam file output.
+ `SpeakerId`: Pengenal yang disediakan klien dari pembicara yang perlu didaftarkan. Anda harus lulus `CustomerSpeakerId` di bidang ini. Saat `GeneratedSpeakerId` ini tidak didukung.
+ `AudioSpecifications`: Daftar file audio yang dapat digunakan ID Suara untuk mendaftarkan speaker ini. ID Suara menggunakan file audio ini bersama-sama untuk mengumpulkan jumlah pidato yang diperlukan untuk pendaftaran. **Saat ini, jumlah maksimum file audio yang diizinkan untuk permintaan pendaftaran adalah 10.** Setiap file dapat berupa file.wav hingga 20MB, berisi audio dengan kecepatan KHz sampel 8 dan pengkodean PCM-16.
+ `S3URI`: Lokasi Amazon S3 dari file audio dalam format.wav yang perlu digunakan untuk mendaftarkan speaker.
+ `ChannelId`: Saluran audio yang akan digunakan untuk mendaftarkan speaker dalam file audio multi-saluran. ID Suara mendukung file audio hingga dua saluran, jadi nilai ini dibatasi untuk **0** atau **1**.
## Skema file keluaran
Berikut ini adalah skema file output yang dihasilkan untuk Speaker Enrollment Job:
```
{
"Version": "string",
"Errors": [
{
"RequestId": "string",
"ErrorCode": number,
"ErrorMessage": "string"
}
],
"SuccessfulEnrollments": [
{
"RequestId": "string",
"GeneratedSpeakerId": "string",
"CustomerSpeakerId": "string",
"EnrollmentStatus": "DUPLICATE_SKIPPED" | "NEW_ENROLLMENT" | "ENROLLMENT_OVERWRITE"
}
]
}
```
Berikut ini adalah deskripsi dari setiap atribut dari skema output.
+ `Version`: Versi dokumen skema keluaran. Saat ini, ini seharusnya`1.0`.
+ `Errors`: Daftar kesalahan untuk permintaan pendaftaran pembicara yang gagal di beberapa titik selama pendaftaran.
+
+ `RequestId`: Pengidentifikasi permintaan yang terkait dengan permintaan ini. Ini sama dengan yang `RequestId` ditentukan dalam file input untuk permintaan ini.
+ `ErrorCode`: Kode kesalahan HTTP yang mewakili jenis kesalahan. Beberapa contoh skenario kesalahan dijelaskan di bawah ini.
**catatan**
Ini bukan daftar lengkap.
+ 400 (Pengecualian Permintaan Buruk):
+ File JSON input salah bentuk dan tidak dapat diurai.
+ File audio yang disediakan tidak memiliki cukup pidato untuk pendaftaran.
+ Pemeriksaan verifikasi penipuan gagal untuk pembicara yang diberikan.
+ 402 (ServiceQuotaLimitExceededException):
+ Batas speaker terlampaui.
+ 409 (Pengecualian Konflik):
+ Tindakan yang bertentangan: Anda tidak dapat meminta pendaftaran untuk pembicara yang memilih keluar.
+ 500 (Kegagalan Internal):
+ Kesalahan Server Internal (Kesalahan tak terduga di sisi Layanan).
+ `ErrorMessage`: Pesan yang menjelaskan penyebab kegagalan pendaftaran.
+ `SuccessfulEnrollments`: Daftar permintaan pendaftaran yang berhasil.
+ `RequestId`: Pengidentifikasi permintaan yang terkait dengan permintaan ini. Ini sama dengan yang `RequestId` ditentukan dalam file input untuk permintaan ini.
+ `CustomerSpeakerId`: Pengenal yang disediakan klien untuk pembicara yang terdaftar.
+ `GeneratedSpeakerId`: Pengenal yang dihasilkan layanan untuk pembicara yang terdaftar.
+ `EnrollmentStatus`: Status pendaftaran pembicara yang sukses
+ `DUPLICATE_SKIPPED`: Pembicara sudah terdaftar, dan pendaftaran dilewati.
+ `NEW_ENROLLMENT`: Pembicara baru terdaftar ke dalam sistem.
+ `ENROLLMENT_OVERWRITE`: Pembicara sudah terdaftar, tetapi didaftarkan ulang/ditimpa menggunakan audio baru.
# Membuat dan mengedit daftar pantauan penipu di Amazon Connect Voice ID
**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).
Gunakan yang berikut ini APIs untuk membuat daftar pantauan penipu dan mendaftarkan penipu:
1. Gunakan [CreateWatchlist](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_CreateWatchlist.html)API untuk membuat daftar pantauan penipu baru.
1. Gunakan [StartFraudsterRegistrationJob](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_StartFraudsterRegistrationJob.html)API untuk pendaftaran batch. Anda dapat mendaftarkan penipu baru ke daftar pantauan baru, atau mendaftarkannya ke daftar pantauan default yang dikaitkan dengan domain ID Suara.
Saat mendaftarkan penipu baru, ID Suara membandingkan cetak suara dengan semua penipu register di domain ID Suara Anda untuk menentukan apakah itu duplikat dari penipu yang ada.
Untuk menambahkan penipu ke daftar pantauan penipu tertentu, teruskan data berikut ke API:
1. ID domain untuk menentukan domain untuk mengaitkan rekaman.
1. File input yang berisi daftar penipu. Lihat [Skema file input dan output untuk Pekerjaan Pendaftaran Penipu di Amazon Connect Voice ID](fraudster-registration-schema.md).
1. Lokasi untuk file output.
1. Kunci KMS untuk digunakan saat menulis output.
1. Peran yang dapat diasumsikan oleh ID Suara. Itu harus memiliki akses ke ember S3 tempat file audio disimpan. Peran ini harus memiliki akses ke kunci KMS yang digunakan untuk mengenkripsi file. Itu juga harus dapat menulis ke lokasi output yang ditentukan dan menggunakan kunci KMS yang diminta untuk menulis output. Secara khusus, ia harus memiliki izin berikut:
+ `s3:GetObject`pada ember input.
+ `s3:PutObject`pada ember output.
+ `kms:Decrypt`pada kunci KMS yang digunakan untuk enkripsi default bucket input.
+ `kms:Decrypt`dan `kms:GenerateDataKey` pada kunci KMS yang disediakan dalam input yang akan digunakan untuk menulis file output ke bucket output.
Anda harus memiliki `iam:PassRole` izin saat melakukan panggilan dan memberikan. `dataAccessRole` Untuk mengaktifkan perlindungan wakil yang membingungkan untuk`dataAccessRole`, lihat[Amazon Connect Voice ID lintas layanan pencegahan wakil membingungkan](cross-service-confused-deputy-prevention.md#voiceid-cross-service).
1. A WatchListid untuk mendaftarkan penipu ke. Jika tidak ada WatchListid yang ditentukan, penipu akan terdaftar ke daftar pantauan default untuk domain ID Suara tersebut.
1. Ambang batas untuk menetapkan status duplikat penipu.
1. Bendera untuk mengabaikan duplikat penipu.
ID Suara memperbarui daftar penipu dengan penambahan yang berhasil, dan mengembalikan entri yang `GeneratedFraudsterID` terkait dengan kembali ke lokasi S3 yang sama. Jika duplikat diidentifikasi, ID Suara mengembalikan status “duplikat” untuk entri dan memberikan pencocokan terdekat. `GeneratedFraudsterId` Setelah penipu berhasil terdaftar, Anda dapat mengaitkan penipu ini yang diidentifikasi oleh `GeneratedFraudsterID` ke dalam daftar pantauan baru dengan menggunakan API. [AssociateFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_AssociateFraudster.html)
ID Suara tidak dapat melakukan deteksi penipu dalam daftar pantauan sebelum daftar penipu dibuat.
Untuk kuota untuk daftar penipu, lihat. [Amazon Connect kuota layanan](amazon-connect-service-limits.md)
**catatan**
Anda dikenakan biaya untuk menambahkan ke daftar penipu. Untuk informasi selengkapnya, lihat [Harga ID Suara Amazon Connect](https://aws.amazon.com/connect/voice-id/).
# Skema file input dan output untuk Pekerjaan Pendaftaran Penipu di Amazon Connect Voice ID
**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).
## Skema file masukan
Berikut ini adalah skema file manifes masukan untuk Pekerjaan Pendaftaran Penipu:
```
{
"Version": "string",
"FraudsterRegistrationRequests": [
{
"RequestId": "string",
"AudioSpecifications": [
{
"S3Uri": "string",
"ChannelId": number
}
]
}
]
}
```
**catatan**
Semua bidang dalam skema **diperlukan**.
Berikut ini adalah deskripsi dari setiap atribut skema masukan.
+ `Version`: Versi dokumen skema. Saat ini, ini seharusnya`1.0`.
+ `FraudsterRegistrationRequests`: Daftar permintaan pendaftaran penipu yang harus dipenuhi sebagai bagian dari pekerjaan.
+ `RequestId`: Pengenal untuk permintaan pendaftaran penipu ini. Itu harus unik dalam file input. Ini digunakan untuk memetakan dan mengidentifikasi entri dalam file output.
+ `AudioSpecifications`: Daftar file audio yang dapat digunakan Voice ID untuk mendaftarkan penipu ini. ID Suara menggunakan file audio ini bersama-sama untuk mengumpulkan jumlah pidato yang diperlukan untuk pendaftaran. Saat ini, jumlah maksimum file audio yang diizinkan untuk permintaan pendaftaran adalah **10**. Setiap file dapat berupa file.wav hingga 20MB, berisi audio dengan kecepatan KHz sampel 8 dan pengkodean PCM-16.
+ `S3URI`: Lokasi Amazon S3 dari file audio dalam format.wav yang perlu digunakan untuk mendaftarkan penipu.
+ `ChannelId`: Saluran audio yang akan digunakan untuk mendaftarkan penipu dalam file audio multi-saluran. ID Suara mendukung file audio hingga dua saluran, jadi nilai ini dibatasi untuk **0** atau **1**.
## Skema file keluaran
Berikut ini adalah skema file manifes keluaran untuk Pekerjaan Pendaftaran Penipu:
```
{
"Version": "string",
"Errors": [
{
"RequestId": "string",
"ErrorCode": number,
"ErrorMessage": "string"
}
],
"SuccessfulRegistrations": [
{
"RequestId": "string",
"GeneratedFraudsterId": "string",
"RegistrationStatus": "DUPLICATE_SKIPPED" | "NEW_REGISTRATION",
"FraudsterSimilarityScore": number
}
]
}
```
Berikut ini adalah deskripsi dari setiap atribut dari skema output.
+ `Version`: Versi dokumen skema keluaran. Saat ini, ini seharusnya`1.0`.
+ `Errors`: Daftar kesalahan untuk permintaan pendaftaran penipu yang gagal di beberapa titik selama pendaftaran.
+
+ `RequestId`: Pengidentifikasi permintaan yang terkait dengan permintaan ini. Ini sama dengan yang `RequestId` ditentukan dalam file input untuk permintaan ini.
+ `ErrorCode`: Kode kesalahan HTTP yang mewakili jenis kesalahan. Beberapa contoh skenario kesalahan dijelaskan di bawah ini.
**catatan**
Ini bukan daftar lengkap.
+ 400 (Pengecualian Permintaan Buruk):
+ File JSON input salah bentuk dan tidak dapat diurai.
+ File audio yang disediakan tidak memiliki cukup pidato untuk pendaftaran.
+ 402 (ServiceQuotaLimitExceededException):
+ Batas penipu terlampaui.
+ 500 (Kegagalan Internal):
+ Kesalahan Server Internal (Kesalahan tak terduga di sisi Layanan).
+ `ErrorMessage`: Pesan yang menjelaskan penyebab kegagalan pendaftaran penipu.
+ `SuccessfulRegistrations`: Daftar permintaan pendaftaran yang berhasil.
+ `RequestId`: Pengidentifikasi permintaan yang terkait dengan permintaan ini. Ini sama dengan yang `RequestId` ditentukan dalam file input untuk permintaan ini.
+ `RegistrationStatus`: Status pendaftaran penipu yang berhasil.
+ `DUPLICATE_SKIPPED`: Penipu diidentifikasi sebagai duplikat, dan pendaftaran dilewati.
+ `NEW_FRAUDSTER`: Penipu baru saja terdaftar ke dalam sistem.
+ `GeneratedFraudsterId`: Pengenal yang dihasilkan layanan untuk penipu yang terdaftar. Dalam hal ini`DUPLICATE_SKIPPED`, ini adalah pengidentifikasi penipu yang sudah ada di domain yang paling cocok dengan penipu yang diberikan. `RegistrationStatus`
+ `FraudsterSimilarityScore`: Bidang opsional yang diisi saat pendaftaran penipu dilewati karena merupakan duplikat. Ini mewakili kesamaan penipu yang diberikan dengan penipu pencocokan terdekat yang sudah ada di domain.
# Amazon Connect Streams APIs untuk mengintegrasikan ID Suara
**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).
Gunakan [Amazon Connect Streams](https://github.com/aws/amazon-connect-streams) berikut APIs untuk mengintegrasikan ID Suara ke dalam aplikasi web agen yang ada.
+ `enrollSpeakerInVoiceId`: Daftarkan pelanggan ke ID Suara setelah mendapatkan persetujuan mereka untuk mendaftar.
+ `evaluateSpeakerWithVoiceId`: Periksa status otentikasi ID Suara pelanggan, dan untuk mendeteksi penipu.
+ `optOutVoiceIdSpeaker`: Menyisih pelanggan dari ID Suara.
+ `getVoiceIdSpeakerStatus`: Jelaskan status pendaftaran pelanggan.
+ `getVoiceIdSpeakerId`: Dapatkan `SpeakerID` untuk pelanggan.
+ `updateVoiceIdSpeakerId`: Perbarui `SpeakerID` untuk pelanggan.
Anda juga dapat menggunakan widget ID Suara di Contact Control Panel (CCP) jika Anda tidak ingin membangun antarmuka agen kustom. Untuk informasi selengkapnya tentang ID Suara di PKT, lihat[Mendaftarkan penelepon di ID Suara di Panel Kontrol Kontak (CCP)](use-voiceid.md).
# 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
}
}
}
```