Descripción general

Compila apps de Google Chat que trasladan tus servicios y recursos directamente a Google Chat para permitir 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 los espacios
  • Espacios de Chat que te permiten dedicar espacios de debate por proyecto, por equipo o de otras formas.
  • 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 por medio de 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 del 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.

  • 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 que las personas hagan preguntas y emitan comandos sin cambiar el contexto. En su backend, una app de Chat puede acceder a otros sistemas y actuar como intermediaria con ellos.

Esta capacidad de proporcionar acceso a una amplia gama de recursos y herramientas, a la vez 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 las 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 búsquedas de texto libre o estructuradas que ingresa el usuario.
  • Envía 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í, como proporcionar "memoria de equipo" o recursos de programación.

Compila apps interactivas de Chat

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

  • Responde a @mentions, comandos de barra o mensajes directos con un mensaje de texto o de tarjeta.
  • Abre un diálogo para ayudar a los usuarios a completar procesos de varios pasos, como completar datos de formularios.
  • Obtén una vista previa de los vínculos adjuntando tarjetas con información útil que les permitan a los usuarios realizar acciones directamente desde la conversación.

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.

Compila apps de Chat no interactivas

Las apps de Google Chat también pueden ser no interactivas para los usuarios, aunque estos 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 funciones como los informes de alarmas. Para obtener más información, consulta la descripción general de la API de Google Chat.

Compila apps de Chat controladas por eventos

Una app de Chat puede suscribirse a eventos sobre recursos de Chat mediante la API de Eventos de Google Workspace. 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 agreguen al espacio. Para obtener más información, consulta Suscríbete a eventos de Google Chat.

Elige una arquitectura de app de Chat

La API de Chat proporciona varias formas en las que puedes integrar tus apps en espacios de Chat, pero no proporciona ni determina 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. Puedes hacerlo en varias plataformas, incluidas las siguientes:

  • AppSheet
  • Google Apps Script
  • 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 dirigirse al invocador. Para acceder a los datos más allá de estos datos de identidad básicos, la app de Chat debe tener acceso 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 a los que se los @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 del avatar del usuario.

  • En el caso de las apps de Chat que generan 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 accedes a los datos del usuario, la app de Chat le pide al usuario que solicite 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?
El canal para desarrolladores de Google Workspace ofrece videos con sugerencias, trucos y las funciones más recientes.