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

重要
  • 如果出现网络异常、响应超时等情况，可能会导致回执消息推送重复、回执消息获取失败等问题。如果回执消息获取失败，您可以通过QuerySendDetails接口进行查询。目前支持查询24小时内的发送数据、30天内的发送记录。
  • HTTP批量推送模式的响应超时时间为700 ms。
  • 使用SDK拉取MNS消息，详情请参见消息回执API。
  • 为优化短信服务底层性能，减少队列调用对您业务的压力，超过3个月无发送量时，MNS消息队列将进入休眠状态，重新发送短信后，MNS队列将自动取消休眠。
  • 由于系统存在缓存，开启回执消息后不会立即全量推送，建议等待15分钟确认是否已生效。

回执消息模式

接收回执消息的模式有MNS消息队列消费模式和HTTP批量推送模式两种，您可根据实际情况选择合适的模式接收回执消息。

  • MNS消息队列消费模式

    MNS消息队列消费模式表示通过MNS的Queue模型来接收指定地域的短信回执消息和上行短信内容。云通信的所有业务消息都支持MNS消息服务向外发送。用户在短信服务控制台启用MNS消息服务订阅指定的消息类型（MessageType）时，系统会自动生成该类型的独立消息队列及名称（QueueName）。您可使用此消息队列名称（QueueName）和消息类型（MessageType），通过调用SDK从后台来获取队列中的短信状态报告。

  • HTTP批量推送模式

    HTTP批量推送模式表示通过HTTP POST方式发送消息到指定的Web URL。在短信服务控制台设置HTTP回调URL（callback_url）后，当业务消息产生时，系统会使用HTTP请求以POST方式将业务消息（即上行短信消息或短信状态报告）发送到指定的回调URL上，用户可直接接收此消息。

回执消息类型

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

名称描述MNS消息队列消费模式HTTP批量推送模式
SmsUp（上行短信消息）上行短信指用户发送给通信服务提供商的短信，用于定制某种服务、完成某种查询、或是办理某种业务等。通过订阅SmsUp上行短信消息，可以获知终端用户回复短信的内容。SmsUpSmsUp
SmsReport（短信下行回执报告消息）与上行短信相对应的是下行短信。下行是指用户收到的短信，例如运营商发送的消息通知、业务提醒等短信。通过订阅SmsReport短信下行状态报告，可以获知每条短信的发送情况，了解短信是否达到终端用户的状态与相关信息。SmsReport
说明 如果您发送短信到国际地区，可以通过GlobeSmsReport获取短信状态报告。
SmsReport
SignSmsReport（签名审核状态消息）签名审核状态消息是指通过API接口AddSmsSign申请短信签名后，可以通过SignSmsReport接口获取签名的审核状态消息。-SignSmsReport
TemplateSmsReport（文本短信模板审核状态消息）文本模板审核状态消息是指通过API接口AddSmsTemplate申请短信模板后，可以通过TemplateSmsReport接口获取模板的审核状态消息。-TemplateSmsReport
MnsCardVender（卡片短信渲染消息）卡片短信渲染消息是指在创建卡片模板时，可以通过MnsCardVender接口获取短信渲染消息。MnsCardVenderMnsCardVender
MnsCardTemplate（卡片短信模板审核状态）卡片短信模板审核状态消息是指通过API接口CreateCardSmsTemplate申请模板后，可以通过MnsCardTemplate接口获取模板的审核状态消息。MnsCardTemplateMnsCardTemplate

配置回执消息接收模式

如果您需要接收回执消息，必须先在短信服务控制台上开启消息接收。以下示例为短信下行回执消息报告的配置流程。
  1. 登录短信服务控制台。
  2. 在左侧导航栏中单击系统设置 > 通用设置。
  3. 在状态报告接收和上行消息接收中，开启指定模式。
    • MNS消息队列消费模式。
      1. 开启MNS消息队列消费模式右侧的功能开关。打开消息队列
      2. 设置地域。
      3. 单击确定。
    • HTTP批量推送模式。
      1. 开启HTTP批量推送模式右侧的功能开关。
      2. 填写接收地址，地址示例：http://push.example.com/contextpath/receive.do。示例
      3. 单击确定。

相关文档