當您使用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類型通道-號碼管理、Viber類型通道-服務號管理、Messenger類型通道-公共主頁、Instagram類型-專業賬戶。
在通道類型所對應的頁面,設置需要訂閱的消息。
WhatsApp-號碼管理
手機號碼驗證通過后,單擊通道Webhook設置,勾選需要訂閱的消息。
勾選HTTP協議,填寫通知回調地址。地址示例:http://push.example.com/contextpath/receive.do
勾選消息隊列監控。
Messenger-公共主頁/Instagram-專業賬戶
頁面/賬戶連接成功后,單擊設置Webhook,勾選需要訂閱的消息。
勾選HTTP協議,填寫狀態報告回調地址和消息上行回調地址。地址示例:http://push.example.com/contextpath/receive.do
勾選消息隊列監控。
輕量消息隊列(原MNS)SDK下載
您可以下載Java SDK安裝包拉取輕量消息隊列(原MNS)消息。
SDK下載:Java 輕量消息隊列(原MNS) SDK