전화번호 요청

Amazon Pinpoint SMS 콘솔을 사용하면 사용 사례에 따라 아래 원본 ID 중 하나를 사용하는 것이 좋습니다. 권장 사항은 SMS, MMS 및/또는 음성 기능이 필요한지 여부, 양방향 번호, 월별 예상 메시지 수 등 입력 기준을 기반으로 합니다.

참고

Support Center 콘솔에서 다음 전화번호 유형을 요청해야 합니다.

단축 코드 —메시징용 단축 코드 요청 방법.
긴 코드 —메시지 전용 긴 코드 요청.

Amazon Pinpoint SMS AWS CLI 콘솔을 사용하거나 새 전화번호를 요청할 수 있습니다.

Request a phone number (Console)

중요

Pinpoint SMS 콘솔을 통해 미국의 새 전화번호를 요청하려면 미국 전화번호 요청 (콘솔) 탭의 지침을 따르십시오.

Amazon Pinpoint SMS 콘솔을 사용해 전화번호를 요청하려면 다음 단계를 따르십시오.

전화번호 요청(콘솔)

https://console.aws.amazon.com/sms-voice/에서 Amazon Pinpoint SMS 콘솔을 엽니다.
탐색 창의 구성에서 전화번호를 선택한 다음 발신자 요청을 선택합니다.
국가 선택 페이지의 드롭다운에서 메시지를 보낼 메시지 수신 국가를 선택해야 합니다. 다음을 선택합니다.
메시징 사용 사례 섹션에서 다음을 수행합니다.
- 번호 기능에서 사용 가능한 기능 중 원하는 조합을 선택합니다.
  
  중요
  전화번호를 구매한 후에는 SMS, MMS 및 음성 기능을 변경할 수 없습니다.
  - 문자 메시지 (SMS) SMS 기능이 필요한 경우 이 옵션을 선택하십시오.
  - 문자 및 미디어 메시지 (SMS, MMS) - SMS 및/또는 MMS 기능이 필요한 경우 이 옵션을 선택합니다.
    
    참고
    MMS 기능은 특정 국가에서만 사용할 수 있으며 특정 출처 유형에서만 지원됩니다. 문자 및 미디어 메시지 (SMS, MMS) 는 메시지 대상 국가에서 MMS가 지원되는 경우에만 제공됩니다. 자세한 내용은 MMS 메시징이 지원되는 국가 및 지역 및 전화번호 또는 발신자 ID 선택 섹션을 참조하세요.
  - 문자-음성 메시지 (음성) — 음성 기능이 필요한 경우 이 옵션을 선택합니다.
- 월간 예상 메시지 양 — 선택 사항에서 매월 전송할 예상 SMS 메시지 수를 선택합니다.
- 회사 본사 - 선택 사항의 경우 다음 중 하나를 선택하십시오.
  - 현지 — 회사 본사가 SMS 메시지를 다시 수신할 고객과 같은 국가에 있는 경우 이 옵션을 선택합니다. 예를 들어 본사는 미국에 있고 메시지를 수신할 사용자도 미국에 있는 경우 이 옵션을 선택합니다.
  - 해외 — 회사 본사가 SMS 메시지를 다시 수신할 고객과 같은 국가에 있지 않은 경우 이 옵션을 선택하십시오.
- 양방향 메시징의 경우 양방향 메시징이 필요한 경우 [예] 를 선택합니다.
다음을 선택합니다.
발신자 유형 선택에서 권장 전화번호 유형 또는 사용 가능한 번호 유형 중 하나를 선택합니다. 사용 가능한 옵션은 이전 단계에서 입력한 사용 사례 정보를 기반으로 합니다.
- 10DLC를 선택하고 이미 등록된 캠페인이 있는 경우 등록 대상 등록 캠페인에서 캠페인을 선택하여 10DLC 캠페인에 10DLC 전화번호를 추가할 수 있습니다.
- 원하는 번호 유형을 사용할 수 없는 경우 이전을 선택하여 돌아가서 사용 사례를 수정할 수 있습니다. 또한 원하는 발신자 유형이 대상 국가에서 지원되는지 확인하십시오. SMS 메시징이 지원되는 국가 및 지역
- 단축 코드나 긴 코드를 요청하려면 함께 AWS Support케이스를 열어야 합니다. 자세한 내용은 메시징용 단축 코드 요청 방법 및 메시지 전용 긴 코드 요청 섹션을 참조하세요.
다음을 선택합니다.
검토 및 요청에서 제출 전에 요청을 확인하고 편집할 수 있습니다. 요청을 선택합니다.
요청한 전화번호 유형에 따라 등록 필요 창이 나타날 수 있습니다. 전화번호 또는 발신자 ID는 이 등록과 연결되어 있으며 등록이 승인되기 전까지는 메시지를 보낼 수 없습니다. 등록 요건에 대한 자세한 내용은 을 참조하십시오. 등록
1. 등록 양식 이름에는 친숙한 이름을 입력하십시오.
2. 등록 시작을 선택하여 전화번호 등록을 완료하거나 나중에 등록을 선택합니다.
  
  중요
  등록이 승인되기 전까지는 전화번호 또는 발신자 ID로 메시지를 보낼 수 없습니다.
  등록 상태와 관계없이 전화번호에 대한 월 임대료는 계속 청구됩니다. 등록 요건에 대한 자세한 내용은 을 참조하십시오. 등록

Request a phone number for the United States (Console)

중요

Pinpoint SMS 콘솔을 통해 미국의 새 전화번호를 요청하려면 다음 지침을 따르십시오.

10DLC 전화번호를 요청하기 전에 승인된 10DLC 등록 브랜드와 10DLC 전화번호와 연결할 수 있는 10DLC 등록 캠페인이 있어야 합니다. 10DLC 등록 브랜드 및 10DLC 등록 캠페인 등록에 대한 자세한 내용은 및 을 참조하십시오. 10DLC 브랜드 등록 양식 10DLC 캠페인 등록 양식

메시징 기능 (SMS, MMS 또는 음성) 은 10DLC 등록 캠페인에 지정되며 10DLC 전화번호 요청에 적용됩니다.

미국 전화번호 요청 (콘솔)

https://console.aws.amazon.com/sms-voice/에서 Amazon Pinpoint SMS 콘솔을 엽니다.
탐색 창의 구성에서 전화번호를 선택한 다음 발신자 요청을 선택합니다.
국가 선택 페이지의 메시지 수신 국가 드롭다운에서 미국 (미국) 을 선택해야 합니다. 다음을 선택합니다.
메시징 사용 사례 섹션에서 다음을 수행합니다.
- 월간 예상 메시지 양 — 선택 사항에서 매월 보낼 예상 SMS 메시지 수를 선택합니다.
- 회사 본사 - 선택 사항의 경우 다음 중 하나를 선택하십시오.
  - 현지 — 회사 본사가 SMS 메시지를 다시 수신할 고객과 같은 국가에 있는 경우 이 옵션을 선택합니다. 예를 들어 본사는 미국에 있고 메시지를 수신할 사용자도 미국에 있는 경우 이 옵션을 선택합니다.
  - 해외 — 회사 본사가 SMS 메시지를 다시 수신할 고객과 같은 국가에 있지 않은 경우 이 옵션을 선택하십시오.
- 양방향 메시징의 경우 양방향 메시징이 필요한 경우 [예] 를 선택합니다.
다음을 선택합니다.
발신자 유형에서 권장 전화번호 유형이나 사용 가능한 번호 유형 중 하나를 선택합니다. 사용 가능한 옵션은 이전 단계에서 입력한 사용 사례 정보를 기반으로 합니다.
- 10DLC 전화번호의 경우 10DLC 전화번호 요청과 연계할 등록된 브랜드와 등록된 캠페인을 선택해야 합니다.
  - 등록 브랜드에 연결을 사용하여 브랜드를 선택합니다.
  - 등록된 캠페인에 연결을 사용하여 캠페인을 선택합니다.
- 단축 코드나 긴 코드를 요청하려면 케이스를 열어야 AWS Support합니다. 자세한 내용은 메시징용 단축 코드 요청 방법 및 메시지 전용 긴 코드 요청 섹션을 참조하세요.
다음을 선택합니다.
검토 및 요청에서 제출 전에 요청을 확인하고 편집할 수 있습니다. 요청을 선택합니다.
요청한 전화번호 유형에 따라 등록 필요 창이 나타날 수 있습니다. 전화번호 또는 발신자 ID는 이 등록과 연결되어 있으며 등록이 승인되기 전까지는 메시지를 보낼 수 없습니다. 등록 요건에 대한 자세한 내용은 을 참조하십시오. 등록
1. 등록 양식 이름에는 친숙한 이름을 입력하십시오.
2. 등록 시작을 선택하여 전화번호 등록을 완료하거나 나중에 등록을 선택합니다.
  
  중요
  등록이 승인되기 전까지는 전화번호 또는 발신자 ID로 메시지를 보낼 수 없습니다.
  등록 상태와 관계없이 전화번호에 대한 월 임대료는 계속 청구됩니다. 등록 요건에 대한 자세한 내용은 을 참조하십시오. 등록

Request a phone number (AWS CLI)

request-phone-number명령을 사용하여 계정에 새 전화번호를 추가할 수 있습니다. 전화번호 사용 가능 여부 및 지원되는 기능은 국가마다 다릅니다.

중요

요청을 완료한 후 전화번호 또는 발신자 ID를 등록해야 할 수 있습니다. 등록 상태와 관계없이 전화번호에 대한 월 임대료는 계속 청구됩니다. 등록 요건에 대한 자세한 내용은 을 참조하십시오. 등록

MMS 기능은 일부 국가에서만 사용할 수 있습니다. SMS 및 MMS 지원 국가에 대한 자세한 내용은 및 을 참조하십시오SMS 메시징이 지원되는 국가 및 지역. MMS 메시징이 지원되는 국가 및 지역

전화번호를 요청하려면

명령줄에 다음 명령을 입력합니다.
```
$ aws pinpoint-sms-voice-v2 request-phone-number \
> --iso-country-code XX \
> --message-type TRANSACTIONAL \
> --number-capabilities VOICE \
> --number-type LONG_CODE \
> --pool-id poolId \
> --deletion-protection-enabled \
> --opt-out-list-name optOutListName \
> --registration-id CO123EX
```
위의 명령에서 다음과 같이 변경하세요.
- XX를 전화번호 국가의 2자리 ISO-3166 alpha-2 코드(예: 캐나다의 경우 CA)로 바꿉니다.
- 전화번호를 사용하여 프로모션 또는 마케팅 관련 콘텐츠를 전송하려면 TRANSACTIONAL을 PROMOTIONAL으로 바꿉니다. 그렇지 않은 경우 TRANSACTIONAL을 사용합니다.
- SMS 메시지 전송을 위한 전화번호를 요청하려면 VOICE를 SMS로 바꿉니다. 를 지정하여 SMS, MMS 및 음성 메시지 기능이 있는 전화번호를 요청할 수 있습니다. SMS MMS VOICE
- LONG_CODE를 요청하려는 전화번호 유형으로 바꿉니다. 사용 가능한 값은 LONG_CODE, TOLL_FREE 및 TEN_DLC입니다.
- poolId를 전화번호를 추가하려는 풀의 ID 또는 Amazon 리소스 이름(ARN)으로 바꿉니다. 이 파라미터는 선택 사항입니다. 전화번호를 풀에 추가하고 싶지 않다면 이 파라미터를 생략합니다.
- 이 전화번호에 대해 삭제 방지를 활성화하려면 --deletion-protection-enabled 매개변수를 추가하십시오. 삭제 방지 기능은 기본적으로 비활성화됩니다. 삭제 방지가 활성화된 경우 이 기능을 비활성화하도록 전화번호 구성을 업데이트하지 않는 한 ReleasePhoneNumberAPI를 사용하여 전화번호를 삭제할 수 없습니다.
- optOutList이름을 전화번호와 연결하려는 옵트아웃 목록의 이름 또는 ARN으로 대체합니다. 이 파라미터는 선택 사항입니다. 전화번호를 옵트아웃 목록과 연결하지 않으려면 이 파라미터를 생략합니다.
- 10DLC 캠페인에 사용할 전화번호를 요청하는 경우, CO123EX를 사용하려는 10DLC 캠페인의 ID로 바꿉니다.
  
  참고
  10DLC 전화번호를 사용하려면 먼저 회사와 캠페인을 등록해야 합니다. 현재 이러한 등록 프로세스를 완료하는 유일한 방법은 Amazon Pinpoint SMS 콘솔을 사용하는 것입니다. 10DLC 등록에 대한 자세한 내용은 을 참조하십시오. 10DLC 등록 프로세스

전화번호가 계정에 성공적으로 추가되면 다음과 같은 출력이 표시됩니다.


{
    "PhoneNumberArn": "arn:aws:sms-voice:us-east-1:111122223333:phone-number/phone-615790209ea34aea8da9b729fexample",
    "PhoneNumberId": "phone-615790209ea34aea8da9b729fexample",
    "PhoneNumber": "+12045550123",
    "Status": "PENDING",
    "IsoCountryCode": "CA",
    "MessageType": "TRANSACTIONAL",
    "NumberCapabilities": [
        "SMS"
    ],
    "NumberType": "LONG_CODE",
    "MonthlyLeasingPrice": "1.00",
    "TwoWayEnabled": false,
    "SelfManagedOptOutsEnabled": false,
    "OptOutListName": "Default",
    "DeletionProtectionEnabled": false,
    "CreatedTimestamp": 1645568542.0
}

참고

전화번호를 처음 구매할 때 Status 속성의 값은 PENDING입니다. 전화번호를 사용할 준비가 되면 Status 값이 ACTIVE로 변경됩니다.

지정한 파라미터를 충족하는 전화번호를 사용할 수 없는 경우 오류가 발생하여 요청이 실패합니다.

Modify phone number capabilities (AWS CLI)

전화 번호를 요청한 후 update-phone-numberCLI를 사용하여 해당 전화 번호의 설정을 변경하거나 추가 기능을 활성화할 수 있습니다. 전화번호와 연결된 풀 및 옵트아웃 목록, 삭제 방지 설정을 비롯한 여러 전화번호 설정을 변경할 수 있습니다.

전화번호를 업데이트하여 활성화할 수 있는 추가 기능의 예로는 양방향 메시징이 있습니다. 양방향 메시징에 대한 지원은 메시지를 보내려는 국가에 따라 다릅니다. 지원되는 국가 목록은 을 참조하십시오SMS 메시징이 지원되는 국가 및 지역.


$ aws pinpoint-sms-voice-v2 update-phone-number \
> --phone-number-id phone-d2b0f5dd4fd14ebdb2a3b9128example \
> --deletion-protection-enabled true \
> --opt-out-list-name optOutListName \ 
> --self-managed-opt-outs-enabled true \
> --two-way-enabled true \
> --two-way-channel-arn arn:aws:sns:us-east-1:111122223333:MyTopic

위의 명령에서 다음을 수행합니다.

phone-d2b0f5dd4fd14ebdb2a3b9128예제를 업데이트하려는 전화번호의 ID 또는 아마존 리소스 이름 (ARN) 으로 바꾸십시오. PhoneNumber 작업을 사용하여 이 두 값을 모두 찾을 수 있습니다. DescribePhoneNumbers
optOutList이름을 이 전화번호와 연결하려는 옵트아웃 목록의 이름으로 바꾸십시오.
삭제 보호 기능을 비활성화하려면 DeletionProtectionEnabled 파라미터 값을 false로 변경합니다.
자체 관리형 SMS 옵트아웃 기능을 사용하려면 매개변수 값을 로 변경하십시오SelfManagedOptOutsEnabled. false
이 전화번호에 대한 양방향 SMS 메시징을 비활성화하려면 매개변수 값을 로 변경하십시오. TwoWayEnabled false
전화번호에 대해 양방향 메시징 기능을 활성화하는 경우 Amazon SNS 주제의 ARN을 지정해야 합니다. arn:aws:sns:us-east- 1:111122223333:를 사용하려는 아마존 SNS 주제의 MyTopic ARN으로 대체하십시오. 수신 메시지를 받으면 지정한 주제로 메시지가 전송됩니다.

PhoneNumberId 파라미터가 이 명령의 유일한 필수 파라미터입니다. 해당 설정을 변경하지 않으려면 다른 파라미터를 모두 생략할 수 있습니다.

List phone numbers (AWS CLI)

를 사용하여 Amazon Pinpoint 계정의 발신자 전화번호에 대한 자세한 정보를 얻을 수 있습니다. describe-phone-numbers

다음을 사용하여 계정의 모든 전화번호를 나열하려면 AWS CLI

명령줄에 다음 명령을 입력합니다.


$ aws pinpoint-sms-voice-v2 describe-phone-numbers

이 명령의 출력에는 계정의 모든 전화번호에 대한 세부 정보가 포함됩니다. PhoneNumberId 파라미터를 포함하여 특정 전화번호에 대한 정보를 볼 수도 있습니다.

를 사용하여 특정 전화번호에 대한 정보를 보려면 AWS CLI

명령줄에 다음 명령을 입력합니다.


$ aws pinpoint-sms-voice-v2 describe-phone-numbers \
>  --phone-number-id phone-d2b0f5dd4fd14ebdb2a3b9128example

위의 예에서 phone-d2b0f5dd4fd14ebdb2a3b9128예제를 추가 정보를 보려는 전화번호의 PhoneNumber ID 또는 Amazon 리소스 이름 (ARN) 으로 바꾸십시오.

filter 파라미터를 사용하여 정의한 기준에 따라 전화번호 목록을 필터링할 수도 있습니다. 예를 들어 전화번호의 국가 또는 전화번호 기능 (즉, SMS, MMS, 음성 메시지 또는 모두 지원 여부) 별로 필터링할 수 있습니다.

를 사용하여 필터링된 전화번호 목록을 보려면 AWS CLI

명령줄에 다음 명령을 입력합니다.


$ aws pinpoint-sms-voice-v2 describe-phone-numbers \
> --filters Name=number-capability,Values=SMS \
> --filters Name=iso-country-code,Values=CA

Name 필터는 다음 값 중 하나일 수 있습니다.

status - 전화 번호의 현재 상태, 예:ACTIVE.
iso-country-code - 전화번호 국가의 2자리 ISO-3166 alpha-2.
message-type - 전화번호를 사용하여 보내는 메시지 유형. 가능한 값은 TRANSACTIONAL 또는 PROMOTIONAL입니다.
number-capability - 전화번호가 지원하는 메시징 채널. 가능한 값은 SMS, MMS 및 VOICE입니다.
number-type— 전화번호 유형 (예: LONG_CODESHORT_CODE, 또는TOLL_FREE)
two-way-enabled - 양방향 SMS 메시징이 활성화되었는지 여부를 나타내는 부울.
self-managed-opt-outs-enabled - 자체 관리형 SMS 옵트아웃이 활성화되었는지 여부를 나타내는 부울.
opt-out-list-name - 전화번호와 연결된 옵트아웃 목록의 이름.
deletion-protection-enabled - DeletePhoneNumber 작업을 사용하여 전화 번호를 삭제할 수 있는지 여부를 나타내는 부울.

주제

전화번호 상태 및 기능

이 섹션에서는 전화번호의 상태 및 기능을 확인하는 방법을 설명합니다.

전화번호 상태

https://console.aws.amazon.com/sms-voice/에서 Amazon Pinpoint SMS 콘솔을 엽니다.
탐색 창의 구성에서 전화번호를 선택합니다.
다음 이미지는 전화번호 상태의 일부를 보여줍니다.
- 발신번호 — 고객이 핸드셋에 표시되는 숫자 번호입니다.
- 발신 유형 — 발신 번호의 유형입니다. 긴 코드, 단축 코드 또는 무료 전화번호일 수 있습니다.
- 국가 — 발신 번호가 제공되는 국가 또는 지역.
- 번호 상태 — 출발지 번호의 상태입니다. Active또는 Action required 일 Pending 수 있습니다.
- 기능 — 오리진 번호의 기능. SMSMMS, 또는 Voice 의 조합일 수 있습니다.
- 풀 — 오리진 번호와 연결된 풀 (있는 경우).
- 생성 날짜 — 오리진 번호가 요청된 시간.
전화번호를 처음 구매할 때 전화번호의 번호 상태는 입니다PENDING. 전화번호를 사용할 준비가 되면 전화번호 상태는 입니다ACTIVE. 전화번호에 등록이 필요한 경우 전화번호의 번호 상태가 로 변경되기 전에 등록을 완료해야 ACTIVE 합니다.

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

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

문서 규칙

음성 지원 국가 및 지역

단축 코드 요청