本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用通知範本
<a name="notify-templates"></a>

通知範本是預先核准的 AWS受管訊息範本，用於傳送 OTP 和驗證訊息。範本會在支援的國家/地區進行預先驗證。您可以從可用的範本中選取 ，但無法建立或修改它們。

## 範本屬性
<a name="notify-templates-properties"></a>

範本 ID  
範本的唯一識別符。

範本類型  
使用案例類別。目前`CODE_VERIFICATION`提供 。

頻道  
範本支援的頻道：`SMS`、 `VOICE`或兩者。

語言代碼  
範本內容的語言 （例如，、`en``es`、`fr`)。

支援的國家/地區  
可以使用此範本的國家/地區。

層存取  
哪些層可以使用此範本 (`BASIC`、 `ADVANCED`或兩者）。

Variables  
您在傳送時間提供 值的範本內容中的預留位置。每個變數都有名稱、類型和限制條件。`CUSTOMER` 您必須提供來源為 的變數。具有 來源的變數`SYSTEM`會自動填入。

內容  
具有預留`{{variable}}`位置的訊息內文。

## 瀏覽範本
<a name="notify-templates-browse"></a>

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

1. 在 https：//[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/) 開啟 AWS 最終使用者傳訊簡訊主控台。

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`（自動填入）。
+ **限制 –** 驗證規則，例如最大長度、最小/最大值或規則運算式模式。

## 設定預設範本
<a name="notify-templates-default"></a>

您可以在通知組態上設定預設範本。當您在不指定範本 ID 的情況下傳送訊息時，會使用預設範本。如果未設定預設範本，且在傳送請求中未提供範本 ID，則請求會失敗。

若要設定或變更預設範本，請參閱 [管理通知組態](notify-configurations.md)。