Mensagens de formato

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

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 Markdown. O texto é formatado de maneira diferente nas mensagens de texto e nas mensagens de cartão, porque as mensagens de texto são formatadas com a mesma sintaxe que os usuários do Chat usam. 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 ` (crase) "Olá" hello
Bloco monoespaçada ` ` ` (três acentos graves) ```
Olá
Mundo
```		 Hello
World
Lista com marcadores * ou - (hífen) seguido por um espaço

* Este é o primeiro item da lista

* Este é o segundo item da lista
  • Este é o primeiro item da lista
  • Este é o segundo item da lista

Por exemplo, considere este JSON:

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

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

O app Cymbal Pizza envia uma mensagem de texto informando que a entrega chegou.

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

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

  • Sintaxe de Markdown adicional para texto
  • Menções do usuário
  • Hiperlinks personalizados
  • Emojis personalizados

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

Mensagem recebida no Chat com a palavra

Se a mensagem foi formatada usando o menu Formatar na interface do Chat, o campo text conterá apenas o texto, enquanto o campo formattedText terá 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, itens em uma lista e uma palavra em negrito:

Rascunho de mensagem com a palavra

A mensagem é recebida no seguinte 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*?",
    }

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 de link alternativo para seu link, use a seguinte sintaxe:

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

O texto da barra vertical e do link são opcionais, 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 com @. Os apps do Chat não podem mencionar usuários em um espaço que está no modo de importação ou que não entrou no espaço.

@mencionar usuários específicos

Para mencionar um usuário específico usando @, adicione <users/{user}> à mensagem de texto, em que {user} é o ID do usuário. Por exemplo, considere esta mensagem de texto 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:

O app de chat menciona uma pessoa em uma mensagem de texto.

É 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, será possível 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, especifique o usuário como users/mahan@example.com. Para usar um alias de e-mail, seu app do Google Chat precisa se autenticar 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 oferece suporte à formatação básica de texto usando um pequeno subconjunto de tags HTML. O texto é formatado de forma diferente nas mensagens de card e em mensagens de texto porque elas são formatadas com a mesma sintaxe que os usuários do Chat usam. Para formatar o texto que aparece em uma mensagem de texto, consulte Formatar uma mensagem de texto.

Use o Card Builder para criar e visualizar mensagens de cards JSON em apps de chat:

Abra o Criador de cards.

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

Formato Exemplo Resultado renderizado
Negrito "This is <b>bold</b>." Está em negrito.
Itálico "This is <i>italics</i>." Está em itálico.
Sublinhado "This is <u>underline</u>." Ele é sublinhado.
Tachado "This is <s>strikethrough</s>." Isso está tachado.
Cor da fonte "This is <font color=\"#FF0000\">red font</font>." Esta é uma 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 horário: .
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 mensagens de cards:

AO PLANO BOOKMARK
BUS CAR
RELÓGIO CONFIRMATION_NUMBER_ICON
DESCRIÇÃO MOEDA
E-MAIL EVENT_SEAT
FLIGHT_ARRIVAL FLIGHT_DEPARTURE
HOTÉ HOTEL_ROOM_TYPE
CONVIDAR MAP_PIN
ASSINATURA MULTIPLE_PEOPLE
PESSOA TELEFONE
RESTAURANT_ICON SHOPPING_CART
MARCAR COM ESTRELA LOJA
INGRESSO TRAIN
VIDEO_CAMERA VIDEO_PLAY

Veja a seguir um exemplo de cartão com um ícone de e-mail:

Adicionar um ícone do Material Design do Google a um card

Os widgets DecoratedText e ButtonList permitem usar os ícones do Google Material para selecionar entre mais de 2.500 opções e personalizar o peso, o preenchimento e a inclinação dos ícones.

Confira a seguir um exemplo de card com um ícone do Material do Google:

Adicionar um ícone personalizado a um cartão

Os widgets DecoratedText e ButtonList permitem usar os ícones integrados ou definir ícones personalizados. Para adicionar um ícone personalizado a um cartão, inclua o campo iconUrl e especifique o URL correspondente do ícone.

Este é um exemplo de ícone personalizado: