**지원 종료 알림:** 2026년 10월 30일에 Amazon Pinpoint에 대한 지원이 AWS 종료됩니다. 2026년 10월 30일 이후에는 Amazon Pinpoint 콘솔 또는 Amazon Pinpoint 리소스(엔드포인트, 세그먼트, 캠페인, 여정, 분석)에 더 이상 액세스할 수 없습니다. 자세한 내용은 [Amazon Pinpoint 지원 종료](https://docs.aws.amazon.com/console/pinpoint/migration-guide)를 참조하세요. **참고:** SMS, 음성, 모바일 푸시, OTP 및 전화번호 검증과 관련된 APIs는이 변경의 영향을 받지 않으며 AWS 최종 사용자 메시징에서 지원됩니다.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon Pinpoint 전화번호 검증 서비스 사용
Amazon Pinpoint에는 전화 번호가 유효한지 확인하고 전화 번호 자체에 대한 추가 정보를 얻는 데 사용할 수 있는 전화 번호 확인 서비스가 포함되어 있습니다. 예를 들어 전화 번호 확인 서비스를 사용하면 다음 정보가 반환됩니다.
+ E.164 형식의 전화 번호
+ 전화 번호 유형(예: 모바일, 유선 또는 VoIP)
+ 해당 전화 번호의 도시 및 국가
+ 전화 번호와 관련된 서비스 공급업체
전화 번호 확인 서비스 사용 시에는 추가 요금이 부과됩니다. 자세한 내용은 [Amazon Pinpoint 요금](https://aws.amazon.com/pinpoint/pricing/#Phone_Number_Validate)을 참조하세요.
**중요**
미국 및 캐나다에서 발신하는 전화번호의 경우 전화번호 확인 API는 더 이상 `City`, `County`, `Timezone` 및 `ZipCode`에 대한 데이터를 반환하지 않습니다.
## Amazon Pinpoint 전화번호 검증 사용 사례
전화 번호 확인 서비스를 사용하여 다음을 비롯한 여러 사용 사례를 활성화할 수 있습니다.
+ **웹 양식에 제공된 전화번호 확인** - 웹 기반 양식을 사용하여 고객의 연락처 정보를 수집하는 경우 양식을 제출하기 전에 고객이 제공한 전화 번호를 확인합니다. 웹 사이트의 백엔드를 활용하여 Amazon Pinpoint API로 번호를 확인합니다. API 응답에는 번호가 유효하지 않은지 여부(예: 전화번호 형식이 잘못된 경우)가 표시됩니다. 고객이 제공한 전화 번호가 유효하지 않다고 판단되면 웹 양식에서 고객에게 다른 번호를 제공하라는 메시지를 표시할 수 있습니다.
+ **기존 연락처 데이터베이스 정리** - 고객 전화 번호 데이터베이스가 있는 경우 각 전화 번호를 확인하고 결과를 기반으로 데이터베이스를 업데이트할 수 있습니다. 예를 들어, SMS 메시지를 수신할 수 없는 전화 번호가 있는 엔드포인트를 찾은 경우 엔드포인트의 `ChannelType` 속성을 `SMS`에서 `VOICE`로 변경할 수 있습니다. 먼저 전화번호를 확인한 다음 단일 엔드포인트의 [Amazon Pinpoint에 엔드포인트 추가](audience-define-endpoints.md) 또는 여러 엔드포인트의 [Amazon Pinpoint에 엔드포인트 배치 추가](audience-define-endpoints-batch.md) 내 지침에 따라 새 엔드포인트 또는 기존 엔드포인트의 `ChannelType` 속성을 업데이트할 수 있습니다.
+ **메시지를 전송하기 전에 올바른 채널 선택** - SMS 메시지를 전송하려고 하는데 대상 번호가 유효하지 않다고 판단된 경우, 다른 채널을 통해 수신자에게 메시지를 전송할 수 있습니다. 예를 들어, 엔드포인트가 SMS 메시지를 수신할 수 없는 경우 대신 음성 메시지를 전송할 수 있습니다.
## 를 사용하여 전화번호 확인 AWS CLI
다음 예제에서는 AWS CLI를 사용하여 전화번호를 검증하는 방법을 보여줍니다. 자세한 내용은 *AWS CLI 명령 참조*의 [phone-number-validate](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/phone-number-validate.html)를 참조하세요. 예제 검증 응답은 [전화 번호 검증 응답](#validate-phone-numbers-example-responses) 섹션을 참조하세요. 구성에 대한 자세한 내용은 [AWS Command Line Interface 사용 설명서](https://docs.aws.amazon.com/cli/latest/userguide/)[의 구성을 AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) AWS CLI참조하세요.
**를 사용하여 전화번호 확인 서비스를 사용하려면 AWS CLI**
+ 명령줄에 다음 명령을 입력합니다.
```
aws pinpoint phone-number-validate --number-validate-request PhoneNumber={{+442079460881}},IsoCountryCode={{GB}}
```
앞의 명령에서 {{\+442079460881}}을 검증하려는 전화번호로 바꾸고 {{GB}}를 두 자리 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 참조*의 [전화번호 확인](https://docs.aws.amazon.com/pinpoint/latest/apireference/phone-number-validate.html)을 참조하세요.