Amazon Connect Voice ID 스피커, 감시 목록, 사기범 관리 API - Amazon Connect
화자 관리 API감시 목록 관리 API사기범 관리 API

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

Amazon Connect Voice ID 스피커, 감시 목록, 사기범 관리 API

Amazon Connect Voice ID에는 Voice ID 도메인에 등록된 화자 및 도메인에 등록된 사기범을 관리하기 위한 API가 포함되어 있습니다. 모든 화자 API(ListSpeakers 제외)는 CustomerSpeakerId 또는 GeneratedSpeakerId를 허용합니다.

화자 관리 API

  1. DescribeSpeaker: 도메인에서의 화자 상태(ENROLLED, OPTED_OUT, EXPIRED)를 설명하고 GeneratedSpeakerId를 CustomerSpeakerId에 매핑하거나 역방향으로 매핑합니다.

  2. DeleteSpeaker: Voice ID 도메인에서 발신자/화자에 대한 모든 레코드를 완전히 제거합니다. 모든 보이스프린트 및 등록 상태가 즉시 삭제되고 연결된 오디오 녹음은 24시간 이내에 제거됩니다.

  3. ListSpeakers: Voice ID 도메인에 항목이 있는 모든 화자를 나열합니다. 이 API는 화자에 대해 CustomerSpeakerId 및 GeneratedSpeakerId를 모두 반환합니다. API 요청에서 지정한 페이지 크기와 함께 페이지가 매겨진 출력을 반환합니다.

  4. OptOutSpeaker: Voice ID 도메인에서 발신자를 옵트아웃합니다. 이 API의 경우 Voice ID에 화자가 있어야 할 필요는 없습니다. 이 API를 사용하여 존재하지 않는 화자를 옵트아웃할 수 있으며, Voice ID는 옵트아웃 상태를 유지하고 이 화자에 대한 향후 등록 요청을 거부합니다. 옵트아웃하면 해당 발신자의 보이스프린트와 저장된 오디오 녹음도 제거됩니다.

감시 목록 관리 API

  1. CreateWatchlist: 사기범이 속할 수 있는 감시 목록을 만듭니다.

  2. DeleteWatchlist: Voice ID 도메인에서 사용자 지정 사기범 감시 목록을 제거합니다. 감시 목록을 삭제하려면 감시 목록이 비어 있어야 합니다. 즉, 연결된 사기범이 없어야 합니다. DeleteFraudster 또는 DisassociateFraudster API를 사용하여 감시 목록에서 모든 사기범을 제거할 수 있습니다.

    Voice ID 도메인에서 기본 감시 목록은 삭제할 수 없습니다.

  3. DescribeWatchlist: 기본 사기범 감시 목록인지, 아니면 직접 만든 사용자 지정 감시 목록인지 확인하고 감시 목록 세부 정보를 확보합니다.

  4. ListWatchlists: Voice ID 도메인의 모든 감시 목록을 나열합니다.

  5. UpdateWatchlist: 사용자 지정 사기범 감시 목록의 이름과 설명을 업데이트합니다. 기본 감시 목록은 Voice ID가 관리하므로 세부 정보를 수정할 수 없습니다.

사기범 관리 API

  1. AssociateFraudster: 사기범을 같은 도메인의 감시 목록에 연결합니다. 사기범을 한 도메인의 여러 감시 목록에 연결할 수 있습니다.

  2. DeleteFraudster: Voice ID 도메인에서 사기범을 삭제합니다. 사기범을 삭제하면 사기범이 속해 있는 모든 감시 목록에서 해당 사기범이 제거됩니다. 또한 모든 보이스프린트와 관련 오디오 녹음이 24시간 이내에 삭제됩니다.

  3. DescribeFraudster: Voice ID 도메인에서의 사기범 상태를 설명합니다.

  4. DisassociateFraudster: 지정된 감시 목록에서 사기범을 연결 해제합니다. 참고로, 사기범은 항상 적어도 하나 이상의 사기범 감시 목록에 연결되어 있어야 합니다. 사기범을 유일한 감시 목록에서 연결 해제하려고 하면 예외가 발생합니다.

    사기범을 완전히 제거하려면 DeleteFraudster를 사용하세요.

  5. ListFraudsters: 도메인 또는 특정 감시 목록에 있는 모든 사기범을 나열합니다. 이 API는 사기범이 속해 있는 감시 목록도 반환합니다. API 요청에서 지정한 페이지 크기와 함께 페이지가 매겨진 출력을 반환합니다.