Configura una app de Google Chat

En esta página, se explica cómo configurar e implementar una app de Google Chat como complemento de Google Workspace.

Para implementar y probar un complemento de Google Workspace que extiende Chat, debes habilitar y configurar una app de Chat con la API de Google Chat. En la configuración de la API de Chat, se especifican todos los detalles sobre la app de Chat, incluidos el nombre, el avatar, la implementación y las funciones interactivas que deseas usar.

Requisitos previos

Elige un nombre visible, un avatar y una descripción para tu app de Chat

El nombre, el avatar y la descripción de la app de Chat se muestran a los usuarios en la IU de Chat. Para interactuar con las apps de chat, los usuarios ven o usan esta información de las siguientes maneras:

  • Menciona con @ la app de Chat para agregarla a un espacio o enviarle un mensaje.
  • Busca la app de Chat y comienza un mensaje directo con ella. En el menú Apps, los mensajes directos muestran el nombre y el avatar de la app de Chat.
  • Desde la barra de redacción, los usuarios pueden explorar las apps de Chat y ver su nombre, avatar y descripción.

Antes de configurar una app de Chat, debes preparar la siguiente información:

Campo Descripción Formato
Nombre de la aplicación Es el nombre visible de la app de Chat. Hasta 25 caracteres alfanuméricos
URL del avatar Es la imagen que se muestra como avatar de tu app de Chat. Es una URL HTTPS que apunta a una imagen gráfica cuadrada (PNG o JPEG). El tamaño recomendado es de 256 × 256 píxeles o más.
Descripción Es una breve descripción del propósito de la app de Chat. Hasta 40 caracteres alfanuméricos

En la siguiente sección, especificarás esta información en la configuración de la API de Chat.

Configura tu app de Chat en la consola de Google Cloud

En la consola de Google Cloud, configuras los detalles sobre tu app de Chat que aparecen a los usuarios en Chat, incluidos un nombre visible, un avatar y una descripción. Estos detalles solo aparecen en Chat. Para publicar tu app de Chat en Marketplace, también debes especificar los detalles que aparecen en la ficha de Marketplace de tu app de Chat.

Cuando tengas los detalles de tu app de Chat, abre tu proyecto de Cloud y configura la API de Chat:

  1. En la consola de Google Cloud, ve a la página de la API de Chat y haz clic en la página Configuración:

    Ir a la página Configuración de la API de Chat

  2. En Información de la aplicación, completa los campos Nombre de la app, URL del avatar y Descripción.

  3. En Funciones interactivas, haz clic en el botón de activación Habilitar funciones interactivas y completa los siguientes pasos:

    1. En Funcionalidad, selecciona Unirse a espacios y conversaciones grupales para que tu app de Chat esté disponible para instalar y usar.

      De forma predeterminada, los usuarios pueden instalar la app de Chat y enviar mensajes con ella en un espacio dedicado entre el usuario y la app de Chat. Los usuarios también pueden agregar la app de Chat a espacios con varias personas y, luego, interactuar con ella.

    2. En Configuración de conexión, selecciona la arquitectura que deseas usar para recibir objetos de eventos de Chat:

      • Para usar un servicio HTTP, selecciona URL del extremo HTTP y proporciona una URL.
      • Para usar un proyecto de Google Apps Script, selecciona Apps Script y proporciona un ID de implementación para el proyecto.

    3. Opcional: Para recibir objetos de eventos en más de un extremo o función, ve a Configuración de conexión > Activadores y proporciona o actualiza las funciones de devolución de llamada para los siguientes activadores de chat:

      • Se agregó al espacio: Un usuario agrega la app de Chat a una conversación grupal o a un espacio, o bien instala la app de Chat para mensajes 1:1.
      • Mensaje: Un usuario envía un mensaje a la app de Chat. Por ejemplo, envía un mensaje directo a la app de Chat o menciona con @a la app de Chat en un espacio con varias personas.
      • Se quitó del espacio: Un usuario desinstala o quita la app de Chat de un espacio.
      • Comando de la app: Un usuario usa un comando rápido o un comando de barra desde la app de Chat.

    4. Opcional: Agrega otras funciones interactivas, como comandos rápidos, comandos de barra o vistas previas de vínculos.

    5. En Visibilidad, especifica tu correo electrónico para que puedas instalar y probar la app de Chat antes de publicarla en Google Workspace Marketplace. Puedes especificar hasta cinco personas o uno o más grupos de Google de tu organización de Google Workspace.

  4. Opcional: En Registros, selecciona la casilla de verificación Registrar errores en Logging para usar Google Cloud Logging. Para obtener más información, consulta Cómo consultar los registros de errores de las apps de Chat en la documentación de la API de Chat.

  5. Haz clic en Guardar.

Después de guardar la configuración, cualquier persona que hayas especificado en el parámetro de configuración Visibilidad de la API de Chat podrá instalar, probar o usar la app de Chat. Para comenzar a probar y depurar tu app de Chat, consulta Cómo probar funciones interactivas para apps de Google Chat en la documentación de la API de Chat.

Consideraciones para los complementos de Google Workspace existentes

Las apps de Chat requieren una configuración diferente en comparación con los complementos de Google Workspace que extienden otras aplicaciones de Google Workspace. Si tu complemento extiende otras aplicaciones de Google Workspace, ten en cuenta los siguientes requisitos para configurar la app de Chat:

  • Tanto las personas como los administradores de Google Workspace deben poder instalar tu complemento desde Marketplace. Puedes configurar estos parámetros en el SDK de Google Workspace Marketplace.
  • Las apps de Chat no usan el nombre ni el logotipo que configuras para otras aplicaciones de Google Workspace en el objeto addons.common del manifiesto.
  • En el caso de los complementos que se publican en Google Workspace Marketplace, no puedes guardar un borrador de los cambios en la configuración de la API de Google Chat. Después de actualizar y guardar la configuración de la API de Chat, la app de Chat actualizada estará disponible para todos los usuarios existentes. Para actualizar tu ficha de Marketplace, puedes crear un borrador antes de enviar cualquier cambio.

  • Si creaste tu complemento con Apps Script, haz lo siguiente:

  • Si creaste tu complemento con un servicio HTTP, omite los detalles de configuración de la app de Chat en el manifiesto y las implementaciones que crees con la API de complementos de Google Workspace. Las implementaciones de HTTP que especificas en el SDK de Google Workspace Marketplace solo se usan para otras aplicaciones de Google Workspace.