申请电话号码

使用 Amazon Pinpoint 短信控制台，我们将根据您的用例推荐以下来源身份之一。建议基于您的输入标准，包括您是否需要短信、彩信和/或语音功能、双向号码以及估计每月的消息。

注意

必须在 Support Center 控制台中申请以下电话号码类型。

短码 —如何请求短码进行消息传递.
长码 —请求专用的长码进行消息传递.

您可以使用 Amazon Pinpoint 短信控制台或 AWS CLI 申请新的电话号码。

Request a phone number (Console)

重要

要通过 Pinpoint SMS 控制台申请美国的新电话号码，请按照 “申请美国电话号码（控制台）” 选项卡中的说明进行操作。

要使用 Amazon Pinpoint SMS 控制台申请电话号码，请按照以下步骤操作：

申请电话号码（控制台）

打开 Amazon Pinpoint SMS 控制台，网址为：https://console.aws.amazon.com/sms-voice/。
在导航窗格的配置下，选择电话号码，然后选择申请发起方。
在 “选择国家/地区” 页面上，您必须从下拉列表中选择要发送消息的目的地国家/地区。选择下一步。
在消息收发应用场景部分，执行以下操作：
- 在 “数字权能” 下，选择可用功能的任意组合：
  
  重要
  购买电话号码后，无法更改短信、彩信和语音功能。
  - 短信 (SMS) 如果您需要短信功能，请选择此选项。
  - 短信和媒体消息（短信、彩信）— 如果您需要短信和/或彩信功能，请选择此选项。
    
    注意
    彩信功能仅在某些国家/地区提供，并且仅在某些来源类型上受支持。仅当@@ 消息目标国家/地区支持彩信时，才会显示短信和媒体消息（短信、彩信）。有关更多信息，请参阅支持彩信的国家和地区和选择电话号码或发件人 ID。
  - 文字转音频消息（语音）-如果您需要语音功能，请选择此选项。
- 在 “预计每月消息量（可选）” 下，选择每月将发送的 SMS 消息的预计数量。
- 对于公司总部-可选，请选择以下任一选项：
  - 本@@ 地 — 如果贵公司的总部与要恢复短信的客户位于同一个国家，请选择此选项。例如，如果您的总部位于美国，而接收消息的用户也在美国，则可以选择此选项。
  - 国际 — 如果贵公司的总部与需要恢复短信的客户不在同一个国家，请选择此选项。
- 对于双向消息，如果您需要双向消息，请选择 “是”。
选择下一步。
在 “选择发起人类型” 下，选择推荐的电话号码类型或可用的号码类型之一。可用选项基于您在前面步骤中填写的用例信息。
- 如果您选择了 10DLC 并且已经有注册的战役，则可以从 “关联人到已注册” 活动中选择该活动，将 10DLC 的电话号码添加到 10DLC 战役中。
- 如果您想要的号码类型不可用，则可以选择 Pre v ious 返回并修改您的用例。另请选中支持短信的国家和地区，确保目标国家/地区支持您想要的发件人类型。
- 如果您想申请短代码或长代码，则需要使用开箱 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 战役报名表

消息功能（短信、彩信或语音）在 10DLC 注册活动中指定，并应用于您的 10DLC 电话号码申请。

申请美国的电话号码（控制台）

打开 Amazon Pinpoint SMS 控制台，网址为：https://console.aws.amazon.com/sms-voice/。
在导航窗格的配置下，选择电话号码，然后选择申请发起方。
在选择国家/地区页面上，您必须从消息目的地国家/地区下拉列表中选择美国（US）。选择下一步。
在消息收发应用场景部分，执行以下操作：
- 在 “预计每月消息量（可选）” 下，选择每月将发送的 SMS 消息的预计数量。
- 对于公司总部-可选，请选择以下任一选项：
  - 本@@ 地 — 如果贵公司的总部与要恢复短信的客户位于同一个国家，请选择此选项。例如，如果您的总部位于美国，而接收消息的用户也在美国，则可以选择此选项。
  - 国际 — 如果贵公司的总部与需要恢复短信的客户不在同一个国家，请选择此选项。
- 对于双向消息，如果您需要双向消息，请选择 “是”。
选择下一步。
在 Originator 类型下，选择推荐的电话号码类型或可用的号码类型之一。可用选项基于您在前面步骤中填写的用例信息。
- 要获得 10DLC 的电话号码，你必须选择注册的品牌和注册的广告系列才能与 10DLC 的电话号码请求相关联。
  - 使用关联注册品牌来选择品牌。
  - 使用 “关联注册广告系列” 来选择广告活动。
- 如果您想申请短代码或长代码，则需要使用开箱 AWS Support。有关更多信息，请参阅如何请求短码进行消息传递和请求专用的长码进行消息传递。
选择下一步。
在查看和请求中，您可以在提交请求之前对其进行验证和编辑。选择请求。
根据您请求的电话号码类型，可能会出现 “需要注册” 窗口。您的电话号码或发件人 ID 与此注册相关联，并且在您的注册获得批准之前无法发送消息。有关注册要求的更多信息，请参阅注册。
1. 对于注册表单名称，请输入一个友好名称。
2. 选择开始注册以完成电话号码的注册，或者选择稍后注册。
  
  重要
  在您的注册获得批准之前，您的电话号码或发件人 ID 无法发送消息。
  无论注册状态如何，您仍然需要支付该电话号码的每月定期租赁费。有关注册要求的更多信息，请参阅注册。

Request a phone number (AWS CLI)

您可以使用该request-phone-number命令向您的帐户添加新的电话号码。电话号码的可用性和支持的功能因国家/地区而异。

重要

完成请求后，您可能需要注册电话号码或发件人 ID。无论注册状态如何，您仍然需要支付该电话号码的每月定期租赁费。有关注册要求的更多信息，请参阅注册。

彩信功能仅在某些国家/地区可用。有关短信和彩信支持的国家/地区的更多信息，请参阅支持短信的国家和地区和。支持彩信的国家和地区

请求电话号码

在命令行输入以下命令：
```
$ 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 替换为电话号码所在国家/地区的双字母 ISO-3166 alpha-2 代码（例如，CA 代表加拿大）。
- 如果您想使用电话号码发送促销或营销相关的内容，请将 TRANSACTIONAL 替换为 PROMOTIONAL。否则，请使用 TRANSACTIONAL。
- 如果您想请求用于发送短信的电话号码，请将 VOICE 替换为 SMS。您可以通过指定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 短信控制台。有关 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 更改该电话号码的设置或启用其他功能。您可以更改多个电话号码设置，包括与电话号码关联的池和选择退出列表以及删除保护设置。

您可以通过更新电话号码来启用的额外功能的一个例子是双向消息。是否支持双向消息功能因国家/地区而异。有关支持的国家/地区的列表，请参阅支持短信的国家和地区。


$ 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 示例替换为您要更新的电话号码的 PhoneNumber ID 或亚马逊资源名称 (ARN)。您可以使用 DescribePhoneNumbers操作找到这两个值。
将optOutList姓名替换为您要与此电话号码关联的选择退出列表的名称。
如果要禁用删除保护功能，请将 DeletionProtectionEnabled 参数的值改为 false。
如果您想要自行管理短信退出功能，请将参数的值更改为。SelfManagedOptOutsEnabled false
如果要禁用此电话号码的双向短信，请将TwoWayEnabled参数的值更改为false。
如果您为电话号码启用双向消息功能，则必须指定 Amazon SNS 主题的 ARN。将 arn: aws: sns: us-east-1:111122223333: 替换为你要使用的亚马逊 SNS 主题MyTopic的 ARN。当您收到传入消息时，这些消息将发送到您指定的主题。

PhoneNumberId 参数是此命令唯一必需参数。如果您不想更改相应的设置，则可以忽略任何其他参数。

List phone numbers (AWS CLI)

您可以使用describe-phone-numbers来获取有关您的 Amazon Pinpoint 账户中的发起电话号码的更多信息。

要列出您账户中的所有电话号码，请使用 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-d2b0f5dd4fd4fdb14ebdb2a3b9128 示例替换为您要查看更多信息的电话号码的 PhoneNumber ID 或亚马逊资源名称 (ARN)。

您也可以使用 filter 参数根据您定义的条件筛选电话号码列表。例如，您可以按电话号码所在的国家/地区或其功能（即它是否支持短信、彩信、语音留言还是全部）进行筛选。

要查看经过筛选的电话号码列表，请使用 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 – 电话号码所在国家/地区的双字符 ISO-3166 alpha-2 代码。
message-type – 使用电话号码发送的消息的类型。可能的值为 TRANSACTIONAL 或 PROMOTIONAL。
number-capability – 电话号码支持的消息渠道。可能的值为 SMS、MMS 和 VOICE。
number-type— 电话号码的类型，例如LONG_CODESHORT_CODE、或TOLL_FREE。
two-way-enabled – 一个布尔值，表示是否启用了双向短信消息。
self-managed-opt-outs-enabled – 一个布尔值，表示是否启用了自我管理的短信选择退出。
opt-out-list-name – 与电话号码关联的选择退出列表的名称。
deletion-protection-enabled – 一个布尔值，表示是否可以使用 DeletePhoneNumber 操作删除电话号码。

主题

电话号码状态和功能

本节介绍如何检查您的电话号码的状态和功能。

电话号码状态

打开 Amazon Pinpoint SMS 控制台，网址为：https://console.aws.amazon.com/sms-voice/。
在导航窗格的配置下，选择电话号码。
下图显示了电话号码状态的各个部分。
- 起始号码-客户在手机上看到的数字。
- 来源类型-起始编号的类型。这可以是长代码、短代码或免费电话。
- 国家-提供来源编号的国家或地区。
- 号码状态-原始号码的状态。这可以是Pending，Active或Action required。
- 权能-起始编号的功能。这可以是SMSMMS、或的组合Voice。
- 池 — 与原始号码关联的矿池（如果有）。
- 创建日期-请求原始编号的时间。
首次购买电话号码时，该电话号码的号码状态为PENDING。当电话号码准备好使用时，电话号码的状态为ACTIVE。如果电话号码需要注册，则必须先完成注册，然后才能将电话号码的号码状态更改为ACTIVE。

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

支持语音的国家和地区

请求短代码