기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 통신 사업자 조회 서비스 사용
AWS End User Messaging SMS에는 전화번호가 유효한지 여부를 포함하여 전화번호에 대한 정보를 얻는 데 사용할 수 있는 통신 사업자 조회 서비스가 포함되어 있습니다. 통신 사업자 조회 서비스는 전화번호에 대해 다음 정보를 반환합니다.
+ E164 형식의 전화번호입니다(원본 입력에서 삭제됨).
+ 전화번호 유형(예: 유효하지 않음, 유선 전화, 휴대폰, 기타).
+ 전화번호의 국가 또는 리전 이름입니다.
+ 전화번호의 국가 또는 리전 숫자 다이얼링 코드입니다.
+ 전화번호에 대한 ISO 3166-1 alpha-2 형식의 2자 국가 또는 리전 코드입니다.
+ 휴대폰 번호의 경우 모바일 국가 코드(MCC).
+ 휴대폰 번호의 경우 모바일 네트워크 코드(MNC).
+ 전화번호가 현재 등록된 통신 사업자 또는 서비스 공급자입니다. 일부 국가 및 리전에서이 값은 전화번호가 원래 등록된 통신 사업자 또는 서비스 공급자일 수 있습니다.
통신 사업자 조회 서비스 사용 시 추가 요금이 부과됩니다. 자세한 내용은 [AWS End User Messaging SMS 요금을](https://aws.amazon.com/end-user-messaging/pricing/#Phone_number_validate) 참조하세요.
## 통신 사업자 조회 사용 사례
통신 사업자 조회 서비스를 사용하여 다음을 포함한 여러 사용 사례를 활성화할 수 있습니다.
+ **웹 양식에 제공된 전화번호 조회** - 웹 기반 양식을 사용하여 고객의 연락처 정보를 수집하는 경우 양식을 제출하기 전에 고객이 제공하는 전화번호를 조회할 수 있습니다. 웹 사이트의 백엔드를 사용하여 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](https://docs.aws.amazon.com/pinpoint/latest/apireference_smsvoicev2/API_CarrierLookup.html) 또는 AWS CLI 명령 참조의 [carrier-lookup](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/carrier-lookup.html)을 참조하세요.
**통신 사업자 조회 서비스(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`이며 해당 전화 번호와 연결된 이동 통신사 또는 위치에 대한 정보를 포함하지 않음을 나타냅니다. `PhoneNumberType`이 `INVALID`인 전화 번호는 실제 수신자에게 속하지 않는 것이므로 이 번호로 SMS 또는 음성 메시지를 보내지 마세요.
**기타 전화 번호**
휴대폰, 유선전화 또는 유효하지 않은 것으로 분류되지 않은 전화번호는 `PhoneNumberType` 값으로 반환됩니다`OTHER`.