View a markdown version of this page

使用通知範本 - AWS 最終使用者傳訊簡訊

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

使用通知範本

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

範本屬性

範本 ID

範本的唯一識別符。

範本類型

使用案例類別。目前CODE_VERIFICATION提供 。

頻道

範本支援的頻道:SMSVOICE或兩者。

語言代碼

範本內容的語言 (例如,、enesfr)。

支援的國家/地區

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

層存取

哪些層可以使用此範本 (BASICADVANCED或兩者)。

Variables

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

內容

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

瀏覽範本

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

  2. 導覽至通知組態,然後選擇範本索引標籤。

  3. 所有範本區段會顯示所有可用的範本。使用 屬性篩選條件,依支援的國家/地區、語言代碼或其他屬性進行篩選。

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

範本變數

範本變數是訊息內容中的預留位置,以您在傳送訊息時提供的值取代。每個變數都有下列中繼資料:

  • 類型 – 邏輯資料類型:STRINGINTEGERBOOLEAN。無論類型為何,所有值都會在 API 中以字串形式傳遞。例如,將整數值傳遞為 ,"42"將布林值傳遞為 "true"

  • 必要 – 是否必須提供變數。如果省略沒有預設值的必要變數,則會導致錯誤。

  • 來源CUSTOMER(您提供 值) 或 SYSTEM(自動填入)。

  • 限制 – 驗證規則,例如最大長度、最小/最大值或規則運算式模式。

設定預設範本

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

若要設定或變更預設範本,請參閱 管理通知組態