REST Resource: phones.agentMessages

{
  "name": string,
  "sendTime": string,
  "contentMessage": {
    object (AgentContentMessage)
  },

  // Union field expiration can be only one of the following:
  "expireTime": string,
  "ttl": string
  // End of list of possible types for union field expiration.
}

string

Dieses Feld wird von der RBM-Plattform festgelegt. Fügen Sie sie nicht hinzu, wenn Sie eine Agent-Nachricht erstellen. Das Feld löst „phones/{E.164}/agentMessages/{messageId}“ auf, wobei {E.164} die Telefonnummer des Nutzers im E.164-Format und {messageId} die vom Agent zugewiesene ID der Agent-Nachricht ist.

string (Timestamp format)

Dieses Feld wird von der RBM-Plattform festgelegt. Fügen Sie sie nicht hinzu, wenn Sie eine Agent-Nachricht erstellen. Das Feld löst den Zeitpunkt auf, zu dem die Nachricht an den Nutzer gesendet wird.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

object (AgentContentMessage)

Der Inhalt der Agent-Nachricht.

string (Timestamp format)

Optional. Der Zeitstempel in UTC, der angibt, wann diese Ressource als abgelaufen gilt. Dieser Wert wird in der Ausgabe angegeben, wenn er festgelegt oder das Feld „TTL“ konfiguriert ist.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

string (Duration format)

Optional. Nur Eingabe. Die Gültigkeitsdauer der Nachricht, bevor sie automatisch widerrufen wird.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".

{
  "suggestions": [
    {
      object (Suggestion)
    }
  ],

  // Union field content can be only one of the following:
  "text": string,
  "fileName": string,
  "uploadedRbmFile": {
    object (UploadedRbmFile)
  },
  "richCard": {
    object (RichCard)
  },
  "contentInfo": {
    object (ContentInfo)
  }
  // End of list of possible types for union field content.
}

object (Suggestion)

Eine Liste mit Antwortvorschlägen und vorgeschlagenen Aktionen, die als Liste mit Vorschlags-Chips nach der zugehörigen Nachricht an einen Kundenservicemitarbeiter angezeigt werden. Maximal 11 Vorschläge.

Die Chips werden nur angezeigt, wenn die zugehörige Agent-Nachricht die neueste Nachricht in der Unterhaltung ist (einschließlich Agent- und Nutzernachrichten). Der Nutzer kann auf eine vorgeschlagene Antwort tippen, um die Textantwort an den Kundenservicemitarbeiter zu senden, oder auf eine vorgeschlagene Aktion tippen, um eine native Aktion auf dem Gerät zu starten.

string

Text ist in UTF-8 codiert.

string

Der eindeutige Name einer Datei. Die RBM-Plattform gibt einen Dateinamen zurück, wenn ein Agent eine Datei hochlädt. Wurde zugunsten von "uploadRbmFile" unten eingestellt

object (UploadedRbmFile)

Enthält Kennungen für eine Datei und ein Thumbnail, die auf den RBM-Server hochgeladen und von diesem bereitgestellt wurden

object (RichCard)

Eine eigenständige interaktive Chat-Nachricht.

object (ContentInfo)

Informationen zu einer Datei, einschließlich der URL der Datei und der URL der Miniaturansicht der Datei.

Die RBM-Plattform stellt Inhalte aus einem Cache bereit, aber ein Agent kann die RBM-Plattform zwingen, eine neue Version des Inhalts abzurufen und den Cache zu aktualisieren.

{
  "fileName": string,
  "thumbnailName": string
}

string

Der Name der Datei, der von der RBM-Plattform beim Hochladen der Datei zurückgegeben wurde.

string

Der Name des Thumbnails, der beim Hochladen des Thumbnails von der RBM-Plattform zurückgegeben wurde.

{

  // Union field card can be only one of the following:
  "carouselCard": {
    object (CarouselCard)
  },
  "standaloneCard": {
    object (StandaloneCard)
  }
  // End of list of possible types for union field card.
}

object (CarouselCard)

Kartenkarussell

object (StandaloneCard)

Eigenständige Karte.

{
  "cardWidth": enum (CarouselCard.CardWidth),
  "cardContents": [
    {
      object (CardContent)
    }
  ]
}

enum (CarouselCard.CardWidth)

Die Breite der Karten im Karussell.

object (CardContent)

Die Inhaltsliste für jede Karte im Karussell. Ein Karussell kann mindestens 2 und maximal 10 Karten enthalten.

{
  "title": string,
  "description": string,
  "media": {
    object (Media)
  },
  "suggestions": [
    {
      object (Suggestion)
    }
  ]
}

string

Optional: Titel der Karte. Maximal 200 Zeichen.

string

Optional: Beschreibung der Karte. Maximal 2.000 Zeichen.

object (Media)

Optional: Medien (Bild, GIF, Video), die in die Karte aufgenommen werden sollen.

object (Suggestion)

Optional: Liste der Vorschläge für die Karte. Maximal vier Vorschläge.

{
  "height": enum (Media.Height),

  // Union field content can be only one of the following:
  "fileName": string,
  "uploadedRbmFile": {
    object (UploadedRbmFile)
  },
  "contentInfo": {
    object (ContentInfo)
  }
  // End of list of possible types for union field content.
}

enum (Media.Height)

Die Höhe der Medien in einer Rich Card mit vertikalem Layout. Bei einer eigenständigen Karte mit horizontalem Layout kann die Höhe nicht angepasst werden. Dieses Feld wird ignoriert.

string

Der eindeutige Name der Datei, der von der RBM-Plattform beim Hochladen der Datei zurückgegeben wird. Wurde zugunsten von "uploadRbmFile" unten eingestellt

object (UploadedRbmFile)

Enthält Kennungen für eine Datei und ein Thumbnail, die auf den RBM-Server hochgeladen und von diesem bereitgestellt wurden

object (ContentInfo)

Informationen zu einer Datei, einschließlich der URL der Datei und der URL der Miniaturansicht der Datei.

Die RBM-Plattform stellt Inhalte aus einem Cache bereit, aber ein Agent kann die RBM-Plattform zwingen, eine neue Version des Inhalts abzurufen und den Cache zu aktualisieren.

{
  "fileUrl": string,
  "thumbnailUrl": string,
  "forceRefresh": boolean
}

string

Öffentlich erreichbare URL der Datei Die RBM-Plattform bestimmt den MIME-Typ der Datei aus dem Feld für den Inhaltstyp in den HTTP-Headern, wenn die Plattform die Datei abruft. Das Feld "content-type" muss in der HTTP-Antwort der URL vorhanden und korrekt sein. Die empfohlene maximale Dateigröße beträgt 100 MB.

string

(Optional, nur für Bild-, Audio- und Videodateien) Öffentlich erreichbare URL der Miniaturansicht. Maximale Größe: 100 KB

Wenn Sie keine Miniaturansicht-URL angeben, zeigt die RBM-Plattform eine leere Platzhalter-Miniaturansicht an, bis das Gerät des Nutzers die Datei herunterlädt. Je nach Nutzereinstellung wird die Datei möglicherweise nicht automatisch heruntergeladen und der Nutzer muss auf eine Downloadschaltfläche tippen.

boolean

Wenn festgelegt, ruft die RBM-Plattform die Datei und die Miniaturansicht von den angegebenen URLs ab, auch wenn die Plattform Kopien der Datei (und/oder der Miniaturansicht) im Cache gespeichert hat.

{

  // Union field option can be only one of the following:
  "reply": {
    object (SuggestedReply)
  },
  "action": {
    object (SuggestedAction)
  }
  // End of list of possible types for union field option.
}

object (SuggestedReply)

Nutzer können auf eine vorgeschlagene Antwort tippen, um die Textantwort an den Kundenservicemitarbeiter zu senden.

object (SuggestedAction)

Nutzer können auf eine vorgeschlagene Aktion tippen, um die entsprechende native Aktion auf dem Gerät zu starten.

{
  "text": string,
  "postbackData": string
}

string

Text, der in der vorgeschlagenen Antwort angezeigt und an den Kundenservicemitarbeiter zurückgesendet wird, wenn der Nutzer darauf tippt. Maximal 25 Zeichen.

string

Die base64-codierte Nutzlast, die der Agent bei einem Nutzerereignis empfängt, wenn der Nutzer auf die vorgeschlagene Antwort tippt.

{
  "text": string,
  "postbackData": string,
  "fallbackUrl": string,

  // Union field action can be only one of the following:
  "dialAction": {
    object (DialAction)
  },
  "viewLocationAction": {
    object (ViewLocationAction)
  },
  "createCalendarEventAction": {
    object (CreateCalendarEventAction)
  },
  "openUrlAction": {
    object (OpenUrlAction)
  },
  "shareLocationAction": {
    object (ShareLocationAction)
  }
  // End of list of possible types for union field action.
}

string

Text, der in der vorgeschlagenen Aktion angezeigt wird. Maximal 25 Zeichen.

string

Base64-codierte Nutzlast, die im Nutzerereignis an den Agent gesendet wird, das entsteht, wenn der Nutzer auf die vorgeschlagene Aktion tippt

string

Optional: Fallback-URL, die verwendet wird, wenn ein Client eine vorgeschlagene Aktion nicht unterstützt. Fallback-URLs werden in einem neuen Browserfenster geöffnet.

object (DialAction)

Öffnet die Standard-Telefon-App des Nutzers mit der vom Agent angegebenen Telefonnummer.

object (ViewLocationAction)

Öffnet die Standardkarten-App des Nutzers und wählt den vom Agent angegebenen Standort aus oder sucht anhand einer Agent-spezifischen Anfrage in der Nähe des Nutzerstandorts.

object (CreateCalendarEventAction)

Öffnet die Standardkalender-App des Nutzers und startet den neuen Ablauf für Kalenderereignisse, wobei die vom Agent angegebenen Termindaten vorausgefüllt sind.

object (OpenUrlAction)

Öffnet die Standard-Webbrowser-App des Nutzers unter der angegebenen URL. Wenn der Nutzer eine App installiert hat, die als Standard-Handler für die URL registriert ist, wird stattdessen diese App geöffnet und ihr Symbol wird in der UI für vorgeschlagene Aktionen verwendet.

object (ShareLocationAction)

Öffnet die Standortauswahl der RCS-App, damit der Nutzer einen Standort auswählen kann, der an den Agent gesendet werden soll.

{
  "phoneNumber": string
}

string

Die Telefonnummer im E.164-Format, z. B. +12223334444.

{
  "latLong": {
    object (LatLng)
  },
  "label": string,
  "query": string
}

object (LatLng)

(Optional) Breiten- und Längengrad des angegebenen Standorts.

string

Optional: Das Label der Markierung, das auf latLong gesetzt wurde.

string

(Optional, nur in Android Messages-Clients unterstützt): Statt einen latLong-Wert (und optional ein Label) anzugeben, kann der Agent stattdessen einen Abfragestring angeben. Bei Standardkarten-Apps, die Suchfunktionen unterstützen (einschließlich Google Maps), kann das Tippen auf diese vorgeschlagene Aktion in einer Standortsuche auf den aktuellen Standort des Nutzers erfolgen. Wenn die Abfrage ausreichend spezifisch ist, können Kundenservicemitarbeiter damit einen beliebigen Standort auf der Welt auswählen.

Wenn Sie z. B. den Abfragestring auf „Wachsen-Baumbank“ setzen, zeigt alle Growing Tree Bank-Standorte in der Nähe des Nutzers an. Festlegen der Abfragezeichenfolge auf "1600 Amphitheater Parkway, Mountain View, CA 94043" wählt diese Adresse unabhängig vom Standort des Nutzers aus.

{
  "latitude": number,
  "longitude": number
}

number

Der Breitengrad in Grad. Er muss im Bereich [-90,0, +90,0] liegen.

number

Der Längengrad in Grad. Er muss im Bereich [-180,0, +180,0] liegen.

{
  "startTime": string,
  "endTime": string,
  "title": string,
  "description": string
}

string (Timestamp format)

Beginn des Ereignisses.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

Ende des Termins.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

string

Termintitel

string

Ereignisbeschreibung

{
  "url": string
}

string

URL

{
  "cardOrientation": enum (StandaloneCard.CardOrientation),
  "thumbnailImageAlignment": enum (StandaloneCard.ThumbnailImageAlignment),
  "cardContent": {
    object (CardContent)
  }
}

enum (StandaloneCard.CardOrientation)

Ausrichtung der Karte.

enum (StandaloneCard.ThumbnailImageAlignment)

Ausrichtung der Bildvorschau für eigenständige Karten mit horizontalem Layout.

object (CardContent)

Karteninhalt.