UserEvent

Ein Ereignis, das auf dem RCS-Client des Nutzers aufgetreten ist und sich auf eine Unterhaltung mit dem Kundenservicemitarbeiter bezieht.

Ein Ereignis kann beispielsweise angeben, dass der Nutzer gerade etwas eintippt oder dass er eine frühere Nachricht des Kundenservicemitarbeiters gelesen hat.

Das UserEvent wird im Feld „data“ des „message“-Objekts angezeigt, das der Kundenservicemitarbeiter über sein Google Pub/Sub-Abo empfängt. Das Feld „data“ ist ein Base64-codierter String, den der Kundenservicemitarbeiter decodieren muss, damit er der Struktur „UserEvent“ entspricht.

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 am Ereignis beteiligt ist.

eventType

enum (UserEvent.EventType)

Typ 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. 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.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

agentId

string

Die eindeutige Kennung des Kundenservicemitarbeiters. Von RCS Business Messaging festgelegt.