new_releases Updates: In den
Versionshinweisen finden Sie Informationen zu neuen Funktionen und Produktupdates.
UserEvent
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Ein Ereignis, das im RCS-Client des Nutzers aufgetreten ist und sich auf eine Unterhaltung mit dem Agent bezog.
Ein Ereignis kann beispielsweise angeben, dass der Nutzer gerade tippt oder dass der Nutzer eine frühere Nachricht vom Agent gelesen hat.
Das UserEvent wird im Feld „data“ des „message“-Objekts angezeigt, das der Agent über sein Google Pub/Sub-Abo empfängt. Das Feld „data“ ist ein Base64-codierter String, den der Agent decodieren muss, um der UserEvent-Struktur zu entsprechen.
| JSON-Darstellung |
{
"senderPhoneNumber": string,
"eventType": enum (UserEvent.EventType),
"eventId": string,
"messageId": string,
"sendTime": string,
"agentId": string
} |
| Felder |
senderPhoneNumber |
string
Telefonnummer (im E.164-Format) des Nutzers, der an dem Ereignis beteiligt ist.
|
eventType |
enum (UserEvent.EventType)
Art des Ereignisses.
|
eventId |
string
Eine eindeutige Ereignis-ID, die vom RCS-Client des sendenden Nutzers zugewiesen wird.
|
messageId |
string
Die ID der Nachricht, die mit dem Ereignis verknüpft ist. Zum Beispiel eine Nachricht, die an den RCS-Client des Nutzers gesendet oder vom Nutzer gelesen wurde. Dieses Feld wird für die Ereignisse DELIVERED und READ ausgefüllt.
|
sendTime |
string (Timestamp format)
Zeitpunkt, zu dem der RCS-Client das Ereignis sendet. Verwendet RFC 3339. Die generierte Ausgabe wird immer Z-normalisiert und verwendet 0, 3, 6 oder 9 Nachkommastellen. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
|
agentId |
string
Die eindeutige ID des Agents. Von RCS Business Messaging festgelegt.
|
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-22 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-08-22 (UTC)."],[[["\u003cp\u003eUserEvents indicate user actions within an RCS conversation with an agent, such as typing or reading a message.\u003c/p\u003e\n"],["\u003cp\u003eThese events are transmitted to the agent within the base64-encoded "data" field of the "message" object from Google Pub/Sub.\u003c/p\u003e\n"],["\u003cp\u003eThe UserEvent structure includes details like \u003ccode\u003esenderPhoneNumber\u003c/code\u003e, \u003ccode\u003eeventType\u003c/code\u003e, \u003ccode\u003eeventId\u003c/code\u003e, \u003ccode\u003emessageId\u003c/code\u003e, \u003ccode\u003esendTime\u003c/code\u003e, and \u003ccode\u003eagentId\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003emessageId\u003c/code\u003e specifies the message associated with the event, which is only populated for DELIVERED and READ event types.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003esendTime\u003c/code\u003e field details when the event occurred, formatted according to RFC 3339.\u003c/p\u003e\n"]]],[],null,["# UserEvent\n\nAn event that occurred on the user's RCS client and was related to a conversation with the agent.\n\nFor instance, an event can indicate that the user is typing or that an earlier message from the agent was read by the user.\n\nThe UserEvent appears in the \"data\" field of the \"message\" object that the agent receives from its Google Pub/Sub subscription. The \"data\" field is a base64-encoded string that the agent must decode to match the UserEvent structure.\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"senderPhoneNumber\": string, \"eventType\": enum (/business-communications/rcs-business-messaging/reference/rest/v1/UserEvent.EventType), \"eventId\": string, \"messageId\": string, \"sendTime\": string, \"agentId\": string } ``` |\n\n| Fields ||\n|---------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `senderPhoneNumber` | `string` Phone number (in E.164 format) of the user involved in the event. |\n| `eventType` | `enum (`[UserEvent.EventType](/business-communications/rcs-business-messaging/reference/rest/v1/UserEvent.EventType)`)` Type of the event. |\n| `eventId` | `string` A unique event ID, assigned by the sending user's RCS client. |\n| `messageId` | `string` The ID of the message that is associated with the event. For example, a message that was delivered to the user's RCS client or read by the user. This field is populated for DELIVERED and READ events. |\n| `sendTime` | `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` Time at which RCS client sends the event. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than \"Z\" are also accepted. Examples: `\"2014-10-02T15:01:23Z\"`, `\"2014-10-02T15:01:23.045123456Z\"` or `\"2014-10-02T15:01:23+05:30\"`. |\n| `agentId` | `string` The agent's unique identifier. Set by RCS Business Messaging. |"]]
