回执消息是在使用API接口发送短信之后,通过配置轻量消息队列(原MNS)消费模式或HTTP批量推送模式,帮助您掌握短信的发送成功率和其他业务提供支持。
如果出现网络异常、响应超时等情况,可能导致回执消息推送重复、回执消息获取失败等问题。
由于系统存在缓存,开启回执消息后不会立即全量推送,建议等待3分钟后确认是否已生效。
回执消息无法保证幂等性,因此需要您自行处理幂等性的问题。建议您在接收到回执消息后,采取适当的措施来确保数据的正确性和一致性。
回执消息模式
短信服务接收回执消息的模式有轻量消息队列(原MNS)消费模式和HTTP批量推送模式两种,您可根据实际情况选择合适的模式接收回执消息。
轻量消息队列(原MNS)消费模式
轻量消息队列(原MNS)消费模式表示通过Queue模型来接收指定地域的短信回执消息。云通信的所有业务消息都支持轻量消息服务向外发送。用户在短信服务控制台启用消息服务订阅指定的消息类型(MessageType)时,系统会自动生成该类型的独立消息队列及名称(QueueName)。您可使用此消息队列名称(QueueName)和消息类型(MessageType),通过调用SDK从后台来获取队列中的短信状态报告。
HTTP批量推送模式
HTTP批量推送模式表示通过HTTP POST方式发送消息到指定的Web URL。在短信服务控制台设置HTTP回调URL(callback_url)后,当业务消息产生时,系统会使用HTTP请求以POST方式将业务消息(即短信状态报告)发送到指定的回调URL上,用户可直接接收此消息。
回执消息类型
选择回执消息模式之后,您还需要选择消息类型,接收不同场景下的回执消息。我们提供了如下消息类型,您可根据业务需要进行选择。
名称 | 描述 | MNS消息队列消费模式 | HTTP批量推送模式 |
SmsReport(短信下行回执报告消息) | 下行是指用户收到的短信,例如运营商发送的消息通知、业务提醒等短信。通过订阅SmsReport短信下行状态报告,可以获知每条短信的发送情况,了解短信是否达到终端用户的状态与相关信息。 |
配置回执消息接收模式
如果您需要接收回执消息,必须先在短信服务控制台上开启消息接收。以下示例展示如何配置短信下行回执消息报告。
登录短信服务控制台。
在左侧导航栏,选择
。在通用设置页面,单击接口API页签。
在云通信消息接收区域,开启指定模式。
轻量消息队列(原MNS)消费模式
开启轻量消息队列(原MNS消息队列)消费模式左侧的功能开关。
HTTP批量推送模式
开启HTTP批量推送模式左侧的功能开关。
填写接收地址,地址示例:http://push.example.com/contextpath/receive.do。
单击保存。
轻量消息队列(原MNS)消费模式请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
MessageType | String | 是 | SmsReport | 消息类型:SmsReport。 |
QueueName | String | 是 | Alicom-Queue-*****-SmsReport | 提供的消息队列名称。登录短信服务控制台,选择 ,查看队列名称。 |