回執訊息是在使用API介面傳送簡訊之後,通過配置MNS訊息佇列消費模式或HTTP批量推送模式,協助您掌握簡訊的發送成功率和其他業務提供支援。
如果出現網路異常、響應逾時等情況,可能導致回執訊息推送重複、回執訊息擷取失敗等問題。
由於系統存在緩衝,開啟回執訊息後不會立即全量推送,建議等待3分鐘後確認是否已生效。
回執訊息無法保證等冪性,因此需要您自行處理等冪性的問題。建議您在接收到回執訊息後,採取適當的措施來確保資料的正確性和一致性。
回執訊息模式
簡訊服務接收回執訊息的模式有MNS訊息佇列消費模式和HTTP批量推送模式兩種,您可根據實際情況選擇合適的模式接收回執訊息。
MNS訊息佇列消費模式
MNS訊息佇列消費模式表示通過MNS的Queue模型來接收指定地區的簡訊回執訊息。雲通訊的所有業務訊息都支援MNSMessage Service向外發送。使用者在簡訊服務控制台啟用MNSMessage Service訂閱指定的訊息類型(MessageType)時,系統會自動產生該類型的獨立訊息佇列及名稱(QueueName)。您可使用此訊息佇列名稱(QueueName)和訊息類型(MessageType),通過調用SDK從後台來擷取隊列中的簡訊狀態報表。
HTTP批量推送模式
HTTP批量推送模式表示通過HTTP POST方式發送訊息到指定的Web URL。在簡訊服務控制台設定HTTP回調URL(callback_url)後,當業務訊息產生時,系統會使用HTTP請求以POST方式將業務訊息(即簡訊狀態報表)發送到指定的回調URL上,使用者可直接接收此訊息。
回執訊息類型
選擇回執訊息模式之後,您還需要選擇訊息類型,接收不同情境下的回執訊息。我們提供了如下訊息類型,您可根據業務需要進行選擇。
名稱 | 描述 | MNS訊息佇列消費模式 | HTTP批量推送模式 |
SmsReport(簡訊下行回執報告訊息) | 下行是指使用者收到的簡訊,例如電訊廠商發送的訊息通知、業務提醒等簡訊。通過訂閱SmsReport簡訊下行狀態報表,可以獲知每條簡訊的發送情況,瞭解簡訊是否達到終端使用者的狀態與相關資訊。 |
配置回執訊息接收模式
如果您需要接收回執訊息,必須先在簡訊服務控制台上開啟訊息接收。以下樣本展示如何配置簡訊下行回執訊息報告。
登入簡訊服務控制台。
在左側導覽列,選擇
。在通用設定頁面,單擊介面API頁簽。
在雲通訊訊息接收地區,開啟指定模式。
MNS訊息佇列消費模式
開啟MNS訊息佇列消費模式左側的功能開關。
HTTP批量推送模式
開啟HTTP批量推送模式左側的功能開關。
填寫接收地址,地址樣本:http://push.example.com/contextpath/receive.do。
單擊儲存。
MNS訊息佇列消費模式請求參數
名稱 | 類型 | 是否必選 | 樣本值 | 描述 |
MessageType | String | 是 | SmsReport | 訊息類型:SmsReport。 |
QueueName | String | 是 | Alicom-Queue-*****-SmsReport | 提供的訊息佇列名稱。登入簡訊服務控制台,選擇 ,查看隊列名稱。 |