Mensagens de formato

Com o Google Chat, você pode adicionar formatação às mensagens, incluindo o seguinte:

• Formatação básica de texto, como negrito, itálico e tachado, em mensagens de texto e mensagens de cards.
• Texto vinculado.
• @mencionar um ou todos os usuários em um espaço do Chat
• Adicione ícones integrados e personalizados apenas nas mensagens do cartão.

Formatar uma mensagem de texto

O Chat permite adicionar formatação básica a uma mensagem de texto, incluindo negrito, itálico e tachado, usando um pequeno subconjunto da sintaxe do Markdown. O texto é formatado de maneira diferente nas mensagens de texto e de cartão, porque elas são formatadas com a mesma sintaxe usada pelos usuários do Chat. Para formatar o texto que aparece em um card, consulte Formatar uma mensagem de card.

Para formatar mensagens de texto, use esta sintaxe:

Formato	Símbolo	Exemplo de sintaxe	Texto exibido no Google Chat
Negrito	*	*Olá*	Olá
Itálico	_ (sublinhado)	_olá_	Olá
Tachado	~	~Olá!	Olá
fonte monoespaçada	` (acento grave)	"Olá"	hello
Bloco monoespacial	` ` ` (três aspas simples)	``` Olá Mundo ```	Hello World

Por exemplo, considere o JSON a seguir:

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

Essa mensagem de texto formatada mostra o seguinte em um espaço do Chat:

Ver a formatação do texto enviada em uma mensagem

Quando um usuário envia uma mensagem, o corpo em texto simples da mensagem está no campo text. Alguma formatação aplicada à mensagem de texto usando a sintaxe Markdown está no campo text. A formatação extra está no campo formattedText somente de saída, incluindo o seguinte:

• Sintaxe de marcação para texto
• Menções do usuário
• Hiperlinks personalizados
• Emojis personalizados

Por exemplo, considere o texto a seguir enviado por um usuário:

Se a mensagem tiver sido formatada usando o menu Formatar na interface do Chat, o campo text conterá apenas texto, enquanto o campo formattedText conterá as marcações, o texto e o hiperlink. O exemplo a seguir mostra o rascunho de uma mensagem de texto com uma palavra com hiperlink e outra em negrito:

A mensagem é recebida no seguinte formato:

    {
      "text": "Be there at noon!",
      "formattedText": "Be <http://example.com|there> at *noon*",
    }

Formatar links

Se você incluir um URL de link simples no texto da mensagem, como http://www.example.com/, o Google Chat vai usá-lo como o texto do link e criar um hiperlink automaticamente para o URL especificado.

Para fornecer um texto alternativo para seu link, use a seguinte sintaxe:

Exemplo de sintaxe	Texto exibido no Google Chat
<https://example.com|Example website>	Example website

O texto da barra vertical e do link é opcional, para que <https://www.example.com/> e https://www.example.com/ sejam equivalentes.

Mencionar usuários em uma mensagem de texto

Os apps de chat podem enviar mensagens de texto que @mencionam um ou todos os usuários em um espaço do Chat. Apps de chat não podem mencionar usuários em um espaço que está no modo de importação.

@mencionar usuários específicos

Para @mencionar um usuário específico, adicione <users/{user}> à mensagem de texto, em que {user} é o ID do usuário. Por exemplo, considere a mensagem de texto abaixo, em que 123456789012345678901 representa o ID do usuário Mahan S.:

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

A mensagem de texto é exibida da seguinte forma:

É possível especificar o valor users/{user} das seguintes maneiras:

• Se o app do Google Chat estiver respondendo a uma mensagem enviada pelo usuário, use o campo message.sender.name do evento de interação MESSAGE.

• Se o app do Google Chat estiver criando uma mensagem de texto assíncrona, você poderá especificar o valor de users/{user} das seguintes maneiras:

  • Use o campo name do recurso User do Google Chat, como users/123456789012345678901.
  • Use o endereço de e-mail do usuário como um alias para o valor {user}. Por exemplo, se o endereço de e-mail for mahan@example.com, é possível especificar o usuário como users/mahan@example.com. Para usar um alias de e-mail, seu app do Google Chat precisa ser autenticado como um usuário.

• Se você usar a API People, também poderá usar o método people.get para identificar o ID do usuário.

@mencionar todos os usuários

Para criar uma mensagem de texto que @mencione todas as pessoas em um espaço, substitua {user} por all. O exemplo de JSON a seguir menciona todos os usuários em uma mensagem:

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

Formatar uma mensagem de card

Dentro dos cards, a maioria dos campos de texto é compatível com a formatação básica usando um pequeno subconjunto de tags HTML. O texto é formatado de maneira diferente nas mensagens de card e nas mensagens de texto porque elas são formatadas com a mesma sintaxe usada pelos usuários do Chat. Para formatar o texto que aparece em uma mensagem de texto, consulte Formatar uma mensagem de texto.

A tabela a seguir mostra as tags compatíveis e as finalidades delas:

Formato	Exemplo	Resultado renderizado
Negrito	"This is <b>bold</b>."	Isso está em negrito.
Itálico	"This is <i>italics</i>."	Está em itálico.
Sublinhado	"This is <u>underline</u>."	Isso é sublinhado.
Tachado	"This is <s>strikethrough</s>."	Isso é tachado.
Cor da fonte	"This is <font color=\"#FF0000\">red font</font>."	Essa é a fonte vermelha.
Hiperlink	"This is a <a href=\"https://www.google.com\">hyperlink</a>."	Este é um hiperlink.
Tempo	"This is a time format: <time>2023-02-16 15:00</time>."	Este é um formato de hora: 2023-02-16 15:00.
Nova linha	"This is the first line. <br> This is a new line. pol.	Esta é a primeira linha. Esta é uma nova linha.

Adicionar um ícone integrado a um card

Os widgets DecoratedText e ButtonList oferecem suporte ao elemento icon usado para especificar um dos ícones integrados disponíveis no Chat.

A tabela a seguir lista os ícones integrados disponíveis para as mensagens do card:

flight	ARPLANO	bookmark	BOOKMARK
directions_bus	BUS	directions_car	CARRO
schedule	RELÓGIO	confirmation_number	CONFIRMATION_NUMBER_ICON
subject	DESCRIÇÃO	attach_money	MOEDA
mail	E-MAIL	event_seat	EVENT_SEAT
flight_land	FLIGHT_ARRIVAL	flight_takeoff	FLIGHT_DEPARTURE
hotel	HOTEL	grade	HOTEL_ROOM_TYPE
insert_invitation	CONVIDAR	location_on	MAP_PIN
card_membership	ASSINATURA	people	MULTIPLE_PEOPLE
person	PESSOA	local_phone	TELEFONE
restaurant	RESTAURANT_ICON	shopping_cart	SHOPPING_CART
grade	ESTRELA	store	LOJA
local_play	INGRESSO	train	TRAIN
videocam	VIDEO_CAMERA	play_circle_filled	VIDEO_PLAY

Confira a seguir um exemplo de card com um ícone de e-mail:

Adicionar um ícone personalizado a um card

Os widgets DecoratedText e ButtonList permitem usar os ícones integrados ou definir ícones personalizados. Para especificar um ícone personalizado, use o elemento iconUrl, conforme mostrado no exemplo abaixo: