View a markdown version of this page

통신 사업자 조회 서비스 사용 - AWS 최종 사용자 메시징 SMS

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

통신 사업자 조회 서비스 사용

AWS End User Messaging SMS에는 전화번호가 유효한지 여부를 포함하여 전화번호에 대한 정보를 얻는 데 사용할 수 있는 통신 사업자 조회 서비스가 포함되어 있습니다. 통신 사업자 조회 서비스는 전화번호에 대해 다음 정보를 반환합니다.

  • E164 형식의 전화번호입니다(원본 입력에서 삭제됨).

  • 전화번호 유형(예: 유효하지 않음, 유선 전화, 휴대폰, 기타).

  • 전화번호의 국가 또는 리전 이름입니다.

  • 전화번호의 국가 또는 리전 숫자 다이얼링 코드입니다.

  • 전화번호에 대한 ISO 3166-1 alpha-2 형식의 2자 국가 또는 리전 코드입니다.

  • 휴대폰 번호의 경우 모바일 국가 코드(MCC).

  • 휴대폰 번호의 경우 모바일 네트워크 코드(MNC).

  • 전화번호가 현재 등록된 통신 사업자 또는 서비스 공급자입니다. 일부 국가 및 리전에서이 값은 전화번호가 원래 등록된 통신 사업자 또는 서비스 공급자일 수 있습니다.

통신 사업자 조회 서비스 사용 시 추가 요금이 부과됩니다. 자세한 내용은 AWS End User Messaging SMS 요금을 참조하세요.

통신 사업자 조회 사용 사례

통신 사업자 조회 서비스를 사용하여 다음을 포함한 여러 사용 사례를 활성화할 수 있습니다.

  • 웹 양식에 제공된 전화번호 조회 - 웹 기반 양식을 사용하여 고객의 연락처 정보를 수집하는 경우 양식을 제출하기 전에 고객이 제공하는 전화번호를 조회할 수 있습니다. 웹 사이트의 백엔드를 사용하여 AWS End User Messaging SMS API를 사용하여 번호를 조회하고 검증합니다. API 응답은 전화번호의 형식이 올바른 경우와 같이 번호가 유효한지 여부를 나타냅니다. 고객이 제공한 전화번호가 유효하지 않다고 판단되면 웹 양식에서 고객에게 유효한 번호를 제공하라는 메시지를 표시할 수 있습니다.

  • 기존 연락처 데이터베이스 정리 - 고객 전화번호 데이터베이스가 있는 경우 각 전화번호를 조회하고 통신 사업자 조회 결과를 사용하여 데이터베이스를 업데이트할 수 있습니다. 예를 들어, SMS 메시지를 수신할 수 없는 전화 번호가 있는 엔드포인트를 찾은 경우 엔드포인트의 ChannelType 속성을 SMS에서 VOICE로 변경할 수 있습니다.

  • 메시지를 전송하기 전에 올바른 채널 선택 - SMS 메시지를 전송하려고 하는데 대상 번호가 유효하지 않다고 판단된 경우, 다른 채널을 통해 수신자에게 메시지를 전송할 수 있습니다. 예를 들어, 엔드포인트가 SMS 메시지를 수신할 수 없는 경우 대신 음성 메시지를 전송할 수 있습니다.

지원되는 전화번호 형식

전화번호는 E164 형식이어야 하며, 더하기 기호(+)로 시작하고 국가 다이얼링 코드 및 전화번호(예: +12065551234)로 시작해야 합니다. 통신 사업자 조회 서비스는 다양한 형식 지정 문자를 수락하고 처리 중에 자동으로 제거합니다. 전화번호 입력에 다음 형식 지정 문자를 포함할 수 있습니다.

  • 괄호: +1 (555) 123-4567

  • 대괄호: +1 [555] 123-4567

  • 스페이스: +1 555 123 4567

  • 하이픈: +1-555-123-4567

  • 기간: +1.555.123.4567

  • 커마스: +1,555,123,4567

  • 혼합 형식: +1 (555)-123.4567

모든 형식 지정 문자는 처리 중에 자동으로 제거되며 서비스는 응답 E164PhoneNumber 필드에 표준 E164 형식(예: +15551234567)으로 전화번호를 반환합니다.

에서 통신 사업자 조회 서비스 사용 AWS CLI

다음 예제에서는에서 통신 사업자 조회 서비스를 사용하는 방법을 보여줍니다 AWS CLI. 이 서비스는 다양한 형식의 문자(괄호, 대괄호, 공백, 하이픈, 마침표, 쉼표)가 있는 전화번호를 수락하고 처리를 위해 자동으로 E164 형식으로 변환합니다. 자세한 내용은 AWS End User Messaging SMS API 참조의 CarrierLookup 또는 AWS CLI 명령 참조의 carrier-lookup을 참조하세요.

통신 사업자 조회 서비스(CLI)를 사용하려면
  • 명령줄에 다음 명령을 입력합니다. 다양한 전화번호 형식을 사용할 수 있습니다. 서비스는 괄호, 대괄호, 공백, 하이픈, 마침표 및 쉼표와 같은 특수 문자를 허용합니다.

    $ aws pinpoint-sms-voice-v2 carrier-lookup --phone-number "+1 (555) 555-5333"

    또는 E164 형식:

    $ aws pinpoint-sms-voice-v2 carrier-lookup --phone-number +15555555333

통신 사업자 조회 응답

통신 사업자 조회 서비스가 제공하는 정보는 사용자가 제공한 전화번호에 사용할 수 있는 데이터에 따라 약간 다릅니다. 이 섹션에는 통신 사업자 조회 서비스가 반환하는 응답의 예가 포함되어 있습니다.

참고

통신 사업자 조회 서비스에서 제공하는 데이터는 통신 공급자 및 전 세계 기타 엔터티에서 제공하는 정보를 기반으로 합니다. 일부 국가의 공급업체는 다른 국가의 공급업체보다 정보 업데이트 간격이 길 수 있습니다. 예를 들어 휴대폰 번호 검증 요청을 발행하고 제공한 번호가 한 이동 통신사에서 다른 이동 통신사로 이식된 경우 이동 통신사 조회 서비스의 응답에는 현재 이동 통신사가 아닌 원래 이동 통신사의 이름이 포함될 수 있습니다.

유효한 휴대폰 번호

다음 응답은 유효한 휴대폰 번호에 대해가 CarrierLookup 반환하는 정보의 예입니다.

{ "E164PhoneNumber": "+15555555333", "DialingCountryCode": "1", "IsoCountryCode": "US", "Country": "United States", "MCC": "310", "MNC": "260", "Carrier": "ExampleCorp Mobile", "PhoneNumberType": "MOBILE" }
유효한 유선 전화 번호

다음 응답은 유효한 유선 전화번호에 대해가 CarrierLookup 반환하는 정보의 예입니다.

{ "E164PhoneNumber": "+15555555333", "DialingCountryCode": "1", "IsoCountryCode": "CA", "Country": "Canada", "Carrier": "ExampleCorp Landline", "PhoneNumberType": "LANDLINE" }
잘못된 전화 번호

요청에 잘못된 전화번호가 포함된 경우 통신 사업자 조회 서비스는 다음 예와 유사한 정보를 반환합니다.

{ "E164PhoneNumber": "+15555555333444666", "PhoneNumberType": "INVALID" }}

이 응답의 PhoneNumberType 속성은 이 전화 번호가 INVALID이며 해당 전화 번호와 연결된 이동 통신사 또는 위치에 대한 정보를 포함하지 않음을 나타냅니다. PhoneNumberTypeINVALID인 전화 번호는 실제 수신자에게 속하지 않는 것이므로 이 번호로 SMS 또는 음성 메시지를 보내지 마세요.

기타 전화 번호

휴대폰, 유선전화 또는 유효하지 않은 것으로 분류되지 않은 전화번호는 PhoneNumberType 값으로 반환됩니다OTHER.