全部產品
Search
文件中心

Short Message Service:回執訊息簡介與配置流程

更新時間:Oct 23, 2024

回執訊息是在使用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簡訊下行狀態報表,可以獲知每條簡訊的發送情況,瞭解簡訊是否達到終端使用者的狀態與相關資訊。

SMS webhook

SmsReport

配置回執訊息接收模式

如果您需要接收回執訊息,必須先在簡訊服務控制台上開啟訊息接收。以下樣本展示如何配置簡訊下行回執訊息報告。

  1. 登入簡訊服務控制台

  2. 在左側導覽列,選擇系統設定 > 通用設定

  3. 通用設定頁面,單擊介面API頁簽。

  4. 雲通訊訊息接收地區,開啟指定模式。

    • MNS訊息佇列消費模式

      開啟MNS訊息佇列消費模式左側的功能開關。MNS配置

    • HTTP批量推送模式

      1. 開啟HTTP批量推送模式左側的功能開關。

      2. 填寫接收地址,地址樣本:http://push.example.com/contextpath/receive.do。

      3. 單擊儲存HTTP配置

MNS訊息佇列消費模式請求參數

名稱

類型

是否必選

樣本值

描述

MessageType

String

SmsReport

訊息類型:SmsReport。

QueueName

String

Alicom-Queue-*****-SmsReport

提供的訊息佇列名稱。登入簡訊服務控制台,選擇系統設定 > 通用設定 > 介面API,查看隊列名稱。