与代理的对话有关的事件,发生在用户的 RCS 客户端上。
例如,事件可以指示用户正在输入,或者用户已经阅读了代理发送的一条早前消息。
UserEvent 显示在代理从其 Google Cloud Pub/Sub 订阅收到的“message”对象的“data”字段中。“data”字段是一个 base64 编码的字符串,代理必须解码该字符串,才能匹配 UserEvent 结构。
JSON 表示法 |
---|
{
"senderPhoneNumber": string,
"eventType": enum ( |
字段 | |
---|---|
senderPhoneNumber |
事件涉及的用户的电话号码(采用 E.164 格式)。 |
eventType |
事件的类型。 |
eventId |
唯一的事件 ID,由发送消息的用户的 RCS 客户端分配。代理应将具有相同(eventId、SenderPhoneNumber)对的事件视为意外重复。 |
messageId |
与事件相关联的消息的 ID。例如,发送到用户的 RCS 客户端或用户读取的消息。对于 DELIVERED 和 READ 事件,将填充此字段。 |
sendTime |
RCS 客户端发送事件的时间。 时间戳,采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式,分辨率为纳秒,最多包含九个小数位。示例: |
agentId |
代理的唯一标识符。由 RCS Business Messaging 设置。 |