전화 번호 확인 사용 사례 전화 번호 확인 서비스 사용 전화 번호 확인 응답

Amazon Pinpoint에서 전화번호 확인

Amazon Pinpoint에는 전화 번호가 유효한지 확인하고 전화 번호 자체에 대한 추가 정보를 얻는 데 사용할 수 있는 전화 번호 확인 서비스가 포함되어 있습니다. 예를 들어 전화 번호 확인 서비스를 사용하면 다음 정보가 반환됩니다.

E.164 형식의 전화 번호
전화 번호 유형(예: 모바일, 유선 또는 VoIP)
해당 전화 번호의 도시 및 국가
전화 번호와 관련된 서비스 공급업체

전화 번호 확인 서비스 사용 시에는 추가 요금이 부과됩니다. 자세한 내용은 Amazon Pinpoint 요금을 참조하세요.

중요

미국 및 캐나다에서 발신하는 전화번호의 경우 전화번호 확인 API는 더 이상 City, County, Timezone 및 ZipCode에 대한 데이터를 반환하지 않습니다.

전화 번호 확인 사용 사례

전화 번호 확인 서비스를 사용하여 다음을 비롯한 여러 사용 사례를 활성화할 수 있습니다.

웹 양식에 제공된 전화번호 확인 - 웹 기반 양식을 사용하여 고객의 연락처 정보를 수집하는 경우 양식을 제출하기 전에 고객이 제공한 전화 번호를 확인합니다. 웹 사이트의 백엔드를 활용하여 Amazon Pinpoint API로 번호를 확인합니다. API 응답에는 번호가 유효하지 않은지 여부(예: 전화번호 형식이 잘못된 경우)가 표시됩니다. 고객이 제공한 전화 번호가 유효하지 않다고 판단되면 웹 양식에서 고객에게 다른 번호를 제공하라는 메시지를 표시할 수 있습니다.
기존 연락처 데이터베이스 정리 - 고객 전화 번호 데이터베이스가 있는 경우 각 전화 번호를 확인하고 결과를 기반으로 데이터베이스를 업데이트할 수 있습니다. 예를 들어, SMS 메시지를 수신할 수 없는 전화 번호가 있는 엔드포인트를 찾은 경우 엔드포인트의 ChannelType 속성을 SMS에서 VOICE로 변경할 수 있습니다. 먼저 전화번호를 확인한 다음 단일 엔드포인트의 Amazon Pinpoint에 엔드포인트 추가 또는 여러 엔드포인트의 Amazon Pinpoint에 엔드포인트 배치 추가 내 지침에 따라 새 엔드포인트 또는 기존 엔드포인트의 ChannelType 속성을 업데이트할 수 있습니다.
메시지를 전송하기 전에 올바른 채널 선택 - SMS 메시지를 전송하려고 하는데 대상 번호가 유효하지 않다고 판단된 경우, 다른 채널을 통해 수신자에게 메시지를 전송할 수 있습니다. 예를 들어, 엔드포인트가 SMS 메시지를 수신할 수 없는 경우 대신 음성 메시지를 전송할 수 있습니다.

전화 번호 확인 서비스 사용

다음 예에서는 를 사용하여 전화 번호를 확인하는 방법을 보여 줍니다 AWS CLI. 자세한 내용은 AWS CLI 명령 참조서를 참조하십시오 phone-number-validate. 유효성 검사 응답의 예는 을 참조하십시오전화 번호 확인 응답. 구성에 대한 자세한 내용은 AWS Command Line Interface 사용 설명서의 AWS CLI구성을 참조하십시오. AWS CLI

를 사용하여 전화번호 확인 서비스를 사용하려면 AWS CLI

명령줄에 다음 명령을 입력합니다.
```
aws pinpoint phone-number-validate --number-validate-request PhoneNumber=+442079460881,IsoCountryCode=GB
```
이전 명령에서 +442079460881을 확인하려는 전화번호로 바꾸고 GB를 2자리 ISO 국가 또는 지역 코드로 바꿉니다.

참고
전화 번호 확인 서비스에 전화 번호를 제공할 때는 항상 국가 코드를 포함해야 합니다. 국가 코드를 포함하지 않으면 서비스에서 다른 국가의 전화 번호에 대한 정보를 반환할 수 있습니다. 전화번호에는 대시를 사용할 수 있습니다 (예: +44-207-946-0881).

전화 번호 확인 응답

전화 번호 확인 서비스가 제공하는 정보는 제공한 전화 번호에 사용할 수 있는 데이터에 따라 약간 다릅니다. 이 단원에는 전화 번호 확인 서비스가 반환하는 응답의 예가 포함되어 있습니다.

참고

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

유효한 휴대폰 번호

전화 번호 확인 서비스에 요청을 보냈는데 해당 전화 번호가 유효한 휴대폰 번호이면 다음 예제와 유사한 정보가 반환됩니다.


{
    "NumberValidateResponse": {
        "Carrier": "ExampleCorp Mobile",
        "City": "Seattle",
        "CleansedPhoneNumberE164": "+12065550142",
        "CleansedPhoneNumberNational": "2065550142",
        "Country": "United States",
        "CountryCodeIso2": "US",
        "CountryCodeNumeric": "1",
        "OriginalPhoneNumber": "+12065550142",
        "PhoneType": "MOBILE",
        "PhoneTypeCode": 0,
        "Timezone": "America/Los_Angeles",
        "ZipCode": "98101"
    }
}

유효한 유선 전화 번호

요청에 유효한 유선 전화 번호가 포함되어 있으면 전화 번호 확인 서비스에서 다음 예제와 유사한 정보를 반환합니다.


{
    "CountryCodeIso2": "US",
    "CountryCodeNumeric": "1",
    "Country": "United States",
    "City": "Santa Clara",
    "ZipCode": "95037",
    "Timezone": "America/Los_Angeles",
    "CleansedPhoneNumberNational": "4085550101",
    "CleansedPhoneNumberE164": "14085550101",
    "Carrier": "AnyCompany",
    "PhoneTypeCode": 1,
    "PhoneType": "LANDLINE",
    "OriginalPhoneNumber": "+14085550101"
}

유효한 VoIP 전화 번호

요청에 유효한 Voice over Internet Protocol(VoIP) 전화 번호가 포함되어 있으면 전화 번호 확인 서비스에서 다음 예제와 유사한 정보를 반환합니다.


{
    "NumberValidateResponse": {
        "Carrier": "ExampleCorp",
        "City": "Countrywide",
        "CleansedPhoneNumberE164": "+441514960001",
        "CleansedPhoneNumberNational": "1514960001",
        "Country": "United Kingdom",
        "CountryCodeIso2": "GB",
        "CountryCodeNumeric": "44",
        "OriginalPhoneNumber": "+441514960001",
        "PhoneType": "VOIP",
        "PhoneTypeCode": 2
    }
}

잘못된 전화 번호

요청에 잘못된 전화 번호가 포함되어 있으면 전화 번호 확인 서비스에서 다음 예제와 유사한 정보를 반환합니다.


{
    "NumberValidateResponse": {
        "CleansedPhoneNumberE164": "+44163296076",
        "CleansedPhoneNumberNational": "163296076",
        "Country": "United Kingdom",
        "CountryCodeIso2": "GB",
        "CountryCodeNumeric": "44",
        "OriginalPhoneNumber": "+440163296076",
        "PhoneType": "INVALID",
        "PhoneTypeCode": 3
    }
}

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

기타 전화 번호

전화 번호 확인 서비스의 응답에 PhoneType 값 OTHER가 포함되는 경우가 있습니다. 이 서비스는 다음과 같은 상황에서 이러한 종류의 응답을 반환할 수 있습니다.

전화 번호가 수신자 부담 전화 번호인 경우
전화 번호가 555로 시작하는 북미 전화 번호와 같이 TV 프로그램 및 영화에 사용하도록 예약된 번호인 경우
전화 번호에 북미 지역의 999 지역 번호와 같이 현재 사용되지 않는 지역 번호가 포함된 경우
전화 번호가 다른 용도로 예약되어 있는 경우

다음 예는 요청에 북미 지역의 가상 전화 번호가 포함되어 있을 때 전화 번호 확인 서비스에서 제공하는 응답을 보여줍니다.


{
    "NumberValidateResponse": {
        "Carrier": "Multiple OCN Listing",
        "CleansedPhoneNumberE164": "+14255550199",
        "CleansedPhoneNumberNational": "4255550199",
        "Country": "United States",
        "CountryCodeIso2": "US",
        "CountryCodeNumeric": "1",
        "OriginalPhoneNumber": "+14255550199",
        "PhoneType": "OTHER",
        "PhoneTypeCode": 4,
        "Timezone": "America/Los_Angeles"
    }
}

선불 전화번호

요청에 유효한 선불 전화번호가 포함되어 있으면 전화번호 확인 서비스에서 다음 예시와 유사한 정보를 반환합니다.


{
    "NumberValidateResponse": {
        "Carrier": "ExampleCorp",
        "City": "Countrywide",
        "CleansedPhoneNumberE164": "+14255550199",
        "CleansedPhoneNumberNational": "4255550199",
        "Country": "United States",
        "CountryCodeIso2": "US",
        "CountryCodeNumeric": "1",
        "OriginalPhoneNumber": "+14255550199",
        "PhoneType": "PREPAID",
        "PhoneTypeCode": 5
    }
}

이러한 응답에 포함된 정보에 대한 자세한 내용은 Amazon Pinpoint API 참조의 전화번호 확인을 참조하세요.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

인앱 메시지 전송 및 검색

메시지 전송