이전 통화의 오디오 데이터를 사용한 배치 등록

이미 생체인식에 동의한 고객을 배치 등록하면 생체인식을 바로 사용할 수 있습니다. S3 버킷에 저장된 오디오 녹음과 화자 식별자를 제공하는 JSON 입력 파일, 오디오 녹음에 대한 링크를 사용하여 Voice ID 배치 API를 호출할 수 있습니다.

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

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

2. 출력 파일의 위치

3. 화자 목록이 포함된 입력 파일. 화자 등록 작업을 위한 입력 및 출력 파일 스키마를 참조하세요.

   각 화자의 파일에는 다음이 포함되어야 합니다.

   • 8kHz 샘플 속도와 PCM-16 인코딩을 사용하는 .wav 파일의 통화 오디오 녹음 링크

   • 고객의 CustomerSpeakerId

   • 오디오 녹음에 있는 발신자의 채널. 오디오에 여러 채널이 있는 경우 하나만 선택할 수 있습니다.

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

5. 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 서비스 간 혼동되는 대리자 방지 섹션을 참조하세요.

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

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

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

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

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

참고

화자 등록 시 요금이 부과됩니다. 자세한 내용은 Amazon Connect Voice ID 요금을 참조하세요.