

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# AWS 最终用户消息 SMS 中的选择退出列表
<a name="opt-out-list"></a>

*选择退出列表*是不应向其发送消息的目标手机号码列表。当您发送 SMS 消息时，如果目标身份使用关键字 STOP 回复您的发起电话号码，则这些身份会自动添加到选择退出列表中（除非您启用了自行管理的选择退出选项）。如果您尝试向选择退出列表中的目标号码发送消息，并且选择退出列表与用于发送消息的电话号码相关联，则 AWS 最终用户消息 SMS 不会尝试发送消息。

如果电话号码位于选择退出列表中，则消息不会被发送，即使存在[允许该电话号码接收消息的覆盖设置](protect-rule-override.md#protect-rule-override.title)也不例外。必须将该电话号码从选择退出列表中删除，才能重新开始接收消息。

默认情况下，选择退出由自动管理。 AWS 您可以通过启用自行管理的选择退出来禁用这种自动退出方式。您的账户既可以包含由其管理选择退出的号码 AWS，也可以包含由您自己管理选择退出的号码。

**Topics**
+ [必要的选择退出列表关键字](opt-out-list-keywords.md)
+ [自行管理的选择退出](opt-out-list-self-managed.md)
+ [设置自行管理的选择退出](opt-out-list-managed.md)
+ [创建选择退出列表](opt-out-list-create.md)
+ [查看发起身份](opt-out-list-originators.md)
+ [查看选择退出列表的详细信息](opt-out-list-view.md)
+ [将目标电话号码添加到退出列表中。](opt-out-list-add-phone-number.md)
+ [搜索目标电话号码](opt-out-list-search.md)
+ [删除目标电话号码](opt-out-list-remove-phone-number.md)
+ [删除选择退出列表](opt-out-list-delete.md)
+ [管理选择退出列表的标签](opt-out-list-tags.md)
+ [列出共享选择退出列表](opt-out-list-shared.md)

# 必填 AWS 的最终用户消息 SMS 退出列表关键字
<a name="opt-out-list-keywords"></a>

如果当地法律和法规有要求（例如美国和加拿大），短信和彩信收件人可以使用自己的设备，通过向该消息回复以下内容来表示退出：
+ ARRET
+ CANCEL
+ END
+ OPT-OUT
+ OPTOUT
+ QUIT
+ REMOVE
+ STOP
+ TD
+ UNSUBSCRIBE

要选择退出，收件人必须回复与 AWS 最终用户消息 SMS 发送消息时使用的相同长代码或短代码。选择退出后，收件人将不再收到来自您 AWS 账户的短信或彩信。

**注意**  
对于美国免费电话号码，由运营商层面管理选择退出。对于美国免费电话号码，唯一支持的选择退出关键字是 STOP。您不能添加其他选择退出关键字，也不能更改收件人选择退出时收到的回复消息。

# 自行管理的选择退出
<a name="opt-out-list-self-managed"></a>

默认情况下，当客户向您的一个专用号码发送以 H *EL* *P 或 ST* OP 开头的消息时， AWS 最终用户消息 SMS 会自动回复一条可自定义的消息。对于收到的 STOP 消息，“ AWS 最终用户消息 SMS” 还允许客户选择不接收 future SMS 消息。如果您更喜欢使用 AWS 终端用户消息发送 SMS 服务之外的服务来管理 HELP 和 STOP 响应，可以启用自行管理的选择退出功能。

启用此功能后， AWS 最终用户消息 SMS 处理客户发送的传入消息的方式会发生三项变化。首先，它会停止向传入 HELP 和 STOP 消息发送自动响应。其次，当您的客户发送 STOP 消息时， AWS 最终用户消息 SMS 会自动停止选择不接收 future 短信和彩信。最后，它会将传入的 HELP 和 STOP 消息路由到您用于接收双向短信的 Amazon SNS 主题，而不是自动响应发件人。

如果您启用此功能，则您将负责响应 HELP 和 STOP 请求。您还负责跟踪和满足退出请求。

**重要**  
许多国家、地区和司法管辖区会对发送不必要的短信的行为给予严重处罚。如果您启用此功能，请确保您已部署用于捕获和管理退出请求的系统和流程。

**注意**  
要为某个池或电话号码启用自行管理的选择退出，您必须先启用双向短信传送。使用 Amazon Connect 发送双向短信时，不支持自行管理选择退出。有关使用 Amazon Connect 发送双向短信的更多信息，请参阅《Amazon Connect 管理员指南》**中的[设置短信收发](https://docs.aws.amazon.com/connect/latest/adminguide/setup-sms-messaging.html)。

# 在 “ AWS 最终用户消息 SMS” 中为电话池或电话号码设置自我管理的选择退出
<a name="opt-out-list-managed"></a>

如果您启用此功能，则您将负责响应 HELP 和 STOP 请求。您还负责跟踪和满足退出请求。

------
#### [ Turn on self managed opt-outs for a phone pool (Console) ]

1. 打开 AWS 最终用户消息 SMS 控制台，网址为[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/)。

1. 在导航窗格中的**配置**下，选择**电话池**。

1. 在**电话池**页面上，选择相应池。

1. 在**选择退出列表**选项卡上，选择**编辑设置**。

1. 在**选择退出管理**页面上，选择**启用自行管理的选择退出**，然后选择**保存更改**。

------
#### [ Turn on self managed opt-outs for a phone number (Console) ]

1. 打开 AWS 最终用户消息 SMS 控制台，网址为[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/)。

1. 在导航窗格中的**配置**下，选择**电话号码**。

1. 在**号码**页面上，选择所需电话号码。

1. 在**选择退出列表**选项卡上，选择**编辑设置**按钮。

1. 在**选择退出管理**页面上，选择**启用自行管理的选择退出**，然后选择**保存更改**。

------

# 在 “ AWS 最终用户消息 SMS” 中创建选择退出列表
<a name="opt-out-list-create"></a>

使用 AWS 最终用户消息 SMS 控制台或 AWS CLI 创建选择退出列表。

------
#### [ Create opt-out list (Console) ]

要使用 AWS 最终用户消息 SMS 控制台创建选择退出列表，请执行以下步骤：

1. 打开 AWS 最终用户消息 SMS 控制台，网址为[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/)。

1. 在导航窗格中的**配置**下，选择**选择退出列表**。

1. 在**选择退出列表**页面上，选择所需退出列表，然后选择**编辑**。

1. 在**列表详细信息**页面上，输入**列表名称**。

1. 选择**创建列表**。

------
#### [ Create opt-out list (AWS CLI) ]

在命令行输入以下命令：

```
$ aws pinpoint-sms-voice-v2 create-opt-out-list \
> --opt-out-list-name optOutListName
```

在前面的示例中，*optOutListName*替换为一个便于识别选择退出列表的名称。

------

# 在 “ AWS 最终用户消息 SMS” 中查看与选择退出列表相关的所有发起身份
<a name="opt-out-list-originators"></a>

您可以使用 AWS 最终用户消息 SMS 控制台查看链接到选择退出列表的所有发起身份，请按照以下步骤操作：

1. 打开 AWS 最终用户消息 SMS 控制台，网址为[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/)。

1. 在导航窗格中的**配置**下，选择**选择退出列表**。

1. 在**选择退出列表**页面上，选择一个选择退出列表。

1. 选择**关联的发起号码**可查看所有发起身份。

# 在 “ AWS 最终用户消息 SMS” 中查看选择退出列表的详细信息
<a name="opt-out-list-view"></a>

使用 AWS 最终用户消息 SMS 控制台或 AWS CLI 管理您的选择退出列表。

------
#### [ View opt-out list (Console) ]

要使用 AWS 最终用户消息 SMS 控制台查看选择退出列表，请执行以下步骤：

1. 打开 AWS 最终用户消息 SMS 控制台，网址为[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/)。

1. 在导航窗格中的**配置**下，选择**选择退出列表**。

1. 在**选择退出列表**页面上，选择一个选择退出列表并查看**选择退出列表的详细信息**。

------
#### [ Describe opt-out lists (AWS CLI) ]

您可以使用该[describe-opt-out-lists](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-opt-out-lists.html)命令查看有关 AWS 最终用户消息 SMS 帐户中的退出列表的信息。

**要查看有关您的所有选择退出列表的信息，请使用 AWS CLI**
+ 在命令行输入以下命令：

  ```
  $ aws pinpoint-sms-voice-v2 describe-opt-out-lists
  ```

您还可以使用 `OptOutListNames` 参数查看有关特定选择退出列表的信息。

**要查看有关特定退出列表的信息，请使用 AWS CLI**
+ 在命令行输入以下命令：

  ```
  $ aws pinpoint-sms-voice-v2 describe-opt-out-lists \
  > --opt-out-list-names optOutListName
  ```

  在前面的命令中，*optOutListName*替换为要查找更多信息的选择退出列表的名称或 Amazon 资源名称 (ARN)。您还可以通过用空格分隔每个列表名称来指定多个选择退出列表。

   AWS CLI 返回有关您账户中所有退出列表的以下信息。

------

# 将目标电话号码添加到 AWS 最终用户消息 SMS 的选择退出列表中
<a name="opt-out-list-add-phone-number"></a>

使用 AWS 最终用户消息 SMS 控制台或将目标电话号码 AWS CLI 添加到选择退出列表中。当您将电话号码添加到选择退出列表时，该电话号码将不再接收来自与选择退出列表关联的发起身份发送的消息。

------
#### [ Add a destination number (Console) ]

1. 打开 AWS 最终用户消息 SMS 控制台，网址为[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/)。

1. 在导航窗格中的**配置**下，选择**选择退出列表**。

1. 在**选择退出列表**页面上，选择一个选择退出列表。

1. 在**已选择退出的号码**选项卡上，选择**添加号码**。

1. 在**添加选择退出号码**页面上，在**目标号码**中输入要添加至选择退出列表的电话号码。电话号码必须采用 E.164 格式，例如 \$112065550150。

1. 选择**添加号码**

------
#### [ Add a destination number (AWS CLI) ]

您可以使用[put-opted-out-number](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/put-opted-out-number.html)命令将电话号码添加到选择退出列表中。

在命令行输入以下命令：

```
$ aws pinpoint-sms-voice-v2 put-opted-out-number \
> --opt-out-list-name optOutListName \
> --opted-out-number +12065550123
```

在前面的示例中，进行以下更改：
+ *optOutListName*替换为您想要添加目标身份的选择退出列表的名称或 Amazon 资源名称 (ARN)。
+ *\$112065550123*替换为要添加到选择退出列表中的电话号码。电话号码必须使用 E.164 格式。

------

# 在 “ AWS 最终用户消息 SMS” 中，在选择退出列表中搜索目标电话号码
<a name="opt-out-list-search"></a>

使用 AWS 最终用户消息 SMS 控制台搜索退出列表以查看其中是否包含目标号码。

1. 打开 AWS 最终用户消息 SMS 控制台，网址为[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/)。

1. 在导航窗格中的**配置**下，选择**选择退出列表**。

1. 在**选择退出列表**页面上，选择一个选择退出列表。

1. 在**已选择退出的号码**选项卡上，在搜索字段中输入电话号码。电话号码必须采用 E.164 格式，例如 **\$112065550149**。

1. 选择**搜索**。

# 从 “ AWS 最终用户消息 SMS” 的选择退出列表中删除目标电话号码
<a name="opt-out-list-remove-phone-number"></a>

使用 AWS 最终用户消息 SMS 控制台或 AWS CLI 从选择退出列表中删除目标电话号码。删除某个电话号码后，该号码将能够接收来自与选择退出列表关联的发起身份发送的消息。

------
#### [ Remove a destination number (Console) ]

1. 打开 AWS 最终用户消息 SMS 控制台，网址为[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/)。

1. 在导航窗格中的**配置**下，选择**选择退出列表**。

1. 在**选择退出列表**页面上，选择一个选择退出列表。

1. 在**已选择退出的号码**选项卡上，输入要删除的电话号码，然后选择**搜索**。

1. 如果找到了电话号码，可以使用**移除号码**将其从选择退出列表中删除。

1. 在**移除选择退出的号码**窗口中，输入 **release**，然后选择**移除号码**。

------
#### [ Remove a destination number (AWS CLI) ]

您可以使用[delete-opted-out-number](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/delete-opted-out-number.html)命令将电话号码移到选择退出列表中。

在命令行输入以下命令：

```
$ aws pinpoint-sms-voice-v2 delete-opted-out-number \
> --opt-out-list-name optOutListName \
> --opted-out-number +12065550123
```

在前面的示例中，进行以下更改：
+ *optOutListName*替换为您想要添加目标身份的选择退出列表的名称或 Amazon 资源名称 (ARN)。
+ *\$112065550123*替换为要添加到选择退出列表中的电话号码。电话号码必须使用 E.164 格式。

------

# 删除 AWS 最终用户消息 SMS 中的选择退出列表
<a name="opt-out-list-delete"></a>

使用 AWS 最终用户消息 SMS 控制台或 AWS CLI 删除选择退出列表。

------
#### [ Delete opt-out list (Console) ]

要使用 AWS 最终用户消息 SMS 控制台删除选择退出列表，请执行以下步骤：

1. 打开 AWS 最终用户消息 SMS 控制台，网址为[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/)。

1. 在导航窗格中的**配置**下，选择**选择退出列表**。

1. 在**选择退出列表**页面上，选择一个选择退出列表，然后选择**删除**。

------
#### [ Delete opt-out list (AWS CLI) ]

您可以使用[delete-opt-out-list](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/delete-opt-out-list.html)命令删除选择退出列表

在命令行输入以下命令：

```
$ aws pinpoint-sms-voice-v2 delete-opt-out-list \
> --opt-out-list-name optOutListName
```

在前面的示例中，*optOutListName*替换为一个便于识别选择退出列表的名称。

------

# 管理 AWS 最终用户消息 SMS 中选择退出列表的标签
<a name="opt-out-list-tags"></a>

标签是一对密钥和值，您可以选择将其应用于您的 AWS 资源以控制访问或使用情况。为资源添加标签有助于您通过不同方式（例如按用途、所有者、环境或其他标准）对资源进行分类和管理。您可以使用标签轻松查找现有资源，或控制哪些用户可以访问特定资源。

------
#### [ Manage tags (Console) ]

使用 AWS 最终用户消息 SMS 控制台在池中添加或编辑标签。

**管理标签（控制台）**

1. 打开 AWS 最终用户消息 SMS 控制台，网址为[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/)。

1. 在导航窗格中的**配置**下，选择**选择退出列表**。

1. 在**选择退出列表**页面上，选择要添加标签的选择退出列表。

1. 在**标签**选项卡上，选择**管理标签**。
   + **添加标签**-在 “**管理标签**” 中，选择 “**添加新标签**” 以创建新的空白 key/value 对。
   + **删除标签**-在 “**管理标签**” 中，选择标签 key/value 对旁边的**移除**。
   + **编辑标签** – 在**管理标签**中，选择**键**或**值**并编辑文本。

1. 选择**保存更改**。

------
#### [ Manage tags (AWS CLI) ]

使用 AWS CLI 添加或编辑标签。

```
$ aws pinpoint-sms-voice-v2 tag-resource \
  --resource-arn resource-arn \
  --tags tags={key1=value1,key2=value2}
```

在上述示例中，执行以下操作：
+ *resource-arn*替换为您要添加标签的亚马逊资源名称 (ARN)。
+ 将*key1*和*key2*替换为要添加到资源中的标签的密钥。
+ *value2*用要为相应密钥添加的标签的值替换*value1*和。

使用 AWS CLI 删除标记。

```
$ aws pinpoint-sms-voice-v2 untag-resource \
  --resource-arn resource-arn \
  --tag-keys tags={key1=value1,key2=value2}
```

在上述示例中，执行以下操作：
+ *resource-arn*替换为您要从中移除标签的亚马逊资源名称 (ARN)。
+ *key2*用要移除的标签的密钥替换*key1*和。
+ *value2*用要移除的标签的值替换*value1*和。

------

# 列出共享的退出列表 AWS CLI
<a name="opt-out-list-shared"></a>

您可以使用查看[describe-opt-out-lists](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-opt-out-lists.html)与您的账户共享的退出列表。有关共享资源的更多信息，请参阅[在 “ AWS 最终用户消息 SMS” 中使用共享资源](shared-resources.md)。

**要列出与您的账户共享的所有退出列表，请使用 AWS CLI**
+ 在命令行输入以下命令：

  ```
  $ aws pinpoint-sms-voice-v2 describe-opt-out-lists --owner SHARED
  ```

在前面的命令中，*SHARED*替换*SELF*为以列出您的账户拥有的退出列表。