當您使用Chat App Message ServiceAPI介面發送訊息後,可以通過輕量訊息佇列(原MNS)消費模式或HTTP批量推送模式來接收訊息發送狀態的結果和使用者回複的訊息內容。
注意事項
如果出現網路異常、響應逾時等情況,可能會導致回執訊息推送重複、回執訊息擷取失敗等問題。
回執訊息模式
接收回執訊息的模式有輕量訊息佇列(原MNS)消費模式和HTTP批量推送模式兩種,您可根據實際情況選擇合適的模式接收回執訊息。
回執訊息無法保證等冪性,因此需要您自行處理等冪性的問題。我們建議您在接收到回執訊息後,採取適當的措施來確保資料的正確性和一致性。
輕量訊息佇列(原MNS)消費模式
輕量訊息佇列(原MNS)消費模式表示通過輕量訊息佇列(原MNS)的Queue模型來接收指定地區的簡訊回執訊息。雲通訊的所有業務訊息都支援輕量訊息佇列(原MNS)向外發送。使用者在Chat App Message Service控制台啟用輕量訊息佇列(原MNS)訂閱指定的訊息類型(MessageType)時,系統會自動產生該類型的獨立訊息佇列及名稱(QueueName)。您可使用此訊息佇列名稱(QueueName)和訊息類型(MessageType),通過調用SDK從後台來擷取隊列中的簡訊狀態報表。
HTTP批量推送模式
HTTP批量推送模式表示通過HTTP POST方式發送訊息到指定的Web URL。在Chat App Message Service控制台設定HTTP回調URL(callback_url)後,當業務訊息產生時,系統會使用HTTP請求以POST方式把業務訊息(即上行簡訊訊息或簡訊狀態報表)發送到指定的回調URL上,使用者可直接接收此訊息。
回執訊息類型
選擇回執訊息模式之後,您還需要選擇訊息類型,接收不同情境下的回執訊息。根據簡訊發送狀態、使用者回複的訊息內容等不同情境,我們提供了如下訊息類型,您可根據業務需要進行選擇。
名稱 | 描述 | 輕量訊息佇列(原MNS)消費模式 | HTTP批量推送模式 |
ChatAppInbound(訊息上行) | 上行訊息指使用者發送給企業號碼的訊息,通過訂閱ChatAppInbound上行訊息,可以擷取終端使用者發送訊息的內容。 | ||
ChatAppStatus(下行訊息狀態報表) | 與上行訊息相對應的是下行訊息。下行是指使用者收到的訊息。通過訂閱ChatAppStatus下行狀態報表,可以獲知每條訊息的發送情況,瞭解訊息是否達到終端使用者的狀態與相關資訊。 | ||
ChatAppAudit(模板審核狀態訊息) | 模板審核狀態訊息是指通過CreateChatappTemplate介面建立模板後,可以通過ChatAppAudit介面擷取模板的審核狀態訊息。 |
配置回執訊息接收模式
組態狀態報告/訊息上行
如果您需要接收回執訊息,必須先在Chat App Message Service控制台開啟訊息接收。
在左側導覽列,選擇通道管理,點擊通道 ID 或者操作列的管理按鈕。

進入通道資料面板頁面,根據通道類型,點擊對應的左側導覽列功能。
WhatsApp類型通道:點擊左側導覽列。

Viber類型通道:點擊左側導覽列。

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