阿里短信

轻量消息队列(原 MNS)支持把发布到主题的消息推送到阿里短信。本文介绍如何将消息推送到阿里短信。

前提条件

步骤一:创建主题

  1. 登录轻量消息队列(原 MNS)控制台

  2. 在左侧导航栏,选择主题模型 > 主题列表

  3. 在顶部菜单栏,选择地域。

  4. 主题列表页面,单击创建主题

  5. 创建主题面板,配置以下参数,然后单击确定

    • 名称:主题名称。

    • 消息最大长度:发送到主题的消息体的最大长度。

    • 启用日志功能:是否开启日志管理功能。

    页面跳转到目标主题的主题详情页面。

步骤二:创建订阅

当前账号

  1. 在左侧导航栏,选择主题模型 > 订阅列表

  2. 订阅列表页面,单击创建订阅

  3. 创建订阅面板中,进行以下配置,然后单击确定

    • 主题名称:订阅所属的主题名称。

    • 订阅名称:输入订阅名称。

    • 订阅类型:选择阿里短信

    • 是否跨账号:选择当前账号

    • 是否固定投递:选择投递方式。

      • 从变量获取:在使用SDK发送消息时,可以设置DmAttributes中的phoneNumber变量,从而动态指定消息推送的手机号码,设置方法请参见带有消息属性的主题推送示例

      • 固定投递:选择固定投递,并输入固定投递的手机号码。

        • 国内短信:无任何前缀的手机号码,例如 1390000****。

        • 国际、中国香港、中国澳门和中国台湾:手机号为国际区号+号码,例如 852000012****。

      说明
      • 若选择从变量获取方式,如果发送消息时未指定phoneNumber,则会发送失败。

      • 若选择固定投递方式,仍然可以在SDK中通过设置DmAttributes中的phoneNumber变量,动态指定手机号码。SDK变量中配置的手机号码的优先级高于订阅创建时输入的手机号码。

    • 短信签名:输入短信签名名称,在短信服务中申请的短信签名。

    • 短信模板:输入短信模板CODE,在短信服务中申请的短信模板。

    • 服务关联角色轻量消息队列(原 MNS)使用服务关联角色AliyunMNSSendSMSRolePolicy来调用短信推送服务,首次使用时需要单击创建服务关联角色 AliyunMNSSendSMSRolePolicy进行授权。

      说明
      • 首次成功创建服务关联角色后,后续无需再次进行创建。

      • 请勿删除已创建的服务关联角色,否则将导致轻量消息队列(原 MNS)短信推失败。

    • 可选:消息过滤标签:输入标签用于过滤消息。

    • 重试策略:选择重试策略。

      • 退避重试:重试3次,间隔时间为10~20秒之间的一个随机值。

      • 指数衰减重试:重试176次,总计重试时间为1天,间隔时间单位为秒,依次为:2^0,2^1,…,512,512,…,512。

    • 消息格式:选择SIMPLIFIED

跨账号

  1. 在左侧导航栏,选择主题模型 > 订阅列表

  2. 订阅列表页面,单击创建订阅

  3. 创建订阅面板中,进行以下配置,然后单击确定

    • 主题名称:订阅所属的主题名称。

    • 订阅名称:输入订阅名称。

    • 订阅类型:选择阿里短信

    • 是否跨账号:选择跨账号,并输入跨账号的阿里云UID。

    • 是否固定投递:选择投递方式。

      • 从变量获取:在使用SDK发送消息时,可以设置DmAttributes中的phoneNumber变量,从而动态指定消息推送的手机号码,设置方法请参见带有消息属性的主题推送示例

      • 固定投递:选择固定投递,并输入固定投递的手机号码。

        • 国内短信:无任何前缀的手机号码,例如 1390000****。

        • 国际、中国香港、中国澳门和中国台湾:手机号为国际区号+号码,例如 852000012****。

      说明
      • 若选择从变量获取方式,如果发送消息时未指定phoneNumber,则会发送失败。

      • 若选择固定投递方式,仍然可以在SDK中通过设置DmAttributes中的phoneNumber变量,动态指定手机号码。SDK变量中配置的手机号码的优先级高于订阅创建时输入的手机号码。

    • 短信签名:输入短信签名名称,在短信服务中申请的短信签名。

    • 短信模板:输入短信模板CODE,在短信服务中申请的短信模板。

    • 服务关联角色:在文本框中输入跨账号授权的RAM角色ARN,RAM角色授权和ARN的获取请参见跨账号推送授权

    • 可选:消息过滤标签:输入标签用于过滤消息。

    • 重试策略:选择重试策略。

      • 退避重试:重试3次,间隔时间为10~20秒之间的一个随机值。

      • 指数衰减重试:重试176次,总计重试时间为1天,间隔时间单位为秒,依次为:2^0,2^1,…,512,512,…,512。

    • 消息格式:选择SIMPLIFIED

步骤三:发布消息

  1. 主题列表页面,找到目标主题,在其右侧操作列单击发布消息

  2. 快速体验向主题发布消息页面,进行以下配置,然后单击发布消息

    • 消息内容:输入消息正文。

    • 可选:消息标签:输入标签用于过滤消息。

    • 推送订阅类型:选择阿里短信

      • 短信模板 ID:输入模板CODE。

      • 短信签名:输入签名名称。

      • 批量短信:选择是否使用批量短信。如果选择使用批量短信,可以将不同的短信内容发送到不同的接收者。

      • 接收者:输入接收者的手机号码和短信模板的键值对。

        说明
        • 匿名订阅会根据指定的接收者来发送短信。

        • 多个手机号码以半角逗号(,)分隔,最多不超过1000个手机号码。

        • 国内手机号码为11位,国际手机号和中国香港、中国澳门和中国台湾手机号为国际区号加号码。

      更多参数说明,请参见SendSms