UserEvent

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

舉例來說,事件可以指出使用者正在輸入內容,或是使用者已讀取代理人先前傳送的訊息。

代理程式從 Google Pub/Sub 訂閱收到的「message」物件中,「data」欄位會顯示 UserEvent。「data」欄位是採用 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

由傳送使用者的 RCS 用戶端指派的專屬事件 ID。

messageId

string

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

sendTime

string (Timestamp format)

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

使用 RFC 3339,產生的輸出內容一律會經過 Z 規格化,並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z""2014-10-02T15:01:23+05:30"

agentId

string

代理程式的專屬 ID。由 RCS Business Messaging 設定。