通过SMN发布模板消息
操作场景
消息通知服务能够根据用户的需求,向订阅终端主动推送消息。消息通知服务支持发布模板消息,该功能用于以下场景:
在用户发送的通知消息中,大部分内容是固定的,只有少数内容随着每次事件指标变化而变化。在这种场景下,用户可以通过创建一个消息模板,用模板变量代替变化的内容。这样在每次发布消息通知时,选择消息模板并设置模板变量便可完成特定的消息通知。
本章节以创建主题并发布模板消息为例,指导您快速上手消息通知服务。
在本示例中,某公司定期举行展览会,需要邀请相关人员,邀请通知消息中消息内容不变,仅需更改展览会的举办时间。
操作流程
操作步骤 |
说明 |
---|---|
注册华为账号并开通华为云,实名认证,为账户充值。 |
|
创建一个主题“Mytopic”。 |
|
为主题“Mytopic”添加协议类型为“短信”和“邮件”的订阅。 |
|
创建一个消息模板“tem_001”,协议分别为“Default”、“短信”和“邮件”。 |
|
向“短信”和“邮件”类型的订阅者发布消息“The Arts and Crafts Exposition will be held from {startdate} through {enddate}. We sincerely invite you to join us. ” 其中,“{startdate} ”表示展览会的开始时间,“{enddate}”表示展览会的结束时间。 |
|
订阅终端接收消息。 |
准备工作
- 注册账号并实名认证。
在使用消息通知服务之前,请先注册华为账号并开通华为云、实名认证。
如果您已开通华为云并进行实名认证,请忽略此步骤。
- 为账户充值。
请保证账户有足够金额。具体操作,请参见账户充值。
- 在主题列表中,单击“Mytopic”主题右侧的“添加订阅”。
- 配置订阅参数。
本示例仅解释必要参数,其余大多数配置可保留默认值。关于配置参数的详细说明,请参见添加订阅。
图2 添加订阅配置参数
表2 添加订阅参数设置说明 参数
示例
说明
主题名称
Mytopic
已选择的需要添加订阅的主题名称,不可修改。
协议
短信
在“协议”下拉框中,选择订阅终端支持的协议“短信”。
更多支持的协议类型,请参见消息通知服务支持的传输协议有哪些?
添加方式
新建订阅
创建新的订阅。
订阅终端
+8618612345678
在“订阅终端”输入框中输入有效的手机号码。
- 批量添加时,每个终端地址占一行,最多可输入10个终端。
- 消息通知服务不会校验订阅终端是否真实存在。
- 单击“确定”,完成协议类型为“短信”的订阅的添加。
完成订阅添加后,您添加的订阅终端会收到订阅确认的通知,接收端需要在订阅终端上单击订阅确认链接,确认同意接收主题发布的消息。此时SMN页面可以看到对应订阅状态为已确认。
- 在主题列表中,单击“Mytopic”主题右侧的“添加订阅”。
- 配置订阅参数。
本示例仅解释必要参数,其余大多数配置可保留默认值。关于配置参数的详细说明,请参见添加订阅。
图3 添加订阅配置参数
表3 添加订阅参数设置说明 参数
示例
说明
主题名称
Mytopic
已选择的需要添加订阅的主题名称,不可修改。
协议
邮件
在“协议”下拉框中,选择订阅终端支持的协议“邮件”。
更多支持的协议类型,请参见消息通知服务支持的传输协议有哪些?
添加方式
新建订阅
创建新的订阅。
订阅终端
username@example.com
在“订阅终端”输入框中输入有效的邮箱地址。
- 批量添加时,每个终端地址占一行,最多可输入10个终端。
- 消息通知服务不会校验订阅终端是否真实存在。
- 单击“确定”,完成协议类型为“邮件”的订阅的添加。
完成订阅添加后,您添加的订阅终端会收到订阅确认的通知,接收端需要在订阅终端上单击订阅确认链接,确认同意接收主题发布的消息。此时SMN页面可以看到对应订阅状态为已确认。
步骤三:创建消息模板
- 在左侧导航栏,选择“主题管理” >“消息模板”。
- 在消息模板页面,单击右上角的“创建消息模板”。
- 配置消息模板参数。
本示例仅解释必要参数,其余大多数配置可保留默认值。关于配置参数的详细说明,请参见消息模板管理。
图4 创建消息模板配置参数
表4 创建消息模板参数设置说明 参数
示例
说明
模板名称
tem_001
输入创建的模板名称。
协议
- Default
- 短信
- 邮件
分别创建模板名称为“tem_001”,协议为“Default”、“短信”、“邮件”的消息模板。
模板内容
The Arts and Crafts Exposition will be held from {startdate} through {enddate}. We sincerely invite you to join us.
自定义模板内容。
请以{xxx}作为占位符创建模板。在使用该模板发送消息时,{xxx}可以被替换成具体内容。{xxx}中的xxx只能包含大写字母、小写字母、数字、-、.和_,且必须由大写字母、小写字母或数字开头,不能超过21个字符。
- 单击“确定”。
步骤四:发布消息
- 在左侧导航栏,选择“主题管理” > “主题”。
- 在主题列表中,单击“Mytopic”主题消息右侧“操作”列的“发布消息”。
图5 发布消息配置参数
表5 发布消息参数设置说明 参数
示例
说明
主题名称
Mytopic
已选择需要发布消息的主题名称,不可修改。
消息类型
模板消息
按模板格式发送的消息。
消息内容
{ "message_template_name": "tem_001", "tags": { "startdate": "08/02/2024", "enddate": "08/20/2024" } }
在消息内容输入框中手动输入模板格式的消息,或通过单击“生成模板消息”自动生成消息。
模板格式的消息描述,请参见模板格式消息说明。
- 单击“确定”,消息将推送至不同的订阅终端。
各个终端接收到的消息内容说明请参考“不同协议消息说明”部分。