Descripción general

Crea apps de Google Chat que lleven tus servicios y recursos directamente a Google Chat, lo que les permitirá a los usuarios obtener información y realizar acciones sin salir de la conversación.

Google Chat admite la colaboración en equipo, ya que ofrece lo siguiente:

  • Mensajes directos entre usuarios
  • Conversaciones intercaladas dentro de los espacios
  • Espacios de chat que te permiten dedicar un espacio de debate por proyecto, por equipo o por cualquier otro motivo.
  • Apps de chat que pueden participar en espacios o responder a mensajes directos

Mensajes y espacios

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

Los mensajes incluyen interacciones con 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 los mensajes y los 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 contienen contenido de texto sin formato.

    • Los mensajes de tarjetas 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 abre un diálogo para recopilar información de un usuario.

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

      Abre el Creador de tarjetas

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

    • Los usuarios pueden ver los espacios grupales o con nombre.
    • Solo el usuario de ese espacio puede ver un mensaje directo.

Casos de uso

Agregar apps de chat a una plataforma de conversación como Chat permite a las personas hacer preguntas y emitir comandos sin cambiar de contexto. En su backend, una app de Chat puede acceder a otros sistemas y actuar como intermediario para ellos.

Esta capacidad de proporcionar acceso a una amplia variedad de recursos y herramientas, a la vez que se mantiene una experiencia cognitiva unificada, puede proporcionar un marco de trabajo 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 lo que podrías pedirle a una app de Chat que haga desde el espacio de Chat:

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

Compila apps de Chat

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

Para cada app de Chat que compiles, debes crear un proyecto de Google Cloud independiente en la consola de Google Cloud. Para implementar y compartir tu app de Chat con otros usuarios de Google Chat, debes publicarla y agregarla a Google Workspace Marketplace. Para obtener más información, consulta Cómo crear y administrar implementaciones para tu app de Chat.

Apps de chat interactivo

Muchas apps de chat permiten que los usuarios envíen mensajes y interactúen directamente con la app de chat. Las apps de chat interactivo pueden hacer lo siguiente:

  • Responde a las @menciones, los comandos de barra o los 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 permita a los usuarios realizar acciones directamente desde la conversación.

Para interactuar con los usuarios, tu app de Chat debe poder recibir y responder a eventos de interacción. Para compilar una app de Chat interactiva, consulta Cómo recibir y responder 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 cuyo caso estos no pueden interactuar directamente con la app de Chat, pero la app de Chat llama directamente a la API de Google Chat. Por ejemplo, puedes crear una app de Chat que envíe un mensaje a un espacio, pero los usuarios no pueden responder a la app de Chat. 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 con la API de Google Workspace Events. Una suscripción permite que tu app de Chat reciba información sobre eventos, que representan cambios en un recurso de Google Workspace suscrito. Por ejemplo, una app de Chat puede responder a los cambios en un espacio al que se suscribió 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 los espacios de Chat, pero no proporciona ni dicta ninguna forma en 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 te gusten, y puedes hacerlo en una variedad de 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 apps a los datos del usuario

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

  • De forma predeterminada, las apps de chat solo pueden leer la identidad básica de los usuarios que las invocan o de los usuarios a los que se menciona con @ en el mismo mensaje que invoca la app. Esta información incluye el nombre visible, el ID, la dirección de correo electrónico y la imagen de avatar del usuario.

  • En el caso de las apps de Chat que obtienen vistas previas de 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 funciones 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 que solicite acceso, y el usuario debe otorgarlo. Para obtener más información, consulta Cómo conectar una app de Chat con otros servicios y herramientas.

¿Quieres ver la API de Google Chat en acción?
El canal de Google Workspace Developers ofrece videos sobre sugerencias, trucos y las funciones más recientes.