Risorsa: AgentMessage
Messaggio inviato dall'agente a un utente.
Rappresentazione JSON |
---|
{ "name": string, "sendTime": string, "contentMessage": { object ( |
Campi | |
---|---|
name |
Questo campo è impostato dalla piattaforma RBM. Non includerlo durante la creazione di un messaggio agente. Il campo risolve "phones/{E.164}/agentMessages/{messageId}", dove {E.164} è il numero di telefono dell'utente in formato E.164 e {messageId} è l'ID assegnato dall'agente del messaggio dell'agente. |
sendTime |
Questo campo è impostato dalla piattaforma RBM. Non includerlo durante la creazione di un messaggio agente. Il campo determina l'ora in cui il messaggio viene inviato all'utente. Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
contentMessage |
Il contenuto del messaggio dell'agente. |
Campo di unione
|
|
expireTime |
Campo facoltativo. Timestamp in UTC relativo al momento in cui la risorsa è considerata scaduta. Questo valore viene fornito nell'output se è impostato o se è impostato il campo TTL. Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
ttl |
Campo facoltativo. Solo input. Solo input. Per quanto tempo il messaggio rimarrà attivo prima della revoca automatica. Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
AgentContentMessage
Il contenuto di un messaggio inviato dall'agente a un utente.
Rappresentazione JSON |
---|
{ "suggestions": [ { object ( |
Campi | |
---|---|
suggestions[] |
Un elenco di risposte suggerite e azioni suggerite che vengono visualizzate sotto forma di elenco di chip di suggerimenti che seguono il messaggio dell'agente associato. Massimo 11 suggerimenti. I chip vengono visualizzati solo quando il messaggio dell'agente associato è quello più recente nella conversazione, inclusi i messaggi dell'agente e degli utenti. L'utente può toccare una risposta suggerita per inviare la risposta testuale all'agente o toccare un'azione suggerita per avviare un'azione nativa sul dispositivo. |
Campo di unione content . Il contenuto del messaggio dell'agente content può essere solo uno dei seguenti: |
|
text |
Testo codificato in UTF-8. |
fileName |
Il nome univoco di un file. La piattaforma RBM restituisce un nome file quando un agente carica un file. Deprecato in favore di uploadedRbmFile di seguito |
uploadedRbmFile |
Contiene gli identificatori di un file e di una miniatura che sono stati caricati e pubblicati dal server RBM |
richCard |
Una scheda informativa a sé stante. |
contentInfo |
Informazioni su un file, inclusi l'URL del file e l'URL della relativa miniatura. La piattaforma RBM gestisce i contenuti da una cache, ma un agente può forzare la piattaforma RBM a recuperare una nuova versione dei contenuti e aggiornare la cache. |
UploadedRbmFile
Messaggio contenente informazioni sul file e sulla miniatura
Rappresentazione JSON |
---|
{ "fileName": string, "thumbnailName": string } |
Campi | |
---|---|
fileName |
Il nome del file, restituito dalla piattaforma RBM al momento del caricamento del file. |
thumbnailName |
Il nome della miniatura, restituito dalla piattaforma RBM al momento del caricamento della miniatura. |
RichCard
Una scheda informativa indipendente o un carosello di schede interattive inviate dall'agente all'utente.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo di unione card . Una scheda separata o un carosello di schede. card può essere solo uno dei seguenti: |
|
carouselCard |
Carosello di schede. |
standaloneCard |
Scheda indipendente. |
CarouselCard
Carosello di schede.
Rappresentazione JSON |
---|
{ "cardWidth": enum ( |
Campi | |
---|---|
cardWidth |
La larghezza delle schede nel carosello. |
cardContents[] |
L'elenco dei contenuti per ciascuna scheda nel carosello. Un carosello può avere un minimo di 2 e un massimo di 10 schede. |
CarouselCard.CardWidth
La larghezza delle schede nel carosello.
Enum | |
---|---|
CARD_WIDTH_UNSPECIFIED |
Non specificato. |
SMALL |
120 DP. Tieni presente che non è possibile utilizzare contenuti multimediali alti. |
MEDIUM |
232 DP. |
CardContent
Contenuti della scheda
Rappresentazione JSON |
---|
{ "title": string, "description": string, "media": { object ( |
Campi | |
---|---|
title |
(Facoltativo) Titolo della scheda. Massimo 200 caratteri. |
description |
(Facoltativo) Descrizione della carta. Massimo 2000 caratteri. |
media |
(Facoltativo) Contenuti multimediali (immagini, GIF, video) da includere nella scheda. |
suggestions[] |
(Facoltativo) Elenco di suggerimenti da includere nella scheda. Massimo 4 suggerimenti. |
Contenuti multimediali
Un file multimediale all'interno di una scheda interattiva.
Rappresentazione JSON |
---|
{ "height": enum ( |
Campi | |
---|---|
height |
L'altezza dell'elemento multimediale all'interno di una scheda interattiva con layout verticale. Per una scheda autonoma con layout orizzontale, l'altezza non è personalizzabile e questo campo viene ignorato. |
Campo di unione content . I contenuti multimediali content possono essere solo uno dei seguenti: |
|
fileName |
Il nome univoco del file, restituito dalla piattaforma RBM al momento del caricamento del file. Deprecato in favore di uploadedRbmFile di seguito |
uploadedRbmFile |
Contiene gli identificatori di un file e di una miniatura che sono stati caricati e pubblicati dal server RBM |
contentInfo |
Informazioni su un file, inclusi l'URL del file e l'URL della relativa miniatura. La piattaforma RBM gestisce i contenuti da una cache, ma un agente può forzare la piattaforma RBM a recuperare una nuova versione dei contenuti e aggiornare la cache. |
ContentInfo
Messaggio contenente le informazioni sui contenuti.
Rappresentazione JSON |
---|
{ "fileUrl": string, "thumbnailUrl": string, "forceRefresh": boolean } |
Campi | |
---|---|
fileUrl |
URL raggiungibile pubblicamente del file. La piattaforma RBM determina il tipo MIME del file dal campo content-type nelle intestazioni HTTP quando la piattaforma recupera il file. Il campo content-type deve essere presente e preciso nella risposta HTTP dall'URL. La dimensione massima consigliata del file è 100 MB. |
thumbnailUrl |
(Facoltativo, solo per file immagine e video) URL raggiungibile pubblicamente della miniatura. Dimensione massima: 100 kB. Se non fornisci un URL miniatura, la piattaforma RBM visualizza una miniatura segnaposto vuota fino a quando il dispositivo dell'utente non scarica il file. A seconda dell'impostazione dell'utente, il file potrebbe non essere scaricato automaticamente e l'utente potrebbe dover toccare un pulsante di download. |
forceRefresh |
Se impostata, la piattaforma RBM recupera il file e la miniatura dagli URL specificati, anche se la piattaforma ha copie cache del file (e/o della miniatura). |
Media.Height
Altezza media
Enum | |
---|---|
HEIGHT_UNSPECIFIED |
Non specificato. |
SHORT |
112 DP. |
MEDIUM |
168 DP. |
TALL |
264 DP. Non disponibile per i caroselli di schede interattive quando la larghezza delle schede è impostata su piccola. |
Suggerimento
Una risposta suggerita o un'azione suggerita inclusi in una scheda informativa o in un elenco di chip di suggerimenti.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo di unione option . Una risposta suggerita o un'azione suggerita option può essere solo uno dei seguenti: |
|
reply |
Gli utenti possono toccare una risposta suggerita per inviare la risposta all'agente. |
action |
Gli utenti possono toccare un'azione suggerita per avviare l'azione nativa corrispondente sul dispositivo. |
SuggestedReply
Quando l'utente lo tocca, invia il messaggio di risposta all'agente.
Rappresentazione JSON |
---|
{ "text": string, "postbackData": string } |
Campi | |
---|---|
text |
Testo visualizzato nella risposta suggerita e inviato all'agente quando l'utente la tocca. Massimo 25 caratteri. |
postbackData |
Il payload con codifica Base64 che l'agente riceve in un evento utente quando l'utente tocca la risposta suggerita. |
SuggestedAction
Se l'utente lo tocca, avvia l'azione nativa corrispondente sul dispositivo.
Rappresentazione JSON |
---|
{ "text": string, "postbackData": string, "fallbackUrl": string, // Union field |
Campi | |
---|---|
text |
Testo visualizzato nell'azione suggerita. Massimo 25 caratteri. |
postbackData |
Payload (con codifica Base64) che verrà inviato all'agente nell'evento utente generato quando l'utente tocca l'azione suggerita |
fallbackUrl |
(Facoltativo) URL di riserva da utilizzare se un client non supporta un'azione suggerita. Gli URL di riserva si aprono in nuove finestre del browser. |
Campo di unione action . L'azione nativa avviata sul dispositivo quando l'utente tocca l'azione suggerita action può essere solo una delle seguenti: |
|
dialAction |
Apre l'app tastiera predefinita dell'utente con il numero di telefono specificato dall'agente compilato. |
viewLocationAction |
Apre l'app di mappe predefinita dell'utente e seleziona la località specificata dall'agente o esegue ricerche nella località dell'utente in base a una query specificata dall'agente. |
createCalendarEventAction |
Apre l'app di calendario predefinita dell'utente e avvia il nuovo flusso di eventi di calendario con i dati dell'evento specificati dall'agente precompilati. |
openUrlAction |
Apre l'app browser web predefinita dell'utente all'URL specificato. Se l'utente ha installato un'app che è registrata come gestore predefinito dell'URL, verrà aperta questa app e la relativa icona verrà utilizzata nell'interfaccia utente dell'azione suggerita. |
shareLocationAction |
Apre il selettore della posizione dell'app RCS in modo che l'utente possa scegliere una posizione da inviare all'agente. |
DialAction
Apre l'app tastiera predefinita dell'utente con il numero di telefono specificato dall'agente compilato.
Rappresentazione JSON |
---|
{ "phoneNumber": string } |
Campi | |
---|---|
phoneNumber |
Il numero di telefono nel formato E.164, ad esempio +12223334444. |
ViewLocationAction
Apre l'app di mappe predefinita dell'utente e seleziona la località specificata dall'agente o esegue ricerche nella località dell'utente in base a una query specificata dall'agente.
Rappresentazione JSON |
---|
{
"latLong": {
object ( |
Campi | |
---|---|
latLong |
(Facoltativo) La latitudine e la longitudine della posizione specificata. |
label |
(Facoltativo) L'etichetta del segnaposto inserito in latLong. |
query |
(Facoltativo, supportato solo sui client Android Messaggi) Anziché specificare il valore latitudine e longitudine (e, facoltativamente, un'etichetta), l'agente può specificare una stringa di query. Per le app di mappe predefinite che supportano la funzionalità di ricerca (compreso Google Maps), toccando l'azione suggerita viene visualizzata una ricerca della posizione incentrata sulla posizione corrente dell'utente. Se la query è sufficientemente specifica, gli agenti possono utilizzarla per selezionare qualsiasi località nel mondo. Ad esempio, se imposti la stringa di query su "Growing Tree Bank", verranno mostrate tutte le sedi di Growing Tree Bank nelle vicinanze dell'utente. Se imposti la stringa di query su "1600 Amphitheatre Parkway, Mountain View, CA 94043", verrà selezionato quell'indirizzo specifico, indipendentemente dalla località dell'utente. |
LatLng
Un oggetto che rappresenta una coppia di latitudine/longitudine. Questo valore viene espresso come una coppia di doppi per rappresentare i gradi di latitudine e i gradi di longitudine. Se non diversamente specificato, questo oggetto deve essere conforme allo standard WGS84. I valori devono essere compresi in intervalli normalizzati.
Rappresentazione JSON |
---|
{ "latitude": number, "longitude": number } |
Campi | |
---|---|
latitude |
Latitudine in gradi. Deve essere compreso nell'intervallo [-90,0, +90,0]. |
longitude |
Longitudine in gradi. Deve essere compreso nell'intervallo [-180,0, +180,0]. |
CreateCalendarEventAction
Apre l'app di calendario predefinita dell'utente e avvia il nuovo flusso di eventi di calendario con i dati dell'evento specificati dall'agente precompilati.
Rappresentazione JSON |
---|
{ "startTime": string, "endTime": string, "title": string, "description": string } |
Campi | |
---|---|
startTime |
Ora di inizio dell'evento. Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
endTime |
Ora di fine dell'evento. Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
title |
Titolo dell'evento. |
description |
Descrizione dell'evento. |
OpenUrlAction
Apre l'app browser web predefinita dell'utente all'URL specificato. Se l'utente ha installato un'app che è registrata come gestore predefinito dell'URL, verrà aperta questa app e la relativa icona verrà utilizzata nell'interfaccia utente dell'azione suggerita.
Rappresentazione JSON |
---|
{ "url": string } |
Campi | |
---|---|
url |
URL |
StandaloneCard
Scheda indipendente
Rappresentazione JSON |
---|
{ "cardOrientation": enum ( |
Campi | |
---|---|
cardOrientation |
Orientamento della scheda. |
thumbnailImageAlignment |
Allineamento dell'anteprima dell'immagine per schede indipendenti con layout orizzontale. |
cardContent |
Contenuti della scheda. |
StandaloneCard.CardOrientation
Orientamento della scheda.
Enum | |
---|---|
CARD_ORIENTATION_UNSPECIFIED |
Non specificato. |
HORIZONTAL |
Layout orizzontale. Se il campo |
VERTICAL |
Layout verticale. |
StandaloneCard.ThumbnailImageAlignment
Allineamento dell'anteprima dell'immagine per schede indipendenti con layout orizzontale.
Enum | |
---|---|
THUMBNAIL_IMAGE_ALIGNMENT_UNSPECIFIED |
Non specificato. |
LEFT |
L'anteprima del file è allineata a sinistra. |
RIGHT |
L'anteprima del file è allineata a destra. |
Metodi |
|
---|---|
|
Invia un messaggio dall'agente a un utente. |
|
Revoca un messaggio dell'agente che è stato inviato ma non ancora consegnato. |