回执消息是在短信发送之后,通过配置MNS消息队列消费模式和HTTP批量推送模式,接收短信发送状态的结果和用户回复的短信内容,帮助您掌握短信的发送成功率和其他业务提供支持。

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

回执消息模式

接收回执消息的模式有两种,用户可根据实际情况选择合适的模式接收回执消息。

  • MNS消息队列消费模式

    用户在控制台启用MNS消息服务订阅指定的消息类型(MessageType)时,系统会自动生成该类型的独立消息队列及名称(QueueName)。您可使用此消息队列名称(QueueName)和消息类型(MessageType),通过调用SDK从后台来获取队列中的短信状态报告。使用消息回执API,请参见升级说明

    说明
    • 使用Java或Node.js语言的SDK拉取消息回执,请分别使用Java MNS SDK原Node.js MNS SDK。其他语言,请参见短信服务SDK简介
    • 为优化短信服务底层性能,减少队列调用对您业务的压力,超过3个月无发送量时,MNS消息队列将进入休眠状态,重新发送短信后,MNS队列将自动取消休眠。
  • HTTP批量推送模式

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

回执消息类型

选择回执消息模式之后,您还需要选择消息类型,接收不同场景下的回执消息。根据短信发送状态、用户回复的消息内容等不同场景,我们提供了如下消息类型,您可根据业务需要进行选择。

名称 描述 MNS消息队列消费模式 HTTP批量推送模式
SmsUp(上行短信消息) 上行短信指用户发送给通信服务提供商的短信,用于定制某种服务、完成某种查询、或是办理某种业务等。通过订阅SmsUp上行短信消息,可以获知终端用户回复短信的内容。 SmsUp SmsUp
SmsReport(短信下行回执报告消息) 与上行短信相对应的是下行短信。下行是指用户收到的短信,例如运营商发送的消息通知、业务提醒等短信。通过订阅SmsReport短信下行状态报告,可以获知每条短信的发送情况,了解短信是否达到终端用户的状态与相关信息。 SmsReport SmsReport
SignSmsReport(签名审核状态消息) 签名审核状态消息是指通过API接口AddSmsSign申请短信签名后,可以通过SignSmsReport接口获取签名的审核状态消息。 - SignSmsReport
TemplateSmsReport(模板审核状态消息) 模板审核状态消息是指通过API接口AddSmsTemplate申请短信模板后,可以通过TemplateSmsReport接口获取模板的审核状态消息。 - TemplateSmsReport

配置回执消息接收模式

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