更新时间:2024-04-19 GMT+08:00

如何发布主题消息

在熟悉了SMN的基本概念之后,您可以通过消息通知服务的管理控制台进行基本主题订阅操作。

通过主题发布消息的流程图如图1所示。
图1 发布主题消息流程

操作场景

假设某公司定期举行展览会,需要邀请相关人员,此时消息内容不变,仅需更改日期。这种场景的特性是:用户发送的通知消息中,大部分内容是固定的,只有少数内容随着每次事件指标变化而变化。针对这种需求,用户可以创建一个消息模板,在模板中,用模板变量代替变化的内容,每次通知时,选择消息模板并设置模板变量值便可完成特定的消息通知。

步骤1 创建主题

  1. 登录管理控制台。
  2. 在管理控制台左上角单击图标,选择区域和项目。
  3. 选择“应用服务” > “消息通知服务”。

    进入消息通知服务页面。

  4. 在左侧导航栏,选择“主题”。

    进入主题页面。

  5. 在主题页面,单击“创建主题”。
  6. 在“主题名称”框中,输入主题名称,在“显示名”框中输入相关描述,如表1所示。
    表1 创建主题参数说明

    参数

    说明

    主题名称

    创建的主题名称,用户可自定义名称,规范如下:

    • 只能包含字母,数字,短横线(-)和下划线(_),且必须由大写字母、小写字母或数字开头。
    • 名称长度限制在1-255字符之间。
    • 主题名称为主题的唯一标识,一旦创建后不能再修改主题名称。

    显示名

    显示名,长度限制在192字节或64个中文字。

    说明:

    推送邮件消息时,如果未设置主题的显示名,发件人呈现为“username@example.com”,如果已设置主题的显示名,发件人则呈现为“显示名<username@example.com>”。

  7. 单击“确定”,主题创建成功。

    主题创建成功后,系统会自动生成主题URN,主题URN是主题的唯一资源标识,不可修改。新创建的主题将显示在主题列表中。

  8. 单击主题名称,可查看主题详情(包含主题URN、显示名等)、主题订阅总数。

步骤2 添加订阅

  1. 登录管理控制台。
  2. 在管理控制台左上角单击图标,选择区域和项目。
  3. 选择“应用服务” > “消息通知服务”。

    进入消息通知服务页面。

  4. 在左侧导航栏,选择“订阅”。

  5. 在订阅页面。单击“添加订阅”,开始添加消息订阅。

    此时将显示“添加订阅”页面。

  6. 向指定主题添加订阅。
    1. 单击“主题名称”输入框右侧的“选择主题”,在弹出的选择主题对话框中选择主题。
    2. 在“协议”下拉框中选择订阅终端支持的协议,在“订阅终端”输入框中输入对应的订阅终端,填写说明如表2所示。
      表2 添加订阅参数说明

      参数

      说明

      主题名称

      在弹出的对话框中选择的主题的名称。

      协议

      在下拉框中选择需要订阅终端支持的协议,提供的选项为“短信”、“邮件”、“HTTP”、“HTTPS”。

      订阅终端

      订阅的终端地址,邮件、HTTP以及HTTPS终端支持批量输入,批量添加时,每个终端地址占一行。最多可输入10个终端。

      • 选择“短信”终端,请输入有效手机号码。

        输入规则为[+] [国家码][手机号码]。

      • 选择“邮件”终端,请输入有效的邮箱地址。

        例如:

        username@example.com

        username2@example.com

      • 选择“HTTP”终端,请输入公网网址。

        例如:

        http://example.com/notification/action

      • 选择“HTTPS”终端,请输入公网网址。

        例如:

        https://example.com/notification/action

  7. 单击“确定”。

    新增订阅将显示在页面下方的订阅列表中。

    • 为了防止恶意攻击订阅终端,云平台会对订阅终端进行流控保护,触发流控规则后,消息通知服务不再发送订阅确认消息,具体的保护规则请参见《消息通知服务用户指南》的附录“订阅确认流控说明”部分。
    • 消息通知服务不会校验订阅终端是否真实存在。
    • 添加订阅后,消息通知服务会向订阅终端发送订阅确认信息,信息中包含订阅确认的链接。订阅确认的链接在48小时内有效,用户需要及时在手机端、邮箱或其他协议终端确认订阅。
    • 发送请求订阅消息也会作为发送条数进行计费。