使用短信的API接口发送短信后,可以通过MNS消息队列消费模式和HTTP批量推送模式来接收短信的回执消息和上行短信内容。

如果出现网络问题等异常情况,导致消息回执未成功获取,还可以通过短信发送记录查询API接口进行一定的补偿。目前支持30天内发送记录的查询,可查询一天的发送数据。

消息类型

短信提供以下消息类型:
  • SmsReport(短信下行回执报告消息)

    上行短信指用户发送给通信服务提供商的短信,用于定制某种服务、完成某种查询、或是办理某种业务等。通过订阅SmsReport短信下行状态报告,可以获知每条短信的发送情况,了解短信是否达到终端用户的状态与相关信息。

  • SmsUp(上行短信消息)

    与上行短信相对应的是下行短信。下行是指用户收到的短信,例如运营商发送的消息通知、业务提醒等短信。通过订阅SmsUp上行短信消息,可以获知终端用户回复短信的内容。

  • SignSmsReport(签名审核状态消息)

    订阅SignSmsReport签名审核状态消息之后,如果通过API接口AddSmsSign申请短信签名,可以获取签名的审核状态消息。

  • TemplateSmsReport(模板审核状态消息)

    订阅TemplateSmsReport模板审核状态消息之后,如果通过API接口AddSmsTemplate申请短信模板,可以获取模板的审核状态消息。

消息发送模式

  • MNS消息队列消费模式

    用户在控制台启用MNS消息服务订阅指定的消息类型(MessageType)时,系统会自动生成该类型的独立消息队列及名称(QueueName)。用户可使用此消息队列名称(QueueName)和消息类型(MessageType),通过阿里云AccessKey信息换取的临时Token来获取队列中的详细内容。使用消息回执API,请参见升级说明

    消息类型包括:
    说明 如果使用JAVA或Node.js语言的SDK拉取消息回执,请分别使用JAVA MNS SDK原Node.js MNS SDK
  • HTTP批量推送模式

    在控制台设置HTTP回调URL(callback_url)后,在业务消息产生时,系统会使用HTTP请求以POST方式将业务消息(即上行短信消息或短信状态报告)发送到指定的回调URL上,用户可直接接收此消息。

    详细报文格式请参见:

开启消息接收

如果需要接受回执消息,必须先在控制台上开启消息接收。
  1. 登录短信服务控制台
  2. 在左侧导航栏中单击系统设置 > 通用设置
  3. 状态报告接收上行消息接收中,开启指定模式。
    • MNS消息队列消费模式表示通过MNS的Queue模型来接收短信的回执消息和上行短信内容。
    • HTTP批量推送模式表示通过 HTTP POST 方式发送消息到指定的 Web URL。

开启消息接收