Amazon Connect의 트래픽 배포 그룹에 요청된 전화번호 할당 - Amazon Connect
워크플로 예제 AssociatePhoneNumberContactFlow 호출이 실패하는 이유 UpdatePhoneNumber 호출이 실패하는 이유전화번호 상태 정의

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

Amazon Connect의 트래픽 배포 그룹에 요청된 전화번호 할당

  • 새 트래픽 분산 그룹을 만들었고 상태는 ACTIVE입니다. DescribeTrafficDistributionGroup API 를 사용하여 상태를 확인하는 것이 좋습니다.

  • 이미 인스턴스나 다른 트래픽 배포 그룹에 전화번호를 클레임했습니다.

이제 UpdatePhoneNumber 를 사용하여 요청된 전화번호를 새 트래픽 배포 그룹에 할당할 수 있습니다API. ARN TargetArn 파라미터에 트래픽 배포 그룹을 제공합니다.

참고

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

워크플로 예제

다음은 트래픽 분산 그룹에 요청된 전화번호를 할당하는 워크플로 예시입니다.

  1. 를 호출UpdatePhoneNumberAPI하여 새 에 전화번호를 할당합니다TargetArn.

    TargetArn은 다른 Amazon Connect 인스턴스용이거나 전화번호가 처음 청구된 동일한 리전에서 생성된 트래픽 분산 그룹용일 수 있습니다.

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

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

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

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

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

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

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

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

AssociatePhoneNumberContactFlow 호출이 실패하는 이유

트래픽 배포 그룹에 번호가 요청되고 트래픽 배포 그룹이 생성된 AWS 리전 의 인스턴스를 AssociatePhoneNumberContactFlow 사용하여 전화를 거는 경우 PhoneNumberId URI 요청 파라미터에 전체 전화번호 ARN 또는 UUID 값을 사용할 수 있습니다.

그러나 트래픽 배포 그룹에 번호가 요청되고 트래픽 배포 그룹과 AWS 리전 연결된 복제본의 인스턴스를 API 사용하여 이 번호를 호출하는 경우 전체 전화번호를 제공해야 합니다ARN. 이 시나리오에서 UUID가 제공되는 경우 를 받게 됩니다ResourceNotFoundException.

UpdatePhoneNumber 호출이 실패하는 이유

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

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

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

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

전화번호 상태 정의

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

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

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

  • FAILED 는 이전 ClaimPhoneNumber 또는 UpdatePhoneNumber 작업이 실패했음을 나타냅니다. 여기에는 실패 이유를 나타내는 메시지가 포함됩니다. 전화번호를 클레임하거나 업데이트하려는 TargetArn 값이 총 클레임된 건수 한도에 도달한 것이 실패의 일반적인 원인입니다.