Formattare i messaggi

Questa pagina spiega come le app Google Chat possono formattare il testo per inviare messaggi che contengono uno dei seguenti elementi:

• Testo RTF che contiene link ipertestuali o @menziona uno o tutti gli utenti in uno spazio di Chat.
• Testo visualizzato in un'interfaccia a schede, ad esempio testo di un paragrafo o testo dell'interfaccia utente visualizzato accanto a un'icona, ad esempio un pulsante.

Formattare un messaggio

Chat ti consente di aggiungere una formattazione di base a un messaggio di testo, tra cui grassetto, corsivo e barrato, utilizzando un piccolo sottoinsieme della sintassi Markdown. La formattazione del testo negli SMS è diversa da quella nei messaggi delle schede perché gli SMS vengono formattati con la stessa sintassi utilizzata dagli utenti di Chat.

Per formattare i messaggi, utilizza la seguente sintassi:

Ad esempio, considera il seguente JSON:

    {
      "text": "Your pizza delivery *has arrived*!\nThank you for using _Cymbal Pizza!_"
    }

Questo messaggio di testo formattato mostra quanto segue in uno spazio Chat:

Visualizzare la formattazione del testo inviata in un messaggio

Quando un utente invia un messaggio, il corpo del messaggio in testo normale si trova nel campo text. Alcune formattazioni applicate al messaggio di testo utilizzando la sintassi Markdown si trovano nel campo text. La formattazione aggiuntiva si trova nel campo formattedText di sola visualizzazione e include quanto segue:

• Sintassi Markdown aggiuntiva per il testo
• Menzioni degli utenti
• Link ipertestuali personalizzati
• Emoji personalizzate

Ad esempio, considera il seguente testo inviato da un utente:

Se il messaggio è stato formattato utilizzando il menu Formato nell'interfaccia utente della chat, il campo text contiene solo il testo, mentre il campo formattedText contiene i markup, il testo e il link ipertestuale. L'esempio seguente mostra la bozza di un messaggio di testo con una parola con link ipertestuale, elementi in un elenco e una parola in grassetto:

Il messaggio viene ricevuto nel seguente formato:

    {
      "text": "I can meet there at:\nNoon\n3 pm\n5 pm\nWhat time works for you?",
      "formattedText": "I can meet <http://example.com|there> at:\n* Noon\n* 3 pm\n* 5 pm\nWhat time works for *you*?",
    }

Formattare i link

Se includi un URL di link semplice nel testo del messaggio, ad esempio http://www.example.com/, Google Chat lo utilizza come testo del link e lo trasforma automaticamente in un link ipertestuale all'URL specificato.

Per fornire un testo alternativo per il link, utilizza la seguente sintassi:

La barra verticale e il testo del link sono facoltativi, quindi <https://www.example.com/> e https://www.example.com/ sono equivalenti.

Utilizzare emoji personalizzate in un messaggio

Le app di chat possono inviare messaggi di testo con emoji personalizzate per personalizzare i messaggi. Le emoji personalizzate sono disponibili solo per le organizzazioni Google Workspace e l'amministratore deve attivarle per l'organizzazione. Per saperne di più, vedi Informazioni sulle emoji personalizzate in Google Chat e Gestire le autorizzazioni per le emoji personalizzate.

Per creare messaggi con emoji personalizzate, la tua app deve utilizzare l'autenticazione utente. Le emoji personalizzate non sono supportate nei messaggi creati come webhook o nei messaggi creati con l'autenticazione dell'app.

Per aggiungere emoji personalizzate al testo di un messaggio, specifica name o emoji_name della risorsa customEmoji:

{
    "text": "Hello <customEmojis/CUSTOM_EMOJI_ID>."
}

Per utilizzare questo esempio, sostituisci CUSTOM_EMOJI_ID con l'ID dell'emoji personalizzata. Puoi trovare questo ID nel campo name o emoji_name della risorsa customEmoji.

Menzionare utenti in un messaggio

Le app di chat possono inviare messaggi di testo che menzionano uno o tutti gli utenti di uno spazio di Chat. Per menzionare utenti che non hanno partecipato allo spazio o a uno spazio in modalità di importazione, le app di chat devono inviare il messaggio con l'autenticazione utente.

@menzionare utenti specifici

Per menzionare un utente specifico, aggiungi <users/{user}> al messaggio di testo, dove {user} è l'ID dell'utente. Ad esempio, considera il seguente messaggio di testo in cui 123456789012345678901 rappresenta l'ID dell'utente Mahan S.:

{
    "text": "A customer has reported an issue. Assigning ticket #942 to <users/123456789012345678901>."
}

L'SMS viene visualizzato come segue:

Puoi specificare il valore di users/{user} nei seguenti modi:

• Se la tua app Google Chat risponde a un messaggio inviato dall'utente, puoi utilizzare il campo message.sender.name dell'MESSAGEevento di interazione.

• Se la tua app Google Chat sta creando un messaggio di testo asincrono, puoi specificare il valore di users/{user} nei seguenti modi:

  • Utilizza il campo name della risorsa Google Chat User, ad esempio users/123456789012345678901.
  • Utilizza l'indirizzo email dell'utente come alias per il valore {user}. Ad esempio, se l'indirizzo email è mahan@example.com, puoi specificare l'utente come users/mahan@example.com. Per utilizzare un alias email, l'app Google Chat deve autenticarsi come utente.

• Se utilizzi l'API People, puoi anche utilizzare il metodo people.get per identificare l'ID utente.

@menzionare tutti gli utenti

Per creare un messaggio di testo che @menzioni tutti i partecipanti a uno spazio, sostituisci {user} con all. Il seguente esempio JSON menziona tutti gli utenti in un messaggio:

{
    "text": "Important message for <users/all>: Code freeze starts at midnight tonight!"
}

Formattare il testo visualizzato nelle schede

All'interno delle schede, la maggior parte dei campi di testo supporta la formattazione di base del testo utilizzando un piccolo sottoinsieme di tag HTML. La formattazione del testo nei messaggi delle schede è diversa da quella dei messaggi di testo perché questi ultimi vengono formattati con la stessa sintassi utilizzata dagli utenti di Chat.

Utilizza Card Builder per progettare e visualizzare in anteprima le interfacce utente e di messaggistica per le app di chat:

Formattare il testo del paragrafo

I tag supportati e il loro scopo sono riportati nella tabella seguente:

Inoltre, puoi utilizzare la sintassi Markdown e i seguenti tag:

This is a code block.

Per selezionare la sintassi da utilizzare durante la formattazione dei contenuti di un paragrafo di testo, utilizza il campo Sintassi del testo.

Aggiungere icone al testo

Per visualizzare le icone accanto al testo in una scheda, puoi utilizzare i widget DecoratedText e ButtonList.

Le sezioni seguenti spiegano come utilizzare icone integrate, icone Google Material o icone personalizzate in testo decorato o pulsanti.

Utilizzare le icone di Chat

Per utilizzare un'icona integrata disponibile in Chat, specifica una delle seguenti:

La seguente tabella elenca le icone integrate disponibili per i messaggi delle schede:

Di seguito è riportato un esempio di scheda con un'icona email:

Utilizzare le icone Google Material

Puoi utilizzare le icone Material di Google per scegliere tra oltre 2500 opzioni di icone e personalizzare il peso, il riempimento e la gradazione delle icone.

Di seguito è riportato un esempio di scheda con un'icona Google Material:

Utilizzare icone personalizzate

Per aggiungere un'icona personalizzata, includi il campo iconUrl e specifica l'URL corrispondente dell'icona.

Di seguito è riportato un esempio di icona personalizzata: