UserEvent

在用户的 RCS 客户端上发生的事件,与与代理的对话相关。

例如,一个事件可能表示用户正在输入,或该用户之前阅读了代理中之前的消息。

UserEvent 出现在“数据”部分中,“message”字段对象从其 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, senderPhoneNumber) 对的事件视为意外重复。

messageId

string

与事件关联的消息的 ID。例如,发送到用户的 RCS 客户端或用户阅读的信息。对于 DELIVERED 和 READ 事件,系统会填充此字段。

sendTime

string (Timestamp format)

RCS 客户端发送事件的时间。

时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

agentId

string

代理的唯一标识符。由 RCS Business Messaging 设置。