文档

回执消息简介与配置流程

更新时间:

当您使用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 消息服务控制台开启消息接收。

  1. 登录Chat App 消息服务控制台

  2. 在左侧导航栏,选择通道管理 > 消息通道66

  3. 消息通道页面,设置需要订阅的消息。

    说明

    queueName是MNS消息队列的名称,您可在WebHook设置页面查看。

    上行消息、下行回执报告消息

    手机号码验证通过后,单击WebHook设置,勾选需要订阅的消息。19

    1. 勾选HTTP协议,填写状态报告回调地址和消息上行回调地址。地址示例:http://push.example.com/contextpath/receive.do

    2. 勾选消息队列监控

    模板审核状态消息

    单击模板Webhook设置,勾选需要订阅的消息。20

    1. 勾选HTTP协议,填写模板审核通知回调地址。地址示例:http://push.example.com/contextpath/receive.do

    2. 勾选消息队列监控

MNS消息队列SDK下载

您可以下载Java SDK安装包拉取MNS消息。

SDK下载:Java MNS SDK

  • 本页导读 (1)