기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # Amazon Connect Global Resiliency 설정 **참고** **신규 사용자인가요?** [Amazon Connect Global Resiliency 워크숍](https://catalog.workshops.aws/amazon-connect-global-resiliency/en-US)을 확인하세요. 이 온라인 과정은 AWS CLI를 통해 새 API를 사용하여 전화번호와 에이전트 장애 조치를 온보딩하고 테스트하는 프로세스를 안내합니다. 글로벌 복원력은 미국 동부(버지니아 북부), 미국 서부(오레곤), 아시아 태평양(오사카), 아시아 태평양(도쿄), 유럽(프랑크푸르트), 유럽(런던) AWS 리전에서 생성된 Amazon Connect 인스턴스에만 사용할 수 있습니다. 소스가 미국 서부(오리건) 또는 그 반대인 경우에만 미국 동부(버지니아 북부) 리전에서 복제본을 생성할 수 있습니다. 소스가 유럽(런던) 또는 그 반대인 경우에만 유럽(프랑크푸르트) 리전에서 복제본을 생성할 수 있습니다. 소스가 아시아 태평양(도쿄)인 경우에만 아시아 태평양(오사카) 리전에서 복제본을 생성할 수 있습니다. 이 기능에 액세스하려면 Amazon Connect 솔루션 아키텍트 또는 기술 계정 관리자에게 문의하세요. **중요** Amazon Connect Global Resiliency(ACGR)는 Amazon Connect에서 다중 리전 복원력을 지원하는 유일한 AWS솔루션입니다. AWS 는 글로벌 복원력을 달성하기 위한 타사 또는 사용자 지정 구축 대안을 지원하지 않습니다. 지원되지 않는 솔루션을 배포하면 보조 인스턴스에서 서비스 제한이 거부되거나 줄어들 수 있으며, 가동 중지가 지원되지 않는 배포로 인한 경우 SLA 적용 범위에 영향을 미칠 수 있습니다. Amazon Connect Global Resiliency를 통해 전 세계 어디에서나 최고의 안정성, 성능, 효율성으로 고객 서비스를 제공할 수 있습니다. 분산 텔레포니 기능을 통해 고객 센터는 국제 규제 요건을 충족할 수 있습니다. Amazon Connect Global Resiliency는 다음과 같은 용도로 사용할 수 있는 API 집합을 제공합니다. + 연결된 Amazon Connect 인스턴스를 다른에 프로비저닝합니다 AWS 리전. + 두 리전에서 모두 액세스할 수 있는 글로벌 전화번호를 프로비저닝하고 관리합니다. + 텔레포니 트래픽과 에이전트를 10% 단위로 Amazon Connect 인스턴스 및 리전 전체에 분산하거나 한 번에 모두 이동시킬 수 있습니다. 이를 통해 인바운드 음성 연락처와 에이전트를 리전 간에 서서히 전환하거나 동시에 모두 전환할 수 있습니다. 예를 들어 인바운드 음성 고객 응대 및 에이전트를 미국 동부(버지니아 북부)에 100%, 미국 서부(오레곤)에 0%로 배포하거나 각 리전에 50%씩 배포할 수 있습니다. + 리전 간 예약 용량에 액세스할 수 있습니다. **Topics** + [Global Resiliency 요구 사항](connect-global-resiliency-requirements.md) + [시작하기](get-started-connect-global-resiliency.md) + [트래픽 분산 그룹 관리](manage-traffic-distribution-groups.md) + [리전 간 전화번호 관리](manage-phone-numbers-across-regions.md) + [리전 간 채팅 관리](manage-chat-across-regions.md) + [ACGR 리전 간 지표, 보고서 및 검색](metrics-reports-and-search-across-acgr-regions.md) # Amazon Connect Global Resiliency 요구 사항 Amazon Connect Global Resiliency가 적합한 배포라고 결정한 경우 온보딩 전에 다음 사전 요구 사항을 준수해야 합니다. + 다중 리전이 되도록 활성화하려는 모든 전화번호를 Amazon Connect 에 [포팅](about-porting.md)합니다. + AWS Amazon Connect Global Resiliency에 온보딩하려면 엔터프라이즈 지원 또는 AWS 통합 운영이 필요합니다. AWS 지원 플랜에 대한 자세한 내용은 [AWS 지원 플랜을 참조하세요](https://aws.amazon.com/premiumsupport/plans/). + Amazon Connect Global Resiliency를 사용할 수 있는 리전에 기존 프로덕션 [SAML 2.0 지원](connect-identity-management.md) Amazon Connect 인스턴스가 있어야 합니다. 확인하려면 [리전별 Global Resiliency 가용성](regions.md#gr_region) 섹션을 참조하세요. + 프로덕션 트래픽을 온보딩하기 전에 테스트 환경에서 Amazon Connect Global Resiliency 서비스를 온보딩하고 테스트하는 것이 좋습니다. + 복제본 인스턴스의 모든 서비스 할당량이 소스 인스턴스의 서비스 할당량과 일치하도록 요청: AWS 관리 콘솔 > 지원에서 [서비스 할당량 증가 사례 생성](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html). + AWS 리전 간 Lambda 함수의 이름이 동일한지 확인합니다. + 흐름을 업데이트하여 하드코딩된 모든 리전을 `$.AwsRegion` 또는 `$['AwsRegion']` 파라미터로 대체합니다. **참고** [AWS Lambda 함수](invoke-lambda-function-block.md) 블록에서는 flowArn에서 `$.AwsRegion`이 허용되지 않습니다. `$.AwsRegion`을 사용하려면 [연락처 속성 설정](set-contact-attributes.md) 블록을 사용하여 흐름을 설정해야 합니다. 예를 들면 다음과 같습니다. `flowIdKey` : `arn:aws:connect:$.AwsRegion:123456789012:instance/12345678-1234-1234-1234-123456789012/contact-flow/12345678-1234-1234-1234-123456789012` 그런 다음 나중에 [AWS Lambda 함수](invoke-lambda-function-block.md) 블록에서 해당 속성 키를 `${flowIdKey}`로 사용합니다. `$.AwsRegion`은 Lambda ARN 및 Lex ARN에서만 지원됩니다. + Amazon Lex 봇의 경우 다음 중 하나를 수행할 수 있습니다. + Amazon Lex Global Resiliency를 사용하여 AWS 리전 간에 봇을 복제하고 봇 ID를 유지합니다. + 흐름이 실행 중인 AWS 리전에 따라 흐름을 분기로 변경합니다. 다음 예시에서 볼 수 있듯이 흐름 런타임에 이러한 파라미터는 흐름이 실행되는 리전으로 대체됩니다. ![\[연락 속성 확인 블록의 속성 페이지.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/acgr-requirements.png) # Amazon Connect Global Resiliency 시작 **중요** Amazon Connect 2021년 3월 31일 이전에 생성된 인스턴스에는 다음 형식의 도메인이 할당되었습니다. ``` https://your-instance-alias.awsapps.com/connect/ ``` 도메인에서 이전 형식을 사용하는 경우 Amazon Connect Global Resiliency 기능을 올바르게 구성할 수 없습니다. 이 기능을 활성화하려면 최신 형식으로 [도메인을 업데이트](update-your-connect-domain.md)해야 합니다. ``` https://your-instance-alias.my.connect.aws/ ``` **참고** **신규 사용자인가요?** [Amazon Connect Global Resiliency 워크숍](https://catalog.workshops.aws/amazon-connect-global-resiliency/en-US)을 확인하세요. 이 온라인 과정은 AWS CLI를 통해 새 API를 사용하여 전화번호와 에이전트 장애 조치를 온보딩하고 테스트하는 프로세스를 안내합니다. 글로벌 복원력은 미국 동부(버지니아 북부), 미국 서부(오레곤), 아시아 태평양(오사카), 아시아 태평양(도쿄), 유럽(프랑크푸르트), 유럽(런던) AWS 리전에서 생성된 Amazon Connect 인스턴스에만 사용할 수 있습니다. 소스가 미국 서부(오리건) 또는 그 반대인 경우에만 미국 동부(버지니아 북부) 리전에서 복제본을 생성할 수 있습니다. 소스가 유럽(런던) 또는 그 반대인 경우에만 유럽(프랑크푸르트) 리전에서 복제본을 생성할 수 있습니다. 소스가 아시아 태평양(도쿄)인 경우에만 아시아 태평양(오사카) 리전에서 복제본을 생성할 수 있습니다. 이 기능에 액세스하려면 Amazon Connect 솔루션 아키텍트 또는 기술 계정 관리자에게 문의하세요. 다른에서 기존 Amazon Connect 인스턴스의 복제본을 생성하고 트래픽 분산 그룹을 AWS 리전생성하여 Amazon Connect Global Resiliency를 시작합니다. *트래픽 분산 그룹*은 서로 다른 AWS 리전에 있는 Amazon Connect 인스턴스를 연결할 수 있는 Amazon Connect 리소스입니다. 전화번호는 트래픽 분산 그룹에 첨부할 수 있습니다. 이 번호에 대한 트래픽은 트래픽 분산 그룹의 인스턴스 간에 분산될 수 있습니다. ## Amazon Connect Global Resiliency를 설정하는 방법 1. [기존 Amazon Connect 인스턴스의 복제본을 생성합니다](create-replica-connect-instance.md). [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) API를 사용합니다. 1. [트래픽 분산 그룹을 생성합니다](setup-traffic-distribution-groups.md). 1. [CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html) API를 사용합니다. 1. [DescribeTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html) API를 사용하여 트래픽 배포 그룹이 성공적으로 생성되었는지 확인합니다(`Status`는 `ACTIVE`여야 함). 1. [트래픽 분산 그룹에 전화번호를 요청합니다](claim-phone-numbers-traffic-distribution-groups.md). 트래픽 분산 그룹이 성공적으로 생성된 후(`Status`가 `ACTIVE` 상태), [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) API를 사용하여 해당 그룹에 전화번호를 요청할 수 있습니다. **참고** 이러한 전화번호의 기본 트래픽 분산은 100% \$1 0%로 설정되어 있습니다. 즉, 인바운드 텔레포니 트래픽의 100%가 복제본을 만드는 데 사용된 소스 Amazon Connect 인스턴스로 이동합니다. 또한 전화번호가 인스턴스에 클레임된 후에는 AWS 리전전반의 여러 인스턴스에 전화번호를 할당할 수 있습니다. 이렇게 하려면 [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) API를 사용하여 번호를 트래픽 분산 그룹에 할당합니다. 1. [트래픽 분산을 업데이트합니다](update-telephony-traffic-distribution.md). [UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html) API를 사용하여 연결된 인스턴스 간에 트래픽을 10% 단위로 분산합니다. # 기존 Amazon Connect 인스턴스의 복제본 생성 **참고** **신규 사용자인가요?** [Amazon Connect Global Resiliency 워크숍](https://catalog.workshops.aws/amazon-connect-global-resiliency/en-US)을 확인하세요. 이 온라인 과정은 AWS CLI를 통해 새 API를 사용하여 전화번호와 에이전트 장애 조치를 온보딩하고 테스트하는 프로세스를 안내합니다. 글로벌 복원력은 미국 동부(버지니아 북부), 미국 서부(오레곤), 아시아 태평양(오사카), 아시아 태평양(도쿄), 유럽(프랑크푸르트), 유럽(런던) AWS 리전에서 생성된 Amazon Connect 인스턴스에만 사용할 수 있습니다. 소스가 미국 서부(오리건) 또는 그 반대인 경우에만 미국 동부(버지니아 북부) 리전에서 복제본을 생성할 수 있습니다. 소스가 유럽(런던) 또는 그 반대인 경우에만 유럽(프랑크푸르트) 리전에서 복제본을 생성할 수 있습니다. 소스가 아시아 태평양(도쿄)인 경우에만 아시아 태평양(오사카) 리전에서 복제본을 생성할 수 있습니다. 이 기능에 액세스하려면 Amazon Connect 솔루션 아키텍트 또는 기술 계정 관리자에게 문의하세요. [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) API를 호출하여 다른에서 Amazon Connect 인스턴스의 복제본 AWS 리전 을 생성하고 Amazon Connect 리소스에 대한 구성 정보를 복사합니다 AWS 리전. **Topics** + [중요한 참고 사항](#important-info-automated-config) + [복제 인스턴스의 특징](#replica-characteristics) + [복제본 인스턴스에 미러링되는 리소스 종류](#mirrored-resources) + [복제본 인스턴스가 생성된 후 수행할 작업](#configure-replica-instance) + [AWS Support에 문의해야 하는 경우](#replica-cs) + [ReplicateInstance 호출이 실패하는 이유](#why-replicateinstance-fails) + [인스턴스의 소스 리전 찾기](#how-to-find-source-region-of-instances) ## 중요한 참고 사항 + [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) 실행 전: + 인스턴스를 만드는 데 필요한 최소한의 IAM 권한이 있는지 확인하세요. [사용자 지정 IAM 정책을 사용하여 Amazon Connect 콘솔에 대한 액세스를 관리하는 데 필요한 권한](security-iam-amazon-connect-permissions.md)을(를) 참조하세요. + 흐름을 업데이트하여 하드코딩된 모든 리전을 `$.AwsRegion` 또는 `$['AwsRegion']` 파라미터로 대체합니다. 흐름 런타임에 이러한 파라미터는 흐름이 실행되는 리전으로 대체됩니다. + AWS 리전 전반에서 Lambda 함수의 이름이 동일한지 확인하세요. + Amazon Lex 봇의 경우 다음 중 하나를 수행할 수 있습니다. + Amazon Lex Global Resiliency를 사용하여 AWS 리전 간에 봇을 복제하고 봇 ID를 유지합니다. + 흐름이 실행 중인 AWS 리전에 따라 흐름을 분기로 변경합니다. 다음 예시에서 볼 수 있듯이 흐름 런타임에 이러한 파라미터는 흐름이 실행되는 리전으로 대체됩니다. ![\[연락 속성 확인 블록의 속성 페이지.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/acgr-requirements.png) + 복제본 인스턴스 AWS 관리형 키 에서를 허용하려면 AWS 콘솔을 사용하여 복제본 인스턴스를 생성하려는 리전에서 임시 Amazon Connect 인스턴스를 생성합니다. 그러면 Amazon Connect의 기본값 AWS 관리형 키 이 생성됩니다. + [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)는 초기 복제 프로세스의 일부로 AWS 리전 전체에 Amazon Connect 구성을 복사합니다. 이 첫 번째 단계가 완료되면 나중에 [미러링된 리소스](#mirrored-resources)에 대한 모든 변경 사항이 지속적으로 동기화됩니다. 이는 소스에서 복제본으로, 복제본에서 소스로 양방향으로 발생합니다. + 소스 인스턴스에서 아직 번호 그룹에 연결되지 않은 모든 전화번호는 기본 트래픽 분산 그룹에 자동으로 추가됩니다. 이 단계를 통해 소스 리전과 복제본 리전 모두에서 전화번호를 사용할 수 있으며, 전화번호 흐름 연결을 AWS 리전전체에서 미러링할 수 있습니다. + 아시아 태평양(도쿄)의 인스턴스의 경우 Amazon Connect Global Resiliency(ACGR)에 대해 명시적으로 활성화된 전화번호만 아시아 태평양(오사카)에 대한 완전한 복제 동작을 지원합니다. 아시아 태평양(오사카)을 통해 라우팅할 때 인바운드 통화의 전송 시간은 최대 20초가 될 수 있습니다. + 복제 인스턴스에 로그인하기 위한 긴급 액세스는 기본 라우팅 프로필과 대기열이 리전 전체에 미러링된 후에만 사용할 수 있습니다. + 구성이 전파되면 AWS CloudTrail 로그의 진행 상황을 볼 AWS 리전수 있습니다. 또는 Amazon Connect 관리자 웹 사이트에서 **사용자 관리**, **기록 변경 사항 보기**로 이동하여 사용자 변경 사항에 대한 감사 추적을 볼 수 있습니다. 감사 추적은 다른 구성에서도 사용할 수 있습니다. + CloudTrail 로그에 구성 미러링에 영향을 주지 않는 다음과 같은 오류가 표시될 수 있습니다. + Http 409(갈등) 오류: 이러한 오류는 동일한 고객 센터 리소스에 대해 수행된 여러 구성 업데이트를 빠르게 연속적으로 처리할 때 미러링 충돌로 인해 발생합니다. 이러한 오류는 로그에 나타날 수 있지만 고객 센터 리소스의 실제 미러링에는 영향을 주지 않습니다. + 소스 인스턴스와 복제 인스턴스의 리소스 이름이 같지만 리소스 ID가 다른 경우 리소스 이름 충돌이 발생합니다. 예를 들어 복제 인스턴스의 리소스가 복제 프로세스 외부에서 수동으로 생성된 경우 이런 일이 발생할 수 있습니다. 리소스 이름이 충돌하는 경우, [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)는 리소스를 리전 간에 동기화하지 않습니다. 대신 `ResourceConflictException` 오류가 발생합니다. 이름 충돌을 해결한 후(예: 복제 인스턴스에서 리소스를 삭제) `ReplicateInstance`를 다시 실행하여 리소스를 동기화할 수 있습니다. + `ReplicateInstance`를 실행한 후에는 [AssociateTrafficDistributionGroupUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateTrafficDistributionGroupUser.html) API를 사용하여 에이전트를 기본 트래픽 배포 그룹 또는 사용자 지정 트래픽 배포 그룹에 연결해야 합니다. + [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)를 실행해도 Lambda 함수, Amazon Lex 봇 또는 사용 중인 다른 타사 /통합은 동기화되지 않습니다. ## 복제 인스턴스의 특징 + 복제 Amazon Connect 인스턴스는 기존 Amazon Connect 인스턴스와 동일한 AWS 계정에서 생성됩니다. + [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)는 기본 트래픽 분산 그룹이 아직 존재하지 않는 경우 이를 생성합니다. 이 기본 트래픽 분산 그룹에는 세 가지 유형의 트래픽 분산이 있습니다. + 로그인 + 에이전트 + 전화 통신 [CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html) API를 사용하여 더 많은 트래픽 분산 그룹을 만들 수 있지만 이러한 추가 트래픽 분산 그룹은 기본 트래픽 분산 그룹이 아니므로 에이전트 및 텔레포니 배포만 지원합니다. + 기본 트래픽 분산 그룹은 `SignInConfig` 분배를 변경할 수 있는 유일한 트래픽 분산 그룹입니다. [TrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_TrafficDistributionGroup.html) 데이터 유형의 `IsDefault` 파라미터를 확인하세요. + 에이전트가 Amazon Connect 인스턴스에 쉽게 로그인할 수 있도록 백엔드 로그인 서버를 선택하는 데 `SignInConfig`를 사용합니다. 예를 들어 수정된 `UpdateTrafficDistribution`와 기본값이 아닌 `SignInConfig`을 사용하여 `TrafficDistributionGroup`을 호출하면 `InvalidRequestException`이 반환됩니다. + 복제 인스턴스는 복제된 Amazon Connect 인스턴스와 동일한 인스턴스 ID를 가집니다. ## 복제본 인스턴스에 미러링되는 리소스 종류 [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)는 AWS 리전전반에서 Amazon Connect 리소스를 미러링합니다. **중요** 이러한 리소스에 대한 서비스 할당량은 리소스가 리전 간에 미러링되기 *전에* AWS 리전 간에 자동으로 일치됩니다. 복제 인스턴스에서 다른 할당량을 늘리려면 요청을 제출하세요. + 에이전트 숙련도 + 흐름 + 흐름 모듈 + Users + 라우팅 프로필 + Queues + 보안 프로필 + 작업 시간 + 빠른 연결 + 사전 정의된 속성 + 프롬프트(S3에 저장된 프롬프트 제외) + 사용자 계층 구조(그룹 및 수준) + 에이전트 상태 + 사전 정의된 속성 + 저장된 보고서 + 뷰 + 데이터 테이블 + 워크스페이스 + 흐름 모듈 버전 + 흐름 모듈 별칭 + 사용자 지정 지표 + 테스트 사례 + 알림 **특정 리소스에 대한 중요 참고 사항** **저장된 보고서**: 저장된 보고서가 복제되는 동안 저장된 보고서와 연결된 일정은 복제*되지 않습니다*. **보기**: *게시*된 상태의 보기만 복제됩니다. 초안 상태의 뷰는 복제*되지 않습니다*. **데이터 테이블**: 리터럴 ARN 참조가 포함된 데이터 테이블 값은 복제 시 리전 코드를 로컬 리전으로 자동 조정합니다. 표현식을 사용하여 구성된 ARNs 리전 코드를 자동으로 조정하지 않을 수 있습니다. 또한 [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)는 다음과 같은 연결을 AWS 리전전체에 복제합니다. + 흐름에 연결할 전화번호 + 라우팅 프로필 대기열 + 사용자에서 보안 프로필, 라우팅 프로필 및 사용자 계층으로 연결 + 라우팅 프로필 + 빠른 연결을 위한 대기열 + 운영 시간 대기열 + 대기열 흐름 **참고** 초기 복제 후 거의 실시간으로 복제된 인스턴스 간에 구성 변경 사항이 양방향으로 복제됩니다. 이 오류가 발생하면 Amazon Connect Global Resiliency는 30분 이내에 업데이트를 동기화하려고 시도합니다. ## 복제본 인스턴스가 생성된 후 수행할 작업 복제본 Amazon Connect 인스턴스가 생성된 후에는 이를 다음과 같이 구성해야 합니다. 1. 여러 리전 간에 프런트엔드 및 백엔드 통합(예: SSO, Lambda, Lex)을 위한 중복성을 보장합니다. 1. 연결된 인스턴스 전체에서 일치하는 수동 업데이트를 수행합니다. 1. [AssociateTrafficDistributionGroupUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateTrafficDistributionGroupUser.html) API를 사용하여 에이전트를 기본 트래픽 배포 그룹에 연결합니다. 에이전트를 트래픽 배포 그룹에 연결하려면 먼저 에이전트가 소스 및 복제본 인스턴스 모두에 있어야 합니다. 사용자를 소스 인스턴스에 새로 추가하고 아직 복제본에 없는 경우에는 트래픽 분산 그룹에 연결할 수 없습니다. ## AWS Support에 문의해야 하는 경우 다음 활동에 대한 도움이 필요하면 AWS Support에 문의하십시오. + Amazon Connect 관리자 웹 사이트의 CloudTrail 로그 및 감사 추적에서 사용할 수 있는 것 이상의 미러링 상태를 이해합니다. ## ReplicateInstance 호출이 실패하는 이유 다음과 같은 경우 `InvalidRequestException`과 함께 [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) API 호출이 실패합니다. 1. 복제본을 생성하는 리전은 기존 인스턴스와 동일한 리전입니다. 1. 다른 [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) API 호출의 일부로 인스턴스가 이미 복제되었습니다. 1. 인스턴스에 별칭이 없습니다. 1. 인스턴스가 `ACTIVE` 상태에 있지 않습니다. 1. 인스턴스에 SAML이 활성화되지 않았습니다. 1. 리소스 이름 충돌이 있습니다. ## Amazon Connect 인스턴스의 소스 리전을 찾는 방법 Amazon Connect 인스턴스의 소스 리전을 잊어버린 경우 다음 단계를 수행하여 해당 리전을 찾습니다. 1. `InstanceId`로 [ListTrafficDistributionGroups](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListTrafficDistributionGroups.html) API를 호출합니다. 1. 응답 목록의 모든 트래픽 분산 그룹에 대해 반환된 `InstanceARN`에는 소스 리전이 포함됩니다. 예를 들어 다음 ARN에서 *source-region*은 Amazon Connect 인스턴스의 리전입니다. `arn:aws:connect:source-region:account-id:traffic-distribution-group/ traffic-distribution-group-id` # Amazon Connect 인스턴스에 대한 트래픽 배포 그룹 생성 [CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html) API를 사용하여 기존 Amazon Connect 인스턴스에 대한 트래픽 분산 그룹을 만들 수 있습니다. *트래픽 분산 그룹*은 서로 다른 AWS 리전에 있는 Amazon Connect 인스턴스를 연결할 수 있는 Amazon Connect 리소스입니다. 전화번호는 트래픽 분산 그룹에 첨부할 수 있습니다. 이 번호에 대한 트래픽은 트래픽 분산 그룹의 인스턴스 간에 분산될 수 있습니다. ## 중요한 참고 사항 + 트래픽 분산 그룹을 생성할 때는 소스 AWS 리전에서 생성해야 합니다 **소스 리전은 기존 Amazon Connect 인스턴스를 설정한 리전입니다. + 전화번호를 트래픽 분산 그룹에 연결하는 경우: + 소스 리전에서 청구된 전화번호만 연결할 수 있습니다. + 전화번호는 트래픽 분산 그룹이 생성된 리전과 동일한 리전에 있어야 합니다. + 트래픽 분산 그룹에 번호를 요청하거나 트래픽 분산 그룹의 `Status`가 `ACTIVE`인 경우에만 트래픽 분산 그룹에 대한 트래픽 분포를 가져오거나 업데이트할 수 있습니다. 트래픽 분산 그룹이 성공적으로 생성되었는지 확인하려면 [DescribeTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html) API를 사용하세요(`Status`는 `ACTIVE`여야 함). + 복제 Amazon Connect 인스턴스를 만들면 해당 인스턴스에 대한 기본 트래픽 분산 그룹이 만들어집니다. 기본 트래픽 분산 그룹은 `SignInConfig` 분배를 변경할 수 있는 유일한 트래픽 분산 그룹입니다. [TrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_TrafficDistributionGroup.html) 데이터 유형의 `IsDefault` 파라미터를 확인하세요. 에이전트가 Amazon Connect 인스턴스에 로그인하는 데 사용할 백엔드 로그인 서버를 선택하려면 `SignInConfig`를 사용합니다. 예를 들어 수정된 `UpdateTrafficDistribution`와 기본값이 아닌 `SignInConfig`을 사용하여 `TrafficDistributionGroup`을 호출하면 `InvalidRequestException`이 반환됩니다. ## 트래픽 분산 그룹 상태 다음은 트래픽 분산 그룹 상태에 대한 설명입니다. + `CREATION_IN_PROGRESS`: 트래픽 분산 그룹 생성이 진행 중입니다. + `ACTIVE`: 트래픽 분산 그룹이 생성되었습니다. + `CREATION_FAILED`: 트래픽 분산 그룹 생성에 실패했습니다. + `PENDING_DELETION`: 트래픽 분산 그룹 삭제가 진행 중입니다. + `DELETION_FAILED`: 트래픽 분산 그룹 삭제에 실패했습니다. + `UPDATE_IN_PROGRESS`: 트래픽 분산 그룹 업데이트가 진행 중입니다. ## 트래픽 분산 그룹 생성 호출이 실패하는 이유 다음과 같은 경우 [CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html) API 호출이 `InvalidRequestException`과 함께 실패합니다 + 연결된 인스턴스에 대한 트래픽 분산 그룹을 생성하기 전에 [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) API가 호출되지 않았습니다. + [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) API가 호출된 동일한 리전에서 [CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html) API가 호출되지 않았습니다. 이 API가 호출된 리전은 복제본을 만드는 데 사용된 인스턴스의 리전과 일치해야 합니다. # Amazon Connect를 사용하여 트래픽 분산 그룹에 전화번호 클레임 **참고** **신규 사용자인가요?** [Amazon Connect Global Resiliency 워크숍](https://catalog.workshops.aws/amazon-connect-global-resiliency/en-US)을 확인하세요. 이 온라인 과정은 AWS CLI를 통해 새 API를 사용하여 전화번호와 에이전트 장애 조치를 온보딩하고 테스트하는 프로세스를 안내합니다. 글로벌 복원력은 미국 동부(버지니아 북부), 미국 서부(오레곤), 아시아 태평양(오사카), 아시아 태평양(도쿄), 유럽(프랑크푸르트), 유럽(런던) AWS 리전에서 생성된 Amazon Connect 인스턴스에만 사용할 수 있습니다. 소스가 미국 서부(오리건) 또는 그 반대인 경우에만 미국 동부(버지니아 북부) 리전에서 복제본을 생성할 수 있습니다. 소스가 유럽(런던) 또는 그 반대인 경우에만 유럽(프랑크푸르트) 리전에서 복제본을 생성할 수 있습니다. 소스가 아시아 태평양(도쿄)인 경우에만 아시아 태평양(오사카) 리전에서 복제본을 생성할 수 있습니다. 이 기능에 액세스하려면 Amazon Connect 솔루션 아키텍트 또는 기술 계정 관리자에게 문의하세요. 트래픽 분산 그룹이 성공적으로 생성된 후(`Status`가 `ACTIVE` 상태) [SearchAvailablePhoneNumbers](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html)를 사용하여 사용 가능한 전화번호를 검색하고 [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)를 사용하여 전화번호를 청구할 수 있습니다. 트래픽 분산 그룹에 전화번호를 요청하기 전에 [DescribeTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html) API를 사용하여 트래픽 분산 그룹의 상태가 `ACTIVE` 상태인지 확인하는 것이 좋습니다. `ACTIVE` 상태가 아닌 트래픽 분산 그룹에 전화번호를 할당하면 `ResourceNotFoundException`이 발생합니다. [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) API를 호출할 때 **TargetArn** 파라미터에 트래픽 분산 그룹 ARN을 제공하면 트래픽 분산 그룹에 전화번호를 청구할 수 있습니다. 또한 [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) API를 사용하여 이전에 인스턴스에 요청된 전화번호를 트래픽 분산 그룹에 할당할 수도 있습니다. **참고** **설명** 필드를 업데이트하려면 Amazon Connect 콘솔을 사용해야 합니다. ## 워크플로 예제 다음은 전화번호를 요청하여 여러 AWS 리전에서 사용하는 워크플로의 예시입니다. 1. 인스턴스의 복제본을 만듭니다. 1. [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) API를 호출합니다. 1. 이러한 인스턴스를 서로 연결하는 트래픽 분산 그룹을 만듭니다. 1. [CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html) API를 호출합니다. 1. 트래픽 분산 그룹에 청구할 수 있는 사용 가능한 전화번호를 찾아보세요. 1. 트래픽 분산 그룹이 생성된 리전에서 [SearchAvailablePhoneNumbers](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html) API를 호출합니다. `TargetArn` 파라미터에 대한 트래픽 분산 그룹 ARN을 입력합니다. 1. 트래픽 분산 그룹이 생성된 리전에서 [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) API를 호출합니다. 1. `TargetArn` 파라미터에 대한 트래픽 분산 그룹 ARN을 입력합니다. 1. 3단계의 [SearchAvailablePhoneNumbers](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html) API 호출에서 반환한 E164 전화번호 값을 입력합니다. `PhoneNumberId`와 `PhoneNumberArn`이 반환됩니다. 이 값을 후속 조치 작업에 사용할 수 있습니다. 1. 전화번호 상태가 `CLAIMED`인지 확인합니다. 1. [DescribePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribePhoneNumber.html) API를 호출합니다. (트래픽 분산 그룹과 연결된 다른 리전에서도 DescribePhoneNumber를 호출할 수 있습니다. 동일한 전화번호 세부 정보를 반환합니다.) 전화번호는 상태가 `CLAIMED`된 후에만 후속 작업에서 사용할 수 있습니다. 가능한 상태에 대한 설명은 [전화번호 상태 정의](#claim-phone-number-status)를 참조하세요. 1. 트래픽 분산 그룹에 청구해야 하는 모든 전화번호에 대해 3\$15단계를 반복합니다. 1. 다음 단계를 수행하여 흐름을 전화번호에 연결합니다. 트래픽 분산 그룹이 운영되는 두 리전 모두에서 수행하세요. 이러한 단계를 통해 텔레포니 트래픽이 흐름으로 올바르게 라우팅되어 트래픽 분산 구성을 지원할 수 있습니다. 1. 트래픽 분산 그룹이 생성된 리전의 기존 Amazon Connect 인스턴스에서 다음 단계를 수행합니다. 1. [ListContactFlows](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListContactFlows.html) API를 호출합니다. 복제된 인스턴스에 해당하는`InstanceId`를 입력합니다. 1. 흐름 ARN 목록이 반환됩니다. 이 흐름 ARN을 사용하여 전화번호에 흐름을 연결하려면 [AssociatePhoneNumberContactFlow](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html) API를 호출하세요. 1. 다른 AWS 리전의 복제된 Amazon Connect 인스턴스에서 다음 단계를 수행합니다. 1. [ListContactFlows](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListContactFlows.html) API를 호출합니다. 복제된 인스턴스에 해당하는`InstanceId`를 입력합니다. 1. 흐름 ARN 목록이 반환됩니다. 이 흐름 ARN을 사용하여 전화번호에 흐름을 연결하려면 [AssociatePhoneNumberContactFlow](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html) API를 호출하세요. ## ClaimPhoneNumber 통화가 실패하는 이유 다음과 같은 경우 [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) API 호출이 `ResourceNotFoundException`과 함께 실패합니다: + 지정한 트래픽 분산 그룹이 존재하지 않거나, 트래픽 분산 그룹의 상태가 `ACTIVE` 상태가 아니거나, 트래픽 분산 그룹의 소유권이 없는 경우입니다. + 해당 전화번호는 요청에 사용할 수 없습니다. 경우에 따라 [SearchAvailablePhoneNumbers](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html)에서 찾은 전화번호를 다른 고객이 청구했을 수도 있습니다. 다음과 같은 경우 [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)는 `InvalidParameterException` 오류와 함께 실패합니다. + 호출 중인 엔드포인트가 트래픽 분산 그룹이 생성된 리전과 동일한 리전에 있지 않습니다. ## 전화번호 상태 정의 다음은 전화번호 상태에 대한 설명입니다. + `CLAIMED`는 [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) 또는 [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) 작업이 성공했음을 의미합니다. + `IN_PROGRESS`는 [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) 또는 [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) 작업이 아직 진행 중이며 아직 완료되지 않았음을 의미합니다. 나중에 [DescribePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribePhoneNumber.html)를 호출하여 이전 작업이 완료되었는지 확인할 수 있습니다. + `FAILED`는 이전 [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) 또는 [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) 작업에 실패했음을 의미합니다. 여기에는 실패 이유를 나타내는 메시지가 포함됩니다. 전화번호를 클레임하거나 업데이트하려는 `TargetArn` 값이 총 클레임된 건수 한도에 도달한 것이 실패의 일반적인 원인입니다. `ClaimPhoneNumber` API 호출을 통해 `FAILED` 상태를 받은 경우 하루 이내에 해당 전화번호의 클레임을 다시 시도해야 다른 고객이 해당 번호를 클레임할 수 있도록 인벤토리로 다시 해제되지 않습니다. # Amazon Connect에서 요청된 전화번호를 트래픽 분산 그룹에 할당 + 새 트래픽 분산 그룹을 만들었고 상태는 `ACTIVE`입니다. 상태를 확인하려면 [DescribeTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html) API를 사용하는 것이 좋습니다. + 이미 인스턴스나 다른 트래픽 배포 그룹에 전화번호를 클레임했습니다. 이제 [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) API를 사용하여 요청한 전화번호를 새 트래픽 분산 그룹에 할당할 수 있습니다. `TargetArn` 파라미터에 대한 트래픽 분산 그룹 ARN을 입력합니다. **참고** **설명** 필드를 업데이트하려면 Amazon Connect 콘솔을 사용해야 합니다. ## 워크플로 예제 다음은 트래픽 분산 그룹에 요청된 전화번호를 할당하는 워크플로 예시입니다. 1. [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) API를 호출하여 새 `TargetArn`에 전화번호를 할당합니다. `TargetArn`은 다른 Amazon Connect 인스턴스용이거나 전화번호가 처음 청구된 동일한 리전에서 생성된 트래픽 분산 그룹용일 수 있습니다. 1. 다음 단계를 수행하여 흐름을 전화번호에 연결합니다. 이러한 단계를 통해 텔레포니 트래픽이 흐름으로 올바르게 라우팅되어 트래픽 분산 구성을 지원할 수 있습니다. 1. 트래픽 분산 그룹이 생성된 리전의 기존 Amazon Connect 인스턴스에서 다음 단계를 수행합니다. 1. [ListContactFlows](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListContactFlows.html) API를 호출합니다. 복제된 인스턴스에 해당하는`InstanceId`를 입력합니다. 1. 흐름 ARN 목록이 반환됩니다. 이 흐름 ARN을 사용하여 전화번호에 흐름을 연결하려면 [AssociatePhoneNumberContactFlow](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html) API를 호출하세요. 흐름 연결에 대한 전화번호는 AWS 리전 간 Amazon Connect 인스턴스 간에 미러링됩니다. ## AssociatePhoneNumberContactFlow 호출이 실패하는 이유 번호가 트래픽 분산 그룹에 클레임되고 트래픽 분산 그룹이 생성된의 인스턴스를 사용하여 [AssociatePhoneNumberContactFlow](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html)를 호출 AWS 리전 하는 경우 `PhoneNumberId` URI 요청 파라미터에 전체 전화번호 ARN 또는 UUID 값을 사용할 수 있습니다. 그러나 트래픽 분산 그룹에 번호가 요청되고 트래픽 분산 그룹과 AWS 리전 연결된 복제본의 인스턴스를 사용하여이 API를 호출하는 경우 전체 전화번호 ARN을 제공해야 합니다. 이 시나리오에서 UUID를 제공하면 `ResourceNotFoundException`이 발생합니다. ## UpdatePhoneNumber 호출이 실패하는 이유 다음과 같은 경우 [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) API 호출이 `ResourceNotFoundException`과 함께 실패합니다. + 지정한 트래픽 분산 그룹이 존재하지 않거나, 트래픽 분산 그룹의 상태가 `ACTIVE` 상태가 아니거나, 트래픽 분산 그룹의 소유권이 없는 경우입니다. 다음과 같은 경우 `InvalidParameterException` 오류와 함께 [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)가 실패합니다 + 호출 중인 엔드포인트가 트래픽 분산 그룹이 생성된 리전과 동일한 리전에 있지 않습니다. ## 전화번호 상태 정의 다음은 전화번호 상태에 대한 설명입니다. + `CLAIMED`는 [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) 또는 [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) 작업이 성공했음을 의미합니다. + `IN_PROGRESS`는 [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) 또는 [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) 작업이 아직 진행 중이며 아직 완료되지 않았음을 의미합니다. 나중에 [DescribePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribePhoneNumber.html)를 호출하여 이전 작업이 완료되었는지 확인할 수 있습니다. + `FAILED`는 이전 [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) 또는 [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) 작업에 실패했음을 의미합니다. 여기에는 실패 이유를 나타내는 메시지가 포함됩니다. 전화번호를 클레임하거나 업데이트하려는 `TargetArn` 값이 총 클레임된 건수 한도에 도달한 것이 실패의 일반적인 원인입니다. # Amazon Connect 인스턴스 및 간의 텔레포니 트래픽 분산 업데이트 AWS 리전 [UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html) API를 사용하여 텔레포니 트래픽을 분배하고 리전 간에 [에이전트를 교대 배치](update-agents-across-regions.md)할 수 있습니다. **참고** 텔레포니 트래픽을 이동할 때 에이전트 및/또는 에이전트 로그인도 다른 리전에서 직접 호출을 처리할 수 있도록 전환합니다. 에이전트를 이동하지 않으면 음성 통화가 이동된 리전으로 이동하지만 전화를 받을 수 있는 에이전트가 없습니다. 트래픽 분산 그룹에 전화번호를 요청하고 나면, [UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html) API를 사용하여 지정된 트래픽 분산 그룹의 연결된 인스턴스 전체에 인바운드 음성 고객 응대를 10% 단위로 배포할 수 있습니다. 다음 요구 사항이 충족되지 않으면 [UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html) API 호출이 `InvalidRequestException`과 함께 실패합니다. + 텔레포니 트래픽 구성에 대한 분산을 제공해야 합니다. + 연결된 두 인스턴스 모두에 대한 트래픽 분포를 지정해야 하며 총 분포를 합산하여 100%가 되어야 합니다. + 트래픽 분산을 10% 단위로 지정해야 합니다. + 텔레포니 구성에 지정된 인스턴스 ARN은 연결된 인스턴스의 ARN과 일치해야 합니다. 소스 AWS 리전에서 `UpdateTrafficDistribution`을 호출할 때 트래픽 분산 그룹 ID 또는 Amazon 리소스 이름(ARN) 중 하나를 사용할 수 있습니다. 복제 리전에서 `UpdateTrafficDistribution`을 호출할 때는 트래픽 배포 그룹 ARN을 사용해야 합니다. # Amazon Connect Global Resiliency를 사용하여 에이전트의 경험을 설정하세요. Amazon Connect Global Resiliency를 사용하면 글로벌 로그인, 에이전트 배포 API 및 에이전트 Workspace 개선 사항을 통해 에이전트에게 글로벌 환경을 제공할 수 있습니다. 이 기능 집합을 사용하면 다음과 같이 할 수 있습니다. + 에이전트가 하루를 시작할 때 한 번만 로그인하면 현재 활성화된 리전의 고객 응대를 처리할 수 있으므로 언제든 어느 리전이 활성화되어 있는지 알 필요가 없습니다. + 트래픽 분산 그룹에 에이전트를 추가하고 AWS 리전 전체에 에이전트를 배포하세요. + 간단한 페이지 새로 고침을 통해 현재 활성 리전의 에이전트 Workspace로 새 인바운드 음성 고객 응대를 리디렉션합니다. **Topics** + [IdP를 Amazon Connect Global Resiliency SAML 로그인 엔드포인트와 통합](integrate-idp.md) + [에이전트를 여러 AWS 리전의 인스턴스에 연결](associate-agents-across-regions.md) + [리전 전반의 에이전트 분산 업데이트](update-agents-across-regions.md) + [에이전트 Workspace 설정](setup-agentworkspace-switchover.md) + [리전 간 에이전트 이동 시 발생하는 문제를 방지하기 위한 팁](possible-issues-shifting-regions.md) # ID 제공업체(idP)를 Amazon Connect Global Resiliency SAML 로그인 엔드포인트와 통합하세요. 에이전트가 한 번 로그인하고 두 AWS 리전 모두에 로그인하여 현재 활성 리전의 고객 응대를 처리하도록 하려면 글로벌 로그인 SAML 엔드포인트를 사용하도록 IAM 설정을 구성해야 합니다. ## 시작하기 전에 Amazon Connect Global Resiliency를 사용하려면 Amazon Connect 인스턴스에서 SAML을 활성화해야 합니다. IAM 페더레이션을 시작하는 방법에 대한 자세한 내용은 [SAML 2.0 페더레이션 사용자가 AWS Management Console에 액세스하도록 활성화](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_enable-console-saml.html)를 참조하세요. ## 중요한 참고 사항 + 에이전트 장애 조치는 글로벌 로그인 엔드포인트를 사용할 때만 지원됩니다. + 이 주제의 단계를 수행하려면 인스턴스 ID가 필요합니다. 이를 찾는 방법에 관한 지침은 [Amazon Connect 인스턴스 ID 또는 ARN 찾기](find-instance-arn.md) 섹션을 참조하세요. + 또한 Amazon Connect 인스턴스의 소스 리전도 알아야 합니다. 이를 찾는 방법에 관한 지침은 [Amazon Connect 인스턴스의 소스 리전을 찾는 방법](create-replica-connect-instance.md#how-to-find-source-region-of-instances) 섹션을 참조하세요. + iframe 내에 Connect 애플리케이션을 임베딩하는 경우 글로벌 로그인이 작동하려면 소스 및 복제본 인스턴스의 승인된 오리진 목록에 도메인이 있는지 확인해야 합니다. 인스턴스 수준에서 승인된 오리진을 구성하려면 [Amazon Connect에서 통합 애플리케이션에 허용 목록 사용](app-integration.md)의 단계를 따릅니다. + 에이전트는 소스 및 복제본 Amazon Connect 인스턴스 *모두*에 이미 생성되어 있어야 하며 ID 제공업체(IdP)의 역할 세션 이름과 동일한 사용자 이름을 가져야 합니다. 그렇지 않으면 `UserNotOnboardedException` 예외가 발생하여 인스턴스 간에 에이전트 중복 기능이 손실될 위험이 있습니다. + 에이전트가 로그인을 시도하기 전에 에이전트를 트래픽 배포 그룹에 연결해야 합니다. 그렇지 않으면 `ResourceNotFoundException`으로 상담원 로그인이 실패합니다. 트래픽 분산 그룹을 설정하고 에이전트를 이 그룹에 연결하는 방법에 대한 자세한 내용은 [여러 AWS 리전의 Amazon Connect 인스턴스에 에이전트 연결](associate-agents-across-regions.md) 섹션을 참조하세요. + 에이전트가 새 SAML 로그인 URL을 사용하여 Amazon Connect에 페더레이션하면, 트래픽 분산 그룹에서 `SignInConfig`가 어떻게 구성되었는지에 관계없이 Amazon Connect Global Resiliency는 항상 에이전트를 소스 및 복제본 리전/인스턴스 모두에 로그인을 시도합니다. CloudTrail 로그를 확인하여 이를 확인할 수 있습니다. + 기본 트래픽 `SignInConfig` 배포 그룹의 배포는 로그인을 용이하게 하는 데 AWS 리전 사용되는 만 결정합니다. `SignInConfig` 분산이 어떻게 구성되어 있는지에 관계없이 Amazon Connect는 항상 에이전트를 Amazon Connect 인스턴스의 두 리전 모두에 로그인하려고 시도합니다. + Amazon Connect 인스턴스를 복제하면 인스턴스에 대해 하나의 SAML 로그인 엔드포인트만 생성됩니다. 이 엔드포인트는 항상 URL AWS 리전 에 소스를 포함합니다. + Amazon Connect Global Resiliency에서 개인화된 SAML 로그인 URL을 사용할 때는 릴레이 상태를 구성할 필요가 없습니다. ## ID 제공자를 통합하는 방법 1. [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) API를 사용하여 Amazon Connect 인스턴스의 복제본을 만들면 Amazon Connect 인스턴스에 대해 개인화된 SAML 로그인 URL이 생성됩니다. URL은 다음 형식으로 생성됩니다. `https://instance-id.source-region.sign-in.connect.aws/saml` 1. *instance-id*는 인스턴스 그룹에 있는 인스턴스의 인스턴스 ID입니다. 인스턴스 ID는 소 및 복제 리전에서 동일합니다. 1. *source-region*은 [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) API가 호출된 소스 AWS 리전에 해당합니다. 1. 다음 신뢰 정책을 IAM 페더레이션 역할에 추가하세요. 다음 예시와 같이 전역 로그인 SAML 엔드포인트의 URL을 사용합니다. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement":[ { "Effect":"Allow", "Principal":{ "Federated":[ "arn:aws:iam::111122223333:saml-provider/MySAMLProvider" ] }, "Action":"sts:AssumeRoleWithSAML", "Condition":{ "StringLike":{ "SAML:aud":[ "https://instance-id.source-region.sign-in.connect.aws/saml*" ] } } } ] } ``` ------ **참고** `saml-provider-arn`은 IAM에서 생성된 ID 제공업체 리소스입니다. 1. IAM 페더레이션 역할에서 `InstanceId`에 대해 `connect:GetFederationToken`에 대한 액세스 권한을 부여합니다. 예제: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "GetFederationTokenAccess", "Effect": "Allow", "Action": "connect:GetFederationToken", "Resource": "*", "Condition": { "StringEquals": { "connect:InstanceId": "your-instance-id" } } } ] } ``` ------ 1. 다음 속성 및 값 문자열을 사용하여 ID 제공업체 애플리케이션에 속성 매핑을 추가합니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/integrate-idp.html) 1. ID 제공업체의 어설션 소비자 서비스(ACS) URL이 개인화된 SAML 로그인 URL을 가리키도록 구성합니다. 다음 예제에서 ACS URL을 사용합니다. ``` https://instance-id.source-region.sign-in.connect.aws/saml?&instanceId=instance-id&accountId=your AWS account ID&role=saml-federation-role&idp=your SAML IDP&destination=optional-destination ``` 1. URL 파라미터에서 다음 필드를 설정합니다. + `instanceId`: Amazon Connect 인스턴스의 식별자입니다. 인스턴스 ID를 찾는 방법에 대한 지침은 [Amazon Connect 인스턴스 ID 또는 ARN 찾기](find-instance-arn.md)를 참조하세요. + `accountId`: Amazon Connect 인스턴스가 위치한 AWS 계정 ID입니다. + `role`: Amazon Connect 페더레이션에 사용되는 SAML 역할의 이름 또는 Amazon 리소스 이름(ARN)으로 설정합니다. + `idp`: IAM에서 SAML ID 제공업체의 이름 또는 Amazon 리소스 이름(ARN)으로 설정합니다. + `destination`: 로그인 후 에이전트가 인스턴스에 들어갈 선택적 경로로 설정합니다(예: `/agent-app-v2`). # 여러 AWS 리전의 Amazon Connect 인스턴스에 에이전트 연결 에이전트가 두에 모두 로그인 AWS 리전 하고 두 리전의 고객 응대를 처리하도록 허용하려면 먼저 트래픽 분산 그룹에 에이전트를 할당해야 합니다. 1. 아직 트래픽 분산 그룹을 설정하지 않았다면 지금 바로 설정하세요. 지침은 [Amazon Connect 인스턴스에 대한 트래픽 배포 그룹 생성](setup-traffic-distribution-groups.md) 섹션을 참조하세요. 1. 트래픽 분산 그룹이 성공적으로 만들어지면(`Status`가 `ACTIVE` 상태) 이 그룹에 에이전트를 배정할 수 있습니다. 항상 사용자를 소스 리전의 트래픽 분산 그룹에 연결하세요. `ACTIVE` 상태 없이 트래픽 분산 그룹에 에이전트를 배정하면 `ResourceNotFoundException`이 발생합니다. 트래픽 분산 그룹이 성공적으로 만들어졌는지 확인하려면 [DescribeTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html) API를 사용하세요(`Status`는 `ACTIVE`여야 함). 1. [AssociateTrafficDistributionGroupUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateTrafficDistributionGroupUser.html) API를 호출하여 트래픽 분산 그룹에 에이전트를 배정할 수 있습니다. ## 예제 다음 `associate-traffic-distribution-group-user` 예제 명령은 에이전트를 여러 AWS 리전에 연결하고 사용하는 방법을 보여줍니다. ``` aws connect associate-traffic-distribution-group-user --traffic-distribution-group-id UUID --user-id UUID --instance-id ``` 다음 [AssociateTrafficDistributionGroupUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateTrafficDistributionGroupUser.html) 예제는 에이전트를 트래픽 분산 그룹에 연결합니다. ``` PUT /traffic-distribution-group/trafficDistributionGroupId/user HTTP/1.1 Content-type: application/json { "UserId": "string" } ``` 다음 `disassociate-traffic-distribution-group-user` 예제는 에이전트를 트래픽 분산 그룹에 연결합니다. ``` aws connect disassociate-traffic-distribution-group-user --instance-id your instance ID --traffic-distribution-group-id UUID --user-id UUID ``` 다음 [disassociate-traffic-distribution-group-user](https://docs.aws.amazon.com/connect/latest/APIReference/API_DisassociateTrafficDistributionGroupUser.html) 예제 명령은 트래픽 분산 그룹에서 에이전트의 연결을 해제합니다. ``` DELETE /traffic-distribution-group/trafficDistributionGroupId/user/UserId HTTP/1.1 ``` ## AssociateTrafficDistributionGroupUser 호출이 실패하는 이유 다음과 같은 경우 [AssociateTrafficDistributionGroupUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateTrafficDistributionGroupUser.html) API 호출이 `ResourceNotFoundException`과 함께 실패합니다. 1. 지정한 트래픽 분산 그룹이 존재하지 않습니다. 1. 트래픽 배포 그룹의 상태가 `ACTIVE`가 아닙니다. 1. `user-id UUID`가 소스 Amazon Connect 인스턴스의 사용자가 아닙니다. # AWS 리전 간 Amazon Connect 에이전트 워크스페이스의 에이전트 배포 업데이트 `UpdateTrafficDistribution` API를 사용하여 [리전 간에 텔레포니 트래픽을 분산](update-telephony-traffic-distribution.md)하는 것처럼 정기적인 운영 준비도 테스트의 일환으로 전체 또는 점진적으로 에이전트를 AWS 리전 간에 분산하는 데에도 사용할 수 있습니다. 예를 들어 에이전트의 40%를 한 AWS 리전에 유지하여 활성 고객 응대를 완료하고 나머지 에이전트를 복제본 리전으로 이동할 수 있습니다. **참고** 텔레포니 트래픽을 이동할 때 에이전트 및/또는 에이전트 로그인도 다른 리전에서 직접 호출을 처리할 수 있도록 전환합니다. 에이전트를 이동하지 않으면 음성 통화가 이동된 리전으로 이동하지만 전화를 받을 수 있는 에이전트가 없습니다. 트래픽 분산 그룹에 에이전트를 추가한 후에는 [UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html) API를 사용하여 지정된 트래픽 분산 그룹의 연결된 인스턴스 간에 에이전트를 10% 단위로 분산합니다. 에이전트는 리전을 이동하기 전에 활성 음성 고객 응대를 완료할 수 있습니다. **참고** 에이전트가 리전을 이동하기 전에 고객 응대를 종료하려고 할 때 오류가 발생하면 에이전트 Workspace 페이지를 새로 고쳐야 합니다. 자세한 내용은 [AWS 리전 간 에이전트 이동을 지원하도록 Amazon Connect 에이전트 Workspace 설정](setup-agentworkspace-switchover.md) 섹션을 참조하세요. **Topics** + [요구 사항](#update-agent-traffic-distribution-requirements) + [정기 작업 중에 두 리전 모두 활성화](#change-signin-weights) + [AWS 리전 간에 모든 텔레포니 트래픽 및 에이전트를 전환하는 방법](#shift-all-traffic) + [리전별 스위치 UI 배너](#regional-switch-ui-banner) ## 요구 사항 다음 요구 사항이 충족되지 않으면 [UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html) API 호출이 실패하고 `InvalidRequestException`이 발생합니다. 1. 지정된 트래픽 분산 그룹이 존재해야 합니다. 1. 트래픽 배포 그룹의 상태가 `ACTIVE`여야 합니다. 1. `SignInConfig` 분산을 변경하는 경우 기본 트래픽 분산 그룹에 대해서만 변경할 수 있습니다. 기본 트래픽 분산 그룹은 복제본 Amazon Connect 인스턴스가 만들어질 때 만들어집니다. [TrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_TrafficDistributionGroup.html) 데이터 유형의 `IsDefault` 파라미터를 확인하세요. 소스 AWS 리전에서 `UpdateTrafficDistribution`을 호출할 때 트래픽 분산 그룹 ID 또는 Amazon 리소스 이름(ARN) 중 하나를 사용할 수 있습니다. 복제 리전에서 `UpdateTrafficDistribution`을 호출할 때는 트래픽 배포 그룹 ARN을 사용해야 합니다. ## 정규 작업 AWS 리전 중에 둘 다 활성화 `UpdateTrafficDistribution` API에는 `SignInConfig`라는 분산이 포함되어 있습니다. 이 분산을 통해 상담원이 인스턴스 그룹에 로그인하는 데 사용할 백엔드 로그인 서버를 선택할 수 있습니다. 트래픽 분산 그룹에 설정된 `SignInConfig`에 관계없이 에이전트는 트래픽 분산 그룹의 두 인스턴스 모두에 로그인하게 됩니다. 최상의 경험을 위해 정규 작업 중에 두 AWS 리전을 모두 활성화하는 것이 좋습니다. 이렇게 하려면 두 `SignInConfig` 배포 모두에 `true`를 전달하세요. 전체 텔레포니 트래픽과 에이전트를 한 AWS 리전으로 전환해야 하는 경우 트래픽을 전환하려는 리전의 `false`를 `SignInConfig`로 변경하는 것이 좋습니다. 예를 들어 다음 호출은 에이전트가 ID 제공업체의 주어진 로그인 호출에 대해 50%의 확률로 us-west-2 로그인 서버를 사용하고 50%의 확률로 us-east-1 로그인 서버를 사용하게 됩니다. ``` aws connect update-traffic-distribution \ --id traffic distribution group ID or ARN \ --cli-input-json \ '{ "SignInConfig":{ "Distributions":[ { "Region":"us-west-2", "Enabled":true }, { "Region":"us-east-1", "Enabled":true } ] } }' ``` 반대로 다음 로그인 배포는 로그인 엔드포인트의 트래픽을 100% us-east-1 로그인 서버를 사용하도록 라우팅합니다. ``` aws connect update-traffic-distribution \ --id traffic distribution group ID or ARN \ --cli-input-json \ '{ "SignInConfig":{ "Distributions":[ { "Region":"us-west-2", "Enabled":false }, { "Region":"us-east-1", "Enabled":true } ] } }' ``` 이 분산은 인스턴스 그룹의 두 인스턴스에 에이전트 로그인을 용이하게 하기 위해 사용되는 로그인 서버의 리전만 제어합니다. 이 분산은 `UpdateTrafficDistribution` API의 `AgentConfig` 부분에 의해 제어되는 에이전트 분산에는 영향을 미치지 않습니다. **중요** 에이전트 로그인 중에 로그인 엔드포인트가 응답하지 않는데 `SignInConfig` 분산이 여러 리전으로 나뉘어져 있다면 분산을 단일 AWS 리전으로 변경하여 오류를 해결할 수 있습니다. 또는 한 리전에 `SignInConfig`가 가중치가 부여되어 있는데 응답하지 않는 경우, `SignInConfig`를 비활성화된 리전으로 이동해 볼 수 있습니다. `SignInConfig`가 어떻게 구성되어 있든 에이전트는 두 리전 모두에서 Amazon Connect 인스턴스에 로그인을 시도하므로 소스 리전 및 복제 리전 모두에서 세션을 활성화하면 여전히 이점을 누릴 수 있습니다. ## AWS 리전 간에 모든 텔레포니 트래픽 및 에이전트를 전환하는 방법 모든 새 인바운드 음성 고객 응대, 에이전트 로그인 분산 및 에이전트 분산을 us-west-2에서 us-east-1로 전환하려면 다음 코드 조각을 사용하세요. ``` aws connect update-traffic-distribution \ --id traffic distribution group ID or ARN \ --cli-input-json \ '{ "SignInConfig":{ "Distributions":[ { "Region":"us-west-2", "Enabled":false }, { "Region":"us-east-1", "Enabled":true } ] }, "AgentConfig":{ "Distributions":[ { "Region":"us-west-2", "Percentage":0 }, { "Region":"us-east-1", "Percentage":100 } ] }, "TelephonyConfig":{ "Distributions":[ { "Region":"us-west-2", "Percentage":0 }, { "Region":"us-east-1", "Percentage":100 } ] } } ' ``` 소스 AWS 리전에서 `UpdateTrafficDistribution`을 호출할 때 트래픽 분산 그룹 ID 또는 Amazon 리소스 이름(ARN) 중 하나를 사용할 수 있습니다. 복제 리전에서 `UpdateTrafficDistribution`을 호출할 때는 트래픽 배포 그룹 ARN을 사용해야 합니다. ## 리전별 스위치 UI 배너 에이전트 Workspace 및 CCP는 리전 전환을 강조 표시하는 UI 배너를 제공합니다. 트래픽 분산 그룹(TDG) 조정으로 인해 리전이 변경될 때 에이전트가 **연락 중인** 경우 아래와 유사한 배너가 표시됩니다. 음성 고객 응대를 완료하고 ACW 상태를 닫으면 에이전트가 자동으로 새 리전으로 업데이트되므로 별도의 조치가 필요하지 않습니다. 에이전트가 고객 응대를 종료하는 데 문제가 있는 경우 **백업에서 계속**을 선택하면 대체 리전으로 전환하라는 확인을 요청하는 팝업이 나타납니다. 이를 반영하도록 실행서와 에이전트 교육 안내서를 조정하는 것이 좋습니다. ![\[TDG 조정 중에 리전별 장애 조치를 강조하는 배너를 보여주는 에이전트 Workspace UI입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/acgr-failover-banner.png) ![\[에이전트가 백업에서 계속을 선택하면 나타나는 확인 팝업입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/acgr-failover-confirmation.png) # AWS 리전 간 에이전트 이동을 지원하도록 Amazon Connect 에이전트 Workspace 설정 다음 단계를 수행하여 Amazon Connect Agent Workspace가 Contact Control Panel을 복제본 AWS 리전에서 소스 리전으로 임베드하고 에이전트의 활성 리전이 변경될 때 이들 간에 이동할 수 있도록 합니다. 아직 소스 Amazon Connect 인스턴스의 복제본을 만들지 않았거나 트래픽 분산 그룹을 설정하지 않은 경우에는 Amazon [Amazon Connect Global Resiliency 시작](get-started-connect-global-resiliency.md) 섹션을 참조하세요. 1. AWS Amazon Connect 콘솔로 이동하여 소스 인스턴스의 **액세스 URL**을 검색합니다. URL을 적어둡니다. 1. 복제본 리전에서 AWS Amazon Connect 콘솔은 복제본 인스턴스의 **액세스 URL**을 검색합니다. URL을 적어둡니다. 1. 복제 Amazon Connect 인스턴스에 대한 동일한 창의 왼쪽 창에서 **승인된 오리진**을 선택합니다. 1. 1단계에서 기록한 소스 인스턴스 **액세스 URL**에 도메인을 추가합니다. **참고** 액세스 URL에 후행 **/**를 포함하지 마세요. 1. 소스 인스턴스에서 위의 단계를 반복합니다. **승인된 오리진**으로 이동하여 복제 인스턴스의 액세스 URL을 추가합니다. **참고** 에이전트가 리전 간에 이동한 후에는 에이전트의 상태를 **사용 가능**으로 설정해야 합니다. # 리전 간 Amazon Connect 인스턴스에서 에이전트 전환 시 발생하는 문제를 방지하기 위한 팁 + 에이전트의 트래픽 분산을 업데이트할 때마다 인바운드 음성 고객 응대의 트래픽 분산도 업데이트해야 합니다. 그렇지 않으면 한 리전에서는 에이전트의 트래픽이 폭주하는 반면 다른 리전에서는 텔레포니 트래픽이 폭주하는 상황이 발생할 수 있습니다. + 사용자를 트래픽 분산 그룹에 연결하기 전에 소스 및 복제 Amazon Connect 인스턴스 모두에서 동일한 사용자 이름을 갖도록 합니다. 그렇지 않으면 사용자를 트래픽 분산 그룹에 연결하지만 해당 사용자 이름을 가진 사용자가 복제 리전에 존재하지 않는 경우 `InvalidRequestException` 오류가 발생합니다. + 에이전트를 소스 리전의 트래픽 분산 그룹에 연결하려면 [ AssociateTrafficDistributionGroupUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateTrafficDistributionGroupUser.html) API를 호출해야 합니다. 복제 리전에 있는 동안 이 작업을 시도하면 `ResourceNotFoundException` 오류가 발생합니다. # Amazon Connect API를 사용하여 트래픽 배포 그룹 관리 이 섹션의 주제에서는 Amazon Connect API를 사용하여 트래픽 분산 그룹을 관리하는 방법에 대해 설명합니다. **Topics** + [트래픽 분산 그룹 목록](list-traffic-distribution-groups.md) + [트래픽 분산 그룹 삭제](delete-traffic-distribution-groups.md) # 트래픽 분산 그룹 목록 모든 트래픽 분산 그룹을 나열하려면 [ListTrafficDistributionGroups](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListTrafficDistributionGroups.html) API를 사용합니다. 특정 Amazon Connect 인스턴스가 트래픽 분산 그룹에 속하는지 여부를 확인하는 방법으로 트래픽 분산 그룹을 나열할 수 있습니다. # Amazon Connect에서 트래픽 분산 그룹 삭제 [DeleteTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DeleteTrafficDistributionGroup.html) API를 사용하여 더 이상 필요하지 않은 트래픽 분산 그룹을 삭제할 수 있습니다. **참고** 전화번호가 트래픽 분산 그룹에 요청된 경우 해당 그룹을 삭제할 수 없습니다. 먼저 [ReleasePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReleasePhoneNumber.html) API를 사용하여 트래픽 분산 그룹에서 전화번호를 릴리스해야 합니다. 그런 다음에 트래픽 분산 그룹을 삭제할 수 있습니다. Amazon Connect 콘솔을 사용하여 트래픽 분산 그룹에서 전화번호를 릴리스할 수 없습니다. 전화번호가 여전히 트래픽 분산 그룹에 요청되어 있는 경우 `ResourceInUseException`과 함께 [DeleteTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DeleteTrafficDistributionGroup.html) API 호출이 실패합니다. # Amazon Connect API를 사용하여 리전 간 전화번호 관리 이 섹션의 주제에서는 Amazon Connect APIs를 사용하여에서 전화번호 AWS 리전 를 관리하는 방법을 설명합니다. **Topics** + [여러의 인스턴스에 전화번호 신청 AWS 리전](claim-phone-number-multiple-regions.md) + [신청한 전화번호를 여러 인스턴스로 옮깁니다. AWS 리전](move-phone-number-multiple-regions.md) + [트래픽 분산 그룹의 번호 릴리스](release-numbers-traffic-distribution-group.md) # 여러의 Amazon Connect 인스턴스에 전화번호 신청 AWS 리전 **참고** **신규 사용자인가요?** [Amazon Connect Global Resiliency 워크숍](https://catalog.workshops.aws/amazon-connect-global-resiliency/en-US)을 확인하세요. 이 온라인 과정은 AWS CLI를 통해 새 API를 사용하여 전화번호와 에이전트 장애 조치를 온보딩하고 테스트하는 프로세스를 안내합니다. 글로벌 복원력은 미국 동부(버지니아 북부), 미국 서부(오레곤), 아시아 태평양(오사카), 아시아 태평양(도쿄), 유럽(프랑크푸르트), 유럽(런던) AWS 리전에서 생성된 Amazon Connect 인스턴스에만 사용할 수 있습니다. 소스가 미국 서부(오리건) 또는 그 반대인 경우에만 미국 동부(버지니아 북부) 리전에서 복제본을 생성할 수 있습니다. 소스가 유럽(런던) 또는 그 반대인 경우에만 유럽(프랑크푸르트) 리전에서 복제본을 생성할 수 있습니다. 소스가 아시아 태평양(도쿄)인 경우에만 아시아 태평양(오사카) 리전에서 복제본을 생성할 수 있습니다. 이 기능에 액세스하려면 Amazon Connect 솔루션 아키텍트 또는 기술 계정 관리자에게 문의하세요. 여러 인스턴스에서 전화번호로 전화를 걸거나 받으려면 트래픽 분산 그룹에 전화번호를 신청해야 AWS 리전합니다. **트래픽 분산 그룹에 전화번호를 클레임하려면 다음을 수행하세요.** 1. [CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html) API를 사용하여 트래픽 분산 그룹을 만듭니다. 1. 트래픽 분산 그룹이 성공적으로 생성되었는지 확인하기 위해 [DescribeTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html) API를 사용하여 트래픽 분산 그룹을 설명합니다(`Status`는 `ACTIVE`여야 함). 1. 트래픽 분산 그룹이 성공적으로 생성된 후(`Status`가 `ACTIVE` 상태), [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) API를 사용하여 해당 그룹에 전화번호를 요청할 수 있습니다. # 신청된 전화번호를 여러 Amazon Connect 인스턴스로 옮깁니다. AWS 리전 **참고** **신규 사용자인가요?** [Amazon Connect Global Resiliency 워크숍](https://catalog.workshops.aws/amazon-connect-global-resiliency/en-US)을 확인하세요. 이 온라인 과정은 AWS CLI를 통해 새 API를 사용하여 전화번호와 에이전트 장애 조치를 온보딩하고 테스트하는 프로세스를 안내합니다. 글로벌 복원력은 미국 동부(버지니아 북부), 미국 서부(오레곤), 아시아 태평양(오사카), 아시아 태평양(도쿄), 유럽(프랑크푸르트), 유럽(런던) AWS 리전에서 생성된 Amazon Connect 인스턴스에만 사용할 수 있습니다. 소스가 미국 서부(오리건) 또는 그 반대인 경우에만 미국 동부(버지니아 북부) 리전에서 복제본을 생성할 수 있습니다. 소스가 유럽(런던) 또는 그 반대인 경우에만 유럽(프랑크푸르트) 리전에서 복제본을 생성할 수 있습니다. 소스가 아시아 태평양(도쿄)인 경우에만 아시아 태평양(오사카) 리전에서 복제본을 생성할 수 있습니다. 이 기능에 액세스하려면 Amazon Connect 솔루션 아키텍트 또는 기술 계정 관리자에게 문의하세요. 이전에 요청된 전화번호를 인스턴스로 이동하는 대신, 해당 전화번호를 AWS 리전전체에 걸쳐 여러 인스턴스에 할당할 수 있습니다. 이 작업은 트래픽 분산 그룹에 전화번호를 할당하여 수행합니다. **트래픽 분산 그룹에 전화번호를 할당하려면 다음을 수행하세요.** 1. [CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html) API를 사용하여 트래픽 분산 그룹을 생성합니다. 1. 트래픽 분산 그룹이 성공적으로 생성되었는지 확인하기 위해 [DescribeTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html) API를 사용하여 트래픽 분산 그룹을 설명합니다(`Status`는 `ACTIVE`여야 함). 1. 트래픽 분산 그룹이 성공적으로 생성된 후(`Status`가 `ACTIVE` 상태), 이전에 요청된 전화번호를 다른 인스턴스나 다른 트래픽 분산 그룹에 할당할 수 있습니다. UpdatePhoneNumber API를 사용합니다. [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) API를 사용합니다. # 트래픽 배포 그룹에서 Amazon Connect의 전화번호 릴리스 트래픽 분산 그룹에서 전화번호를 릴리스하려면 [ReleasePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReleasePhoneNumber.html) API를 사용하세요. 해당 번호는 다른 고객이 요청할 수 있도록 인벤토리에 다시 릴리스됩니다. Amazon Connect 콘솔을 사용하여 트래픽 분산 그룹에서 전화번호를 릴리스할 수 없습니다. # 리전 간 Amazon Connect 인스턴스에서 채팅 관리 두 개의 사용자 지정 채팅 인터페이스 또는 두 개의 out-of-the-box 제공 커뮤니케이션 위젯을 생성하여 AWS 리전 간 채팅을 관리합니다. 하나는 소스 리전에 있고 다른 하나는 복제본 리전에 있습니다. 사용할 리전의 채팅 인터페이스 또는 기본 제공 커뮤니케이션 위젯에 따라 수동으로 전환합니다. + 사용자 지정 채팅 인터페이스: 복제본 리전의 API 엔드포인트를 사용하도록 복제본 리전의 채팅 인터페이스를 구성합니다. 사용자 지정 인터페이스의 예는 GitHub의 [Amazon Connect 오픈 소스 라이브러리](https://github.com/amazon-connect/amazon-connect-chat-ui-examples/tree/master)를 참조하세요. 자세한 내용은 [Amazon Connect 오픈 소스 예시로 채팅 사용자 지정](download-chat-example.md) 단원을 참조하십시오. + 기본 제공 커뮤니케이션 위젯: 복제본 Amazon Connect 인스턴스에서 커뮤니케이션 위젯을 생성합니다. 지침은 [복제본 인스턴스에서 커뮤니케이션 위젯 구성](#communicationswidget-multiple-regions) 섹션을 참조하세요. 다음은 웹 사이트 또는 앱에서 클라이언트 측 채팅을 시작하는 데 필요한 채팅 구성 파라미터입니다. + **Amazon Connect 인스턴스 ID** 및 **흐름 ID **: 이러한 파라미터는 소스 및 복제본 리전에서 동일합니다. + **대상 AWS 리전** 및 일반적으로 채팅을 시작하는 **API 엔드포인트**(즉, 참가자 토큰 획득): 이러한 파라미터는 소스 및 복제본 리전에서 다릅니다. 예를 들어, 다음 다이어그램은 채팅 트래픽을 리전 간에 이동해야 할 때 복제본 리전의 API Gateway를 가리키도록 채팅 구성을 업데이트해야 하는 방법을 보여 줍니다. ![\[소스 리전과 복제본 리전을 보여 주는 다이어그램입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/chatconfig.png) ## 복제본 인스턴스에서 커뮤니케이션 위젯 구성 1. 소스 Amazon Connect 인스턴스에서 채팅용 커뮤니케이션 위젯이 아직 존재하지 않는 경우 위젯을 생성합니다. 지침은 [Amazon Connect에서 호스팅하는 웹 사이트에 채팅 사용자 인터페이스 추가](add-chat-to-website.md) 섹션을 참조하세요. 1. 복제본 인스턴스에서 채팅을 위한 다른 커뮤니케이션 위젯을 생성합니다. 소스 인스턴스의 위젯에 사용된 것과 동일한 흐름으로 위젯을 구성합니다. Amazon Connect Global Resiliency는 소스의 모든 흐름을 복제본으로 복사하고 지속적으로 동기화하기 때문에 흐름은 이미 복제본 인스턴스에 있습니다. 1. 복제본 인스턴스에서 생성한 새 커뮤니케이션 위젯 스크립트를 복사합니다. 채팅 트래픽이 복제본 인스턴스로 전달될 때 활성화해야 하는 스크립트를 웹 사이트 또는 앱에 포함합니다. 1. 리전 간 트래픽을 전환하려면 소스 인스턴스 커뮤니케이션 위젯을 웹 페이지의 복제본 인스턴스 커뮤니케이션션 위젯으로 바꿉니다. 다음 이미지는 위젯 스크립트 예시입니다. ![\[샘플 커뮤니케이션 위젯 스크립트입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/source-comwidget.png) 1. 나중에 소스 인스턴스의 커뮤니케이션 위젯을 변경하는 경우 복제본 인스턴스의 커뮤니케이션 위젯도 동일하게 변경해야 합니다. ## 더 원활한 추가 옵션 리전 간 채팅 트래픽을 보다 원활하게 전환하고 수동 변경을 줄이려면 채팅 환경을 사용자 지정할 수 있는 또 다른 방법은 다음과 같습니다. 1. 중앙에서 제어하는 데이터베이스(예: DynamoDB Global Table)에 파라미터를 추가합니다. 이 파라미터의 목적은 현재 활성화되어 있는 리전을 정의하는 것입니다. 1. 웹 사이트 또는 애플리케이션을 업데이트하여 중앙 데이터베이스에서 리전 파라미터의 상태를 확인합니다. 1. 활성 리전에 따라 웹 사이트 또는 애플리케이션은 해당 리전의 API 엔드포인트 또는 커뮤니케이션 위젯을 사용합니다. 1. 이 파라미터는 [UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html) API를 직접적으로 호출하는 동시에 업데이트하여 해당하는 경우 리전 간에 음성 트래픽과 에이전트를 전환해야 합니다. # ACGR 리전 간 지표, 보고서 및 검색 이 섹션의 주제에서는 Amazon Connect Global Resiliency(ACGR) 고객의 통합 지표, 보고서 및 검색 AWS 리전 에 대해 설명합니다. **Topics** + [연락처 검색 및 연락처 세부 정보](contact-search-and-contact-details.md) + [리전 간 통합 지표](consolidated-metrics-across-regions.md) # 연락처 검색 및 연락처 세부 정보 **중요** ACGR 인스턴스에 대한 통합 연락처 검색을 활성화하려면 [AWS Support](https://console.aws.amazon.com/support/home)에 문의하세요. **중요** 이 기능에 온보딩하면 Amazon Connect 별칭이 형식의 새 하위 도메인으로 업데이트됩니다`region.sourcealias.my.connect.aws`. 예를 들어 ACGR 인스턴스가 소스 별칭이 로 구성되고 복제본 별칭이 로 구성된 미국 동부(버지니아 북부) `source.my.connect.aws` 및 미국 서부(오레곤)에 배포된 경우 Amazon Connect 인스턴스를이 기능에 온보딩한 `replica.my.connect.aws`후 `us-east-1.source.my.connect.aws` 및를 사용합니다`us-west-2.source.my.connect.aws`. 이러한 새 하위 도메인을 사용하려면 방화벽 규칙 및 타사 통합을 업데이트해야 합니다. 고객 응대 검색 페이지에 액세스하면 기본적으로 페어링된 Amazon Connect Global Resiliency(ACGR) 인스턴스의 고객 응대가 표시되므로 조직 전체의 고객 상호 작용을 전체적으로 볼 수 있습니다. 이렇게 하면 어떤 리전 고객 응대가 시작되었는지 또는 현재 어떤 리전에 로그인했는지에 관계없이 원활한 검색 환경을 제공할 수 있습니다. + **활성 리전**: 고객 응대가 처리 중이거나 완료된 AWS 리전 입니다. ## 고객 응대 검색 환경 ### 활성 리전 필터 필터 드롭다운에 새 '활성 리전' 필터가 표시됩니다. 이렇게 하면 필요할 때 리전별 검색 범위를 좁힐 수 있습니다. 활성 리전 필터를 사용하려면: 1. **고객 응대 검색 페이지 **에서 **필터 추가**를 선택합니다. 1. 드롭다운에서 **활성 리전**을 선택합니다. 1. 리전을 하나 이상 선택합니다. ![\[선택할 수 있는 리전을 보여주는 활성 리전 필터 드롭다운입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/active-region-filter.png) ### 리전별 리소스 필터 다음 필터를 사용하면 드롭다운 옵션에 로그인한 리전에서 생성된 리소스만 표시됩니다. + 사용자 지정 연락처 속성 + 연락 범주 + 평가 필터 + 이메일 주소 + 사용자 지정 고객 응대 세그먼트 속성 **중요** 드롭다운에서 선택하는 대신 필터 값을 수동으로 입력하고 이러한 리소스 이름이 ACGR 인스턴스 간에 동일한 경우 결과에 두 리전의 연락처가 포함됩니다. 사용자 지정 연락처 속성 이메일 주소 **평가 필터**는 리전별 고유 평가 양식 IDs를 사용하여 검색하므로 현재 리전의 고객 응대만 반환합니다. ### 저장된 검색 저장된 검색에는 두 ACGR 인스턴스의 연락처가 표시됩니다. 이전에 저장된 리전 필터는 예상대로 계속 작동합니다. ## 연락처 세부 정보 경험 ### 연락처 정보 보기 연락처 세부 정보 페이지를 열면 연락처가 시작된 리전에 관계없이 다음을 포함한 포괄적인 정보가 표시됩니다. + 개요, 연결 세부 정보 및 대기열 정보 + 연락처 태그 및 속성 + Contact Lens 데이터(대화형 분석, 음성 대화 기록, 채팅 대화 기록) + 화면 및 오디오 녹음 + 채팅 트랜스크립트 및 IVR 상호 작용 + 이메일 첨부 파일 및 트랜스크립트 연락처의 활성 리전은 연락처 세부 정보 페이지의 **글로벌 복원력 메타데이터** 아래에 표시됩니다. ![\[연락처 세부 정보 페이지에는 활성 리전 정보가 포함된 글로벌 복원력 메타데이터 섹션이 표시됩니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/global-resiliency-metadata.png) **참고** 연락처의 활성 리전이 손상된 경우 화면 및 오디오 녹음, 채팅 트랜스크립트, IVR 상호 작용, 이메일 첨부 파일 및 트랜스크립트, Contact Lens 데이터 등 일부 정보를 사용하지 못할 수 있습니다. ### Contact Lens 데이터 액세스 다음을 포함하여 여러 리전에서 Contact Lens 데이터에 대한 전체 액세스 권한이 있습니다. + 진행 중인 고객 응대: 대화 분석, 음성 트랜스크립트(수정 및 미수정) 및 채팅 트랜스크립트. + 완료된 고객 응대: 모든 대화 분석, 음성 트랜스크립트(수정 및 미수정) 및 채팅 트랜스크립트. + 레코딩: 연락처의 활성 리전에 관계없이 화면 및 오디오 레코딩에 액세스할 수 있습니다. + 트랜스크립트: 채팅, IVR 및 이메일 트랜스크립트는 리전 간에 사용할 수 있습니다. ### 고객 응대 작업 연락처의 활성 리전에 관계없이 Transfer, Reschedule 또는 End contact과 같은 연락처 작업을 수행할 수 있습니다. 이러한 작업은 연락처의 활성 리전으로 라우팅됩니다. ### 고객 응대 평가 고객 응대 평가는 로그인한 리전에서 활성 상태인 고객 응대에만 사용할 수 있습니다. 다른 리전에서 복제된 고객 응대에 대한 평가는 보거나 수행할 수 없습니다. ### SearchContacts API 프로그래밍 방식으로 SearchContacts API를 사용하는 경우 응답에는 추가 정보가 포함됩니다. + GlobalResiliencyMetadata 객체: 연락처가 활성 상태인 특정 리전을 보여주는 모든 연락처의 `ActiveRegion``OriginRegion`, 및 `TrafficDistributionGroupId` 필드를 포함합니다. SearchContacts API에 대한 자세한 내용은 [Amazon Connect API 참조](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchContacts.html)를 참조하세요. # 리전 간 통합 지표 **중요** ACGR 인스턴스에 대한 통합 에이전트 및 연락처 지표를 활성화하려면 [AWS Support](https://console.aws.amazon.com/support/home)에 문의하세요. Amazon Connect에서 지표를 보면 현재 로그인한 리전에 관계없이 페어링된 모든 리전의 에이전트 및 고객 응대 지표에 대한 통합 보기가 표시됩니다. 예를 들어, 에이전트 5명이 us-east-1에 로그인하고 BasicQueue에서 사용할 수 있고 에이전트 10명이 us-west-2에 로그인하고 BasicQueue에서 사용할 수 있는 경우 실시간 지표 페이지에 총 15명의 에이전트가 온라인 상태로 표시됩니다. 이 통합 보기를 사용하면 단일 인터페이스 내에서 콜 센터 작업을 모니터링할 수 있습니다. ## 사용 가능한 지표 통합 보기는 다음 전체에서 사용할 수 있습니다. + 실시간 지표: ACGR 인스턴스에서 현재 에이전트 활동 및 고객 응대 지표를 봅니다. + 기록 지표: ACGR 인스턴스 전반의 기록 성능 데이터에 액세스합니다. + 지표 APIs: API 응답은 ACGR 인스턴스 전체에서 통합 지표를 반환합니다. **참고** 에이전트 및 고객 응대 지표는 리전 간에 통합됩니다. 분석과 같은 다른 지표는 리전별로 유지됩니다. Amazon Connect 보고에 대한 자세한 내용은 섹션을 참조하세요[Amazon Connect의 지표, 대시보드 및 보고서](amazon-connect-metrics.md).