

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 이전 통화의 오디오 데이터를 사용하여 Amazon Connect Voice ID에 일괄 등록
<a name="voiceid-batch-enrollment"></a>

**참고**  
지원 종료 알림: 2026년 5월 20일에 Amazon Connect Voice ID에 대한 지원이 AWS 종료됩니다. 2026년 5월 20일 이후에는 Amazon Connect 콘솔에서 Voice ID에 액세스하거나, Connect Customer 관리자 웹 사이트 또는 연락처 제어판에서 Voice ID 기능에 액세스하거나, Voice ID 리소스에 액세스할 수 없습니다. 자세한 내용은 [Amazon Connect Voice ID 지원 종료](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html) 섹션을 참조하세요.

이미 생체인식에 동의한 고객을 배치 등록하면 생체인식을 바로 사용할 수 있습니다. S3 버킷에 저장된 오디오 녹음과 화자 식별자를 제공하는 JSON 입력 파일, 오디오 녹음에 대한 링크를 사용하여 [Voice ID 배치 API](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_StartSpeakerEnrollmentJob.html)를 호출할 수 있습니다.

프로그래밍 방식으로 고객을 등록하려면 다음 데이터를 API에 전달하세요.

1. 녹음을 연결할 도메인을 지정하는 데 사용할 도메인 ID

1. 출력 파일의 위치

1. 화자 목록이 포함된 입력 파일. [Amazon Connect Voice ID의 스피커 등록 작업에 대한 입력 및 출력 파일 스키마](speaker-enrollment-job-schema.md)을(를) 참조하세요.

    각 화자의 파일에는 다음이 포함되어야 합니다.
   + 8kHz 샘플 속도와 PCM-16 인코딩을 사용하는 .wav 파일의 통화 오디오 녹음 링크
   + 고객의 `CustomerSpeakerId`
   + 오디오 녹음에 있는 발신자의 채널. 오디오에 여러 채널이 있는 경우 하나만 선택할 수 있습니다.

1. 출력을 작성할 때 사용할 KMS 키

1. 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 서비스 간 혼동되는 대리자 방지](cross-service-confused-deputy-prevention.md#voiceid-cross-service) 섹션을 참조하세요.

1. 등록 오디오에서 사기 및 음성 스푸핑 검사를 건너뛰려는 경우 선택적으로 사기 검사 건너뛰기 플래그를 사용할 수 있습니다.

1. 원하는 경우 사기 검사를 수행하려는 사기범 감시 목록을 지정할 수 있습니다. 감시 목록이 지정되지 않은 경우 Voice ID는 도메인의 기본 사기범 감시 목록을 사용합니다.

1. 위험을 높이거나 낮추려는 경우 선택적으로 사기 임계값을 설정할 수 있습니다.

1. 원하는 경우 등록한 고객을 재등록하는 플래그를 설정할 수 있습니다. 이전에 등록한 고객을 무시하는 것이 기본값이므로 오디오 녹음을 새로 고치려는 경우에 유용합니다.

배치 등록은 각 항목의 `CustomerSpeakerId`, `GeneratedSpeakerId` 및 관련 상태를 반환합니다. API에서 지정한 출력 경로의 JSON 파일에 이 데이터가 저장됩니다.

**참고**  
화자 등록 시 요금이 부과됩니다. 자세한 내용은 [Amazon Connect Voice ID 요금](https://aws.amazon.com/connect/pricing/)을 참조하세요.