当您使用Chat App 消息服务API接口发送消息后,可以通过轻量消息队列(原MNS)消费模式或HTTP批量推送模式来接收消息发送状态的结果和用户回复的消息内容。
注意事项
如果出现网络异常、响应超时等情况,可能会导致回执消息推送重复、回执消息获取失败等问题。
回执消息模式
接收回执消息的模式有轻量消息队列(原MNS)消费模式和HTTP批量推送模式两种,您可根据实际情况选择合适的模式接收回执消息。
回执消息无法保证幂等性,因此需要您自行处理幂等性的问题。我们建议您在接收到回执消息后,采取适当的措施来确保数据的正确性和一致性。
轻量消息队列(原MNS)消费模式
轻量消息队列(原MNS)消费模式表示通过轻量消息队列(原MNS)的Queue模型来接收指定地域的短信回执消息。云通信的所有业务消息都支持轻量消息队列(原MNS)向外发送。用户在Chat App 消息服务控制台启用轻量消息队列(原MNS)订阅指定的消息类型(MessageType)时,系统会自动生成该类型的独立消息队列及名称(QueueName)。您可使用此消息队列名称(QueueName)和消息类型(MessageType),通过调用SDK从后台来获取队列中的短信状态报告。
HTTP批量推送模式
HTTP批量推送模式表示通过HTTP POST方式发送消息到指定的Web URL。在Chat App 消息服务控制台设置HTTP回调URL(callback_url)后,当业务消息产生时,系统会使用HTTP请求以POST方式把业务消息(即上行短信消息或短信状态报告)发送到指定的回调URL上,用户可直接接收此消息。
回执消息类型
选择回执消息模式之后,您还需要选择消息类型,接收不同场景下的回执消息。根据短信发送状态、用户回复的消息内容等不同场景,我们提供了如下消息类型,您可根据业务需要进行选择。
名称 | 描述 | 轻量消息队列(原MNS)消费模式 | HTTP批量推送模式 |
ChatAppInbound(消息上行) | 上行消息指用户发送给企业号码的消息,通过订阅ChatAppInbound上行消息,可以获取终端用户发送消息的内容。 | ||
ChatAppStatus(下行消息状态报告) | 与上行消息相对应的是下行消息。下行是指用户收到的消息。通过订阅ChatAppStatus下行状态报告,可以获知每条消息的发送情况,了解消息是否达到终端用户的状态与相关信息。 | ||
ChatAppAudit(模板审核状态消息) | 模板审核状态消息是指通过CreateChatappTemplate接口创建模板后,可以通过ChatAppAudit接口获取模板的审核状态消息。 |
配置回执消息接收模式
配置状态报告/消息上行
如果您需要接收回执消息,必须先在Chat App 消息服务控制台开启消息接收。
在左侧导航栏,选择通道管理,点击通道 ID 或者操作列的管理按钮。

进入通道数据面板页面,根据通道类型,点击对应的左侧导航栏功能。
WhatsApp类型通道:点击左侧导航栏。

Messenger类型通道:点击左侧导航栏。

Instagram类型通道:点击左侧导航栏。

在通道类型所对应的页面,设置需要订阅的消息。
页面/账户连接成功后,单击设置Webhook,勾选需要订阅的消息。
说明状态报告回调地址:指的是ChatAppStatus(状态报告下行消息)。
消息上行回调地址:指的是ChatAppInbound(消息上行)。

勾选HTTP协议,填写状态报告回调地址和消息上行回调地址。地址示例:
说明建议在服务器端(如
https://xxxx.com)为三类消息分别配置不同的路径(path)进行接收,以便明确区分。
不推荐将三个消息都指向同一个 URL,再通过解析消息体中的某个字段来区分类型。在接收状态报告回调地址填写:https://xxxx.com/appstatus
在接收消息上行回调地址填写:https://xxxx.com/inbound
勾选消息队列监控后,点击确定。
重新点击设置Webhook,弹出的表单即可复制状态回执消息队列和消息上行消息队列。

配置模板审核状态消息
目前仅WhatsApp类型通道支持配置模板审核状态消息。
在左侧导航栏,选择通道管理,点击通道 ID 或者操作列的管理按钮。

进入通道数据面板页面,点击左侧工具栏的。

勾选HTTP协议,填写通知回调地址。
通知回调地址示例:https://xxxx.com/appaudit
勾选消息队列监控后,点击确定。

重新点击通道Webhook设置,弹出的表单即可复制通知队列。

轻量消息队列(原MNS)SDK下载
您可以下载Java SDK安装包拉取轻量消息队列(原MNS)消息。
SDK下载:Java 轻量消息队列(原MNS) SDK