Per impedire il cambio di contesto quando gli utenti condividono un link in Google Chat, l'app Chat può visualizzare l'anteprima del link allegando una scheda al messaggio che contiene più informazioni e consente alle persone di eseguire azioni direttamente da Google Chat.
Ad esempio, immagina uno spazio di Google Chat che include tutti gli agenti dell'assistenza clienti di un'azienda più un'app di chat di nome Case-y. Gli agenti condividono spesso link alle richieste di assistenza clienti nello spazio di Chat e, ogni volta che lo fanno, i loro colleghi devono aprire il link della richiesta per visualizzare dettagli come assegnatario, stato e oggetto. Allo stesso modo, se qualcuno vuole assumere la proprietà di una richiesta o modificarne lo stato, deve aprire il link.
L'anteprima dei link consente all'app Chat residente dello spazio, Case-y, di allegare una scheda che mostra l'assegnatario, lo stato e il soggetto ogni volta che qualcuno condivide il link di una richiesta. I pulsanti sulla scheda consentono agli agenti di gestire la richiesta e modificarne lo stato direttamente dallo stream della chat.
Come funziona l'anteprima dei link
Quando qualcuno aggiunge un link a un messaggio, viene visualizzato un chip che la informa che l'app di Chat potrebbe visualizzare l'anteprima del link.
Dopo l'invio del messaggio, il link viene inviato all'app Chat, che a sua volta genera e allega la scheda al messaggio dell'utente.
Oltre al link, la scheda fornisce ulteriori informazioni sul link, inclusi elementi interattivi come i pulsanti. L'app di chat può aggiornare la scheda allegata in risposta alle interazioni degli utenti, ad esempio ai clic sui pulsanti.
Se qualcuno non vuole che l'app Chat visualizzi l'anteprima del link allegando una scheda al messaggio, può impedire la visualizzazione dell'anteprima facendo clic su
nel chip di anteprima. Gli utenti possono rimuovere la scheda allegata in qualsiasi momento facendo clic su Rimuovi anteprima.Configura le anteprime dei link
Registra link specifici, come example.com
, support.example.com
e support.example.com/cases/
, come pattern URL nella pagina di configurazione dell'app Chat in Google Cloud Console in modo che l'app Chat possa visualizzarne l'anteprima.
- Apri la console Google Cloud.
- Accanto a "Google Cloud", fai clic sulla Freccia giù e apri il progetto dell'app Chat.
- Nel campo di ricerca, digita
Google Chat API
e fai clic su API Google Chat. - Fai clic su Gestisci > Configurazione.
- In Anteprime link, aggiungi o modifica un pattern URL.
- Per configurare le anteprime dei link per un nuovo pattern URL, fai clic su Aggiungi pattern URL.
- Per modificare la configurazione di un pattern URL esistente, fai clic sulla Freccia giù .
Nel campo Pattern host, inserisci il dominio del pattern URL. L'app Chat mostrerà l'anteprima dei link a questo dominio.
Per avere i link di anteprima dell'app Chat per un sottodominio specifico, come
subdomain.example.com
, includi il sottodominio.Per visualizzare i link di anteprima dell'app Chat per l'intero dominio, specifica un carattere jolly con un asterisco (*) come sottodominio. Ad esempio,
*.example.com
corrisponde asubdomain.example.com
eany.number.of.subdomains.example.com
.Nel campo Prefisso percorso, inserisci un percorso da aggiungere al dominio del pattern host.
Per trovare la corrispondenza con tutti gli URL nel dominio del pattern host, lascia vuoto il campo Prefisso percorso.
Ad esempio, se il pattern host è
support.example.com
, inseriscicases/
per trovare corrispondenze con gli URL per i casi ospitati sul sitosupport.example.com/cases/
.Fai clic su Fine.
Fai clic su Salva.
Ora, ogni volta che qualcuno include un link che corrisponde a un pattern URL di anteprima del link a un messaggio in uno spazio di Chat che include la tua app Chat, l'app visualizza l'anteprima del link.
Visualizzare l'anteprima di un link
Dopo aver configurato l'anteprima del link per un determinato link, l'app Chat può riconoscere e visualizzare l'anteprima del link allegando ulteriori informazioni.
All'interno degli spazi di Chat che includono la tua app Chat, quando il messaggio di un utente contiene un link che corrisponde a un pattern URL di anteprima link, l'app Chat riceve un evento di interazione MESSAGE
. Il payload JSON per l'evento di interazione contiene il campo matchedUrl
:
JSON
"message": {
. . . // other message attributes redacted
"matchedUrl": {
"url": "https://support.example.com/cases/case123"
},
. . . // other message attributes redacted
}
Se verifichi la presenza del campo matchedUrl
nel payload
dell'evento MESSAGE
, la tua app Chat può aggiungere informazioni al
messaggio con il link in anteprima. L'app Chat può rispondere con un semplice messaggio di testo o allegare una scheda.
Rispondi con un SMS
Per risposte semplici, l'app Chat può visualizzare l'anteprima di un link rispondendo con un semplice messaggio di testo a un link. Questo esempio allega un messaggio che ripete l'URL del link che corrisponde a un pattern URL di anteprima link.
Node.js
Apps Script
Allega una carta
Per allegare una scheda a un link visualizzato in anteprima, restituisci un elemento ActionResponse
di tipo UPDATE_USER_MESSAGE_CARDS
. In questo esempio è allegata una scheda semplice.
Node.js
Apps Script
In questo esempio viene inviato un messaggio relativo alle schede restituendo un JSON della scheda. Puoi anche utilizzare il servizio di schede di Apps Script.
Aggiornare una carta
Per aggiornare la scheda allegata a un link di anteprima, restituisci un elemento ActionResponse
di tipo UPDATE_USER_MESSAGE_CARDS
. Le app di chat possono aggiornare solo le schede che visualizzano l'anteprima dei link in risposta a un evento di interazione con l'app di Chat.
Le app di chat non possono aggiornare queste schede chiamando l'API Chat in modo asincrono.
L'anteprima dei link non supporta la restituzione di un elemento ActionResponse
di tipo UPDATE_MESSAGE
. Poiché UPDATE_MESSAGE
aggiorna l'intero messaggio anziché solo la scheda, funziona solo se l'app Chat ha creato il messaggio originale. L'anteprima del link allega una scheda a un messaggio creato dall'utente, quindi l'app Chat non dispone dell'autorizzazione per aggiornarla.
Per fare in modo che una funzione aggiorni le schede create dall'utente e dall'app nello stream di Chat, imposta in modo dinamico il valore ActionResponse
a seconda che il messaggio sia stato creato dall'app Chat o da un utente.
- Se il messaggio è stato creato da un utente, imposta
ActionResponse
suUPDATE_USER_MESSAGE_CARDS
. - Se il messaggio è stato creato da un'app di chat, imposta
ActionResponse
suUPDATE_MESSAGE
.
Puoi farlo in due modi: specificando una actionMethodName
personalizzata che fa parte della proprietà onclick
della scheda allegata (che identifica il messaggio come creato dall'utente) oppure controllando se il messaggio è stato creato da un utente.
Opzione 1: controlla se è presente actionMethodName
Per utilizzare actionMethodName
per gestire correttamente gli eventi di interazione CARD_CLICKED
nelle schede in anteprima, imposta un'actionMethodName
personalizzata come parte della proprietà onclick
della scheda allegata:
JSON
. . . // Preview card details
{
"textButton": {
"text": "ASSIGN TO ME",
"onClick": {
// actionMethodName identifies the button to help determine the
// appropriate ActionResponse.
"action": {
"actionMethodName": "assign",
}
}
}
}
. . . // Preview card details
Se "actionMethodName": "assign"
identifica il pulsante come parte di un'anteprima link, è possibile restituire in modo dinamico il valore ActionResponse
corretto verificando un actionMethodName
corrispondente:
Node.js
Apps Script
In questo esempio viene inviato un messaggio relativo alle schede restituendo un JSON della scheda. Puoi anche utilizzare il servizio di schede di Apps Script.
Opzione 2: controlla il tipo di mittente
Controlla se message.sender.type
è HUMAN
o BOT
. Se HUMAN
, imposta ActionResponse
su UPDATE_USER_MESSAGE_CARDS
, altrimenti imposta ActionResponse
su UPDATE_MESSAGE
. Ecco come:
Node.js
Apps Script
In questo esempio viene inviato un messaggio relativo alle schede restituendo un JSON della scheda. Puoi anche utilizzare il servizio di schede di Apps Script.
Un motivo tipico per aggiornare una scheda è la risposta al clic su un pulsante. Ricorda il pulsante Assegna a me della sezione precedente, Allegare una scheda. Il seguente esempio completo aggiorna la scheda in modo che risulti assegnata a "Tu " dopo che l'utente fa clic su Assegna a me. Nell'esempio viene impostato in modo dinamico ActionResponse
controllando il tipo di mittente.
Esempio completo: Case-y, l'app Chat dell'assistenza clienti
Ecco il codice completo per Case-y, un'app di chat che mostra in anteprima i link alle richieste condivise in uno spazio di Chat in cui collaborano gli agenti dell'assistenza clienti.
Node.js
Apps Script
In questo esempio viene inviato un messaggio relativo alle schede restituendo un JSON della scheda. Puoi anche utilizzare il servizio di schede di Apps Script.
Limiti e considerazioni
Quando configuri le anteprime dei link per l'app Chat, tieni presente questi limiti e considerazioni:
- Ogni app di chat supporta le anteprime dei link per un massimo di 5 pattern URL.
- Le app di chat visualizzano l'anteprima di un link per messaggio. Se in un singolo messaggio sono presenti più link visualizzabili in anteprima, viene visualizzato in anteprima solo il primo link di anteprima.
- Le app di chat visualizzano l'anteprima solo dei link che iniziano con
https://
, perciò l'anteprima dihttps://support.example.com/cases/
non viene mostrata insupport.example.com/cases/
. - A meno che il messaggio non includa altre informazioni che vengono inviate all'app Chat, ad esempio un comando slash, all'app Chat viene inviato solo l'URL del link tramite le anteprime del link.
- Le schede allegate ai link in anteprima supportano solo
ActionResponse
di tipoUPDATE_USER_MESSAGE_CARDS
e solo in risposta a un evento di interazione nell'app Chat. Le anteprime link non supportanoUPDATE_MESSAGE
o richieste asincrone di aggiornamento delle schede collegate a un link in anteprima tramite l'API Chat. Per ulteriori informazioni, consulta la sezione Aggiornare una carta.
Anteprime dei link di debug
Durante l'implementazione delle anteprime dei link, potresti dover eseguire il debug dell'app Chat leggendo i log dell'app. Per leggere i log, visita Esplora log nella console Google Cloud.