全部產品
Search
文件中心

Chat App Message Service:ChatAppStatus(下行訊息狀態報表)

更新時間:Nov 26, 2025

您可以通過輕量訊息佇列(原MNS)接收ChatApp訊息發送狀態報表(ChatAppStatus)。

前提條件

說明

配置下行訊息狀態報表操作步驟參見:組態狀態報告/訊息上行

訊息體格式

名稱

類型

是否必填

描述

MessageId

String

訊息的ID。

From

String

訊息發送方號碼。

To

String

訊息接收方號碼。

Timestamp

Long

時間戳記為Unix timestamp 毫秒。

Status

String

訊息發送狀態。取值:

  • Sent:訊息已發送。

  • Delivered:訊息已投遞到使用者裝置。

  • Read:訊息已被使用者閱讀。

  • Failed:訊息發送失敗。

  • Deleted:訊息已被使用者刪除。

    說明

    Deleted狀態暫不可用,WhatsApp不會推送給ChatAppMessage Service。

StatusDescription

String

狀態代碼的描述。

ErrorCode

String

錯誤碼。

ErrorDescription

String

錯誤碼描述。詳情請參見API錯誤碼

ConversationType

String

會話類型。取值:

  • service:使用者發起會話

  • utility交易相關訊息

  • marketing營銷類訊息

  • authentication身分識別驗證訊息

ConversationId

String

會話ID。

ConversionExpirationTime(過時)

Long

會話到期時間。

說明

針對新的按條計費規則時已無效。

MsgFrameType

String

訊息類型。取值:

  • message:任意格式的訊息,時間限制為在收到使用者最後一條訊息後的24小時內可發送此類訊息。

  • template:在控制台已被審核通過的訊息模板,可以在任意時間發送。

Type

String

訊息內容中多媒體資源類型。取值:

  • image:圖片

  • video:視頻

  • document:文檔

  • audio:音頻

  • none:純文字

TaskId

String

客戶任務ID。預設取值MessageId。

說明

如果TaskId未傳值,則TaskId=MessageId。

OriginPhoneNumber

String

訊息發送方的真實號碼。

TemplateCode

String

訊息模板編碼。

說明

當MsgFrameType=template時有值。