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

# 使用通知模板
<a name="notify-templates"></a>

通知模板是预先批准的 AWS托管消息模板，用于发送 OTP 和验证消息。模板已在支持的国家/地区进行预先验证。您可以从可用模板中进行选择，但无法创建或修改它们。

## 模板属性
<a name="notify-templates-properties"></a>

模板 ID  
模板的唯一标识符。

模板类型  
用例类别。目前，`CODE_VERIFICATION`可用。

渠道  
模板支持的频道：`SMS``VOICE`、，或两者兼而有之。

语言代码  
模板内容的语言（例如、`en``es`、`fr`）。

支持的国家  
可以使用此模板的国家/地区。

等级访问权限  
哪些层可以使用此模板（`BASIC``ADVANCED`、或两者兼而有之）。

变量  
您在发送时为其提供值的模板内容中的占位符。每个变量都有名称、类型和约束。来源为的变量`CUSTOMER`必须由您提供。源为的变量会自动填充。`SYSTEM`

内容  
带有`{{variable}}`占位符的邮件正文。

## 浏览模板
<a name="notify-templates-browse"></a>

------
#### [ Console ]

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

1. 导航到 “通知” 配置，然后选择 “**模板**” 选项卡。

1. **所有模板**部分显示了所有可用的模板。使用属性筛选器按支持的国家/地区、语言代码或其他属性进行筛选。

------
#### [ AWS CLI ]

列出所有模板：

```
aws pinpoint-sms-voice-v2 describe-notify-templates
```

按模板类型筛选：

```
aws pinpoint-sms-voice-v2 describe-notify-templates \
  --filters Name=template-type,Values=CODE_VERIFICATION
```

按频道筛选：

```
aws pinpoint-sms-voice-v2 describe-notify-templates \
  --filters Name=channels,Values=SMS
```

按国家筛选：

```
aws pinpoint-sms-voice-v2 describe-notify-templates \
  --filters Name=supported-countries,Values=US
```

按语言筛选：

```
aws pinpoint-sms-voice-v2 describe-notify-templates \
  --filters Name=language-code,Values=en
```

------

## 模板变量
<a name="notify-templates-variables"></a>

模板变量是消息内容中的占位符，这些占位符会被您在发送消息时提供的值所取代。每个变量都有以下元数据：
+ **类型**-逻辑数据类型：`STRING``INTEGER`、或`BOOLEAN`。无论类型如何，所有值都作为字符串在 API 中传递。例如，将整数值传递为，`"42"`将布尔值传递为`"true"`。
+ **必填项**-是否必须提供变量。如果省略没有默认值的必需变量，则会导致错误。
+ **来源**-`CUSTOMER`（由您提供值）或`SYSTEM`（自动填充）。
+ **约束**-验证规则，例如最大长度、 minimum/maximum 值或正则表达式模式。

## 设置默认模板
<a name="notify-templates-default"></a>

您可以在 “通知” 配置上设置默认模板。当您发送消息时未指定模板 ID 时，将使用默认模板。如果未设置默认模板且发送请求中未提供模板 ID，则请求将失败。

要设置或更改默认模板，请参阅[管理通知配置](notify-configurations.md)。