ServerEvent

伺服器端發生的事件,與代理程式和使用者之間的對話相關。

舉例來說,如果機器人為訊息設定 TTL,且 TTL 已過期,系統就會觸發這項事件,通知合作夥伴機器人訊息已逾時。

ServerEvent 會顯示在代理程式從 Pub/Sub 訂閱項目收到的「message」物件的「data」欄位中。「data」欄位是 Base64 編碼的字串,代理程式必須解碼才能符合 ServerEvent 結構。

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

string

涉及事件的使用者電話號碼 (E.164 格式)。

agentId

string

代理程式的專屬 ID。由企業專用 RCS 設定。

messageId

string

與事件相關聯的訊息 RCS 訊息 ID。

eventType

enum (ServerEvent.EventType)

活動類型。

eventId

string

指派給活動例項的專屬活動 ID。

sendTime

string (Timestamp format)

伺服器傳送事件的時間。

使用 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"