全部產品
Search
文件中心

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

更新時間:Nov 26, 2025

當您使用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上行訊息,可以擷取終端使用者發送訊息的內容。

ChatAppInbound

ChatAppInbound

ChatAppStatus(下行訊息狀態報表)

與上行訊息相對應的是下行訊息。下行是指使用者收到的訊息。通過訂閱ChatAppStatus下行狀態報表,可以獲知每條訊息的發送情況,瞭解訊息是否達到終端使用者的狀態與相關資訊。

ChatAppStatus

ChatAppStatus

ChatAppAudit(模板審核狀態訊息)

模板審核狀態訊息是指通過CreateChatappTemplate介面建立模板後,可以通過ChatAppAudit介面擷取模板的審核狀態訊息。

ChatAppAudit

ChatAppAudit

配置回執訊息接收模式

組態狀態報告/訊息上行

如果您需要接收回執訊息,必須先在Chat App Message Service控制台開啟訊息接收。

  1. 登入Chat App Message Service控制台

  2. 在左側導覽列,選擇通道管理,點擊通道 ID 或者操作列的管理按鈕。

    1727246074700_ABEAF096-F1AF-4e81-8822-1D3117BBBB05

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

    1. WhatsApp類型通道:點擊左側導覽列WABA管理 > 設定Webhook

      image

    2. Viber類型通道:點擊左側導覽列服務號管理 > Webhook設定

      image

    3. Messenger類型通道:點擊左側導覽列公用首頁 > 設定Webhook

      image

    4. Instagram類型通道:點擊左側導覽列專業賬戶 > 設定Webhook

      image

  1. 在通道類型所對應的頁面,設定需要訂閱的訊息。

    1. 頁面/賬戶/服務號串連成功後,單擊設定Webhook,勾選需要訂閱的訊息。

      說明

      狀態報表回調地址:指的是ChatAppStatus(狀態報表下行訊息)。

      訊息上行回調地址:指的是ChatAppInbound(訊息上行)。

      image

  2. 勾選HTTP協議,填寫狀態報表回調地址和訊息上行回調地址。地址樣本:

    說明

    建議在伺服器端(如 https://xxxx.com)為三類訊息分別配置不同的路徑(path)進行接收,以便明確區分。
    不推薦將三個訊息都指向同一個 URL,再通過解析訊息體中的某個欄位來區分類型。

    1. 在接收狀態報表回調地址填寫:https://xxxx.com/appstatus

    2. 在接收訊息上行回調地址填寫:https://xxxx.com/inbound

  3. 勾選訊息佇列監控後,點擊確定。

  4. 重新點擊設定Webhook,彈出的表單即可複製狀態回執訊息佇列訊息上行訊息佇列

    image

配置模板審核狀態訊息

說明

目前僅WhatsApp類型通道支援配置模板審核狀態訊息。

  1. 登入Chat App Message Service控制台

  2. 在左側導覽列,選擇通道管理,點擊通道 ID 或者操作列的管理按鈕。

    1727246074700_ABEAF096-F1AF-4e81-8822-1D3117BBBB05

  3. 進入通道資料面板頁面,點擊左側工具列的WABA管理 > 通道Webhook設定

    image

  4. 勾選HTTP協議,填寫通知回調地址。

    1. 通知回調地址樣本:https://xxxx.com/appaudit

    2. 勾選訊息佇列監控後,點擊確定。

    image

  5. 重新點擊通道Webhook設定,彈出的表單即可複製通知隊列

    image

輕量訊息佇列(原MNS)SDK下載

您可以下載Java SDK安裝包拉取輕量訊息佇列(原MNS)訊息。

SDK下載:Java 輕量訊息佇列(原MNS) SDK