本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 在 Amazon Connect 中搭配語音 ID 使用即時來電者身分驗證
**注意**
支援結束通知：2026 年 5 月 20 日， AWS 將結束對 Amazon Connect Voice ID 的支援。2026 年 5 月 20 日之後，您將無法再存取 Amazon Connect 主控台上的語音 ID、管理員網站或聯絡控制面板上的語音 ID Amazon Connect 功能，或存取語音 ID 資源。如需詳細資訊，請造訪 [Amazon Connect Voice ID 終止支援](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html)。
Amazon Connect Voice ID 提供即時來電者身分驗證和詐騙風險偵測，讓客服中心的語音互動更加安全、更有效率。語音 ID 使用機器學習技術，透過分析來電者的獨特語音特性來驗證真實客戶的身分。如此一來，聯絡中心就可以使用額外的安全層級，而不需要來電者回答多個安全性問題，也可以輕鬆地註冊和驗證客戶，而無需變更對話的自然流程。語音 ID 亦可即時偵測經常以您的聯絡中心為目標的詐騙者，進而減少因詐騙而造成的損失。
使用 Amazon Connect Voice ID，您可以：
+ 被動地為客戶註冊語音驗證，而不需要他們重複特定單字或片語。
+ 透過批次註冊，將客戶遷移至語音 ID。
+ 通過分析其獨特的語音特徵來驗證註冊客戶的身分。
+ 從您建立的監視清單中偵測詐騙者。
+ 偵測語音欺騙。
## 語音 ID 如何運作
### 客戶註冊
1. 當客戶第一次致電時，客服人員通過使用現有的安全措施來確認來電者的身分，例如詢問母親的娘家姓或通過簡訊發送的一次性密碼 (OTP)。這樣可確保只有真正的客戶才能註冊語音 ID。
1. 當聯絡人遇到已啟用語音 ID 的 [設定 Voice ID](set-voice-id.md) 區塊時，語音 ID 就會開始接聽客戶的語音。語音 ID 會接聽來電，直到發生下列其中一種情況：
+ 它獲得足夠的音訊來評估發言者的身分驗證、詐騙和註冊發言者 (如果要求)。這是 30 秒的客戶講話，不包括靜音。
+ 通話結束。
1. 語音 ID 接著會建立註冊聲紋。聲紋是一種數學表示形式，隱含地擷取個人聲音的獨特方面，例如語音節奏、音調、語調和響度。
來電者不需要說出或重複任何特定片語即可註冊語音 ID。
### 自訂身分驗證
1. 當註冊的客戶回電，他們會透過與 IVR 的互動或在與客服人員的互動過程中進行驗證。
預設情況下，語音 ID 設定為需要 10 秒來電者的語音進行身分驗證，這可以作為 IVR 中的典型客戶互動或與客服人員的一部分 (例如「您的名字和姓氏是什麼？」和「您打電話來做什麼？」)。您可以使用 [設定 Voice ID](set-voice-id.md) 區塊中的 [認證回應時間](set-voice-id.md#set-voice-id-properties-authentication-response-time) 屬性調整所需的語音量。
1. 語音認證使用聲音產生來電者的聲紋，並將其與已註冊的聲紋對應於宣告的身分，並傳回認證結果。
如需客服人員體驗的詳細資訊，請參閱 [在聯絡人控制台 (CCP) 的 Voice ID 中註冊來電者](use-voiceid.md)。
## 註冊和驗證需要多少語音
+ 註冊：30 秒的客戶網路語音 (不包括任何靜音的語音) 以建立聲紋並註冊客戶。
+ 驗證：根據預設，客戶網路語音需要 10 秒鐘，以驗證語音是否屬於已宣告的身分。語音可以來自與 IVR 或客服人員的互動。您可以使用 [設定 Voice ID](set-voice-id.md) 中的 [認證回應時間](set-voice-id.md#set-voice-id-properties-authentication-response-time) 屬性調整所需的語音數量。
## 批次註冊
通過批次註冊已同意使用生物識別技術的客戶，您可以快速開始使用生物識別技術。您可以使用 S3 儲存貯體中儲存的錄音，以及提供發言者識別碼和錄音連結的 JSON 輸入檔案，您可以調用語音 ID 批次 API。
如需詳細資訊，請參閱[使用來自先前通話的音訊資料，在 Amazon Connect Voice ID 中進行批次註冊](voiceid-batch-enrollment.md)。
## 已知詐騙者偵測
設定詐騙者的即時偵測，有幾個步驟：
1. [建立新的監視清單](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_CreateWatchlist.html)來儲存已知詐騙者。或者，您也可以使用啟用語音 ID 時建立的預設監視清單。
1. 將[詐騙者註冊](voiceid-fraudster-watchlist.md)到新的監視清單或預設監視清單。
1. 在 [設定 Voice ID](set-voice-id.md) 區塊中，指定您要使用的監視清單。
當流程中指定的監視清單中的詐騙者之一呼叫您的聯絡中心時，語音 ID 會分析通話音訊以傳回風險評分和結果。該分數表示來電者的聲紋與監視清單中詐騙者的聲紋相符的程度。語音認證需要 10 秒的音訊來評估通話音訊是否存在已知詐騙者的詐騙風險。
### 預設監視清單
建立語音 ID 網域後，語音 ID 會為該網域建立預設詐騙者監視清單。預設詐騙者監視清單的名稱和說明會使用網域中提供並儲存在 Voice ID 中的 KMS 金鑰加密。
如果您沒有提供詐騙者 watchlistId 進行詐騙偵測或詐騙者註冊，語音 ID 會使用預設的詐騙者監視清單。
您無法更新預設詐騙者監視清單的中繼資料，但可以將詐騙者與其關聯或取消關聯。
**注意**
如果您的語音 ID 網域是在 2023 年 3 月之前建立的，則在啟動詐騙者監視清單時：系統已建立預設監視清單，且所有現有的詐騙者都已加入其中。
## 語音欺騙偵測
1. 當潛在的詐騙者嘗試使用音訊播放或合成語音來欺騙來電者音訊時，語音 ID 會傳回風險評分和結果，以指示語音被欺騙的可能性。
1. 僅在您於聯絡流程中啟用詐騙偵測功能時，才會啟用語音詐騙。僅啟用發言者身分驗證時，不會傳回語音詐騙分數。
1. 語音識別需要 10 秒的音訊來評估通話音訊是否存在語音欺騙帶來的詐騙風險。
## 儲存哪些資料？
語音 ID 會儲存發言者語音、聲紋和發言者識別碼的音訊檔案。此資料會使用您提供的 KMS 金鑰加密。
如果您啟用監視清單中的詐騙者偵測功能，語音 ID 也會儲存詐騙者的音訊和聲紋。如需詳細資訊，請參閱[由 Amazon Connect 處理的資料](data-handled-by-connect.md)。
# Amazon Connect Voice ID 終止支援
經審慎考量後，我們決定終止對 Amazon Connect Voice ID 的支援，自 2026 年 5 月 20 日起生效。自 2025 年 5 月 20 日起，Amazon Connect Voice ID 將不再接受新客戶。現有客戶若是在 2025 年 5 月 20 日之前使用帳戶註冊服務，則可繼續使用 Amazon Connect Voice ID 功能。2026 年 5 月 20 日之後，您將無法再使用 Amazon Connect Voice ID。
此頁面提供 Amazon Connect IT 管理員和使用者將 Voice ID 轉換為替代解決方案的指示和最佳實務，以因應您的業務需求。這可能包括 AWS Marketplace 上可用 AWS 合作夥伴的解決方案，例如 [Pindrop®](https://aws.amazon.com/marketplace/pp/prodview-f7rqlwjby3er4) 或do-it-yourself解決方案 AWS End User Messaging SMS。
## 使用 Do-it-yourself解決方案 AWS End User Messaging SMS
您可以為聯絡中心啟用One-Time-Pin(OTP) 型身分驗證，藉此改善聯絡中心的安全性 AWS End User Messaging SMS。您可以參考解決方案範例，以使用 為聯絡中心 AWS End User Messaging SMS 建立 OTPs。如需此解決方案的詳細資訊，請參閱下列部落格文章：[使用 建置安全一次性密碼架構 AWS](https://aws.amazon.com/blogs/messaging-and-targeting/build-a-secure-one-time-password-architecture-with-aws/)。如需詳細資訊 AWS End User Messaging SMS，請參閱[什麼是 AWS End User Messaging SMS？](https://docs.aws.amazon.com/sms-voice/latest/userguide/what-is-sms-mms.html)
## 管理您的 Voice ID 資料
您可以使用語音 ID `ListDomains` API 搭配 `DescribeDomain` API，取得 AWS 會計中所有語音 ID 網域的相關資訊。如需管理 Amazon Connect Voice ID 網域的詳細資訊，請參閱 [管理 Amazon Connect Voice ID 網域](voiceid-domain-operations.md)。
對於特定 Voice ID 網域，您可以使用 `ListSpeakers` API 來下載已註冊撥打者的相關資料，並使用 `ListFraudsters` API 下載已註冊詐騙者的資料。如需發言者和詐騙者管理的詳細資訊，請參閱 [Amazon Connect Voice ID 發言者、監視清單和詐騙者管理 API](voiceid-speaker-fraudster-management-apis.md)。您可以使用 Voice ID `DeleteDomain` API，確定 Voice ID 上的所有客戶資料都已刪除。您需要為每個 AWS 區域和每個帳戶中的每個語音 ID 網域執行此操作。
# Amazon Connect Voice ID 中的語音 ID 網域
**注意**
支援結束通知：2026 年 5 月 20 日， AWS 將結束對 Amazon Connect Voice ID 的支援。2026 年 5 月 20 日之後，您將無法再存取 Amazon Connect 主控台上的語音 ID、管理員網站或聯絡控制面板上的語音 ID Amazon Connect 功能，或存取語音 ID 資源。如需詳細資訊，請造訪 [Amazon Connect Voice ID 終止支援](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html)。
啟用 Amazon Connect Voice ID 時，您會建立語音 ID 網域：用於所有語音 ID 資料的容器，例如發言者識別碼 (用作客戶識別碼)、聲紋、用於建立註冊聲紋的客戶音訊，以及與發言者識別碼相關聯的註冊狀態 (已註冊、已退出等)。為了偵測監視清單中的詐騙者，語音 ID 網域會儲存用於建立聲紋的詐騙者識別碼、聲紋和音訊。
以下是建立語音 ID 網域的準則：
+ 每個 Amazon Connect 執行個體只能與一個語音 ID 網域關聯。
+ 每個語音 ID 網域可以與多個 Amazon Connect 執行個體關聯。這可讓您跨多個 Amazon Connect 執行個體使用相同的存放客戶資料。
+ 您可以建立多個網域，但這些網域不會彼此共用客戶資料。
+ 我們建議在下列情況下建立新的語音 ID 網域以與 Amazon Connect 執行個體關聯：
+ 您是在某個 AWS 地區的帳戶中首次啟用語音 ID。
+ 您想要確保隔離用於測試和生產環境的語音 ID 網域。
+ 我們建議在以下情況使用現有的語音 ID 網域：
+ 您想要在不同的 Amazon Connect 執行個體 (可能屬於不同的客戶服務團隊) 中使用同一組註冊的來電者和詐騙者
+ 您想要在不同的測試 Amazon Connect 執行個體上使用相同的測試環境。
**注意**
只有您 Amazon Connect 帳戶中相同區域中的現有語音 ID 網域可以在該區域的 Amazon Connect 執行個體之間共用。
+ 您可以選擇不同的網域，隨時將 Amazon Connect 執行個體的關聯從目前的網域變更為新網域。
+ 若要刪除語音 ID 網域，請使用 [DeleteDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteDomain.html) 語音 ID API。`DeleteDomain` 軟刪除網域。Amazon Connect 在完全清除網域資料之前等待 30 天。在此期間，語音 ID 會停用與其相關聯的所有 Amazon Connect 執行個體。若要在此時段還原網域，請提交 支援 票證並提供網域 ID。您可以在 Amazon Connect Voice ID 區段找到網域 ID，如下列範例所示：
![\[Amazon Connect 主控台的語音 ID 區段，其中顯示網域還原所需的網域 ID 欄位。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/voiceid-domain.png)
刪除語音 ID 網域會刪除所有儲存的客戶資料，例如錄音、聲紋和發言者識別碼，以及您管理的任何詐騙者監視清單。
## 註冊狀態
語音 ID 會為發言者儲存三種不同的註冊狀態：`ENROLLED`、` OPTED_OUT` 和 `EXPIRED`。您可以使用 [Amazon Connect Voice ID API](https://docs.aws.amazon.com/voiceid/latest/APIReference/) 來回憶這些發言者狀態，並使用聯絡流程區塊採取適當的動作。
+ `ENROLLED`：當您註冊新來電者已註冊至語音 ID 時，語音 ID 會建立新的聲紋，並將發言者狀態設定為 `ENROLLED`。即使您將同一來電者重新註冊至語音 ID，狀態仍會保持為 `ENROLLED`。
+ `OPTED_OUT`：如果來電者不同意註冊生物識別技術，您可以選擇退出來電者 (在聯絡控制面板中) 或使用 API。語音 ID 為此來電者建立新項目，並設定發言者的狀態 `OPTED_OUT`。語音 ID 不會產生任何聲紋或儲存發言者的任何錄音。除非刪除其輸入內容，否則將拒絕此發言者的未來註冊請求。
+ `EXPIRED`：如果來電者的聲紋已經 3 年未被存取或重新整理，語音 ID 會將狀態變更為 `EXPIRED`，且您無法再對此來電者執行驗證。您可以重新註冊來電者，或從語音 ID 刪除來電者。
## 發言者過期
為了符合 BIPA 規範，對於三年內未存取以進行註冊、重新註冊或成功進行身分驗證的發言者，語音 ID 會自動過期。
若要檢視發言者的上次存取，請查看 `DescribeSpeaker` 和 `ListSpeakers` API 傳回的 `lastAccessedAt` 屬性。
如果您嘗試使用 `EvaluateSesssion` API 來驗證過期的發言者，則會傳回 `SPEAKER_EXPIRED` 驗證決定。
若要再次使用過期的發言者，他們必須重新註冊。
## 發言者和詐騙者識別碼
語音 ID 使用發言者識別碼來參考和擷取語音 ID 網域中的聲紋。我們建議您在識別碼中使用不包含個人身分識別資訊 (PII) 的識別碼。
語音識別會建立兩個欄位來引用來電者：
+ `CustomerSpeakerId`：客戶提供的識別碼。它可以介於 1-256 個字元之間，且只能包含：**a-z**、**A-Z**、**0-9**、**-** 和 **\$1**
+ `GeneratedSpeakerId`：語音 ID 在註冊來電者時建立並傳回的唯一 22 個字元英數字串。
[Amazon Connect Voice ID 發言者 API](https://docs.aws.amazon.com/voiceid/latest/APIReference/Welcome.html) 接受任一種形式的發言者識別碼，但只會在語音 ID 事件串流和聯絡記錄中發出 `GeneratedSpeakerId`。如果您想重新錄製來電者以重做聲紋，可以使用相同的 `CustomerSpeakerId` 註冊來電者。
同樣地，語音 ID 會為您新增至網域中監視清單的每個詐騙者建立名為 `GeneratedFraudsterID` 的唯一詐騙者識別碼。執行詐騙風險偵測時，如果在來電中偵測到詐騙者，語音 ID 會傳回詐騙者識別碼。
# 開始在 Amazon Connect 中啟用語音 ID
**注意**
支援結束通知：2026 年 5 月 20 日， AWS 將結束對 Amazon Connect Voice ID 的支援。2026 年 5 月 20 日之後，您將無法再存取 Amazon Connect 主控台上的語音 ID、管理員網站或聯絡控制面板上的語音 ID Amazon Connect 功能，或存取語音 ID 資源。如需詳細資訊，請造訪 [Amazon Connect Voice ID 終止支援](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html)。
## 開始之前
開始使用之前，請完成以下任務。
**Topics**
+ [授予所需的許可。](#enable-voiceid-permissions)
+ [決定如何命名您的語音 ID 網域](#enable-voiceid-domains)
+ [建立 AWS KMS key 來加密存放在網域中的資料](#enable-voiceid-awsmanagedkey)
### 授予所需的許可。
您必須向使用者、群組或角色授予所需的許可。如需詳細資訊，請參閱 [AmazonConnectVoiceIDFullAccess](security_iam_awsmanpol.md#amazonconnectvoiceidfullaccesspolicy)。
預設情況下，停止使用聯絡控制面板 (CCP) 存取語音 ID API。
### 決定如何命名您的語音 ID 網域
當您啟用語音 ID 時，系統會提示您提供對您有意義的易記網域名稱，例如您的組織名稱，例如*語音 ID-ExampleCorp*。
### 建立 AWS KMS key 來加密存放在網域中的資料
當您啟用語音 ID 時，系統會提示您建立或提供 [AWS KMS key](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#kms_keys)。它會加密語音 ID 儲存的客戶資料，例如音訊檔案、聲紋和發言者識別碼。
[步驟 2：建立新的語音 ID 網域和加密金鑰](#enable-voiceid-step2) 中提供建立這些 KMS 金鑰的逐步說明。
靜態資料 (特別是您提供的自由格式欄位加上音訊檔案/語音) 會根據您選擇的 KMS 金鑰加密。客戶受管金鑰由您建立、擁有且管理。您可以完全控制 KMS 金鑰 （需支付AWS KMS 費用）。
當針對 `CreateDomain` 或 `UpdateDomain` 以外的任何內容呼叫語音 ID 時，進行通話的使用者需要與網域關聯的金鑰的 `kms:Decrypt` 許可。當向 `CreateDomain` 或 `UpdateDomain` 撥打電話時，使用者還需要金鑰的 `kms:DescribeKey` 和 `kms:CreateGrant` 許可。建立 (或更新) 語音 ID 網域時，它會在 KMS 金鑰上建立授權，以便語音 ID 非同步程序 (例如說話者註冊) 以及在流程期間由 Amazon Connect 服務連結角色使用。此授權包括加密內容，指定與金鑰相關聯的網域。如需詳細資訊，請參閱 AWS Key Management Service 開發人員指南中的[使用授權](https://docs.aws.amazon.com/kms/latest/developerguide/grants.html)。
如果您建立網域並將其與一個金鑰建立關聯、儲存一些資料，然後將 KMS 金鑰變更為其他金鑰，則會觸發非同步程序，以使用新的 KMS 金鑰重新加密舊資料。完成此程序後，您網域的所有資料都會以新的 KMS 金鑰加密，您可以安全地淘汰舊金鑰。如需詳細資訊，請參閱 [UpdateDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_UpdateDomain)。
**提示**
您能以程式設計方式建立 KMS 金鑰或提供現有的 KMS 金鑰。如需詳細資訊，請參閱 [Amazon Connect Voice ID API](https://docs.aws.amazon.com/voiceid/latest/APIReference/)。
## 步驟 1：閱讀 BIPPA 同意確認書
閱讀生物識別隱私法 (BIPA) 同意確認書是啟用語音 ID 的必要條件。您需要在所有區域中為每個帳戶執行這項操作一次。您無法使用 API 來執行此步驟。有關 BIPA 的詳細資訊，請參閱此 Wikipedia 文章：[生物識別資訊隱私法](https://en.wikipedia.org/wiki/Biometric_Information_Privacy_Act)。
1. 在 [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/) 開啟 Amazon Connect 主控台。
1. 在執行個體頁面上，選擇執行個體別名。執行個體別名也是您的**執行個體名稱**，它會出現在您的 Amazon Connect URL 中。下圖顯示 **Amazon Connect 虛擬聯絡中心執行個體**頁面，其中包含執行個體別名周圍的方塊。
![\[Amazon Connect 虛擬聯絡中心執行個體頁面、執行個體別名。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/instance.png)
1. 在導覽窗格上,選擇**語音 ID**。閱讀 BIPA 同意確認書，如果您同意，請接受。
![\[啟用語音 ID 頁面顯示 BIPA (生物識別資訊隱私權法) 同意確認按鈕，使用者必須先閱讀並接受該按鈕，才能啟用語音 ID。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/voiceid-bipa.png)
## 步驟 2：建立新的語音 ID 網域和加密金鑰
您可以使用 Amazon Connect 主控台或使用 Amazon Connect 和語音 ID API 來執行此步驟。
------
#### [ Amazon Connect console instructions ]
1. 在**網域設定**區段中，選擇**建立新網域**。
![\[網域設定介面，其中具有建立新網域或選擇現有網域的選項。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/voiceid-enable-domain.png)
1. 在**網域名稱**方塊中，輸入對您有意義的易記名稱，例如您的組織名稱，例如 *VoiceID-ExampleCorp*。
1. 在**加密**下，建立或輸入您自己的語音 ID 網域 AWS KMS key 來加密。以下是建立 KMS 金鑰的步驟：
1. 選擇**建立 KMS 金鑰**。
![\[語音 ID 設定頁面的加密區段，其中顯示用於建立新的加密金鑰的「建立 AWS KMS 金鑰」按鈕。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/voiceid-create-kms-key.png)
1. AWS Key Management Service (KMS) 主控台會在瀏覽器中開啟新分頁。在**設定金鑰**頁面上，選擇**對稱**，然後選擇**下一步**。
![\[使用為加密和解密選取的對稱金鑰類型來設定金鑰頁面。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/customer-profiles-create-kms-key-configure-key.png)
1. 在**新增標籤**頁面上，新增 KMS 金鑰的名稱和說明，然後選擇**下一步**。
1. 在**定義金鑰管理許可**頁面上，選擇**下一步**。
1. 在**定義金鑰使用許可**頁面上，選擇**下一步**。
1. 在**檢閱並編輯金鑰政策**頁面上，選擇**完成**。
1. 返回瀏覽器中的索引標籤，以取得 Amazon Connect 主控台的**語音 ID** 頁面。按一下或點選您建立的金鑰的 **AWS KMS key**，以顯示在下拉式清單中。選擇您建立的金鑰。
1. 選擇**啟用語音 ID**。
------
#### [ API instructions ]
1. 呼叫 [CreateDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_CreateDomain.html) API 以建立新的語音 ID 網域。
1. 呼叫 [CreateIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateIntegrationAssociation.html) API，將語音 ID 網域與 Amazon Connect 執行個體建立關聯。
1. 將剛建立之語音 ID 網域的 ARN 傳遞至 `IntegrationArn` 參數。對於 `IntegrationType`，請使用 `VOICE_ID`。
------
您已為執行個體啟用語音 ID。已建立下列項目：
+ 您的語音 ID 網域和預設詐騙者監視清單，這些清單會保留您的詐騙者。
+ 您帳戶中的受管 Amazon EventBridge 規則。此規則是用來擷取語音 ID 事件，以建立與語音 ID 相關的聯絡記錄。此外，Amazon Connect 將[語音 ID 許可](connect-slr.md)新增到服務連結角色的 Amazon Connect。
接下來，在步驟 3 中設定語音 ID 在流程中的運作方式。
## 步驟 3：在聯絡流程中設定語音 ID
在此步驟中，您將所需的區塊新增至流程，並設定語音 ID 的運作方式。
+ [播放提示](play.md)：在 [設定 Voice ID](set-voice-id.md) 區塊之前新增此區塊以正確串流音訊。您可以對其進行編輯以包含簡單的訊息，例如「歡迎」。
+ [設定 Voice ID](set-voice-id.md)：在 [播放提示](play.md) 區塊之後，新增 [設定 Voice ID](set-voice-id.md) 區塊。它應該是在通話的開始。使用此區塊開始將音訊串流至 Amazon Connect Voice ID，以便在通話連線至流程後立即驗證來電者的身分。
在**設定語音 ID** 區塊中，您可以設定驗證閾值、回應時間、詐騙閾值，以及詐騙者監視清單，以用於偵測已知詐騙者。
+ [設定聯絡屬性](set-contact-attributes.md)：用於將 `CustomerId` 屬性傳遞至語音 ID。例如，`CustomerId` 可能是 CRM 中的客戶編號。您可以建立 Lambda 函數，從 CRM 系統中提取來電者的唯一客戶 ID。語音 ID 會使用此屬性作為來電者的 `CustomerSpeakerId`。
**注意**
`CustomerId` 可以是字母數字值。它僅支援 \$1 和 - (底線和連字號) 特殊字元。它不需要是 UUID。由於 Voice ID 會儲存每個說話者的生物識別資訊，因此我們強烈建議您使用 CustomerSpeakerId 欄位不包含 PII 的識別碼。如需詳細資訊，請參閱[發言者](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_Speaker.html)資料類型中的 `CustomerSpeakerId`。
+ [檢查語音 ID](check-voice-id.md)：用於檢查來自語音 ID 的註冊狀態、語音驗證和詐騙偵測的回應，然後根據其中一個傳回的狀態進行分支。
### 語音 ID 流程範例
**來電者未註冊**
1. 當客戶第一次致電時，他們的 `CustomerId` 會使用該 [設定聯絡屬性](set-contact-attributes.md) 區塊傳送至語音 ID。
1. 語音 ID 會在其資料庫中尋找 `CustomerId`。由於它不在那裡，它會發送一個**未註冊**的結果訊息。基於此結果的 [檢查語音 ID](check-voice-id.md) 區塊分支，您可以決定下一步應該是什麼。例如，您可能希望客服人員在語音驗證中註冊客戶。
1. 當聯絡人遇到已啟用語音 ID 的 [設定 Voice ID](set-voice-id.md) 區塊後，語音 ID 就會開始接聽客戶的語音。它會接聽，直到它累積 30 秒的網路語音或通話結束，以先發生者為準。
**來電者註冊**
1. 下次客戶撥打電話時，語音 ID 在資料庫中找到他們的 `CustomerId`。
1. 語音 ID 會開始接聽音訊以建立聲紋。這次建立的聲紋是用於認證目的，因此語音 ID 可以比較來電者之前是否已註冊過。
1. 它將來電者目前的聲紋與所儲存的與所聲稱的身分相關聯的聲紋進行比較。它會根據您在 [設定 Voice ID](set-voice-id.md) 區塊中設定的**驗證閾值**屬性傳回結果。
1. 評估語音後，如果聲紋相似，則返回**已驗證**訊息。或者返回其他狀態之一。
1. 然後，該聯絡人將透過 [檢查語音 ID](check-voice-id.md) 區塊路由到適當的分支。
# Amazon Connect Voice ID 的安全性設定檔許可
**注意**
支援結束通知：2026 年 5 月 20 日， AWS 將結束對 Amazon Connect Voice ID 的支援。2026 年 5 月 20 日之後，您將無法再存取 Amazon Connect 主控台上的語音 ID、管理員網站或聯絡控制面板上的語音 ID Amazon Connect 功能，或存取語音 ID 資源。如需詳細資訊，請造訪 [Amazon Connect Voice ID 終止支援](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html)。
+ 若要讓使用者依語音 ID 狀態搜尋聯絡人，請將下列**分析與最佳化**許可指派給其安全性設定檔：
+ **語音 ID-屬性和搜尋**：可讓使用者在**聯絡人詳細資料**頁面上搜尋和檢視語音 ID 結果。
+ 在聯絡控制面板中授予客服人員對語音 ID 的存取權，請在**聯絡控制面板**群組中指派下列許可：
+ **語音 ID - 存取**：啟用聯絡控制面板中的控制項，讓客服人員可以：
+ 檢視驗證結果。
+ 選擇退出或重新驗證來電者。
+ 更新 `SpeakerID`。
+ 查看詐騙偵測結果，重新運行詐騙分析 (詐騙偵測決策，詐騙類型和分數)。
**注意**
CCP 中的預設語音 ID 小工具不提供輸入或更新 `SpeakerID` 的功能。若要包含更新 `SpeakerID` 的選項，請在您的自訂 CCP 中實作 `updateVoiceIdSpeakerId` [Amazon Connect Streams](https://github.com/aws/amazon-connect-streams) API。
下圖顯示了 CCP 上這些控制項的範例：
![\[顯示語音 ID 控制項的聯絡人控制台 (CCP)，包括註冊狀態、身分驗證結果，以及用於註冊或選擇退出客戶的按鈕。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/voiceid-ccp-controls.png)
如需如何將更多權限新增到現有安全性設定檔的資訊，請參閱 [在 Amazon Connect 中更新安全性設定檔](update-security-profiles.md)。
根據預設，**管理員**安全性設定檔已擁有執行所有語音 ID 活動的許可。
# 搜尋並檢閱語音 ID 身分驗證的結果
**注意**
支援結束通知：2026 年 5 月 20 日， AWS 將結束對 Amazon Connect Voice ID 的支援。2026 年 5 月 20 日之後，您將無法再存取 Amazon Connect 主控台上的語音 ID、管理員網站或聯絡控制面板上的語音 ID Amazon Connect 功能，或存取語音 ID 資源。如需詳細資訊，請造訪 [Amazon Connect Voice ID 終止支援](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html)。
使用[聯絡搜尋](contact-search.md)頁面來搜尋和檢視監視清單中的註冊狀態、語音驗證和偵測詐騙者的結果。透過必要的[安全性設定檔許可](contact-search.md#required-permissions-search-contacts) (**分析與最佳化** - **語音 ID - 屬性和搜尋 - 檢視**)，您可以使用下列篩選器搜尋語音 ID 結果：
+ **發言者動作**：使用此篩選器來搜尋來電者已註冊至語音 ID 或選擇完全退出語音 ID 的聯絡人。
+ **驗證結果**：使用此篩選器可搜尋語音 ID 驗證傳回下列結果的聯絡人：
+ 已驗證
+ 未驗證
+ 選擇退出
+ 不確定
+ 未註冊
例如，如果您想要搜尋驗證狀態傳回為**未驗證**或**選擇退出**的所有聯絡人，請同時選擇這兩個選項，然後選擇**套用**。
+ **詐騙偵測結果**：使用此篩選器來搜尋語音 ID 詐騙分析傳回下列結果的聯絡人：
+ 高風險詐騙
+ 低風險詐騙
+ 不確定
+ **詐騙偵測原因**：使用此過濾器搜索偵測到特定詐騙風險機制的聯絡人：
+ 已知的詐騙者：來電者的聲音與您建立的詐騙者監視清單中的詐騙者相符。
+ 語音欺騙：來電者正在修改他們的聲音，或者正在使用語音合成來欺騙客服人員。
## 語音 ID 會產生聯絡記錄
搜尋聯絡人後，您可以選擇 ID 來檢視其聯絡記錄。下圖顯示聯絡記錄語音 ID 區段中的欄位範例：
![\[聯絡人記錄的語音 ID 區段，其中顯示身分驗證結果、詐騙者偵測狀態、詐騙者 ID 和監視清單 ID 欄位。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/voiceid-ctr-nospoofing.png)
# 使用語音 ID API 管理 Amazon Connect Voice ID
**注意**
支援結束通知：2026 年 5 月 20 日， AWS 將結束對 Amazon Connect Voice ID 的支援。2026 年 5 月 20 日之後，您將無法再存取 Amazon Connect 主控台上的語音 ID、管理員網站或聯絡控制面板上的語音 ID Amazon Connect 功能，或存取語音 ID 資源。如需詳細資訊，請造訪 [Amazon Connect Voice ID 終止支援](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html)。
若要以程式設計方式管理語音 ID，請參閱 [Amazon Connect Voice ID API](https://docs.aws.amazon.com/voiceid/latest/APIReference/)。
本節說明如何使用 Voice ID API 執行常見案例。
**Topics**
+ [管理 Amazon Connect Voice ID 網域](voiceid-domain-operations.md)
+ [Amazon Connect 整合關聯 API](voiceid-integration-association-apis.md)
+ [發言者、監視清單和詐騙者管理 API](voiceid-speaker-fraudster-management-apis.md)
+ [使用來自先前通話的音訊資料，在 Amazon Connect Voice ID 中進行批次註冊](voiceid-batch-enrollment.md)
+ [發言者註冊工作的檔案結構描述](speaker-enrollment-job-schema.md)
+ [在 Amazon Connect Voice ID 中建立和編輯詐騙者監視清單](voiceid-fraudster-watchlist.md)
+ [詐騙者註冊工作的檔案結構描述](fraudster-registration-schema.md)
+ [整合語音 ID 的 Amazon Connect Streams API](voiceid-streams-apis.md)
# 管理 Amazon Connect Voice ID 網域
**注意**
支援結束通知：2026 年 5 月 20 日， AWS 將結束對 Amazon Connect Voice ID 的支援。2026 年 5 月 20 日之後，您將無法再存取 Amazon Connect 主控台上的語音 ID、管理員網站或聯絡控制面板上的語音 ID Amazon Connect 功能，或存取語音 ID 資源。如需詳細資訊，請造訪 [Amazon Connect Voice ID 終止支援](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html)。
Amazon Connect Voice ID 為您提供用於管理語音 ID 網域的 API。您可以在 AWS 主控台中找到建立、描述、列出和更新的對等項目。
1. [CreateDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_CreateDomain.html)：若要建立新的語音 ID 網域，請使用 `CreateDomain` 語音 ID API。建立 Voice ID 網域後，系統會同時建立預設的詐騙者監視清單，以保留您的詐騙者。
使用 `CreateDomain` API 時，請注意下列指導方針：
+ 只有在您在 AWS 主控台中確認 BIPA 同意後，才能叫用您的帳戶。
+ 您也必須在建立時指定語音 ID 網域的 KMS 金鑰。
+ 建立語音 ID 網域後，請使用 [Amazon Connect 關聯 API](https://docs.aws.amazon.com/connect/latest/APIReference/) 將其與 Amazon Connect 執行個體建立關聯。
1. [DeleteDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteDomain.html)：若要刪除語音 ID 網域，您必須調用 `DeleteDomain` 語音 ID API 並提供網域 ID。如果此網域與 Amazon Connect 執行個體相關聯，語音 ID API 呼叫和語音 ID 流程區塊將傳回執行期錯誤。刪除語音 ID 網域會刪除所有儲存的客戶資料，例如錄音、聲紋和發言者識別碼，以及您管理的詐騙者名單。
1. [DescribeDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DescribeDomain.html)：使用此 API 傳回由 `DomainID` 識別的現有網域的名稱，描述和加密配置。
1. [ListDomains](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_ListDomains.html)：使用此 API 列出您在該地區帳戶擁有的所有語音 ID 網域。
1. [UpdateDomain](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_UpdateDomain.html)：若要更新網域的名稱和加密設定，您可以使用 `UpdateDomain` 語音 ID API。此 API 會破壞現有屬性，而且您必須同時提供這兩個欄位。
當您變更與 Voice ID 網域相關聯的 KMS 金鑰時，在 `UpdateDomain` 呼叫之後，網域的現有資料將在新的 KMS 金鑰下以非同步方式重新加密。您可以使用 `DescribeDomain` API 從網域的 `ServerSideEncryptionUpdateDetails` 屬性中檢查此過程的狀態。此更新程序正在進行中時，您必須將舊 KMS 金鑰保留在可存取的狀態，否則此程序可能會失敗。完成此程序之後，舊的 KMS 金鑰可能會安全淘汰。
# 語音 ID 和 Amazon Connect 整合關聯 API
**注意**
支援結束通知：2026 年 5 月 20 日， AWS 將結束對 Amazon Connect Voice ID 的支援。2026 年 5 月 20 日之後，您將無法再存取 Amazon Connect 主控台上的語音 ID、管理員網站或聯絡控制面板上的語音 ID Amazon Connect 功能，或存取語音 ID 資源。如需詳細資訊，請造訪 [Amazon Connect Voice ID 終止支援](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html)。
您可以使用下列 API 來管理與 Amazon Connect 執行個體的關聯。您也可以在 AWS 主控台上執行這些操作。
1. [CreateIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateIntegrationAssociation.html)：若要在 Amazon Connect 執行個體上啟用語音 ID，您需要使用 `CreateIntegrationAssociation` 請求將語音 ID 域與 Amazon Connect 執行個體關聯。您只能將一個語音 ID 網域關聯到一個 Amazon Connect 執行個體。如果執行個體已與網域相關聯，則 API 會傳回下列錯誤：
`DuplicateResourceException` (409) - 請求正在嘗試建立重複的資源。
**注意**
當您為 Amazon Connect 執行個體啟用語音 ID 時 (透過使用 Amazon Connect 主控台或 [CreateIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateIntegrationAssociation.html) API)，Amazon Connect 會在您的帳戶中建立受管 Amazon EventBridge 規則。此規則是用來擷取語音 ID 事件，以建立與語音 ID 相關的聯絡記錄。此外，Amazon Connect 將[語音 ID 許可](connect-slr.md)新增到服務連結角色的 Amazon Connect。
1. [DeleteIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_DeleteIntegrationAssociation.html)：若要刪除 Amazon Connect 執行個體和語音 ID 網域之間的現有關聯，您將需要呼叫 `DeleteIntegrationAssociation` API 以及 Amazon Connect InstanceID 和 `CreateIntegrationAssociation` 傳回的 `IntegrationAssociationID`。如果您想要將不同的語音 ID 網域與此 Amazon Connect 執行個體建立關聯，這是必要步驟。我們不建議刪除生產設定中的關聯，因為這可能會導致 Amazon Connect 執行個體中的語音 ID 無法預測的行為。
1. [ListIntegrationAssociations](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListIntegrationAssociations.html)：若要列出此區域中您帳戶之 Amazon Connect 執行個體和語音 ID 網域之間的所有關聯，您可以調用 `ListIntegrationAssociations` API。
# Amazon Connect Voice ID 發言者、監視清單和詐騙者管理 API
**注意**
支援結束通知：2026 年 5 月 20 日， AWS 將結束對 Amazon Connect Voice ID 的支援。2026 年 5 月 20 日之後，您將無法再存取 Amazon Connect 主控台上的語音 ID、管理員網站或聯絡控制面板上的語音 ID Amazon Connect 功能，或存取語音 ID 資源。如需詳細資訊，請造訪 [Amazon Connect Voice ID 終止支援](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html)。
Amazon Connect Voice ID 包含用於管理註冊到語音 ID 網域的發言者和在網域中註冊的詐騙者的 API。所有發言者 API (`ListSpeakers` 除外) 都接受 `CustomerSpeakerId` 或 `GeneratedSpeakerId`。
## 發言者管理 API
1. [DescribeSpeaker](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DescribeSpeaker.html)：描述[網域中發言者的狀態 (已註冊、OPTED\$1OUT、已註冊)](voiceid-domain.md#voiceid-speaker-enrollments)，並將 `GeneratedSpeakerId` 對應到 `CustomerSpeakerId`，反之亦然。
1. [DescribeSpeaker](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteSpeaker.html)：從語音 ID 網域中完全刪除來電者/發言者的所有記錄。所有聲紋和註冊狀態都會立即刪除，並在 24 小時內刪除相關的錄音。
1. [ListSpeakers](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_ListSpeakers.html)：列出其項目存在於語音 ID 網域中的所有發言者。此 API 傳回發言者的 `CustomerSpeakerId` 和 `GeneratedSpeakerId`。它傳回與 API 請求指定的頁面大小的分頁輸出。
1. [OptOutSpeaker](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_OptOutSpeaker.html)：從語音識別網域中選擇退出來電者。此 API 不需要發言者出現在語音 ID 中。不存在的發言者可以使用此 API 選擇退出，語音 ID 會保留選擇退出狀態，並拒絕此發言者的未來註冊請求。選擇退出也會移除此來電者的聲紋和任何儲存的錄音。
## 監視清單管理 API
1. [CreateWatchlist](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_CreateWatchlist.html)：建立監視清單，詐騙者可以成為其中的一部分。
1. [DeleteWatchlist](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteWatchlist.html)：從語音 ID 網域中刪除自訂詐騙者監視清單。若要刪除監視清單，該清單必須為空白。也就是說，它不得有任何與之關聯的詐騙者。您可以使用 [DeleteFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteFraudster.html) 或 [DisassociateFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DisassociateFraudster.html) API 以利從監視清單中刪除所有詐騙者。
您無法從語音 ID 網域刪除預設監視清單。
1. [DescribeWatchlist](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DescribeWatchlist.html)：確定它是預設的詐騙者監視清單還是您建立的自訂監視清單，並獲取監視清單詳細資訊。
1. [ListWatchlists](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_ListWatchlists.html)：列出語音 ID 網域中的所有監視清單。
1. [UpdateWatchlist](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_UpdateWatchlist.html)：更新自訂詐騙者監視清單的名稱和描述。您無法修改預設監視清單的詳細資料，因為它是由語音 ID 管理。
## 詐騙者管理 API
1. [AssociateFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_AssociateFraudster.html)：將詐騙者與同網域中的監視清單建立關聯。您可以將詐騙者與網域中的多個監視清單建立關聯。
1. [DeleteFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DeleteFraudster.html)：從語音 ID 網域刪除詐騙者。刪除詐騙者會將詐騙者從其所屬的所有監視清單中刪除。它還會在 24 小時內刪除所有聲紋和相關的錄音。
1. [DescribeFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DescribeFraudster.html)：描述詐騙者在語音 ID 網域中的狀態。
1. [DisassociateFraudster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_DisassociateFraudster.html)：取消詐騙者與指定監視清單的關聯。請注意，詐騙者始終必須與至少一個詐騙者監視清單相關聯；如果您嘗試將詐騙者與其唯一監視清單取消關聯，則會發生例外狀況。
要完全刪除詐騙者，請使用 `DeleteFraudster`。
1. [ListFraudsters](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_ListFraudsters.html)：列出網域或特定監視清單中的所有詐騙者。此 API 還會傳回詐騙者所屬的監視清單。它傳回與 API 請求指定的頁面大小的分頁輸出。
# 使用來自先前通話的音訊資料，在 Amazon Connect Voice ID 中進行批次註冊
**注意**
支援結束通知：2026 年 5 月 20 日， AWS 將結束對 Amazon Connect Voice ID 的支援。2026 年 5 月 20 日之後，您將無法再存取 Amazon Connect 主控台上的語音 ID、管理員網站或聯絡控制面板上的語音 ID Amazon Connect 功能，或存取語音 ID 資源。如需詳細資訊，請造訪 [Amazon Connect Voice ID 終止支援](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html)。
通過批次註冊已同意使用生物識別技術的客戶，您可以快速開始使用生物識別技術。您可以使用 S3 儲存貯體中儲存的錄音，以及提供發言者識別碼和錄音連結的 JSON 輸入檔案，您可以調用[語音 ID 批次](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_StartSpeakerEnrollmentJob.html) API。
若要以程式設計方式註冊客戶，請將下列資料傳遞至 API：
1. 用來指定與錄音相關聯之網域的網域 ID。
1. 輸出檔案的位置。
1. 包含發言者清單的輸入文件。請參閱 [Amazon Connect Voice ID 中發言者註冊任務的輸入和輸出檔案結構描述](speaker-enrollment-job-schema.md)。
對於每個發言者，檔案必須包括：
+ 使用 8 kHz 取樣率和 PCM-16 編碼的 .wav 檔案中的通話錄音連結。
+ 客戶對應的 `CustomerSpeakerId`。
+ 錄音中來電者的頻道。如果音訊有多個頻道，您只能選擇一個頻道。
1. 寫入輸出時要使用的 KMS 金鑰。
1. 語音 ID 可以承擔的角色。它必須能夠存取儲存音訊檔案的 S3 儲存貯體。此角色必須具有用於加密檔案的任何 KMS 金鑰的存取權。它還必須能夠寫入指定的輸出位置，並使用要求寫入輸出的 KMS 密鑰。具體而言，它必須具備下列許可：
+ `s3:GetObject` 在輸入儲存貯體上。
+ `s3:PutObject` 在輸出儲存貯體上。
+ `kms:Decrypt` 在用於輸入儲存貯體預設加密的 KMS 密鑰上。
+ `kms:Decrypt` 和 `kms:GenerateDataKey` 在輸入中提供的 KMS 密鑰，該密鑰將用於將輸出檔案寫入輸出儲存貯體。
撥打電話並提供 `dataAccessRole` 時，您必須擁有 `iam:PassRole` 許可。若要啟用 `dataAccessRole` 的混淆代理人保護，請參閱 [Amazon Connect Voice ID 跨服務混淆代理預防](cross-service-confused-deputy-prevention.md#voiceid-cross-service)。
1. 或者，如果您想要跳過註冊音訊上的詐騙和語音欺騙檢查，則可以選擇使用詐騙檢查跳過標記。
1. 選擇性地指定您要執行詐騙檢查的詐騙者監視清單。如果未指定監視清單，語音 ID 會使用網域的預設詐騙者監視清單。
1. 如果您想提高或降低風險，可以選擇詐騙閾值。
1. 選擇性地使用標記來重新註冊已註冊的客戶。如果您想要重新整理錄音，這很有用，因為預設值是忽略先前註冊的客戶。
批次註冊會傳回每個項目的 `CustomerSpeakerId`、`GeneratedSpeakerId` 和相關聯的狀態。它將此資料儲存在您在 API 中指定的輸出路徑的 JSON 檔案中。
**注意**
您需要為註冊發言者付費。如需詳細資訊，請參閱 [Amazon Connect Voice ID 定價](https://aws.amazon.com/connect/pricing/)。
# Amazon Connect Voice ID 中發言者註冊任務的輸入和輸出檔案結構描述
**注意**
支援結束通知：2026 年 5 月 20 日， AWS 將結束對 Amazon Connect Voice ID 的支援。2026 年 5 月 20 日之後，您將無法再存取 Amazon Connect 主控台上的語音 ID、管理員網站或聯絡控制面板上的語音 ID Amazon Connect 功能，或存取語音 ID 資源。如需詳細資訊，請造訪 [Amazon Connect Voice ID 終止支援](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html)。
## 輸入檔案結構描述
以下是發言者註冊工作的輸入清單檔案的結構描述：
```
{
"Version": "string",
"SpeakerEnrollmentRequests": [
{
"RequestId": "string",
"SpeakerId": "string",
"AudioSpecifications": [
{
"S3Uri": "string",
"ChannelId": number
}
]
}
]
}
```
**注意**
結構中的所有欄位都是**必要的**。
以下是輸入結構描述的每個屬性的說明。
+ `Version`：輸入結構描述文件的版本。目前，此項目應為 `1.0`。
+ `SpeakerEnrollmentRequests`：作為工作的一部分要履行的發言者註冊請求清單。
+ `RequestId`：此發言者註冊要求的識別碼。在輸入檔案內，此項目必須是唯一的。它用於映射和識別輸出檔案中的項目。
+ `SpeakerId`：需要註冊之發言者的用戶端提供的識別碼。您必須在此欄位中傳遞 `CustomerSpeakerId`。目前不支援 `GeneratedSpeakerId`。
+ `AudioSpecifications`：語音 ID 可用於註冊此發言者的音訊檔案清單。語音 ID 會將這些音訊檔案一起使用，以收集註冊所需的語音數量。目前，註冊請求允許的音訊檔案數量上限為 **10** 個。每個檔案可以是高達 20 MB 的 .wav 檔案，包含具有 8 kHz 採樣率和 PCM-16 編碼的音訊。
+ `S3URI`：音訊檔案的 Amazon S3 位置，需要使用 .wav 格式註冊發言者。
+ `ChannelId`：用於將發言者註冊為多頻道音訊檔案的音訊頻道。語音 ID 支援最多兩個頻道的音訊檔案，因此此值限制為 **0** 或 **1**。
## 輸入檔案結構描述
以下是為發言者註冊工作所產生的輸出檔案的結構描述：
```
{
"Version": "string",
"Errors": [
{
"RequestId": "string",
"ErrorCode": number,
"ErrorMessage": "string"
}
],
"SuccessfulEnrollments": [
{
"RequestId": "string",
"GeneratedSpeakerId": "string",
"CustomerSpeakerId": "string",
"EnrollmentStatus": "DUPLICATE_SKIPPED" | "NEW_ENROLLMENT" | "ENROLLMENT_OVERWRITE"
}
]
}
```
以下是輸出結構描述的每個屬性的說明。
+ `Version`：輸出結構描述文件的版本。目前，此項目應為 `1.0`。
+ `Errors`：在註冊期間某個時間點失敗的發言者註冊請求的錯誤清單。
+
+ `RequestId`：與此請求相關聯的請求識別碼。這與此請求的輸入檔案中指定的 `RequestId` 相同。
+ `ErrorCode`：代表錯誤類型的 HTTP 錯誤代碼。以下描述一些範例錯誤案例。
**注意**
這並非一份詳盡無遺的清單。
+ 400 (錯誤的請求異常)：
+ 輸入的 JSON 檔案格式錯誤，無法剖析。
+ 提供的音訊檔案沒有足夠的語音進行註冊。
+ 指定發言者的詐騙驗證檢查失敗。
+ 402 (ServiceQuotaLimitExceededException)：
+ 超過發言者限制。
+ 409 (衝突例外狀況)：
+ 動作衝突：您無法為選擇退出的發言者申請註冊。
+ 500 (內部錯誤)：
+ 內部伺服器錯誤 (服務端出現意外錯誤)。
+ `ErrorMessage`：說明註冊失敗原因的訊息。
+ `SuccessfulEnrollments`：成功的註冊請求清單。
+ `RequestId`：與此請求相關聯的請求識別碼。這與此請求的輸入檔案中指定的 `RequestId` 相同。
+ `CustomerSpeakerId`：已註冊發言者的用戶端提供的識別碼。
+ `GeneratedSpeakerId`：已註冊發言者的服務產生識別碼。
+ `EnrollmentStatus`：發言者註冊成功的狀態
+ `DUPLICATE_SKIPPED`：發言者已經註冊，並且已跳過註冊。
+ `NEW_ENROLLMENT`：發言者是新加入系統的。
+ `ENROLLMENT_OVERWRITE`：發言者已經註冊，但已使用新音訊重新註冊/覆寫。
# 在 Amazon Connect Voice ID 中建立和編輯詐騙者監視清單
**注意**
支援結束通知：2026 年 5 月 20 日， AWS 將結束對 Amazon Connect Voice ID 的支援。2026 年 5 月 20 日之後，您將無法再存取 Amazon Connect 主控台上的語音 ID、管理員網站或聯絡控制面板上的語音 ID Amazon Connect 功能，或存取語音 ID 資源。如需詳細資訊，請造訪 [Amazon Connect Voice ID 終止支援](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html)。
使用以下 API 建立詐騙者監視清單並註冊詐騙者：
1. 使用[CreateWatchlist](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_CreateWatchlist.html) API 來建立新的詐騙者監視清單。
1. 使用[StartFraudsterRegistrationJob](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_StartFraudsterRegistrationJob.html) API 進行批次註冊。您可以將新的詐騙者註冊到新的監視清單，或將他們註冊到與 Voice ID 網域相關聯的預設監視清單。
當您註冊新的詐騙者時，語音 ID 會將聲紋與您語音 ID 網域中的所有註冊詐騙者進行比較，以判斷該聲紋是否與現有詐騙者重複。
要將詐騙者新增到指定的詐騙者監視清單中，請將以下資料傳遞給 API：
1. 用來指定與錄音相關聯之網域的網域 ID。
1. 包含詐騙者清單的輸入檔案。請參閱 [Amazon Connect Voice ID 中詐騙者註冊任務的輸入和輸出檔案結構描述](fraudster-registration-schema.md)。
1. 輸出檔案的位置。
1. 寫入輸出時要使用的 KMS 金鑰。
1. 語音 ID 可以承擔的角色。它必須能夠存取儲存音訊檔案的 S3 儲存貯體。此角色必須具有用於加密檔案的任何 KMS 金鑰的存取權。它還必須能夠寫入指定的輸出位置，並使用要求寫入輸出的 KMS 密鑰。具體而言，它必須具備下列許可：
+ `s3:GetObject` 在輸入儲存貯體上。
+ `s3:PutObject` 在輸出儲存貯體上。
+ `kms:Decrypt` 在用於輸入儲存貯體預設加密的 KMS 密鑰上。
+ `kms:Decrypt` 和 `kms:GenerateDataKey` 在輸入中提供的 KMS 密鑰，該密鑰將用於將輸出檔案寫入輸出儲存貯體。
撥打電話並提供 `dataAccessRole` 時，您必須擁有 `iam:PassRole` 許可。若要啟用 `dataAccessRole` 的混淆代理人保護，請參閱 [Amazon Connect Voice ID 跨服務混淆代理預防](cross-service-confused-deputy-prevention.md#voiceid-cross-service)。
1. 將詐騙者註冊到的 watchlistId。如果未指定 watchlistId，則詐騙者會註冊到該語音 ID 網域的預設監視清單。
1. 建立詐騙者重複狀態的閾值。
1. 忽略詐騙者重複項的標記。
語音 ID 通過成功新增來更新詐騙者清單，並將與項目相關聯的 `GeneratedFraudsterID` 傳回到相同的 S3 位置。如果識別出重複項目，Voice ID 會傳回項目的「重複」狀態，並提供最接近的相符項目 `GeneratedFraudsterId`。成功註冊詐騙者後，您可以使用 [AssociateFradster](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_AssociateFraudster.html) API 將 `GeneratedFraudsterID` 識別的詐騙者關聯到新的監視清單中。
在建立詐騙者名單前，語音 ID 無法偵測監察清單中的詐騙者。
如需詐騙者清單的配額，請參閱 [Amazon Connect 服務配額](amazon-connect-service-limits.md)。
**注意**
您需要支付新增至詐騙者清單的費用。如需詳細資訊，請參閱 [Amazon Connect Voice ID 定價](https://aws.amazon.com/connect/voice-id/)。
# Amazon Connect Voice ID 中詐騙者註冊任務的輸入和輸出檔案結構描述
**注意**
支援結束通知：2026 年 5 月 20 日， AWS 將結束對 Amazon Connect Voice ID 的支援。2026 年 5 月 20 日之後，您將無法再存取 Amazon Connect 主控台上的語音 ID、管理員網站或聯絡控制面板上的語音 ID Amazon Connect 功能，或存取語音 ID 資源。如需詳細資訊，請造訪 [Amazon Connect Voice ID 終止支援](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html)。
## 輸入檔案結構描述
以下是詐騙者註冊工作的輸入清單檔案的結構描述：
```
{
"Version": "string",
"FraudsterRegistrationRequests": [
{
"RequestId": "string",
"AudioSpecifications": [
{
"S3Uri": "string",
"ChannelId": number
}
]
}
]
}
```
**注意**
結構描述中的所有欄位都是**必要的**。
以下是輸入結構描述的每個屬性的說明。
+ `Version`：結構描述文件的版本。目前，此項目應為 `1.0`。
+ `FraudsterRegistrationRequests`：作為工作一部分要履行的詐騙者註冊請求清單。
+ `RequestId`：此詐騙者註冊請求的識別碼。在輸入檔案內，此項目必須是唯一的。它用於映射和識別輸出檔案中的項目。
+ `AudioSpecifications`：語音 ID 可用於註冊此詐騙者的音訊檔案清單。語音 ID 會將這些音訊檔案一起使用，以收集註冊所需的語音數量。目前，註冊請求允許的音訊檔案數量上限為 **10** 個。每個檔案可以是高達 20 MB 的 .wav 檔案，包含具有 8 kHz 採樣率和 PCM-16 編碼的音訊。
+ `S3URI`：需要用於註冊詐騙者的 .wav 格式音訊檔案的 Amazon S3 位置。
+ `ChannelId`：用於在多頻道音訊檔案中註冊詐騙者的音訊頻道。語音 ID 支援最多兩個頻道的音訊檔案，因此此值限制為 **0** 或 **1**。
## 輸入檔案結構描述
以下是詐騙者註冊工作的輸出清單檔案的結構描述：
```
{
"Version": "string",
"Errors": [
{
"RequestId": "string",
"ErrorCode": number,
"ErrorMessage": "string"
}
],
"SuccessfulRegistrations": [
{
"RequestId": "string",
"GeneratedFraudsterId": "string",
"RegistrationStatus": "DUPLICATE_SKIPPED" | "NEW_REGISTRATION",
"FraudsterSimilarityScore": number
}
]
}
```
以下是輸出結構描述的每個屬性的說明。
+ `Version`：輸出結構描述文件的版本。目前，此項目應為 `1.0`。
+ `Errors`：在註冊過程中某個時候失敗的詐騙者註冊請求的錯誤清單。
+
+ `RequestId`：與此要求相關聯的請求識別碼。這與此請求的輸入檔案中指定的 `RequestId` 相同。
+ `ErrorCode`：代表錯誤類型的 HTTP 錯誤代碼。以下描述一些範例錯誤案例。
**注意**
這並非一份詳盡無遺的清單。
+ 400 (錯誤的請求異常)：
+ 輸入的 JSON 檔案格式錯誤，無法剖析。
+ 提供的音訊檔案沒有足夠的語音進行註冊。
+ 402 (ServiceQuotaLimitExceededException)：
+ 超過詐騙者限制。
+ 500 (內部錯誤)：
+ 內部伺服器錯誤 (服務端出現意外錯誤)。
+ `ErrorMessage`：描述詐騙者註冊失敗原因的訊息。
+ `SuccessfulRegistrations`：成功的註冊請求清單。
+ `RequestId`：與此請求相關聯的請求識別碼。這與此請求的輸入檔案中指定的 `RequestId` 相同。
+ `RegistrationStatus`：成功的詐騙者註冊狀態。
+ `DUPLICATE_SKIPPED`：詐騙者被識別為重複，並跳過註冊。
+ `NEW_FRAUDSTER`：詐騙者是新加入該系統的。
+ `GeneratedFraudsterId`：已註冊詐騙者的服務產生識別碼。如果 `RegistrationStatus` 是 `DUPLICATE_SKIPPED`，則這是網域中已經與給定詐騙者最接近匹配的詐騙者的識別碼。
+ `FraudsterSimilarityScore`：當詐騙者註冊由於重複而跳過詐騙者註冊時填充的可選欄位。這代表了給定的詐騙者與網域中已經存在的最接近相符詐騙者的相似性。
# 整合語音 ID 的 Amazon Connect Streams API
**注意**
支援結束通知：2026 年 5 月 20 日， AWS 將結束對 Amazon Connect Voice ID 的支援。2026 年 5 月 20 日之後，您將無法再存取 Amazon Connect 主控台上的語音 ID、管理員網站或聯絡控制面板上的語音 ID Amazon Connect 功能，或存取語音 ID 資源。如需詳細資訊，請造訪 [Amazon Connect Voice ID 終止支援](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html)。
使用下列 [Amazon Connect Streams](https://github.com/aws/amazon-connect-streams) API，將語音 ID 整合到您現有的客服人員 Web 應用程式中。
+ `enrollSpeakerInVoiceId`：在取得客戶註冊同意後，將其註冊至語音 ID。
+ `evaluateSpeakerWithVoiceId`：檢查客戶的語音身分驗證狀態，並偵測詐騙者。
+ `optOutVoiceIdSpeaker`：從語音 ID 中選擇退出客戶。
+ `getVoiceIdSpeakerStatus`：描述客戶的註冊狀態。
+ `getVoiceIdSpeakerId`：為客戶獲取 `SpeakerID`。
+ `updateVoiceIdSpeakerId`：為客戶更新 `SpeakerID`。
如果您不想建立自訂客服人員介面，也可以使用聯絡控制面板 (CCP) 中的語音 ID 小工具。有關 CCP 中語音 ID 的更多詳細資訊，請參閱 [在聯絡人控制台 (CCP) 的 Voice ID 中註冊來電者](use-voiceid.md)。
# Amazon Connect Voice ID 事件結構描述
**注意**
支援結束通知：2026 年 5 月 20 日， AWS 將結束對 Amazon Connect Voice ID 的支援。2026 年 5 月 20 日之後，您將無法再存取 Amazon Connect 主控台上的語音 ID、管理員網站或聯絡控制面板上的語音 ID Amazon Connect 功能，或存取語音 ID 資源。如需詳細資訊，請造訪 [Amazon Connect Voice ID 終止支援](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html)。
語音 ID 會為每筆交易產生事件：註冊、驗證或偵測監視清單中的詐騙者。事件會以 JSON 格式傳送至預設 EventBridge 事件匯流排。
您可以使用 EventBridge 監控語音 ID 事件，建立語音 ID 驗證結果和偵測監視清單中詐騙者的分析管道。使用本主題中提供的結構描述，您可以設定 EventBridge 規則來接聽和篩選相關的語音 ID 事件，然後透過 Amazon Data Firehose 處理這些事件，以存放在您選擇的資料倉儲中。
例如，您可能想要近即時的語音 ID 分析追蹤功能。要做到這一點，您可以提取所有的 `Evaluate-Session` 事件，並得到 `authenticationResult` 和 `fraudDetectionResult`。
[盡可能](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html)發出事件。
## 事件中常見的欄位
+ `version` - 事件資料的版本。
+ `id` - EventBridge 所產生之事件的唯一識別碼
+ `detail-type` - 事件詳細資訊的識別碼。
+ `source` - 事件的來源。一律為 `aws.voiceid`。
+ `account` AWS - 帳戶 ID。
+ `timestamp` - 事件發布的日期和時間 (UTC)。
+ `region` - 進行 API 呼叫 AWS 的區域。
+ `resources` - API 呼叫使用的資源。
+ `detail` - 有關活動的詳細資訊：
+ `detail.sourceId` - 由語音 ID 產生的唯一 ID，可用於刪除重複資料。
+ `detail.action` - 類似於正在調用的 API。
+ `detail.status` - 指定動作的狀態：成功或失敗。
+ `detail.errorInfo` - 在語音 ID 中出現指定的操作錯誤時填入。
以下是所發出的結構描述事件。
## 啟動工作階段動作
在串流開始 (設定後)，串流結束和故障時發出事件。
```
{...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
}
}
}
```
## 更新工作階段動作
內部工作階段更新成功或失敗時發出事件。
```
{...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
}
}
}
```
## 評估工作階段動作
工作階段評估成功或失敗時發出事件。原因可以是 KNOWN\$1FRAUDSTER 或 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
}
}
}
```
## 發言者動作
發表有關成功或失敗選擇退出發言者，刪除發言者或註冊發言者的事件。
```
{...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
}
}
}
```
## 詐騙者行動
成功註冊或刪除詐騙者時發出事件。
當詐騙者與監視清單關聯或取消關聯時，不會傳送事件。
```
{...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
提交註冊請求時發出此事件。當實際註冊成功或失敗時，會發出 `Speaker` 事件。
```
{...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
當批次註冊請求提交、成功或失敗時發出此事件。會針對每個個別發言者發出 `Speaker` 事件，以指出對應的註冊成功或失敗。
```
{...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
當批次註冊請求提交、成功或失敗時發出此事件。每個詐騙者都會發出 `Fraudster` 事件，以指示對應的註冊成功還是失敗。
```
{...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
}
}
}
```