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

# Voice ID 및 Connect Customer Integration Association APIs
<a name="voiceid-integration-association-apis"></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) 섹션을 참조하세요.

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

1. [CreateIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateIntegrationAssociation.html): Connect Customer 인스턴스에서 Voice ID를 활성화하려면 `CreateIntegrationAssociation` 요청을 사용하여 Voice ID 도메인을 Connect Customer 인스턴스와 연결해야 합니다. 하나의 Voice ID 도메인만 Connect Customer 인스턴스에 연결할 수 있습니다. 인스턴스가 이미 도메인과 연결되어 있는 경우 API는 다음 오류를 반환합니다.

   `DuplicateResourceException`(409) - 요청에서 중복 리소스를 만들려고 합니다.
**참고**  
Connect Customer 인스턴스에 대해 Voice ID를 활성화하면(Connect Customer 콘솔 또는 [CreateIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateIntegrationAssociation.html) API 사용) Connect Customer는 계정에 관리형 Amazon EventBridge 규칙을 생성합니다. 이 규칙은 Voice ID 이벤트를 수집하여 Voice ID와 관련된 연락 레코드를 생성하는 데 사용됩니다. 또한 Connect Customer는 Connect Customer의 서비스 연결 역할에 [Voice ID 권한을](connect-slr.md) 추가합니다.

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

1.  [ListIntegrationAssociations](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListIntegrationAssociations.html): Connect Customer 인스턴스와이 리전의 계정에 대한 Voice ID 도메인 간의 모든 연결을 나열하려면 `ListIntegrationAssociations` API를 호출하면 됩니다.