View a markdown version of this page

使用通知模板 - AWS 最终用户消息 SMS

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

使用通知模板

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

模板属性

模板 ID

模板的唯一标识符。

模板类型

用例类别。目前,CODE_VERIFICATION可用。

渠道

模板支持的频道:SMSVOICE、,或两者兼而有之。

语言代码

模板内容的语言(例如、enesfr)。

支持的国家

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

等级访问权限

哪些层可以使用此模板(BASICADVANCED、或两者兼而有之)。

变量

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

内容

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

浏览模板

Console
  1. 打开 AWS 最终用户消息 SMS 控制台,网址为https://console.aws.amazon.com/sms-voice/

  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

模板变量

模板变量是消息内容中的占位符,这些占位符会被您在发送消息时提供的值所取代。每个变量都有以下元数据:

  • 类型-逻辑数据类型:STRINGINTEGER、或BOOLEAN。无论类型如何,所有值都作为字符串在 API 中传递。例如,将整数值传递为,"42"将布尔值传递为"true"

  • 必填项-是否必须提供变量。如果省略没有默认值的必需变量,则会导致错误。

  • 来源-CUSTOMER(由您提供值)或SYSTEM(自动填充)。

  • 约束-验证规则,例如最大长度、 minimum/maximum 值或正则表达式模式。

设置默认模板

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

要设置或更改默认模板,请参阅管理通知配置