什么是回执消息,如何配置回执消息接收模式-Chat App 消息服务(Chat App)-阿里云帮助中心

当您使用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上行消息，可以获取终端用户发送消息的内容。	ChatAppInbound	ChatAppInbound
ChatAppStatus（下行消息状态报告）	与上行消息相对应的是下行消息。下行是指用户收到的消息。通过订阅ChatAppStatus下行状态报告，可以获知每条消息的发送情况，了解消息是否达到终端用户的状态与相关信息。	ChatAppStatus	ChatAppStatus
ChatAppAudit（模板审核状态消息）	模板审核状态消息是指通过CreateChatappTemplate接口创建模板后，可以通过ChatAppAudit接口获取模板的审核状态消息。	ChatAppAudit	ChatAppAudit

如果您需要接收回执消息，必须先在Chat App 消息服务控制台开启消息接收。

登录Chat App 消息服务控制台。
在左侧导航栏，选择通道管理，点击通道 ID 或者操作列的管理按钮。
进入通道数据面板页面，根据通道类型，点击对应的左侧导航栏功能。
1. WhatsApp类型通道：点击左侧导航栏WABA管理 > 设置Webhook。
2. Messenger类型通道：点击左侧导航栏公共主页 > 设置Webhook。
3. Instagram类型通道：点击左侧导航栏专业账户 > 设置Webhook。

说明

目前仅WhatsApp类型通道支持配置模板审核状态消息。

登录Chat App 消息服务控制台。
在左侧导航栏，选择通道管理，点击通道 ID 或者操作列的管理按钮。
进入通道数据面板页面，点击左侧工具栏的WABA管理 > 通道Webhook设置。
勾选HTTP协议，填写通知回调地址。
1. 通知回调地址示例：https://xxxx.com/appaudit
2. 勾选消息队列监控后，点击确定。
在通道Webhook设置对话框中，勾选消息队列监控后会显示通知队列字段（可复制队列地址），并根据需要选择API版本。
重新点击通道Webhook设置，弹出的表单即可复制通知队列。

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