Saltearse al contenido
Nappai Documentation

Google Chat Spaces

Este componente actúa como un puente directo entre Nappai y tus espacios de Google Chat. Te permite crear nuevos espacios de conversación, ver una lista de los que ya tienes disponibles, consultar información detallada sobre uno en específico y administrar a los miembros (usuarios o bots) que participan en ellos. Es ideal para organizar equipos, centralizar comunicaciones automatizadas y mantener tus flujos de trabajo alineados con las herramientas de colaboración de Google Workspace.

Conexión y Credenciales

Este componente requiere configurar previamente una credencial en el panel de Nappai para poder interactuar con el servicio de Google Chat:

  1. Dirígete a la sección de Credenciales en tu panel de Nappai.
  2. Crea una nueva credencial del tipo Google Chat y guarda los campos requeridos (Seleccionar Proyecto, Client Id, Client Secret y Acceso a Google Chat).
  3. En tu flujo de trabajo, selecciona la credencial guardada en el campo de entrada Credential de este nodo.

Entradas

A continuación, encontrarás los campos que puedes configurar para personalizar el comportamiento de este componente. Todos los nombres se mantienen en su formato original para garantizar una correcta integración:

  • Operation: Define la acción principal que deseas ejecutar (por ejemplo, listar espacios, crear uno nuevo, obtener detalles o gestionar miembros).
  • Space: Permite seleccionar un espacio de Google Chat ya existente desde una lista desplegable para trabajar con él.
  • Spaces Count: Establece el número máximo de espacios que deseas recuperar en una sola consulta (el valor predeterminado es 100).
  • Space Name: Indica el nombre que tendrá el nuevo espacio cuando lo estés creando.
  • Space Type: Elige el tipo de espacio que deseas crear (público o privado) según la visibilidad que necesites.
  • User Email: Ingresa la dirección de correo electrónico del usuario o bot que deseas agregar o eliminar de un espacio.

Salidas

El componente entrega un resultado estructurado llamado Data, que contiene la respuesta final de la operación seleccionada. Dependiendo de lo que hayas configurado, podrás recibir una lista de espacios, los metadatos de un espacio creado, el estado de la gestión de miembros, o un mensaje de éxito/error que puedes usar para tomar decisiones en pasos posteriores de tu automatización.

Ejemplo de Respuesta JSONjson

{ “name”: “spaces/ABC123XYZ”, “displayName”: “Soporte Técnico 2024”, “spaceType”: “SPACE”, “defaultLanguageCode”: “es”, “avatarUrl”: “https://example.com/avatar.png”, “memberCount”: 8, “success”: true, “message”: “Operación completada exitosamente” } Nota: La estructura exacta del JSON variará según la operación que hayas seleccionado. Puedes mapear campos específicos de este resultado hacia otros componentes en tu flujo.

Conectividad

Este componente suele conectar su salida Data hacia nodos de notificación, bases de datos o flujos de aprobación, ya que es común necesitar reaccionar ante un nuevo espacio creado o ante la baja/alta de un miembro. También es frecuente que se conecte previamente con componentes de captura de datos (como formularios web o triggers de email) para alimentar los campos de Space Name, Space Type o User Email con información en tiempo real.

Ejemplo de Uso

Imagina que necesitas automatizar la creación de un espacio privado para cada nuevo cliente que ingresa a tu empresa. El flujo sería el siguiente:

  1. Captura de datos: Un componente anterior obtiene el nombre del cliente y su correo electrónico.
  2. Google Chat Spaces: Configuras la operación para crear un nuevo espacio, asignas un nombre personalizado y lo marcas como “Privado”.
  3. Gestión de miembros: En el mismo flujo, conectas una segunda instancia de este componente para agregar el correo del cliente al espacio recién creado.
  4. Notificación: Envías un mensaje de confirmación al equipo de ventas indicando que el espacio está listo.

Este enfoque te permite eliminar tareas repetitivas y garantizar que cada cliente tenga su propio canal de comunicación automatizado.

Consejos y Mejores Prácticas

  • Verifica siempre que el nombre del espacio no esté duplicado para evitar confusiones en tu organización.
  • Utiliza espacios privados cuando trabajes con información sensible o proyectos confidenciales.
  • Revisa que las direcciones de correo ingresadas en User Email sean válidas para evitar errores de integración con la API de Google.
  • Si esperas grandes cantidades de datos, ajusta el campo Spaces Count para optimizar el rendimiento de tu flujo.

Consideraciones de Seguridad

Este componente utiliza autenticación segura mediante OAuth2, lo que garantiza que solo las credenciales autorizadas puedan acceder o modificar tus espacios. Asegúrate de revisar los permisos asignados en tu credencial de Google Chat y revocar el acceso cuando ya no sea necesario. La información intercambiada viaja cifrada y cumple con los estándares de privacidad de Google Workspace.