UserEvent

發生在使用者 RCS 用戶端中的事件,與服務專員的對話相關。

舉例來說,事件可能表示使用者正在輸入訊息,或表示使用者已閱讀服務專員稍早的訊息。

UserEvent 會出現在代理程式從 Google Cloud Pub/Sub 訂閱項目接收的「訊息」物件中。「資料」欄位是採用 Base64 編碼的字串,代理程式必須解碼才能符合 UserEvent 結構。

JSON 表示法
{
  "senderPhoneNumber": string,
  "eventType": enum (UserEvent.EventType),
  "eventId": string,
  "messageId": string,
  "sendTime": string,
  "agentId": string
}
欄位
senderPhoneNumber

string

事件相關使用者的電話號碼 (採用 E.164 格式)。

eventType

enum (UserEvent.EventType)

活動類型。

eventId

string

專屬活動 ID,由傳送者的 RCS 用戶端指派。代理程式應將具有相同 (eventId、sendPhoneNumber) 組合的事件視為非預期的重複事件。

messageId

string

與事件相關聯的訊息 ID。例如傳送給使用者的 RCS 用戶端或使用者讀取的訊息。這個欄位會填入「DELIVERED」和「READ」事件。

sendTime

string (Timestamp format)

RCS 用戶端傳送事件的時間。

RFC3339 世界標準時間「祖魯文」格式的時間戳記,含奈秒解析度,最多九個小數位數。範例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

agentId

string

服務專員的專屬 ID。由 RCS Business Messaging 設定。