Amazon Connect Voice ID で不正行為者ウォッチリストを作成および編集する
以下の API を使用して、不正行為者ウォッチリストを作成し、不正行為者を登録します。
-
CreateWatchlist API を使用して、新しい不正行為者ウォッチリストを作成します。
-
一括登録には、StartFraudsterRegistrationJob API を使用してください。新しい不正行為者を新しいウォッチリストに登録するか、Voice ID ドメインに関連付けられているデフォルトのウォッチリストに登録できます。
新しい不正行為者を登録すると、Voice ID は声紋を Voice ID ドメイン内のすべての登録不正行為者と照合して、既存の不正行為者と重複していないかどうかを判断します。
不正行為者を指定した不正行為者ウォッチリストに追加するには、次のデータを API に渡します。
-
録音を関連付けるドメインを指定するドメイン ID。
-
不正行為者のリストを含む入力ファイル。「Amazon Connect Voice ID の不正行為者登録ジョブの入出力ファイルスキーマ」を参照してください。
-
出力ファイルの場所。
-
出力の書き込みに使用する KMS キー。
-
Voice ID が引き受けることができるロール。これには、オーディオファイルが保存されている S3 バケットへのアクセス権が必要です。このロールは、ファイルの暗号化に使用される KMS キーへのアクセス権を持っている必要があります。また、指定された出力場所に書き込み、出力を書き込むために要求された KMS キーを使用できる必要があります。具体的には、次のアクセス許可が必要です。
-
入力バケットに
s3:GetObject。 -
出力バケットに
s3:PutObject。 -
入力バケットのデフォルトの暗号化に使用される KMS キーに
kms:Decrypt。 -
出力バケットへの出力ファイルの書き込みに使用される入力で指定された KMS キーに
kms:Decryptおよびkms:GenerateDataKey。
通話をして
dataAccessRoleを付与するにはiam:PassRoleアクセス許可が必要です。dataAccessRoleの「混乱した代理」問題対策を有効にするには、Amazon Connect Voice ID サービス間の混乱した代理問題の防止を参照してください。 -
-
不正行為者を登録する watchlistId。watchlistId が指定されなかった場合、不正行為者はその Voice ID ドメインのデフォルトのウォッチリストに登録されます。
-
不正行為者の重複ステータスを確定するためのしきい値。
-
不正行為者の重複を無視するフラグ。
Voice ID は正常に追加して不正行為者のリストを更新し、エントリに関連付けられた GeneratedFraudsterID を同じ S3 ロケーションに戻します。重複が確認された場合、Voice ID はエントリの「重複」ステータスを返し、最も類似している GeneratedFraudsterId を示します。不正行為者が正常に登録されたら、AssociateFraudster API を使用して、GeneratedFraudsterID で識別されたこの不正行為者を新しいウォッチリストに関連付けることができます。
Voice ID では、不正行為者リストが作成されていないとウォッチリスト内の不正行為者の検出を実行できません。
不正行為者リストのクォータについては、「Amazon Connect サービスクォータ」を参照してください。
注記
不正行為者リストに追加すると料金が発生します。詳細については、「Amazon Connect の料金
