Descripción general

Compila apps de Google Chat que incorporan tus servicios y recursos a Google Chat para que los usuarios obtengan información y realicen acciones sin abandonar la conversación.

Google Chat admite la colaboración en equipo proporcionando lo siguiente:

  • Mensajes directos entre usuarios
  • Conversaciones agrupadas dentro de espacios
  • Espacios de Chat que te permiten dedicar espacios de debate por proyecto, por equipo o por cualquier otro motivo.
  • Apps de Chat que pueden participar en espacios o responder mensajes directos

Mensajes y espacios

Las interacciones entre Google Chat y las apps de Chat se producen mediante mensajes en el contexto de espacios particulares. Por ejemplo, una app de Chat puede enviar un mensaje de texto (un tipo de mensaje) a un espacio de Chat específico.

Los mensajes incluyen interacciones de la app de Chat, texto o tarjetas, mientras que los espacios incluyen salas de chat y mensajes directos.

En el diagrama anterior, se muestran los diferentes tipos de interacciones y contextos disponibles para mensajes y espacios:

  • Los mensajes entre Google Chat y una app de Chat siguen un formato de mensaje definido, en el que cada mensaje consta de un objeto JSON cuyos componentes especifican el ID de usuario, el estilo, el contenido y otros aspectos del mensaje. Las apps de chat pueden enviar los siguientes tipos de mensajes:

    • Los mensajes de texto incluyen contenido de texto sin formato con formato de texto limitado.
    • Los mensajes de tarjeta definen el formato, el contenido y el comportamiento de las tarjetas que se mostrarán en un espacio. Por ejemplo, un mensaje de tarjeta puede incluir un botón con un vínculo que abra un diálogo para recopilar información de un usuario.


      Usa el Creador de tarjetas para diseñar mensajes de tarjetas JSON y obtener una vista previa de ellos en las apps de Chat:

      Abre el Creador de tarjetas

  • En Google Chat, los espacios pueden tener los siguientes contextos:

    • Varios usuarios pueden ver un espacio con nombre o grupo.
    • Los mensajes directos solo serán visibles para el usuario de ese espacio.

Casos de uso

Agregar apps de Chat a una plataforma de conversación como Chat permite a los usuarios hacer preguntas y emitir comandos sin cambiar el contexto. En su backend, una app de Chat puede acceder a otros sistemas y actuar como intermediaria en ellos.

Esta capacidad para proporcionar acceso a una amplia variedad de recursos y herramientas, al tiempo que mantiene una experiencia cognitiva unificada, puede proporcionar un framework para muchos tipos de aplicaciones, incluidas las siguientes:

  • Administración de flujos de trabajo
  • Instalación y configuración
  • Generación de pedidos
  • Buscar
  • Recopilación de datos

Estos son algunos ejemplos de acciones que puedes pedirle a una app de Chat desde el espacio de Chat:

  • Buscar información: Una app de Chat puede recuperar información basada en consultas estructuradas o de texto libre que ingresa el usuario.
  • Enviar tickets: Una app de Chat puede generar informes de incidentes u otros artefactos con la información que proporciona el usuario.
  • Coordinar los esfuerzos: Una app de Chat puede mejorar la forma en que los miembros del equipo interactúan entre sí, por ejemplo, proporcionando "memoria de equipo" o recursos de programación.

Compila apps de Chat

En esta sección, se explican algunos de los tipos de apps de Chat que puedes compilar.

Por cada app de Chat que compiles, debes crear un proyecto de Google Cloud independiente en la consola de Google Cloud. Para implementar y compartir la app de Chat con otros usuarios de Google Chat, debes publicarla y enumerarlos en Google Workspace Marketplace. Si quieres obtener más información, consulta Crea y administra implementaciones para tu app de Chat.

Apps de chat interactivo

Muchas apps de Chat permiten a los usuarios interactuar con la app de Chat y enviar mensajes directamente. Las apps de Chat interactivo pueden realizar cualquiera de las siguientes acciones:

Para interactuar con los usuarios, la app de Chat debe poder recibir eventos de interacción y responder a ellos. Para compilar una app de Chat interactiva, consulta Recibe y responde eventos de interacción de la app de Google Chat.

Apps de Chat no interactivas

Las apps de Google Chat también pueden ser no interactivas para los usuarios en las que los usuarios no pueden interactuar directamente con la app de Chat, pero esta llama directamente a la API de Google Chat. Por ejemplo, puedes crear una app de Chat que envíe un mensaje en un espacio, pero los usuarios no pueden responder a ella. Este tipo de arquitectura de app de Chat es útil para tareas como los informes de alarmas. Para obtener más información, consulta la descripción general de la API de Google Chat.

Apps de Chat controladas por eventos

Una app de Chat puede suscribirse a eventos sobre recursos de Chat mediante la API de Google Workspace Events. Una suscripción permite que la app de Chat reciba información sobre eventos, que representan cambios en un recurso suscrito de Google Workspace. Por ejemplo, una app de Chat puede responder a los cambios en un espacio al que está suscrita la app de Chat, como enviar un mensaje de bienvenida a los miembros nuevos que se agregaron al espacio. Para obtener más información, consulta Cómo suscribirte a eventos de Google Chat.

Elige una arquitectura de app de Chat

La API de Chat proporciona varias formas de integrar tus apps en espacios de Chat, pero no proporciona ni dicta una forma particular de implementar la lógica de la app de Chat. Puedes crear una app de Chat basada en comandos o usar cualquier tipo de procesamiento de lenguaje y servicios o módulos de IA que desees. También puedes hacerlo en varias plataformas, incluidas las siguientes:

  • AppSheet
  • Google Apps Script
  • Dialogflow
  • Pub/Sub
  • Google Cloud o un servidor HTTP local

Para obtener más información, consulta Elige una arquitectura de apps de Chat.

Acceso de las apps a los datos del usuario

Cuando se invoca una app de Chat, esta necesita saber quién la invoca, en qué contexto y cómo abordar al invocador. Para acceder a los datos más allá de estos datos básicos de identidad, se debe otorgar acceso a la app de Chat mediante la autenticación.

  • De forma predeterminada, las apps de Chat solo pueden leer la identidad básica de los usuarios que los invocan o de los usuarios que se @menciona en el mismo mensaje que invoca la app. Esta información incluye el nombre visible, el ID de usuario, la dirección de correo electrónico y la imagen de avatar del usuario.
  • En el caso de las apps de Chat que tienen una vista previa de los vínculos, la app de Chat puede leer las URLs agregadas al mensaje que coinciden con los patrones de URL configurados de la app de Chat.

  • Si una app de Chat necesita acceder a otros datos para proporcionar capacidades mejoradas a los usuarios, como leer todos los mensajes o la lista de miembros de un espacio, configura la autenticación para que pueda acceder a esos datos. Si se accede a los datos del usuario, la app de Chat le solicita al usuario acceso, y este debe otorgarlo. Para obtener más información, consulta Conecta una app de Chat con otros servicios y herramientas.

¿Quieres ver la API de Google Chat en acción?
En el canal para desarrolladores de Google Workspace, se ofrecen videos sobre sugerencias, trucos y las funciones más recientes.