View a markdown version of this page

Voice ID 및 Connect Customer Integration Association APIs - Amazon Connect Customer

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

Voice ID 및 Connect Customer Integration Association APIs

참고

지원 종료 알림: 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 지원 종료 섹션을 참조하세요.

다음 APIs를 사용하여 Connect Customer 인스턴스와의 연결을 관리할 수 있습니다. AWS 콘솔에서도 이러한 작업을 수행할 수 있습니다.

  1. CreateIntegrationAssociation: Connect Customer 인스턴스에서 Voice ID를 활성화하려면 CreateIntegrationAssociation 요청을 사용하여 Voice ID 도메인을 Connect Customer 인스턴스와 연결해야 합니다. 하나의 Voice ID 도메인만 Connect Customer 인스턴스에 연결할 수 있습니다. 인스턴스가 이미 도메인과 연결되어 있는 경우 API는 다음 오류를 반환합니다.

    DuplicateResourceException(409) - 요청에서 중복 리소스를 만들려고 합니다.

    참고

    Connect Customer 인스턴스에 대해 Voice ID를 활성화하면(Connect Customer 콘솔 또는 CreateIntegrationAssociation API 사용) Connect Customer는 계정에 관리형 Amazon EventBridge 규칙을 생성합니다. 이 규칙은 Voice ID 이벤트를 수집하여 Voice ID와 관련된 연락 레코드를 생성하는 데 사용됩니다. 또한 Connect Customer는 Connect Customer의 서비스 연결 역할에 Voice ID 권한을 추가합니다.

  2. DeleteIntegrationAssociation: Connect Customer 인스턴스와 Voice ID 도메인 간의 기존 연결을 삭제하려면 Connect Customer InstanceID 및에서 IntegrationAssociationID 반환한와 함께 DeleteIntegrationAssociation APIs를 호출해야 합니다CreateIntegrationAssociation. 다른 Voice ID 도메인을이 Connect Customer 인스턴스에 연결하려는 경우 필수 단계입니다. Connect Customer 인스턴스의 Voice ID에 예측할 수 없는 동작이 발생할 수 있으므로 프로덕션 설정에서 연결을 삭제하지 않는 것이 좋습니다.

  3. ListIntegrationAssociations: Connect Customer 인스턴스와이 리전의 계정에 대한 Voice ID 도메인 간의 모든 연결을 나열하려면 ListIntegrationAssociations API를 호출하면 됩니다.