Dar formato a los mensajes

Google Chat te permite agregar formato a los mensajes, incluido lo siguiente:

• Formato de texto básico, como negrita, cursiva y tachado, en mensajes de texto y mensajes de tarjetas
• Texto vinculado.
• @menciona a uno o todos los usuarios en un espacio de Chat.
• Agrega íconos integrados y personalizados solo en los mensajes de tarjetas.

Cómo darle formato a un mensaje de texto

Chat te permite agregar formato básico a un mensaje de texto, como negrita, cursiva y tachado, mediante un pequeño subconjunto de sintaxis de Markdown. El formato del texto es diferente en los mensajes de texto que en los mensajes de tarjetas, ya que estos tienen la misma sintaxis que los usuarios de Chat. Para dar formato al texto que aparece en una tarjeta, consulta Da formato a un mensaje de tarjeta.

Para dar formato a los mensajes de texto, usa la siguiente sintaxis:

Formato	Símbolo	Sintaxis de ejemplo	Texto que se muestra en Google Chat
Negrita	*	*hola*	hola
Cursiva	_ (guion bajo)	_hola_	hola
Tachado	~	~hola~	hola
Monoespacio	` (comilla inversa)	"hola"	hello
Bloque monoespacio	` ` ` (tres comillas inversas)	``` Hola Hola a todos ```	Hello World

Por ejemplo, considera el siguiente JSON:

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

Este mensaje de texto con formato muestra lo siguiente en un espacio de Chat:

Cómo ver el formato de texto enviado en un mensaje

Cuando un usuario envía un mensaje, el cuerpo con texto sin formato se encuentra en el campo text. Parte del formato que se aplica al mensaje de texto con la sintaxis de Markdown se encuentra en el campo text. El formato adicional se encuentra en el campo formattedText de solo salida, incluido lo siguiente:

• Sintaxis de lenguaje de marcado para texto
• Menciones del usuario
• Hipervínculos personalizados
• Emoji personalizados

Por ejemplo, considera el siguiente texto que envió un usuario:

Si se usó el menú Formato en la IU de Chat para dar formato al mensaje, el campo text contiene solo el texto, mientras que el campo formattedText contiene las marcas, el texto y el hipervínculo. En el siguiente ejemplo, se muestra el borrador de un mensaje de texto con una palabra como hipervinculada y otra palabra en negrita:

El mensaje se recibe en el siguiente formato:

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

Cómo aplicarles formato a los vínculos

Si incluyes una URL de vínculo simple en el texto de tu mensaje, como http://www.example.com/, Google Chat la usará como texto del vínculo y la vinculará automáticamente con la URL especificada.

Para proporcionar un texto alternativo para tu vínculo, usa la siguiente sintaxis:

Sintaxis de ejemplo	Texto que se muestra en Google Chat
<https://example.com|Example website>	Example website

La canalización y el texto del vínculo son opcionales, por lo que <https://www.example.com/> y https://www.example.com/ son equivalentes.

Mencionar usuarios en un mensaje de texto

Las apps de Chat pueden enviar mensajes de texto en los que se mencione con @a uno o todos los usuarios de un espacio de Chat. Las apps de Chat no pueden mencionar usuarios en un espacio que está en modo de importación.

@menciona a usuarios específicos

Para @mencionar a un usuario específico, agrega <users/{user}> al mensaje de texto, en el que {user} es el ID del usuario. Por ejemplo, considera el siguiente mensaje de texto, en el que 123456789012345678901 representa el ID del usuario Mahan S:

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

El mensaje de texto se muestra de la siguiente manera:

Puedes especificar el valor users/{user} de las siguientes maneras:

• Si tu app de Google Chat responde a un mensaje que envió el usuario, puedes usar el campo message.sender.name del evento de interacción MESSAGE.

• Si tu app de Google Chat crea un mensaje de texto asíncrono, puedes especificar el valor de users/{user} de las siguientes maneras:

  • Usa el campo name del recurso User de Google Chat, como users/123456789012345678901.
  • Usa la dirección de correo electrónico del usuario como un alias para el valor {user}. Por ejemplo, si la dirección de correo electrónico es [e-mail], puedes especificar el usuario como users/[e-mail]. Para usar un alias de correo electrónico, tu app de Google Chat debe autenticarse como usuario.

• Si usas la API de People, también puedes usar el método people.get para identificar el ID del usuario.

@menciona a todos los usuarios

Para crear un mensaje de texto en el que @mencione a todos en un espacio, reemplaza {user} por all. El siguiente ejemplo de JSON menciona a todos los usuarios de un mensaje:

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

Cómo dar formato a un mensaje de tarjeta

Dentro de las tarjetas, la mayoría de los campos de texto admiten el formato de texto básico, ya que usan un subconjunto pequeño de etiquetas HTML. En los mensajes de tarjetas, el formato del texto es diferente que en los mensajes de texto, ya que estos tienen la misma sintaxis que los usuarios de Chat. Para dar formato al texto que aparece en un mensaje de texto, consulta Da formato a un mensaje de texto.

Las etiquetas compatibles y su propósito se muestran en la siguiente tabla:

Formato	Ejemplo	Resultado procesado
Negrita	"This is <b>bold</b>."	Está en negrita.
Cursiva	"This is <i>italics</i>."	Es cursiva.
Subrayado	"This is <u>underline</u>."	Es subrayado.
Tachado	"This is <s>strikethrough</s>."	Este mensaje está tachado.
Color de la fuente	"This is <font color=\"#FF0000\">red font</font>."	Es una fuente roja.
Hipervínculo	"This is a <a href=\"https://www.google.com\">hyperlink</a>."	Este es un hipervínculo.
Tiempo	"This is a time format: <time>2023-02-16 15:00</time>."	Debe ser un formato de hora: 2023-02-16 15:00.
Nueva línea	"This is the first line. <br> This is a new line."	Esta es la primera línea. Esta es una línea nueva.

Cómo agregar un ícono integrado a una tarjeta

Los widgets DecoratedText y ButtonList admiten el elemento icon que se usa para especificar uno de los íconos integrados disponibles en Chat.

En la siguiente tabla, se muestran los íconos integrados que están disponibles para los mensajes de tarjetas:

	AVIÓN		BOOKMARK
	BUS		AUTO
	RELOJ		CONFIRMATION_NUMBER_ICON
	DESCRIPTION		MONEDA
	CORREO ELECTRÓNICO		EVENT_SEAT
	FLIGHT_ARRIVAL		FLIGHT_DEPARTURE
	HOTEL		HOTEL_ROOM_TYPE
	INVITAR		MAP_PIN
	MEMBRESÍA		MULTIPLE_PEOPLE
	PERSONA		TELÉFONO
	RESTAURANT_ICON		SHOPPING_CART
	DESTACAR		TIENDA
	BOLETO		TRAIN
	VIDEO_CAMERA		VIDEO_PLAY

El siguiente es un ejemplo de una tarjeta con un ícono de correo electrónico:

Cómo agregar un ícono personalizado a una tarjeta

Los widgets DecoratedText y ButtonList te permiten usar los íconos integrados o definir tus propios íconos personalizados. Para especificar un ícono personalizado, usa el elemento iconUrl como se muestra en el siguiente ejemplo: