기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 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` 상태를 받은 경우 하루 이내에 해당 전화번호의 클레임을 다시 시도해야 다른 고객이 해당 번호를 클레임할 수 있도록 인벤토리로 다시 해제되지 않습니다.