全部產品
Search
文件中心

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

更新時間:Apr 21, 2026

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

前提條件

說明

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

訊息體格式

名稱

類型

是否必填

描述

MessageId

String

訊息的ID。

From

String

訊息發送方號碼。

To

String

訊息接收方號碼。

UserId

String

BSUID

ParentUserId

String

父級 BSUID(如果有)

UserName

String

使用者帳號(如果有)

Timestamp

Long

時間戳記為Unix timestamp 毫秒。

Status

String

訊息發送狀態。取值:

  • Sent:訊息已發送。

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

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

  • Failed:訊息發送失敗。

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

    說明

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

  • unsubscribe:使用者屏蔽商家帳號。

  • subscribe:使用者取消對商家帳號的屏蔽。

    說明

    unsubscribe和subscribe僅對 Viber通道適用。

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時有值。