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 @menciona a uno o a todos los usuarios en un espacio de chat.
• Texto que aparece en una interfaz de 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 darle 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 formato del texto en los mensajes de texto es diferente al de los mensajes de tarjeta, ya que los mensajes de texto se formatean con la misma sintaxis 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:

Cómo 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. En el campo text, se incluye el formato que se aplica al mensaje de texto con la sintaxis de Markdown. El formato adicional se encuentra en el campo formattedText de solo salida, que incluye lo siguiente:

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

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

Si el mensaje se formateó con el menú Format de la IU de chat, 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 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*?",
    }

Cómo dar 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 creará automáticamente un hipervínculo a la URL especificada.

Para proporcionar 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 usar emojis personalizados en un mensaje de texto

Las apps de chat pueden enviar mensajes de texto con emojis personalizados para personalizar los mensajes. Los emojis personalizados solo están disponibles para las organizaciones de Google Workspace, y el administrador debe activarlos para la organización. Para obtener más información, consulta Más información sobre los emojis personalizados en Google Chat y Cómo administrar los permisos de los emojis personalizados.

Para crear mensajes con emojis personalizados, tu app debe usar la autenticación de usuarios. Los emojis personalizados no se admiten en los mensajes creados como webhook ni en los mensajes creados con autenticación de la app.

Para agregar emojis personalizados al texto de un mensaje, especifica name o emoji_name del recurso customEmoji:

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

Para usar este ejemplo, reemplaza CUSTOM_EMOJI_ID por el ID del emoji personalizado. Puedes encontrar este ID en el campo name o emoji_name del recurso customEmoji.

Cómo mencionar usuarios en un mensaje de texto

Las apps de Chat pueden enviar mensajes de texto que @mencionen a uno o a todos los usuarios de un espacio de Chat. Para mencionar a usuarios que no se unieron al espacio o a un espacio en modo de importación, las apps de Chat deben enviar el mensaje con autenticación de usuario.

@menciona a usuarios específicos

Para mencionar a un usuario específico, agrega <users/{user}> al mensaje de texto, donde {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 de users/{user} de las siguientes maneras:

• Si tu app de Google Chat responde a un mensaje enviado por 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 alias para el valor de {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 usuario.

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

@mencionar a todos los usuarios

Para crear un mensaje de texto en el que se @mencione a todas las personas de un espacio, reemplaza {user} por all. En el siguiente ejemplo de JSON, se menciona a 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 con un pequeño subconjunto de etiquetas HTML. El formato del texto en los mensajes de tarjetas es diferente al de los mensajes de texto, ya que estos últimos se formatean con 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 los mensajes de las apps de Chat:

Cómo dar formato al texto de un párrafo

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

Además, se puede usar la sintaxis de Markdown y las siguientes etiquetas:

This is a code block.

Para seleccionar la sintaxis que se usará cuando se dé formato al contenido de un párrafo de texto, usa el campo Sintaxis de texto.

Cómo agregar íconos al texto

Para mostrar íconos junto al 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 íconos personalizados en texto decorado o botones.

Cómo usar íconos de Chat

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

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

A continuación, se muestra un ejemplo de una tarjeta con un ícono de correo electrónico:

Usa íconos de Material de Google

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

A continuación, se muestra un ejemplo de una tarjeta con un ícono de Google Material:

Usa íconos personalizados

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

A continuación, se muestra un ejemplo de un ícono personalizado: