Dar formato a los mensajes

En esta página, se explica cómo las apps de Google Chat pueden dar formato al texto para enviar mensajes que contengan cualquiera de los siguientes elementos:

• Texto enriquecido que contiene hipervínculos o @menciones a uno o todos los usuarios en un espacio de Chat
• Es el texto que aparece en la interfaz de una tarjeta, incluido el texto de párrafo o el texto de la IU que se muestra junto a un ícono, como un botón.

Cómo dar formato a un mensaje de texto

Chat te permite agregar formato básico a un mensaje de texto, como negrita, cursiva y tachado, con un pequeño subconjunto de la sintaxis de Markdown. El texto se da formato de manera diferente en los mensajes de texto que en los mensajes de tarjetas porque los mensajes de texto tienen el mismo formato que usan los usuarios de Chat.

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

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:

Ver el formato de texto enviado en un mensaje

Cuando un usuario envía un mensaje, el cuerpo de texto sin formato del mensaje 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, que incluye lo siguiente:

• Sintaxis adicional de Markdown para texto
• Menciones de usuarios
• Hipervínculos personalizados
• Emojis personalizados

Por ejemplo, considera el siguiente texto que envía un usuario:

Si el mensaje se formateó con el menú Formatear en la IU de Chat, el campo text solo contiene el texto, mientras que el campo formattedText contiene los marcadores, el texto y el hipervínculo. En el siguiente ejemplo, se muestra el borrador de un mensaje de texto con una palabra hipervinculada, elementos en una lista y una palabra en negrita:

El mensaje se recibe en el siguiente 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*?",
    }

Formatear vínculos

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

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

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

Cómo mencionar a usuarios en un mensaje de texto

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

Mencionar a usuarios específicos con @

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 la app de Google Chat responde a un mensaje que envía 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 mahan@example.com, puedes especificar el usuario como users/mahan@example.com. Para usar un alias de correo electrónico, tu app de Google Chat debe autenticarse como un usuario.

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

@mencionar a todos los usuarios

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

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

Cómo dar formato al texto que aparece en las tarjetas

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

Usa Card Builder para diseñar y obtener una vista previa de las interfaces de usuario y mensajería para apps de Chat:

Aplica formato al texto de un párrafo

En la siguiente tabla, se muestran las etiquetas admitidas y su propósito:

Cómo agregar íconos al texto

Para mostrar íconos junto con el texto en una tarjeta, puedes usar los widgets DecoratedText y ButtonList.

En las siguientes secciones, se explica cómo usar íconos integrados, íconos de Google Material o personalizados en botones o texto decorados.

Cómo usar íconos de Chat

Para usar uno de los íconos integrados disponibles en Chat, especifica una de las siguientes opciones:

En la siguiente tabla, se enumeran los íconos integrados disponibles para los mensajes de tarjetas:

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

Usa íconos de Google Material

Puedes usar íconos de Material de Google para seleccionar entre más de 2, 500 opciones de íconos y personalizar el grosor, el relleno y el grado de los íconos.

El siguiente es un ejemplo de una tarjeta con un ícono de Material de Google:

Cómo usar íconos personalizados

Para agregar un ícono personalizado, incluye el campo iconUrl y especifica la URL correspondiente del ícono.

El siguiente es un ejemplo de un ícono personalizado: