Amazon Connect를 사용하여 트래픽 배포 그룹에 전화번호 요청 - Amazon Connect
워크플로 예제호출이 실패하는 ClaimPhoneNumber 이유전화번호 상태 정의

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

Amazon Connect를 사용하여 트래픽 배포 그룹에 전화번호 요청

참고

새 사용자? Amazon Connect 글로벌 복원력 워크숍 을 확인하세요. 이 온라인 과정에서는 AWS 를 APIs 통해 새 를 사용하여 전화번호 및 에이전트 장애 조치를 온보딩하고 테스트하는 프로세스를 안내합니다CLI.

글로벌 복원력은 미국 동부(버지니아 북부), 미국 서부(오레곤), 유럽(프랑크푸르트) 및 유럽(런던) AWS 리전에서 생성된 Amazon Connect 인스턴스에만 사용할 수 있습니다.

소스가 미국 서부(오레곤) 또는 그 반대인 경우에만 미국 동부(버지니아 북부) 리전에서 복제본을 생성할 수 있습니다. 마찬가지로 소스가 유럽(런던) 또는 그 반대인 경우에만 유럽(프랑크푸르트) 리전에서 복제본을 생성할 수 있습니다.

이 기능에 액세스하려면 Amazon Connect 솔루션 아키텍트 또는 기술 계정 관리자에게 문의하세요.

트래픽 배포 그룹이 성공적으로 생성된 후(Status 는 ACTIVE) SearchAvailablePhoneNumbers를 사용하여 사용 가능한 전화번호를 검색하고 청구ClaimPhoneNumber할 수 있습니다.

트래픽 배포 그룹에 전화번호를 청구하기 전에 DescribeTrafficDistributionGroupAPI를 사용하여 트래픽 배포 그룹의 상태가 인지 확인하는 것이 좋습니다ACTIVE. ACTIVE 상태가 아닌 트래픽 분산 그룹에 전화번호를 할당하면 ResourceNotFoundException이 발생합니다.

를 호출할 때 TargetArn 파라미터ARN에 트래픽 배포 그룹을 제공하여 트래픽 배포 그룹에 전화번호를 요청할 수 있습니다ClaimPhoneNumberAPI. 또한 를 사용하여 이전에 인스턴스UpdatePhoneNumberAPI에 요청된 전화번호를 트래픽 배포 그룹에 할당할 수도 있습니다.

참고

설명 필드를 업데이트하려면 Amazon Connect 콘솔을 사용해야 합니다.

워크플로 예제

다음은 전화번호를 요청하여 여러 AWS 리전에서 사용하는 워크플로의 예시입니다.

  1. 인스턴스의 복제본을 만듭니다.

    1. 를 호출합니다ReplicateInstanceAPI.

  2. 이러한 인스턴스를 서로 연결하는 트래픽 분산 그룹을 만듭니다.

    1. 를 호출합니다CreateTrafficDistributionGroupAPI.

  3. 트래픽 분산 그룹에 청구할 수 있는 사용 가능한 전화번호를 찾아보세요.

    1. 트래픽 배포 그룹이 생성된 리전SearchAvailablePhoneNumbersAPI에서 를 호출합니다. ARN TargetArn 파라미터의 트래픽 배포 그룹을 제공합니다.

  4. 트래픽 배포 그룹이 생성된 리전에서 ClaimPhoneNumber 를 호출합니다API.

    1. TargetArn 파라미터에 ARN 대한 트래픽 배포 그룹을 제공합니다.

    2. 3단계에서 SearchAvailablePhoneNumbers API 호출로 반환된 E164 전화번호 값을 입력합니다.

    PhoneNumberId와 PhoneNumberArn이 반환됩니다. 이 값을 후속 조치 작업에 사용할 수 있습니다.

  5. 전화번호 상태가 CLAIMED인지 확인합니다.

    1. 를 호출합니다DescribePhoneNumberAPI.

      (트래픽 배포 그룹과 연결된 다른 리전에서도 호출할 수 DescribePhoneNumber 있습니다. 동일한 전화번호 세부 정보가 반환됩니다.)

    전화번호는 상태가 CLAIMED된 후에만 후속 작업에서 사용할 수 있습니다.

    가능한 상태에 대한 설명은 전화번호 상태 정의를 참조하세요.

  6. 트래픽 분산 그룹에 청구해야 하는 모든 전화번호에 대해 3~5단계를 반복합니다.

  7. 다음 단계를 수행하여 흐름을 전화번호에 연결합니다. 트래픽 분산 그룹이 운영되는 두 리전 모두에서 수행하세요.

    이러한 단계를 통해 텔레포니 트래픽이 흐름으로 올바르게 라우팅되어 트래픽 분산 구성을 지원할 수 있습니다.

    1. 트래픽 분산 그룹이 생성된 리전의 기존 Amazon Connect 인스턴스에서 다음 단계를 수행합니다.

      1. ListContactFlows 를 호출합니다API. 복제된 인스턴스에 해당하는InstanceId를 입력합니다.

      2. 흐름 목록이 반환ARNs됩니다. 이러한 흐름을 사용하여 흐름을 전화번호에 ARNs 연결하고 AssociatePhoneNumberContactFlow 를 호출합니다API.

    2. 다른 AWS 리전의 복제된 Amazon Connect 인스턴스에서 다음 단계를 수행합니다.

      1. ListContactFlows 를 호출합니다API. 복제된 인스턴스에 해당하는InstanceId를 입력합니다.

      2. 흐름 목록이 반환ARNs됩니다. 이러한 흐름을 사용하여 흐름을 전화번호에 ARNs 연결하고 AssociatePhoneNumberContactFlow 를 호출합니다API.

ClaimPhoneNumber 호출이 실패하는 이유

다음과 같은 경우 에서 ClaimPhoneNumber API 호출ResourceNotFoundException이 실패합니다.

  • 지정한 트래픽 분산 그룹이 존재하지 않거나, 트래픽 분산 그룹의 상태가 ACTIVE 상태가 아니거나, 트래픽 분산 그룹의 소유권이 없는 경우입니다.

  • 해당 전화번호는 요청에 사용할 수 없습니다. 경우에 따라 다른 고객이 에서 찾은 전화번호를 청구했을 SearchAvailablePhoneNumbers 수 있습니다.

ClaimPhoneNumber 다음과 같은 경우 InvalidParameterException 오류와 함께 실패합니다.

  • 호출 중인 엔드포인트가 트래픽 분산 그룹이 생성된 리전과 동일한 리전에 있지 않습니다.

전화번호 상태 정의

다음은 전화번호 상태에 대한 설명입니다.

  • CLAIMED 는 성공한 이전 ClaimPhoneNumber 또는 UpdatePhoneNumber 작업을 의미합니다.

  • IN_PROGRESS 는 작업이 아직 진행 중ClaimPhoneNumberUpdatePhoneNumber이고 아직 완료되지 않았음을 의미합니다. DescribePhoneNumber 나중에 를 호출하여 이전 작업이 완료되었는지 확인할 수 있습니다.

  • FAILED 는 이전 ClaimPhoneNumber 또는 UpdatePhoneNumber 작업이 실패했음을 나타냅니다. 여기에는 실패 이유를 나타내는 메시지가 포함됩니다.

    전화번호를 클레임하거나 업데이트하려는 TargetArn 값이 총 클레임된 건수 한도에 도달한 것이 실패의 일반적인 원인입니다.

    ClaimPhoneNumber API 통화에서 FAILED 상태를 수신한 경우 전화번호가 다른 고객이 청구할 수 있도록 인벤토리로 다시 릴리스되기 전에 전화번호를 다시 청구해야 합니다.